array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.srand.php', 1 => 'srand', 2 => 'Устанавливает начальное значение для инициализации генератора псевдослучайных чисел', ), 'up' => array ( 0 => 'ref.random.php', 1 => 'Функции Random', ), 'prev' => array ( 0 => 'function.random-int.php', 1 => 'random_int', ), 'next' => array ( 0 => 'class.random-randomizer.php', 1 => 'Random\\Randomizer', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/random/functions/srand.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

srand

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

srand — Устанавливает начальное значение для инициализации генератора псевдослучайных чисел

Описание

srand(?int $seed = null, int $mode = MT_RAND_MT19937): void

Функция устанавливает значение параметра seed как начальное значение для инициализации генератора псевдослучайных чисел. При пропуске параметра seed генерируется псевдослучайное начальное значение.

Замечание: Устанавливать начальное значение для инициализации генератора псевдослучайных чисел функциями srand() или mt_srand() не требуется, поскольку значение инициализируется автоматически.

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

Количество возможных случайных последовательностей ограничено только 4 294 967 296 значениями, поскольку механизм Mt19937 «Вихрь Мерсе́на» принимает в качестве значения инициализации только одно 32-битное целое число, или 232, хотя переод Mt19937 равен 219937 - 1.

Дубликаты появятся гораздо раньше, если полагаться на неявное или явное случайное значение. Дублированные значения ожидаются с 50% вероятностью после менее чем 80 000 случайно сгенерированных значений в соответствии с проблемой дня рождения. Вероятность дублирования значений составляет 10% после случайной генерации примерно 30 000 значений.

Это делает алгоритм Mt19937 непригодным для генерации последовательностей, в которых дублирование возникает с ничтожной вероятностью. Если требуется воспроизводимое значение, то движки Random\Engine\Xoshiro256StarStar и Random\Engine\PcgOneseq128XslRr64 поддерживают гораздо большие значения, которые вряд ли столкнутся случайно. Если воспроизводимость не требуется, механизм Random\Engine\Secure генерирует криптографически безопасную случайную последовательность.

Замечание: Начиная с PHP 7.1.0 функция srand() стала синонимом функции mt_srand().

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

seed

Внутренний механизм функции интерпретирует значение параметра seed как 32-битное целое беззнаковое число, генерирует на основе числа линейную конгруэнтную последовательность чисел, а затем инициализирует генератор псевдослучайных чисел значениями последовательности.

При пропуске параметра seed или при установке значения null начальное значение инициализируется случайным беззнаковым 32-битным числом.

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

Функция не возвращает значения после выполнения.

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

Версия Описание
8.3.0 Параметр seed теперь принимает значение null.
7.1.0 Функция srand() стала синонимом функции mt_srand().

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