nushell/docs/commands/str-rpad.md
JT bff81f24aa
Autogenerate missing docs (#3514)
* Autogenerate missing docs

* Update ansi.md

* Rename question mark command docs

* Delete empty?.md
2021-05-30 12:57:04 +12:00

38 lines
785 B
Markdown

# str rpad
pad a string with a character a certain length
## Usage
```shell
> str rpad ...args {flags}
```
## Parameters
* ...args: optionally check if string contains pattern by column paths
## Flags
* -h, --help: Display this help message
* -l, --length <integer> (required parameter): length to pad to
* -c, --character <string> (required parameter): character to pad with
## Examples
Right pad a string with a character a number of places
```shell
> echo 'nushell' | str rpad -l 10 -c '*'
```
Right pad a string with a character a number of places
```shell
> echo '123' | str rpad -l 10 -c '0'
```
Use rpad to truncate a string
```shell
> echo '123456789' | str rpad -l 3 -c '0'
```
Use rpad to pad Unicode
```shell
> echo '▉' | str rpad -l 10 -c '▉'
```