gmp_random_range

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

gmp_random_range — Obtém um inteiro uniformemente selecionado

Descrição

gmp_random_range(GMP|int|string $min, GMP|int|string $max): GMP

Gera um número aleatório. O número estará entre min e max.

min e max podem ambos ser negativos mas min precisa sempre ser menor que max.

Caution

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

min: Um número GMP representando o limite inferior para o número aleatório.
max: Um número GMP representando o limite superior para o número aleatório.

Valor Retornado

Retorna um objeto GMP que contém um inteiro uniformemente selecionado do intervalo fechado [min, max]. Tanto min quanto max são valores de retorno possíveis.

Erros/Exceções

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

Exemplos

Example #1 Exemplo de gmp_random_range()

<?php
$rand1 = gmp_random_range(0, 100);    // número aleatório entre 0 e 100
$rand2 = gmp_random_range(-100, -10); // número aleatório entre -100 e -10

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

O exemplo acima produzirá:

42
-67