BIS fnc conditionalSelect: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\|+$" to "") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
| 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| | {{Feature|arma3|Use {{ic|''items'' [[select]] ''condition''}} syntax instead (since {{arma3}} v1.55).}} | ||
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]]". | ||
The original array is '''not''' modified. | The original array is '''not''' modified. | ||
|s1=[items, condition] call [[BIS_fnc_conditionalSelect]] | |s1= [items, condition] call [[BIS_fnc_conditionalSelect]] | ||
|p1= items: [[Array]] - array to check | |p1= items: [[Array]] - array to check | ||
| Line 29: | Line 29: | ||
|r1= [[Array]] | |r1= [[Array]] | ||
|x1= <code><nowiki | |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> | ||
|x2= <code><nowiki | |x2= <code>[<nowiki/>[10, [[true]], 8, [[player]]], { [[typeName]] _x == "STRING" }] [[call]] [[BIS_fnc_conditionalSelect]]; {{cc|will return []}}</code> | ||
|seealso= [[select]], [[count]] | |seealso= [[select]], [[count]] | ||
}} | }} | ||
Revision as of 14:52, 28 November 2021
Description
- Description:
- This returns a sub-array of elements that satisfy a specific condition in the order they have been passed.
Useitems select conditionsyntax instead (since Arma 3 v1.55).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
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