BIS fnc setToPairs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "(\|[pr][0-9]+ *= *[^- ]*) *- *R([a-z ])" to "$1 - r$2")
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function
{{RV|type=function


|game1= arma3
|game1= arma3
|version1= 1.00
|version1= 1.00


<!--|serverExec= server-->
|gr1= Arrays
 
<!--|arg= local-->
 
<!--|eff= local-->


|descr= 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.
|descr= 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.
Line 15: 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>
 
|exec= call


|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]]
}}
}}
[[Category:Function Group: Arrays|{{uc:setToPairs}}]]
[[Category:Functions|{{uc:setToPairs}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:setToPairs}}]]

Latest revision as of 15: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