Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — Получает перестановку массива

Описание

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

Возвращает равномерно выбранную перестановку входного массива array.

Каждая возможная перестановка входного массива array с равной вероятностью будет возвращена.

Список параметров

array

Массив (array), значения которого перемешиваются.

Входной массив (array) не будет изменён.

Возвращаемые значения

Перестановка значений параметра array.

Ключи входного массива array не сохраняются; возвращаемый массив (array) будет списком (array_is_list()).

Ошибки

Любые Throwable, выбрасываемые методом Random\Engine::generate() базового Random\Randomizer::$engine.

Примеры

Пример #1 Пример использования Random\Randomizer::shuffleArray()

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

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

/ Перемешивание массива:
echo "Салат: ", implode(', ', $r->shuffleArray($fruits)), "\n";

/ Перемешивание массива ещё раз:
echo "Другой салат: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>

Вывод приведённого примера будет похож на:

Салат: 🍎, 🥝, 🍇, 🍌, 🍑
Другой салат: 🍑, 🍇, 🥝, 🍎, 🍌

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы