Random\Randomizer::nextFloat

(PHP 8 >= 8.3.0)

Random\Randomizer::nextFloat — Devuelve un float seleccionado del intervalo abierto a la derecha [0.0, 1.0)

Descripción

public Random\Randomizer::nextFloat(): float

Devuelve un float seleccionado de manera uniforme y equidistribuida del intervalo abierto a la derecha de 0.0 hasta, pero sin incluir, 1.0.

La probabilidad de que un float devuelto esté en un subintervalo dado abierto a la derecha es proporcional al tamaño del subintervalo. Esto significa que la probabilidad de que un float sea menor que 0.5 es del 50 %, lo cual es igual a la probabilidad de que un float sea al menos 0.5. Del mismo modo, la probabilidad de que un float esté en el intervalo abierto a la derecha de 0.2 hasta, pero sin incluir, 0.25 es exactamente del 5 %.

Esta propiedad permite utilizar fácilmente Random\Randomizer::nextFloat() para generar un bool aleatorio con una probabilidad dada verificando si el float devuelto es menor que una probabilidad dada.

Nota:
El dominio de los floats devueltos por Random\Randomizer::nextFloat() es idéntico al de Randomizer::getFloat(0.0, 1.0, IntervalBoundary::ClosedOpen).

La implementación interna de Random\Randomizer::nextFloat() es más eficiente.

Precaución

Escalar el valor devuelto a un intervalo diferente utilizando la multiplicación o la adición (una transformación afín) podría resultar en un sesgo en el valor resultante, ya que los floats no son igualmente densos a lo largo de la línea de los números. Como no todos los valores pueden ser representados exactamente por un float, el resultado de la transformación afín podría también resultar en valores fuera del intervalo solicitado debido a redondeos implícitos. Una explicación detallada de los problemas con la transformación afín se proporciona en la documentación para Random\Randomizer::getFloat().

Utilizar Random\Randomizer::getFloat() para generar un float aleatorio en un intervalo arbitrario. Utilizar Random\Randomizer::getInt() para generar un integer aleatorio en un intervalo arbitrario.

Parámetros

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

Valores devueltos

Un float seleccionado de manera uniforme en el intervalo abierto a la derecha (IntervalBoundary::ClosedOpen) [0.0, 1.0). 0.0 es un valor de retorno posible, 1.0 no lo es.

Errores/Excepciones

Cualquier Throwable lanzado por el método Random\Engine::generate() del Random\Randomizer::$engine subyacente.

Ejemplos

Ejemplo #1 Ejemplo de Random\Randomizer::nextFloat()

<?php
$r = new \Random\Randomizer();

// El resultado del bool será verdadero con la probabilidad dada.
$chance = 0.5;

$bool = $r->nextFloat() < $chance;

echo ($bool ? "You won" : "You lost"), "\n";
?>

Resultado del ejemplo anterior es similar a:

You won

Ejemplo #2 Escalado incorrecto utilizando una transformación afín

<?php
final class MaxEngine implements Random\Engine {
    public function generate(): string {
        return "\xff";
    }
}

$randomizer = new \Random\Randomizer(new MaxEngine);

$min = 3.5;
$max = 4.5;

// NO HACER ESTO:
//
// Esto mostrará 4.5, a pesar de que nextFloat() muestree
// desde un intervalo abierto a la derecha, que nunca devolverá 1.
printf("Wrong scaling: %.17g", $randomizer->nextFloat() * ($max - $min) + $min);

// Correcto:
// $randomizer->getFloat($min, $max, \Random\IntervalBoundary::ClosedOpen);
?>

El ejemplo anterior mostrará:

Wrong scaling: 4.5

Ver también

Random\Randomizer::getFloat() - Devuelve un float seleccionado uniformemente