mirror of
https://github.com/fish-shell/fish-shell
synced 2024-12-27 05:13:10 +00:00
54 lines
1.5 KiB
ReStructuredText
54 lines
1.5 KiB
ReStructuredText
string-repeat - multiply a string
|
|
=================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. BEGIN SYNOPSIS
|
|
|
|
.. synopsis::
|
|
|
|
string repeat [(-n | --count) COUNT] [(-m | --max) MAX] [-N | --no-newline]
|
|
[-q | --quiet] [STRING ...]
|
|
string repeat [-N | --no-newline] [-q | --quiet] COUNT [STRING ...]
|
|
|
|
.. END SYNOPSIS
|
|
|
|
Description
|
|
-----------
|
|
|
|
.. BEGIN DESCRIPTION
|
|
|
|
``string repeat`` repeats the *STRING* **-n** or **--count** times. The **-m** or **--max** option will limit the number of outputted characters (excluding the newline). This option can be used by itself or in conjunction with **--count**. If both **--count** and **--max** are present, max char will be outputed unless the final repeated string size is less than max, in that case, the string will repeat until count has been reached. Both **--count** and **--max** will accept a number greater than or equal to zero, in the case of zero, nothing will be outputed. The first argument is interpreted as *COUNT* if **--count** or **--max** are not explicilty specified. If **-N** or **--no-newline** is given, the output won't contain a newline character at the end. Exit status: 0 if yielded string is not empty, 1 otherwise.
|
|
|
|
.. END DESCRIPTION
|
|
|
|
Examples
|
|
--------
|
|
|
|
.. BEGIN EXAMPLES
|
|
|
|
Repeat Examples
|
|
^^^^^^^^^^^^^^^
|
|
|
|
::
|
|
|
|
>_ string repeat -n 2 'foo '
|
|
foo foo
|
|
|
|
>_ echo foo | string repeat -n 2
|
|
foofoo
|
|
|
|
>_ string repeat -n 2 -m 5 'foo'
|
|
foofo
|
|
|
|
>_ string repeat -m 5 'foo'
|
|
foofo
|
|
|
|
>_ string repeat 2 'foo'
|
|
foofoo
|
|
|
|
>_ string repeat 2 -n 3
|
|
222
|
|
|
|
.. END EXAMPLES
|