BIS fnc conditionalSelect: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Some wiki formatting)
m (Some wiki formatting)
 
(2 intermediate revisions by the same user not shown)
Line 16: Line 16:


|descr= This returns a sub-array of elements that satisfy a specific condition '''in the order they have been passed'''.
|descr= This returns a sub-array of elements that satisfy a specific condition '''in the order they have been passed'''.
{{Feature|arma3|Use {{ic|''items'' [[select]] ''condition''}} syntax instead (since {{arma3}} v1.55).}}
{{Feature|arma3|Since {{arma3}} v1.55, use <sqf inline>array select condition</sqf> instead.}}


In the condition, the currently tested element is assigned to the variable "[[Magic Variables#x|_x]]".
In the condition, the currently tested element is assigned to the variable "[[Magic Variables#x|_x]]".
Line 29: Line 29:
|r1= [[Array]]
|r1= [[Array]]


|x1= <code>[<nowiki/>[10, 0, 8, 2, 6, 4], { [[Magic Variables#x|_x]] > 5 }] [[call]] [[BIS_fnc_conditionalSelect]]; {{cc|will return [10,8,6]}}</code>
|x1= <sqf>[[10, 0, 8, 2, 6, 4], { _x > 5 }] call BIS_fnc_conditionalSelect; // will return [10,8,6]</sqf>


|x2= <code>[<nowiki/>[10, [[true]], 8, [[player]]], { [[typeName]] _x == "STRING" }] [[call]] [[BIS_fnc_conditionalSelect]]; {{cc|will return []}}</code>
|x2= <sqf>[[10, true, 8, player], { typeName _x == "STRING" }] call BIS_fnc_conditionalSelect; // will return []</sqf>


|seealso= [[select]], [[count]]
|seealso= [[select]] [[count]]
}}
}}

Latest revision as of 13:57, 13 July 2022

Hover & click on the images for description

Description

Description:
This returns a sub-array of elements that satisfy a specific condition in the order they have been passed.
Arma 3
Since Arma 3 v1.55, use array select condition instead.

In the condition, the currently tested element is assigned to the variable "_x".

The original array is not modified.
Execution:
call
Groups:
Arrays

Syntax

Syntax:
[items, condition] call BIS_fnc_conditionalSelect
Parameters:
items: Array - array to check
condition: Code - selection code
Return Value:
Array

Examples

Example 1:
[[10, 0, 8, 2, 6, 4], { _x > 5 }] call BIS_fnc_conditionalSelect; // will return [10,8,6]
Example 2:
[[10, true, 8, player], { typeName _x == "STRING" }] call BIS_fnc_conditionalSelect; // will return []

Additional Information

See also:
select 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