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

# gmp_random_range

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

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

### Описание

function 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open