---
name: "BIS_fnc_arrayShuffle"
type: function
status: ok
groups: ["Arrays"]
arma3_since: "0.58"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_arrayShuffle
revid: 327476
updated: 2022-07-12T22:13:51Z
---

# BIS_fnc_arrayShuffle

*Function · Arrays · Arma 3 v0.58*

## Description

Return a new array with randomized order of elements from input array.

## Syntax

```sqf
array call BIS_fnc_arrayShuffle
```

**Parameters:**

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

**Returns:** [Array](../topics/Array.md) - a new array instance

## Examples

### Example 1

```sqf
[1,2,3] call BIS_fnc_arrayShuffle; // can return [1,2,3] (the original order), [3,1,2], [2,3,1], [1,3,2], [2,1,3] or [3,2,1]
```

## See also

[sort](../commands/sort.md) · [BIS_fnc_sortBy](../functions/BIS_fnc_sortBy.md) · [random](../commands/random.md)

<sub>Source: [BI Community Wiki — BIS fnc arrayShuffle](https://community.bistudio.com/wiki/BIS_fnc_arrayShuffle) (revision 327476).</sub>