Struct Rng 

pub struct Rng { /* private fields */ }

xorshift64 uniform PRNG. Identical seeds produce identical sequences.

Seed 0 is mapped to a non-zero splinter constant to avoid the degenerate all-zero state.

Implementations

impl Rng

pub fn new(seed: u64) -> Self

Create a new generator. seed == 0 is remapped to a fixed non-zero constant (the golden-ratio splinter) so the stream is never stuck at 0.

pub fn next_u64(&mut self) -> u64

Advance the state and return the next raw u64.

pub fn next_unit(&mut self) -> f64

Uniform f64 in [0, 1).

pub fn next_range(&mut self, lo: f64, hi: f64) -> f64

Uniform f64 in [lo, hi). Panics if lo >= hi or either bound is non-finite.

pub fn next_usize(&mut self, hi: usize) -> usize

Uniform usize in [0, hi). hi == 0 returns 0 (no-op).

The float-based mapping is retained for compatibility with the pre-v0.7 model-selection RNG stream; the final clamp protects the documented bound in the extreme usize case. Prefer next_u64 / next_unit with integer rejection sampling when unbiased subsampling matters.

pub fn next_index(&mut self, hi: usize) -> usize

Uniform usize in [0, hi). hi == 0 returns 0.

pub fn next_normal(&mut self) -> f64

Standard normal sample via the Box–Muller transform.

pub fn shuffle<T>(&mut self, slice: &mut [T])

Shuffle a slice in place using the Fisher–Yates algorithm.

Trait Implementations

impl Clone for Rng

fn clone(&self) -> Rng

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Rng

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Rng

fn default() -> Self

Returns the “default value” for a type.