findIf

From Bohemia Interactive Community
Revision as of 15:31, 6 March 2018 by warkonaut (talk | contribs) (Created page with "{{Command|= Comments ____________________________________________________________________________________________ | arma3dev |= Game name |1.81|= Game version ______________...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Introduced with Arma 3 Development Branch version 1.811.81DEV BRANCH ONLY ⚠
Hover & click on the images for descriptions

Description

Description:
Searches for an element within array for which the code evaluates to true. Returns the 0 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.

NOTE: Because command findIf terminates as soon as it finds an element that fulfills the condition, it is more efficient then count in scenarios where you need to check for presence / absence of at least one element that evaluates to true.

Syntax

Syntax:
array find 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 - 0 based position of the first array element for which the code evaluate to true, -1 if not found

Examples

Example 1:
[unit1,unit2,unit3] find {!alive _x}; //return index of first dead unit

Additional Information

See also:
find
Groups:
Uncategorised

Notes

i
Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.

Notes

Bottom Section