find

1.001.991.001.001.501.000.50

Hover & click on the images for description

Description

Description:

Searches for an array element within an array or an ANSI string within an ANSI string.

If Unicode support is desired, see forceUnicode.

⚠

Search is cASe-seNsItiVE!

Groups:

StringsArrays

Syntax 1

Syntax:

array find element

Parameters:

array: Array - array to search in

element: Anything - array element to find

Return Value:

Number - zero-based position of the first array element that matches x, -1 if not found

1.28

Syntax 2

Syntax:

string find substring

Parameters:

string: String - string to search in

substring: String - substring to find

Return Value:

Number - zero-based position of the first sequence of characters that matches substring, -1 if not found

2.02

Syntax 3

Syntax:

string find [substring, indexStart]

Parameters:

string: String - string to search in

substring: String - substring to find

indexStart: Number - zero-based index which defines where find starts from

Return Value:

Number - zero-based position of the first sequence of characters that matches substring, -1 if not found

Examples

Example 1:

["Apples", "Oranges", "Pears"] find "Oranges"; // returns 1

Example 2:

[1, [2], [[3]]] find [[3]]; // returns 2 - does not work in OFP, returns -1

Example 3:

if (magazines player find "Strela" != -1) then { hint "You've got Strela!"; };

Example 4:

hint str ("japa is the man!" find "the man!"); // returns 8

Example 5:

"abc" find ""; // returns 0

Example 6:

"abcdefghijklmnopqrstuvxyz" find "z"; // returns 24 "abcdefghijklmnopqrstuvxyz" find ["z", 20]; // returns 24, better performance

Example 7:

"abcßdef" find "c" // 2 "abcßdef" find "ß" // 3 "abcßdef" find "d" // 5 - before forceUnicode forceUnicode 0; // since Arma 3 v2.02 "abcßdef" find "d" // 4

Additional Information

See also:

in findIf forceUnicode

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Heeeere's Johnny! - c

Posted on Jan 04, 2015 - 09:38 (UTC)

Using nil on either side of find will make the whole statement return Nothing:

_array = [1, 2, nil, 4, 5]; _result = _array find nil; hintSilent str (isNil "_result"); // true _result = nil find 1; hintSilent str (isNil "_result"); // true

R3vo - c

Posted on Jul 16, 2020 - 07:33 (UTC)

If you want to return all occurences of a given string in a string use the following code. Thanks to sharp. for providing the code.

private _fnc_findStringsInString = { params ["_string", "_search"]; if (_string == "") exitWith { [] }; private _searchLength = count _search; private _return = []; private _i = 0; private _index = 0; while { _index = _string find _search; _index != -1 } do { _string = _string select [_index + _searchLength]; _i = _i + _index + _searchLength; _return pushBack _i - _searchLength; }; _return; }; ["Test,123,123,Test", "Test"] call _fnc_findStringsInString; // returns [0, 13]