Struct LcgRng 

pub struct LcgRng { /* private fields */ }

Minimal LCG (MMIX variant) pseudo-random number generator.

Uses Knuth’s MMIX constants for a full-period 64-bit LCG. CRITICAL: next_bool() uses bit 32, NOT bit 0 (bit 0 has period 2 in MMIX LCG).

Implementations

impl LcgRng

pub fn new(seed: u64) -> Self

Create a new LCG seeded with seed.

pub fn next_u64(&mut self) -> u64

Advance the state and return the next 64-bit value.

pub fn next_f64(&mut self) -> f64

Return a uniform f64 in [0, 1).

pub fn next_bool(&mut self) -> bool

Return a random bool. Uses bit 32 (NOT bit 0) for better statistical quality.

pub fn next_normal(&mut self) -> f64

Return a standard-normal sample via Box-Muller.

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

Uniform sample on [lo, hi).

pub fn sample_categorical(&mut self, probs: &[f64]) -> usize

Sample a categorical index given a probability vector. Probabilities are expected to sum to ~1; if the sum is short due to rounding, the last index is returned.

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

Return a random usize in [0, n). Returns 0 if n == 0.

Trait Implementations

impl Clone for LcgRng

fn clone(&self) -> LcgRng

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LcgRng

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

Formats the value using the given formatter.