Struct ThreadLocalRngPool 

pub struct ThreadLocalRngPool { /* private fields */ }

Thread-local random number generator pool

Provides deterministic, thread-safe random number generation by maintaining separate RNG instances for each thread, seeded in a predictable manner.

Implementations

impl ThreadLocalRngPool

pub fn new(seed: u64) -> Self

Create a new thread-local RNG pool with a specific seed

This ensures deterministic behavior across parallel executions when the same base seed is used.

pub fn new_time_seeded() -> Self

Create a thread-local RNG pool with a seed derived from system time

pub fn get_rng(&self) -> Random<StdRng>

Get a thread-local RNG

Each call to this method returns a new RNG instance seeded with a deterministic value based on the base seed and thread counter.

pub fn with_rng<F, R>(&self, f: F) -> R

where F: FnOnce(&mut Random<StdRng>) -> R,

Execute a closure with a thread-local RNG

This is the preferred way to use the thread-local RNG pool as it ensures proper resource management and consistent seeding.

pub fn base_seed(&self) -> u64

Get the base seed used by this pool

pub fn thread_counter(&self) -> usize

Get the current thread counter value

pub fn reset_counter(&self)

Reset the thread counter (useful for reproducible testing)

Trait Implementations

impl Debug for ThreadLocalRngPool

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

Formats the value using the given formatter.

impl Default for ThreadLocalRngPool

fn default() -> Self

Returns the “default value” for a type.