# shuffle

(PHP 4, PHP 5, PHP 7)

shuffle — 打乱数组

### 说明

shuffle ( array `&$array` ) : bool

本函数打乱（随机排列单元的顺序）一个数组。 它使用的是伪随机数产生器，并不适合密码学的场合。

> Note:

> If two members compare as equal, their relative order in the sorted array is undefined.

### 参数

`array`

  待操作的数组。

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
7.1.0 | 内置的随机数产生算法从 libc rand 函数改成 » 梅森旋转伪随机数生成算法。

### 范例

Example #1 shuffle() 例子

    <?php
    $numbers = range(1, 20);
    shuffle($numbers);
    foreach ($numbers as $number) {
        echo "$number ";
    }
    ?>

### 注释

> Note: 此函数为 `array` 中的元素赋与新的键名。这将删除原有的键名，而不是仅仅将键名重新排序。

### 参见

- array_rand() - 从数组中随机取出一个或多个单元
- 数组排序函数对比