Random\Engine\Xoshiro256StarStar::jump

(PHP 8 >= 8.2.0)

Random\Engine\Xoshiro256StarStar::jump — Avanza el motor de manera eficiente 2^128 pasos

Descripción

public function Random\Engine\Xoshiro256StarStar::jump(): void

Avanza el estado del algoritmo 2128 pasos, como si Random\Engine\Xoshiro256StarStar::generate() fuera llamado 2128 veces.

El objetivo de un salto es facilitar la creación de un nuevo motor Random\Engine\Xoshiro256StarStar a partir de un motor Random\Engine\Xoshiro256StarStar existente inicializado. El motor inicializado actúa como un modelo, que puede ser clonado y saltado varias veces para crear 2128 secuencias no superpuestas con 2128 valores cada una.

Parámetros

Esta función no contiene ningún parámetro.

Valores devueltos

No se retorna ningún valor.

Ejemplos

Ejemplo #1 Ejemplo de Random\Engine\Xoshiro256StarStar::jump()

<?php
use Random\Engine\Xoshiro256StarStar;
use Random\Randomizer;

$blueprintRng = new Xoshiro256StarStar(0);

$fibers = [];
for ($i = 0; $i < 8; $i++) {
    $fiberRng = clone $blueprintRng;
    $blueprintRng->jump();

    $fiber = new Fiber(static function () use ($fiberRng, $i): void {
        $randomizer = new Randomizer($fiberRng);

        while (true) {
            Fiber::suspend();

            echo "{$i}: ", $randomizer->getInt(0, 100), "\n";
        }
    });
    $fiber->start();

    $fibers[] = $fiber;
}

// Aunque las fibras se ejecuten en un orden aleatorio, imprimirán el mismo valor
// cada vez, ya que cada una tiene su propia instancia única del RNG.
$randomizer = new Randomizer();

$fibers = $randomizer->shuffleArray($fibers);
foreach ($fibers as $fiber) {
    $fiber->resume();
}

$fibers = $randomizer->shuffleArray($fibers);
foreach ($fibers as $fiber) {
    $fiber->resume();
}
?>

Resultado del ejemplo anterior es similar a:

4: 89
3: 10
2: 63
1: 75
6: 41
5: 56
0: 16
7: 60
7: 34
6: 58
1: 74
4: 63
3: 3
5: 42
2: 45
0: 86

Ver también