BIS fnc getFromPairs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[ *(https?\:\/\/[^\[ ]+\.arma3\.com[^\[]+) ([^ ]+) *\]" to "{{ExternalLink|link= $1|text= $2}}")
m (Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>")
Line 19: Line 19:
|r1= [[Anything]] - Value associated with the key.
|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]]; {{cc|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]]; {{cc|Returns "6"}}</code>


|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_removeFromPairs]] [[BIS_fnc_setToPairs]]
|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_removeFromPairs]] [[BIS_fnc_setToPairs]]

Revision as of 21:35, 12 July 2022

Hover & click on the images for description

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

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.

Examples

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"

Additional Information

See also:
find findIf BIS_fnc_findInPairs BIS_fnc_addToPairs BIS_fnc_removeFromPairs BIS_fnc_setToPairs

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
Posted on October 2, 2014 - 01:17 (UTC)
Benargee
BIS_fnc_findInPairs renamed to BIS_fnc_getFromPairs and now supports all variable types Source