Random\Randomizer::nextInt

(PHP 8 >= 8.2.0)

Random\Randomizer::nextInt — Obtém um inteiro positivo

Descrição

public Random\Randomizer::nextInt(): int

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Um inteiro positivo entre 0 e um valor máximo, dependendo do número de bytes retornado de Random\Engine::generate(). O máximo exato pode ser calculado como 2^{$engine_bytes * 8 - 1} - 1.

Erros/Exceções

Para evitar inconsistências, o PHP de 32 bits lançará Random\RandomException se o tamanho da saída de Random\Engine::generate() exceder 32 bits, pois o inteiro selecionado não pode ser retornado sem perdas. Isso afeta os mecanismos nativos de 64 bits Random\Engine\PcgOneseq128XslRr64 e Random\Engine\Xoshiro256StarStar. Qualquer mecanismo de ambiente de usuário que retorne mais de 4 bytes de aleatoriedade também é afetado.
Qualquer erro ou exceção Throwable lançados pelo método Random\Engine::generate() do mecanismo Random\Randomizer::$engine subjacente.

Exemplos

Exemplo #1 Exemplo de Random\Randomizer::nextInt()

<?php
$r = new \Random\Randomizer();

// "Próximo" inteiro aleatório:
echo $r->nextInt(), "\n";
?>

O exemplo acima produzirá algo semelhante a:

8041689838856078718