BIS fnc removeFromPairs: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Some wiki formatting)
 
(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= Removes an item from pair array modifying original array. This can be overriden by setting '_copyArray' param to true.
|descr= Removes an item from pair array, modifying or not the original array.


|s1= [array, key, copyArray] call [[BIS_fnc_removeFromPairs]]
|s1= [array, key, copyArray] call [[BIS_fnc_removeFromPairs]]


|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= copyArray: [[Boolean]] - (Optional, default [[false]]) [[True]] to copy the array and return it, [[false]] to modify the original array
|p3= copyArray: [[Boolean]] - (Optional, default [[false]]) [[true]] to copy the array and return it, [[false]] to modify the original array


|r1= [[Array]] - Resulting modified array or a copy
|r1= [[Array]] - resulting modified array or a copy


|x1= <code>[[["apple",3],["pear",2]],"pear"] [[call]] [[BIS_fnc_removeFromPairs]]; {{cc|Returns <nowiki>[[</nowiki>"apple",3<nowiki>]]</nowiki>}}</code>
|x1= <sqf>private _pairs = [[["apple", 3], ["pear", 2]], "pear"];
 
[_pairs, "pear", true] call BIS_fnc_removeFromPairs; // returns [<nowiki/>["apple", 3]] - _pairs is not modified
|exec= call
[_pairs, "pear"] call BIS_fnc_removeFromPairs; // returns [<nowiki/>["apple", 3]] - _pairs is now [<nowiki/>["apple", 3]]
</sqf>


|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_getFromPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_setToPairs]]
|seealso= [[find]] [[findIf]] [[BIS_fnc_findInPairs]] [[BIS_fnc_getFromPairs]] [[BIS_fnc_addToPairs]] [[BIS_fnc_setToPairs]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Function Group: Arrays|{{uc:removeFromPairs}}]]
[[Category:Functions|{{uc:removeFromPairs}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:removeFromPairs}}]]

Latest revision as of 20:25, 7 April 2024

Arma 3 logo black.png1.00
Hover & click on the images for description

Description

Description:
Removes an item from pair array, modifying or not the original array.
Execution:
call
Groups:
Arrays

Syntax

Syntax:
[array, key, copyArray] call BIS_fnc_removeFromPairs
Parameters:
array: Array - array to search through
key: String - key to search for
copyArray: Boolean - (Optional, default false) true to copy the array and return it, false to modify the original array
Return Value:
Array - resulting modified array or a copy

Examples

Example 1:
private _pairs = [[["apple", 3], ["pear", 2]], "pear"]; [_pairs, "pear", true] call BIS_fnc_removeFromPairs; // returns [["apple", 3]] - _pairs is not modified [_pairs, "pear"] call BIS_fnc_removeFromPairs; // returns [["apple", 3]] - _pairs is now [["apple", 3]]

Additional Information

See also:
find findIf BIS_fnc_findInPairs BIS_fnc_getFromPairs BIS_fnc_addToPairs 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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_removeFromPairs&oldid=363590"