PHPCon Poland 2024

Random\Engine::generate

(PHP 8 >= 8.2.0)

Random\Engine::generateGera aleatoriedade

Descrição

public Random\Engine::generate(): string

Retorna aleatoriedade e avança o estado do algoritmo em uma etapa.

A aleatoriedade é representada por uma string binária contendo bytes aleatórios. Esta representação permite interpretar de forma inequívoca os bits aleatórios gerados pelo algoritmo, por exemplo, para acomodar diferentes tamanhos de saída usados por diferentes algoritmos.

Algoritmos que operam nativamente em valores inteiros devem retornar o inteiro na ordem de bytes Little-Endian, por exemplo, aproveitando a função pack() com o código de formato P. A interface de alto nível fornecida pelo Random\Randomizer interpretará os bytes aleatórios retornados como inteiros Little-Endian sem sinal se uma representação numérica for necessária.

É altamente recomendável que cada bit da string retornada seja selecionado de maneira uniforme e independente, pois alguns aplicativos exigem aleatoriedade com base no nível de bit para funcionar corretamente. Por exemplo, geradores congruentes lineares geralmente geram aleatoriedade de qualidade inferior para os bits menos significativos do valor inteiro de retorno e, portanto, não seriam apropriados para aplicações que exigem aleatoriedade em nível de bit.

Parâmetros

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

Valor Retornado

Uma string não vazia contendo bytes aleatórios.

Nota: A Random\Randomizer funciona internamente com inteiros sem sinal de 64 bits. Se a string retornada contiver mais de 64 bits (8 bytes) de aleatoriedade, os bytes excedentes serão ignorados. Outros aplicativos podem processar mais de 64 bits ao mesmo tempo.

Erros/Exceções

Exemplos

Exemplo #1 Exemplo de Random\Engine::generate()

<?php
/**
* Implementa um Gerador Linear Congruente com módulo 65536,
* multiplicador 61 e incremento 17 retornando um número inteiro de 8 bits.
*
* Nota: Este motor é adequado apenas para fins de demonstração.
* Geradores Congruentes Lineares geralmente geram aleatoriedade
* de baixa qualidade e esta implementação específica tem
* um período muito curto de 16 bits que é inadequado para
* quase todo caso de uso do mundo real.
*/
final class LinearCongruentialGenerator implements \Random\Engine
{
private
int $state;

public function
__construct(?int $seed = null)
{
if (
$seed === null) {
$seed = random_int(0, 0xffff);
}

$this->state = $seed & 0xffff;
}

public function
generate(): string
{
$this->state = (61 * $this->state + 17) & 0xffff;

return
pack('C', $this->state >> 8);
}
}

$r = new \Random\Randomizer(
new
LinearCongruentialGenerator(seed: 1)
);

echo
"Número da Sorte: ", $r->getInt(0, 99), "\n";
?>

O exemplo acima produzirá:

Número da Sorte: 4
add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top