BIS fnc findNestedElement: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\{\{ *codecomment *\| *\/\/ *([^ ]+) *\}\} " to "{{cc|$1}}") |
Lou Montana (talk | contribs) m (revert + fix) |
||
| Line 1: | Line 1: | ||
{{RV|type=function | {{RV|type=function | ||
| arma2 | |game1= arma2 | ||
|1.00 | |version1= 1.00 | ||
|gr1= Arrays | |gr1= Arrays | ||
| Function to find item in nested arrays and return a path to the first match. | |descr= Function to find item in nested arrays and return a path to the first match. | ||
{{Feature|arma3|In some cases [[findIf]] might be the better way of finding a nested element. It is a lot faster!}} | {{Feature|arma3|In some cases [[findIf]] might be the better way of finding a nested element. It is a lot faster!}} | ||
| [array, query] call [[BIS_fnc_findNestedElement]] | |s1= [array, query] call [[BIS_fnc_findNestedElement]] | ||
|p1= array: [[Array]] - array to explore | |p1= array: [[Array]] - array to explore | ||
| Line 16: | Line 16: | ||
|p2= query: [[Anything]] - wanted item | |p2= query: [[Anything]] - wanted item | ||
| [[Array]] of [[Number|Numbers]] - path to the first occurence of ''query'' | |r1= [[Array]] of [[Number|Numbers]] - path to the first occurence of ''query'' | ||
|x1= <code>_array = [[1, 2], [3, 4]]; | |x1= <code>_array = [[1, 2], [3, 4]]; | ||
_path = [_array, 3] [[call]] [[BIS_fnc_findNestedElement]]; {{cc| expected result: [1, 0]}}{{ | _path = [_array, 3] [[call]] [[BIS_fnc_findNestedElement]]; {{cc|expected result: [1, 0]}} | ||
{{cc|((_array [[select]] '''1''') [[select]] '''0''') {{=}}{{=}} 3}}</code> | |||
| [[BIS_fnc_findAllNestedElements]], [[BIS_fnc_removeNestedElement]], [[BIS_fnc_returnNestedElement]], [[BIS_fnc_setNestedElement]] | |seealso= [[BIS_fnc_findAllNestedElements]], [[BIS_fnc_removeNestedElement]], [[BIS_fnc_returnNestedElement]], [[BIS_fnc_setNestedElement]] | ||
}} | }} | ||
[[Category:{{Name|arma2oa}}: Functions|{{uc:findNestedElement}}]] | [[Category:{{Name|arma2oa}}: Functions|{{uc:findNestedElement}}]] | ||
[[Category:{{Name|tkoh}}: Functions|{{uc:findNestedElement}}]] | [[Category:{{Name|tkoh}}: Functions|{{uc:findNestedElement}}]] | ||
[[Category:{{Name|arma3}}: Functions|{{uc:findNestedElement}}]] | [[Category:{{Name|arma3}}: Functions|{{uc:findNestedElement}}]] | ||
Revision as of 22:38, 29 January 2021
Description
- Description:
- Function to find item in nested arrays and return a path to the first match.
In some cases findIf might be the better way of finding a nested element. It is a lot faster! - Execution:
- call
- Groups:
- Arrays
Syntax
- Syntax:
- [array, query] call BIS_fnc_findNestedElement
- Parameters:
- array: Array - array to explore
- query: Anything - wanted item
- Return Value:
- Array of Numbers - path to the first occurence of query
Examples
- Example 1:
_array = [[1, 2], [3, 4]]; _path = [_array, 3] call BIS_fnc_findNestedElement; // expected result: [1, 0] // ((_array select 1) select 0) == 3
Additional Information
- See also:
- BIS_fnc_findAllNestedElementsBIS_fnc_removeNestedElementBIS_fnc_returnNestedElementBIS_fnc_setNestedElement
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