Получает перестановку массива

# Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

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

### Описание

public function 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";
    ?>

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open