str index-of

Returns start index of first occurrence of string in input, or -1 if no match.

Command Type

built-in

> str index-of {flags} (string) ...rest

--grapheme-clusters, -g: Count indexes using grapheme clusters (all visible chars have length 1).
--utf-8-bytes, -b: Count indexes using UTF-8 bytes (default; non-ASCII chars have length 2+).
--range, -r {range}: Optional start and/or end index.
--end, -e: Search from the end of the input.

string: The string to find in the input.
...rest: For a data structure input, search strings at the given cell paths, and replace with result.

Returns index of string in input.

>  'my_library.rb' | str index-of '.rb'
10

Count length using grapheme clusters.

> '🇯🇵ほげ ふが ぴよ' | str index-of --grapheme-clusters 'ふが'
4

A match that falls inside a grapheme cluster is reported as not found.

> '🇯🇵' | str index-of --grapheme-clusters '🇵'
-1

Returns index of string in input within arhs open range.

>  '.rb.rb' | str index-of '.rb' --range 1..
3

Returns index of string in input within a lhs open range.

>  '123456' | str index-of '6' --range ..4
-1

Returns index of string in input within a range.

>  '123456' | str index-of '3' --range 1..4
2

Returns index of string in input.

>  '/this/is/some/path/file.txt' | str index-of '/' -e
18