gmp_random_seed

(PHP 7, PHP 8)

gmp_random_seed — Define a semente do gerador de números aleatórios

Descrição

gmp_random_seed(GMP|int|string $seed): void

Parâmetros

seed

A semente a ser definida para as funções gmp_random(), gmp_random_bits() e gmp_random_range().

Um objeto GMP, um int ou uma string numérica.

Valor Retornado

Nenhum valor é retornado.

Erros/Exceções

Lança uma exceção ValueError se o parâmetro seed for inválido.

Registro de Alterações

Versão Descrição
8.0.0 Se seed for inválido, gmp_random_seed() agora lança uma exceção ValueError. Anteriormente, emitia um E_WARNING e retornava false.

Exemplos

Example #1 Exemplo de gmp_random_seed()

<?php
// define a semente
gmp_random_seed(100);

var_dump(gmp_strval(gmp_random(1)));

// define a semente para algo diferente
gmp_random_seed(gmp_init(-100));

var_dump(gmp_strval(gmp_random_bits(10)));

// define a semente para algo inválido
var_dump(gmp_random_seed('not a number'));

O exemplo acima produzirá:

string(20) "15370156633245019617"
string(3) "683"

Warning: gmp_random_seed(): Unable to convert variable to GMP - string is not an integer in %s on line %d
bool(false)

Veja Também