shuffle

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

    shuffle — Перемешивает массив

    Описание

    shuffle(array&$array): true

    Функция перемешивает элементы массива в случайном порядке.

    Предостережение

    Функция не создаёт криптографически безопасные значения и не должна использоваться в криптографических целях или целях, которые требуют, чтобы возвращаемые значения были недоступны для разгадывания.

    Если нужна криптографически безопасная случайная последовательность, можно использовать класс Random\Randomizer с движком Random\Engine\Secure. Для простых сценариев существуют функции random_int() и random_bytes() с удобным API криптографически безопасного генератора псевдослучайных чисел (CSPRNG), поддерживаемого операционной системой.

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

    array

    Массив.

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

    Функция всегда возвращает true.

    Список изменений

    ВерсияОписание
    7.1.0 Внутренний алгоритм получения случайных чисел изменён с функции rand библиотеки libc на генератор на базе » Вихря Мерсена.

    Примеры

    Пример #1 Пример использования shuffle()

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

    Примечания

    Замечание: Эта функция присваивает новые ключи элементам array. Она удалит все существующие ключи, а не просто переупорядочит их.

    Замечание:

    Функция сбрасывает внутренний указатель массива на первый элемент.

    Смотрите также

    To Top