array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.gmp-random-bits.php', 1 => 'gmp_random_bits', 2 => 'Numero aleatório', ), 'up' => array ( 0 => 'ref.gmp.php', 1 => 'Funções GMP', ), 'prev' => array ( 0 => 'function.gmp-random.php', 1 => 'gmp_random', ), 'next' => array ( 0 => 'function.gmp-random-range.php', 1 => 'gmp_random_range', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/gmp/functions/gmp-random-bits.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

gmp_random_bits

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

gmp_random_bits — Numero aleatório

Descrição

gmp_random_bits(int $bits): GMP

Gera um número aleatório. O número estará entre 0 e 2$bits - 1.

bits precisa ser maior que 0, e o valor máximo é restrito pela memória disponível.

Cuidado

Esta função não gera valores criptograficamente seguros e não deve ser usada para propósitos criptográficos ou fins que exijam que os valores retornados sejam impossíveis de adivinhar.

Se aleatoriedade criptograficamente segura for necessária, a classe Random\Randomizer pode ser usada com o mecanismo Random\Engine\Secure. Para casos de uso simples, as funções random_int() e random_bytes() fornecem uma API conveniente e segura que é garantida pelo CSPRNG do sistema operacional.

Parâmetros

bits

O número de bits a gerar.

Valor Retornado

Um número GMP aleatório.

Erros/Exceções

Se bits for menor que 1, uma exceção ValueError será lançada.

Exemplos

Exemplo #1 Exemplo de gmp_random_bits()

<?php
$rand1 = gmp_random_bits(3); // número aleatório de 0 a 7
$rand2 = gmp_random_bits(5); // número aleatório de 0 a 31

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

O exemplo acima produzirá:

3
15