W3cubDocs

/Nushell

str substring for strings

Get part of a string. Note that the start is included but the end is excluded, and that the first character of a string is index 0.

Signature

> str substring {flags} (range) ...rest

Flags

  • --grapheme-clusters, -g: count indexes and split using grapheme clusters (all visible chars have length 1)
  • --utf-8-bytes, -b: count indexes and split using UTF-8 bytes (default; non-ASCII chars have length 2+)

Parameters

  • range: the indexes to substring [start end]
  • ...rest: For a data structure input, turn strings at the given cell paths into substrings

Input/output types:

input output
list<string> list<string>
record record
string string
table table

Examples

Get a substring "nushell" from the text "good nushell" using a range

>'good nushell'|str substring5..12
nushell

Count indexes and split using grapheme clusters

>'๐Ÿ‡ฏ๐Ÿ‡ตใปใ’ ใตใŒ ใดใ‚ˆ'|str substring-g4..6
ใตใŒ

Copyright ยฉ 2019โ€“2023 The Nushell Project DevelopersLicensed under the MIT License.
https://www.nushell.sh/commands/docs/str_substring.html