findIf

1.82

Hover & click on the images for description

Description

Description:

Searches for an element within array for which the code evaluates to true. Returns the zero-based index on success or -1 if not found.
Code on the right side of the command is evaluated for each element of the array, processed element can be referenced in code as _x.

ⓘ

findIf terminates as soon as it finds an element that fulfills the condition, thus it is more efficient than count in scenarios where a check for presence / absence of at least one element should be done (See Example 2).

Groups:

Arrays

Syntax

Syntax:

array findIf code

Parameters:

array: Array - array to search in

code: Code - code defining an element to find, processed element can be referenced within the code as _x

Return Value:

Number - zero-based position of the first array element for which the code evaluate to true, -1 if not found

Examples

Example 1:

[unit1, unit2, unit3] findIf {not alive _x}; // return index of the first dead unit)

Example 2:

// two ways how to 'wait for all units to be dead': waitUntil { [unit1, unit2, unit3] findIf { alive _x } == -1 }; // fast, terminates as soon as it finds a living unit waitUntil { { alive _x } count [unit1, unit2, unit3] == 0 }; // slow, always goes through all array elements

Additional Information

See also:

find count

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