nushell/docs/commands/str_trim.md

1.3 KiB

title layout version
str trim command 0.59.1

trims text

Signature

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

Parameters

  • ...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)

Examples

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 '='