Struct PseudoRng 

pub struct PseudoRng { /* private fields */ }

Linear congruential generator with the parameters used by glibc’s non-secure random() family. Sufficient for ring dispatch (the only caller); not cryptographically strong.

Examples

use dynomite::hashkit::PseudoRng;
let mut rng = PseudoRng::from_seed(42);
let value = rng.next_u32();
// Same seed reproduces the same stream.
let mut rng2 = PseudoRng::from_seed(42);
assert_eq!(value, rng2.next_u32());

Implementations

impl PseudoRng

pub fn from_monotonic() -> Self

Construct a generator seeded from the system clock.

The seed mixes seconds and nanoseconds drawn from SystemTime::now(). See the module-level docs for why we use the system clock rather than a monotonic clock.

Examples

use dynomite::hashkit::PseudoRng;
let mut rng = PseudoRng::from_monotonic();
let _ = rng.next_u32();

pub fn from_seed(seed: u64) -> Self

Construct a generator from an explicit seed.

Examples

use dynomite::hashkit::PseudoRng;
let mut a = PseudoRng::from_seed(7);
let mut b = PseudoRng::from_seed(7);
assert_eq!(a.next_u32(), b.next_u32());

pub fn next_u32(&mut self) -> u32

Advance the generator and return the next 32-bit value.

Examples

use dynomite::hashkit::PseudoRng;
let mut rng = PseudoRng::from_seed(1);
let _: u32 = rng.next_u32();

pub fn next_index(&mut self, modulus: u32) -> u32

Pick a uniform value in [0, modulus). Returns 0 when modulus is zero.

Examples

use dynomite::hashkit::PseudoRng;
let mut rng = PseudoRng::from_seed(7);
for _ in 0..16 {
    assert!(rng.next_index(13) < 13);
}
assert_eq!(rng.next_index(0), 0);

Trait Implementations

impl Clone for PseudoRng

fn clone(&self) -> PseudoRng

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PseudoRng

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

Formats the value using the given formatter.