Random\Randomizer::nextInt

(PHP 8 >= 8.2.0)

Random\Randomizer::nextInt — Получает целое положительное число

Описание

public Random\Randomizer::nextInt(): int

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

Сигнатура функции не содержит параметров.

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

Положительное целое число от 0 до максимального значения, которое зависит от количества байтов в результате вызова метода Random\Engine::generate(). Точное максимальное значение вычисляется по формуле: 2^{$engine_bytes * 8 - 1} - 1.

Ошибки

Во избежание несоответствий 32-битный PHP-интерпретатор выбрасывает исключение Random\RandomException, если размер возвращаемого методом Random\Engine::generate() значения превышает 32 бита, так как выбранное целое число невозможно вернуть без потерь. Это касается собственных 64-битных движков Random\Engine\PcgOneseq128XslRr64 и Random\Engine\Xoshiro256StarStar. Пользовательский механизм, который возвращает больше 4 байтов случайных данных, тоже подвержен влиянию.
Любые Throwable, выбрасываемые методом Random\Engine::generate() базового Random\Randomizer::$engine.

Примеры

Пример #1 Пример получения целого положительного числа методом Random\Randomizer::nextInt()

<?php

$r = new \Random\Randomizer();

// Случайное «следующее» целое число:
echo $r->nextInt(), "\n";

?>

Вывод приведённого примера будет похож на:

8041689838856078718