BIS fnc findNestedElement: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{Feature[ _]arma3" to "{{Feature|arma3")
m (Text replacement - "_{10,} " to "")
Line 1: Line 1:
{{Function|Comments=
{{Function|Comments=
____________________________________________________________________________________________


| arma2 |Game name=
| arma2 |Game name=
Line 7: Line 6:


|gr1= Arrays |GROUP1=
|gr1= Arrays |GROUP1=
____________________________________________________________________________________________


| Function to find item in nested arrays and return a path to the first match.
| 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!}}|Description=
{{Feature|arma3|In some cases [[findIf]] might be the better way of finding a nested element. It is a lot faster!}}|Description=
____________________________________________________________________________________________


| [array, query] call [[BIS_fnc_findNestedElement]] |Syntax=
| [array, query] call [[BIS_fnc_findNestedElement]] |Syntax=
Line 20: Line 17:


| [[Array]] of [[Number|Numbers]] - path to the first occurence of ''query'' |Return value=
| [[Array]] of [[Number|Numbers]] - path to the first occurence of ''query'' |Return value=
____________________________________________________________________________________________


|x1= <code>_array = [[1, 2], [3, 4]];
|x1= <code>_array = [[1, 2], [3, 4]];
_path = [_array, 3] [[call]] [[BIS_fnc_findNestedElement]]; {{codecomment|// expected result: [1, 0]}}
_path = [_array, 3] [[call]] [[BIS_fnc_findNestedElement]]; {{codecomment|// expected result: [1, 0]}}
{{codecomment|// ((_array [[select]] '''1''') [[select]] '''0''') {{=}}{{=}} 3}}</code> |Example 1=
{{codecomment|// ((_array [[select]] '''1''') [[select]] '''0''') {{=}}{{=}} 3}}</code> |Example 1=
____________________________________________________________________________________________


| [[BIS_fnc_findAllNestedElements]], [[BIS_fnc_removeNestedElement]], [[BIS_fnc_returnNestedElement]], [[BIS_fnc_setNestedElement]] |See also=
| [[BIS_fnc_findAllNestedElements]], [[BIS_fnc_removeNestedElement]], [[BIS_fnc_returnNestedElement]], [[BIS_fnc_setNestedElement]] |See also=

Revision as of 23:07, 16 January 2021

Hover & click on the images for description

Description

Description:
Function to find item in nested arrays and return a path to the first match.
Arma 3
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

Notes

Bottom Section