[函数]Random\Randomizer::shuffleArray()函数—用法及示例

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — 获取数组的排列

说明

public Random\Randomizer::shuffleArray(array $array): array

返回输入数组的一致选择排列。

输入数组的每一种可能的排列被返回的可能性是相等的。

参数
array
其值被洗牌的数组。

输入数组将不会被修改。

返回值
数组中值的排列。

输入数组的数组键将不被保留;返回的数组将是一个列表(array_is_list())。

错误／异常
底层 Random\Randomizer::$engine 的 Random\Engine::generate() 方法抛出的任何 Throwable。

示例 ¶
示例 #1 Random\Randomizer::shuffleArray() example

<?php
$r = new \Random\Randomizer();

$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];

// Shuffle array:
echo "Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";

// Shuffle again:
echo "Another Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>

以上示例的输出类似于：

Salad: 🍎, 🥝, 🍇, 🍌, 🍑
Another Salad: 🍑, 🍇, 🥝, 🍎, 🍌