Struct DeterministicRng 

pub struct DeterministicRng { /* private fields */ }

A deterministic random number generator.

TigerStyle:

• Same seed always produces same sequence
• Fork creates independent streams
• All randomness flows through this

Implementations

impl DeterministicRng

pub fn new(seed: u64) -> Self

Create a new RNG with the given seed.

Example

use umi_memory::dst::DeterministicRng;
let mut rng = DeterministicRng::new(42);
let value = rng.next_float();

pub fn seed(&self) -> u64

Get the original seed.

pub fn next_float(&mut self) -> f64

Generate a random float in [0, 1).

pub fn next_u64(&mut self) -> u64

Generate a random u64.

pub fn next_int(&mut self, min: i64, max: i64) -> i64

Generate a random integer in [min, max] (inclusive).

Panics

Panics if min > max.

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

Generate a random usize in [min, max] (inclusive).

Panics

Panics if min > max.

pub fn next_bool(&mut self, probability: f64) -> bool

Generate a random boolean with the given probability of true.

Panics

Panics if probability is not in [0, 1].

pub fn choose<'a, T>(&mut self, items: &'a [T]) -> &'a T

Choose a random element from a slice.

Panics

Panics if the slice is empty.

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

Shuffle a mutable slice in place.

pub fn fork(&mut self) -> Self

Create an independent fork of this RNG.

TigerStyle: Forks have independent sequences derived from parent.

Example

use umi_memory::dst::DeterministicRng;
let mut rng = DeterministicRng::new(42);
let mut fork1 = rng.fork();
let mut fork2 = rng.fork();
// fork1 and fork2 have independent sequences

pub fn next_bytes(&mut self, len: usize) -> Vec<u8>

Generate random bytes.

Trait Implementations

impl Clone for DeterministicRng

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeterministicRng

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

Formats the value using the given formatter.