nushell/docs/commands/str_rpad.md
Justin Ma c0a1d18e3d
update #4455, regenerate commands' docs and update make_docs script (#4586)
* feat: update #4455, regenerate commands' docs

* chore: update make_docs script
2022-02-21 11:26:00 -06:00

40 lines
717 B
Markdown

---
title: str rpad
layout: command
version: 0.59.0
---
pad a string with a character a certain length
## Signature
```> str rpad ...rest --length --character```
## Parameters
- `...rest`: optionally check if string contains pattern by column paths
- `--length {int}`: length to pad to
- `--character {string}`: character to pad with
## Examples
Right pad a string with a character a number of places
```shell
> 'nushell' | str rpad -l 10 -c '*'
```
Right pad a string with a character a number of places
```shell
> '123' | str rpad -l 10 -c '0'
```
Use rpad to truncate a string
```shell
> '123456789' | str rpad -l 3 -c '0'
```
Use rpad to pad Unicode
```shell
> '▉' | str rpad -l 10 -c '▉'
```