BIS fnc findNestedElement: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (1 revision)
(Page filling)
Line 1: Line 1:
 
{{Function|Comments=
{{Function|= Comments
____________________________________________________________________________________________
____________________________________________________________________________________________


| arma2 |= Game name
| arma2 |Game name=


|1.00|= Game version
|1.00|Game version=
____________________________________________________________________________________________
____________________________________________________________________________________________


| <pre>
| Function to find item in nested arrays and return a path to the first match. |Description=
/*
____________________________________________________________________________________________
File: fn_findNestedElement.sqf
 
Description:
Function to find item in nested arrays and return a path to the first match.
Example:
_array = [[1, 2], [3, 4]];
_path = [_array, 3] call BIS_fnc_findNestedElement; //Expected result: [1, 0]
 
Parameter(s):
_this select 0: Array
_this select 1: queried element (Any Value)
Returns:
Array path to the element
*/


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
| [array, query] call [[BIS_fnc_findNestedElement]] |Syntax=
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_findNestedElement]]; --> |= Syntax
|p1= array: [[Array]] - array to explore |Parameter 1=


|p1= |= Parameter 1
|p2= query: [[Anything]] - wanted item |Parameter 2=


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


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


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


Line 52: Line 35:


<h3 style="display:none">Bottom Section</h3>
<h3 style="display:none">Bottom Section</h3>
[[Category:Functions|{{uc:findNestedElement}}]]
[[Category:Function Group: Arrays|{{uc:findNestedElement}}]]
[[Category:Function Group: Arrays|{{uc:findNestedElement}}]]
[[Category:Functions|{{uc:findNestedElement}}]]
[[Category:{{Name|arma2}}: Functions|{{uc:findNestedElement}}]]
[[Category:{{Name|arma2}}: Functions|{{uc:findNestedElement}}]]
[[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:44, 5 June 2018

Hover & click on the images for description

Description

Description:
Function to find item in nested arrays and return a path to the first match.
Execution:
call
Groups:
Uncategorised

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