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 (range) ...rest --grapheme-clusters --utf-8-bytes

Parameters

• range: the indexes to substring [start end]
• ...rest: For a data structure input, turn strings at the given cell paths into substrings
• --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+)

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 substring 5..12
nushell

Count indexes and split using grapheme clusters

>  '🇯🇵ほげ ふが ぴよ' | str substring -g 4..6
ふが