Генерирует случайное число

# gmp_random_bits

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

gmp_random_bits — Генерирует случайное число

### Описание

function gmp_random_bits(int `$bits`): GMP

Генерирует случайное число. Число будет находиться в диапазоне между `0` и `2$bits - 1`.

Значение параметра `bits` должно быть больше 0, а максимальное значение ограничено размером доступной памяти.

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

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

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

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

`bits`

  Количество битов для генерации.

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

Случайное GMP-число.

### Ошибки

Если значение параметра `bits` будет меньше `1`, будет выброшено исключение ValueError.

### Примеры

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

    <?php

    $rand1 = gmp_random_bits(3); // случайное число от 0 до 7
    $rand2 = gmp_random_bits(5); // случайное число от 0 до 31

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

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

    3
    15

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