Function malachite_base::num::random::random_primitive_floats

source · [−]

pub fn random_primitive_floats<T: PrimitiveFloat>(
    seed: Seed
) -> RandomPrimitiveFloats<T>ⓘNotable traits for RandomPrimitiveFloats<T>impl<T: PrimitiveFloat> Iterator for RandomPrimitiveFloats<T>    type Item = T;

Expand description

Generates finite primitive floats.

Every float has an equal probability of being chosen. This does not mean that the distribution approximates a uniform distribution over the reals. For example, a float in $[1/4, 1/2)$ is as likely to be chosen as a float in $[1, 2)$, since these subranges contain an equal number of floats.

Positive zero, negative zero, and NaN are all generated.

The output length is infinite.

Expected complexity per iteration

Constant time and additional memory.

Examples

use malachite_base::iterators::prefix_to_string;
use malachite_base::num::float::NiceFloat;
use malachite_base::num::random::random_primitive_floats;
use malachite_base::random::EXAMPLE_SEED;

assert_eq!(
    prefix_to_string(random_primitive_floats::<f32>(EXAMPLE_SEED).map(NiceFloat), 10),
    "[-2.3484665e-27, 2.2879888e-18, -2.0729896e-12, 3.3600117e28, -9.0217234e-32, 3564911.0, \
    -0.000013376945, -1.885545e18, 8.249455e-29, 2.2178013e-38, ...]"
);