BIS fnc setToPairs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>([^<]*)\[\[([a-zA-Z][a-zA-Z0-9_]+)\]\]([^<]*) *<\/code>" to "<code>$1$2$3</code>")
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *R([a-z ])" to "$1 - r$2")
 
(5 intermediate revisions by the same user not shown)
Line 10: Line 10:
|s1= [array, key, newValue] call [[BIS_fnc_setToPairs]]
|s1= [array, key, newValue] call [[BIS_fnc_setToPairs]]


|p1= array: [[Array]] - Array to search through
|p1= array: [[Array]] - array to search through


|p2= key: [[String]] - Key to search for
|p2= key: [[String]] - key to search for


|p3= newValue: [[Anything]] - (Optional, default 1) New value set if match was found
|p3= newValue: [[Anything]] - (Optional, default 1) new value set if match was found


|r1= [[Array]] - Resulting modified array
|r1= [[Array]] - resulting modified array


|x1= <code>[[["apple",3],["pear",2]],"pear",10] call BIS_fnc_setToPairs; {{cc|Returns [["apple",3],["pear",10]]}}</code>
|x1= <sqf>[[["apple",3],["pear",2]],"pear",10] call BIS_fnc_setToPairs; // Returns [["apple",3],["pear",10]]</sqf>


|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_getFromPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_removeFromPairs]]
|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_getFromPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_removeFromPairs]]
}}
}}

Latest revision as of 16:47, 8 November 2023

Hover & click on the images for description

Description

Description:
Works similar to the BIS_fnc_addToPairs but it doesn't try to add values. It just overwrites the volue if the key already exists.
Execution:
call
Groups:
Arrays

Syntax

Syntax:
[array, key, newValue] call BIS_fnc_setToPairs
Parameters:
array: Array - array to search through
key: String - key to search for
newValue: Anything - (Optional, default 1) new value set if match was found
Return Value:
Array - resulting modified array

Examples

Example 1:
[[["apple",3],["pear",2]],"pear",10] call BIS_fnc_setToPairs; // Returns [["apple",3],["pear",10]]

Additional Information

See also:
find findIf BIS_fnc_findInPairs BIS_fnc_getFromPairs BIS_fnc_addToPairs BIS_fnc_removeFromPairs

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