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 "rsh" from the text "good rsh" using a range
> 'good rsh' | str substring 5..12
rsh
Count indexes and split using grapheme clusters
> '🇯🇵ほげ ふが ぴよ' | str substring --grapheme-clusters 4..6
ふが