array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'random-engine-mt19937.construct.php', 1 => 'Random\\Engine\\Mt19937::__construct', 2 => 'Создаёт новый объект движка Mt19937', ), 'up' => array ( 0 => 'class.random-engine-mt19937.php', 1 => 'Random\\Engine\\Mt19937', ), 'prev' => array ( 0 => 'class.random-engine-mt19937.php', 1 => 'Random\\Engine\\Mt19937', ), 'next' => array ( 0 => 'random-engine-mt19937.debuginfo.php', 1 => 'Random\\Engine\\Mt19937::__debugInfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/random/random/engine/mt19937/construct.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Random\Engine\Mt19937::__construct

(PHP 8 >= 8.2.0)

Random\Engine\Mt19937::__construct — Создаёт новый объект движка Mt19937

Описание

public Random\Engine\Mt19937::__construct(?int $seed = null, int $mode = MT_RAND_MT19937)

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

Количество возможных случайных последовательностей ограничено только 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 генерирует криптографически безопасную случайную последовательность.

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

seed

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

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

mode

Константа из следующего списка, которая указывает реализацию алгоритма.

  • MT_RAND_MT19937: Корректная реализация движка Mt19937.
  • MT_RAND_PHP: Некорректная реализация для обратной совместимости с функцией mt_srand() до версии PHP 7.1.0.

Внимание

Начиная с PHP 8.3.0 функциональность УСТАРЕЛА. Полагаться на функциональность настоятельно не рекомендуют.

Примеры

Пример #1 Пример работы метода Random\Engine\Mt19937::__construct()

<?php

// Используется случайное 32-битное начальное число
$e = new \Random\Engine\Mt19937();

$r = new \Random\Randomizer($e);

?>