shuffle

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

shuffle — 打亂數(shù)組

說明

shuffle(array &$array): bool

本函數(shù)打亂（隨機排列單元的順序）一個數(shù)組。 它使用的是偽隨機數(shù)產生器，并不適合密碼學的場合。

參數(shù)

array

待操作的數(shù)組。

返回值

成功時返回 true， 或者在失敗時返回 false。

更新日志

版本 說明
7.1.0 內置的隨機數(shù)產生算法從 libc rand 函數(shù)改成? 梅森旋轉偽隨機數(shù)生成算法。

范例

示例 #1 shuffle() 例子

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

注釋

注意: 此函數(shù)為 array 中的元素賦與新的鍵名。這將刪除原有的鍵名，而不是僅僅將鍵名重新排序。

注意:

重置數(shù)組中的內部指針，指向第一個元素。

參見