gmp_random_range
(PHP 5 >= 5.6.3, PHP 7, PHP 8)
gmp_random_range — Получает равномерно выбранное целое число
Описание
Генерирует случайное число. Число будет находиться в диапазоне между
значениями параметров 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
add a note
