BIS fnc getFromPairs: Difference between revisions

Revision as of 22:23, 12 July 2022

Hover & click on the images for description

Description:: Searches the associative array for the 1st occurance of the key string and returns the value associated with it. Search is not case sensitiv.
Execution:: call
Groups:: Arrays

Syntax:: [array, key, defaultValue] call BIS_fnc_getFromPairs
Parameters:: array: Array - Array to search through
: key: String - Key to search for
: defaultValue: Anything - (Optional, default nil) Default return value if no match was found
Return Value:: Anything - Value associated with the key.

Example 1:: [[["apple",3],["pear","test"]],"pear"] call BIS_fnc_getFromPairs; // Returns "test"
Example 2:: [[["apple",3],["pear",6]],"pear"] call BIS_fnc_getFromPairs; // Returns "6"

See also:: find findIf BIS_fnc_findInPairs BIS_fnc_addToPairs BIS_fnc_removeFromPairs BIS_fnc_setToPairs

: 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

: Posted on October 2, 2014 - 01:17 (UTC)
Benargee: BIS_fnc_findInPairs renamed to BIS_fnc_getFromPairs and now supports all variable types Source

@@ Line 19: / Line 19: @@
 |r1= [[Anything]] - Value associated with the key.
-|x1= <code>[[["apple",3],["pear","test"]],"pear"] call BIS_fnc_getFromPairs; {{cc|Returns "test"}}</code>
+|x1= <code>[[["apple",3],["pear","test"]],"pear"] call BIS_fnc_getFromPairs; // Returns "test"</code>
-|x2= <code>[[["apple",3],["pear",6]],"pear"] call BIS_fnc_getFromPairs; {{cc|Returns "6"}}</code>
+|x2= <code>[[["apple",3],["pear",6]],"pear"] call BIS_fnc_getFromPairs; // Returns "6"</code>
 |seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_removeFromPairs]] [[BIS_fnc_setToPairs]]