PHP Velho Oeste 2024

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top