gmp_random_range

(PHP 5 >= 5.6.3, PHP 7, PHP 8)

gmp_random_range — Получает равномерно выбранное целое число

Описание

gmp_random_range(GMP|int|string $min, GMP|int|string $max): GMP

Генерирует случайное число. Число будет находиться в диапазоне между значениями параметров min и max.

Оба числа в параметрах min и max могут быть отрицательными, но число min должно быть меньше числа max.

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

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

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

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

min: GMP-число — нижня граница случайного числа.
max: GMP-число — верхняя граница случайного числа.

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

Возвращает объект GMP, который содержит равномерно выбранное целое число из интервала [min, max]. Значения параметров min и max могут оказаться возвращаемыми значениями.

Ошибки

Если число в параметре max окажется меньше числа в параметре min, будет выброшено исключение ValueError.

Примеры

Пример #1 Пример использования функции gmp_random_range()

<?php
$rand1 = gmp_random_range(0, 100);    // случайное число между 0 и 100
$rand2 = gmp_random_range(-100, -10); // случайное число между -100 и -10

echo gmp_strval($rand1) . "\n";
echo gmp_strval($rand2) . "\n";
?>

Результат выполнения приведённого примера:

42
-67