Function

find( search_text, within_text, start_num )

Searches the text for a particular substring, returning the positional index of the first character of the first match.

See also: search(), searchb()

Parameters

Returns

Number

Examples

Searching for a substring within a string

1
find("to", "boston")

Returns 4.

Searching for a substring not contained in a string

1
find("ne", "boston")

Returns 0.

Searching with a start index

1
find("o", "boston", 4)

Returns 5. The function starts searching the string at index 4.

Lists

Searching multiple strings at once

1
find({ "t", "i" }, { "boston", "paris" })

Returns { 4, 4 }.

Searching with multiple start indices

1
find("o", "boston", { 1, 3 })

Returns { 2, 5 }. The search is repeated at each start index in the list.

Edge cases

Empty list parameters

1
find({}, "boston")

Returns {}.

Empty string start_num

1
find("o", "boston", "")

Returns 0. The function always returns 0 when given an empty string start_num.

Feature compatibility