---
name: "BIS_fnc_arrayUnShift"
type: function
status: ok
groups: ["Arrays"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_arrayUnShift
revid: 327477
updated: 2022-07-12T22:16:10Z
---

# BIS_fnc_arrayUnShift

*Function · Arrays · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

This function adds an element to the beginning of an array and returns the array.
The array is passed by reference so changes inside the function will be reflected outside of it.

## Syntax

```sqf
[array, value] call BIS_fnc_arrayUnShift
```

**Parameters:**

- `array`: [Array](../topics/Array.md)
- `value`: [Anything](../topics/Anything.md)

**Returns:** [Array](../topics/Array.md) - *array* reference

## Examples

### Example 1

```sqf
private _array = [2,3,4];
[_array, 1] call BIS_fnc_arrayUnShift;                        // _array is now [1,2,3,4]
```

### Example 2

```sqf
private _array = [[2,3,4], 1] call BIS_fnc_arrayUnShift;    // _array is now [1,2,3,4]
```

## See also

[BIS_fnc_arrayShift](../functions/BIS_fnc_arrayShift.md) · [pushBack](../commands/pushBack.md) · [select](../commands/select.md) · [set](../commands/set.md)

<sub>Source: [BI Community Wiki — BIS fnc arrayUnShift](https://community.bistudio.com/wiki/BIS_fnc_arrayUnShift) (revision 327477).</sub>