{"name":"BIS_fnc_removeFromPairs","title":"BIS fnc removeFromPairs","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_removeFromPairs","revid":363590,"updated":"2024-04-07T18:25:56Z","groups":["Arrays"],"status":"ok","games":{"arma3":"1.00"},"since":"arma3 1.00","arma3_since":"1.00","description":"Removes an item from pair array, modifying or not the original array.","syntaxes":[{"syntax":"[array, key, copyArray] call BIS_fnc_removeFromPairs","params":[{"name":"array","type":"Array","description":"array to search through","type_expr":"Array"},{"name":"key","type":"String","description":"key to search for","type_expr":"String"},{"name":"copyArray","type":"Boolean","optional":true,"default":"false","description":"true to copy the array and return it, false to modify the original array","type_expr":"Boolean","text":"copyArray: Boolean - (Optional, default false) true to copy the array and return it, false to modify the original array"}],"returns":{"type":"Array","type_expr":"Array","description":"resulting modified array or a copy"}}],"examples":[{"text":"```sqf\nprivate _pairs = [[[\"apple\", 3], [\"pear\", 2]], \"pear\"];\n[_pairs, \"pear\", true]    call BIS_fnc_removeFromPairs; // returns [[\"apple\", 3]] - _pairs is not modified\n[_pairs, \"pear\"]        call BIS_fnc_removeFromPairs; // returns [[\"apple\", 3]] - _pairs is now [[\"apple\", 3]]\n```","code":["private _pairs = [[[\"apple\", 3], [\"pear\", 2]], \"pear\"];\n[_pairs, \"pear\", true]\tcall BIS_fnc_removeFromPairs; // returns [[\"apple\", 3]] - _pairs is not modified\n[_pairs, \"pear\"]\t\tcall BIS_fnc_removeFromPairs; // returns [[\"apple\", 3]] - _pairs is now [[\"apple\", 3]]"]}],"see_also":["find","findIf","BIS_fnc_findInPairs","BIS_fnc_getFromPairs","BIS_fnc_addToPairs","BIS_fnc_setToPairs"]}