array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.lcg-value.php', 1 => 'lcg_value', 2 => 'Генерирует псевдослучайное число, применяя комбинированный линейный конгруэнтный метод', ), 'up' => array ( 0 => 'ref.random.php', 1 => 'Функции Random', ), 'prev' => array ( 0 => 'function.getrandmax.php', 1 => 'getrandmax', ), 'next' => array ( 0 => 'function.mt-getrandmax.php', 1 => 'mt_getrandmax', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/random/functions/lcg-value.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

lcg_value

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

lcg_value — Генерирует псевдослучайное число, применяя комбинированный линейный конгруэнтный метод

Внимание

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

Описание

#[\Deprecated]
lcg_value(): float

Функция lcg_value() возвращает псевдослучайное значение в диапазоне (0, 1). Функция комбинирует два конгруэнтных генератора с периодами 2^31 - 85 и 2^31 - 249. Период этой функции равен произведению обоих простых чисел.

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

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

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

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

Масштабирование возвращаемого значения для разных интервалов путём умножения или сложения (аффинного преобразования) может сместить результирующее значение, так как числа с плавающей точкой не одинаково плотные по всему ряду чисел. Поскольку не все значения можно точно представить числом с плавающей точкой, результат афинного преобразования также может вернуть значения, выходящие за пределы запрошенного интервала.

Чтобы сгенерировать случайное число с плавающей точкой в пределах произвольного интервала, вызывают метод Random\Randomizer::getFloat(). Для генерации случайного целого числа в пределах произвольного интервала вызывают метод Random\Randomizer::getInt().

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

Сигнатура функции не содержит параметров.

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

Функция возвращает псевдослучайное число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно.

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

Версия Описание
8.4.0 Функция устарела.

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