(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: 🍑, 🍇, 🥝, 🍎, 🍌