{"name":"BIS_fnc_arrayShift","title":"BIS fnc arrayShift","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_arrayShift","revid":329366,"updated":"2022-07-27T12:29:43Z","groups":["Arrays"],"status":"ok","games":{"arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma2 1.00","arma3_since":"0.50","description":"This function removes the first (leftmost) element of an array and returns it.\nThe array is passed by reference so changes inside the function will be reflected outside of it.\n\n> [!NOTE]\n> **Arma 3:** In Arma 3, use `array deleteAt 0`.","syntaxes":[{"syntax":"[array] call BIS_fnc_arrayShift","params":[{"name":"array","type":"Array","description":"**NOTE:** given array must be within an array (e.g `[[10, 20, 30]] call BIS_fnc_arrayShift`)","type_expr":"Array"}],"returns":{"type":"Anything","type_expr":"Anything","description":"the removed element"}}],"examples":[{"text":"```sqf\nprivate _myArray = [\"2\", \"report\", \"status\"];\n_removedElement = [_myArray] call BIS_fnc_arrayShift;    // array is -within an array-\n_removedElement == \"2\";                                    // true\n_myArray isEqualTo [\"report\", \"status\"];                // true\n```","code":["private _myArray = [\"2\", \"report\", \"status\"];\n_removedElement = [_myArray] call BIS_fnc_arrayShift;\t// array is -within an array-\n_removedElement == \"2\";\t\t\t\t\t\t\t\t\t// true\n_myArray isEqualTo [\"report\", \"status\"];\t\t\t\t// true"]}],"see_also":["deleteAt","pushBack"]}