Obtém um inteiro uniformemente selecionado

# gmp_random_range

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

gmp_random_range — Obtém um inteiro uniformemente selecionado

### Descrição

function 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`.

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

`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

Exemplo #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

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