shuffle

(PHP 4, PHP 5, PHP 7, PHP 8)

shuffle打乱数组

说明

shuffle(array &$array): bool

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

注意:

如果两个成员完全相同,那么它们在排序数组中的相对顺序是未定义的。

参数

array

待操作的数组。

返回值

成功时返回 true, 或者在失败时返回 false

更新日志

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

范例

示例 #1 shuffle() 例子

<?php
$numbers 
range(120);
shuffle($numbers);
foreach (
$numbers as $number) {
    echo 
"$number ";
}
?>

注释

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

参见