nushell/str_trim.md at 9b2a022f5b41aad69d87545bae00d725a2fac09f

* Finish updating

* a couple improvements

* Update renames

* cleanup examples

2022-02-13 21:22:51 -05:00

title	layout	version
str trim	command	0.59.0

trims text

Signature

> str trim ...rest --char --left --right --all --both --format

...rest: optionally trim text by column paths
--char {string}: character to trim (default: whitespace)
--left: trims characters only from the beginning of the string (default: whitespace)
--right: trims characters only from the end of the string (default: whitespace)
--all: trims all characters from both sides of the string and in the middle (default: whitespace)
--both: trims all characters from left and right side of the string (default: whitespace)
--format: trims spaces replacing multiple characters with singles in the middle (default: whitespace)

Trim whitespace

> 'Nu shell ' | str trim

Trim a specific character

> '=== Nu shell ===' | str trim -c '=' | str trim

Trim all characters

> ' Nu   shell ' | str trim -a

Trim whitespace from the beginning of string

> ' Nu shell ' | str trim -l

Trim a specific character

> '=== Nu shell ===' | str trim -c '='

Trim whitespace from the end of string

> ' Nu shell ' | str trim -r

Trim a specific character

> '=== Nu shell ===' | str trim -r -c '='