Struct onejoker::utils::Random

pub struct Random { /* private fields */ }

wiki | A simple xoshiro256** PRNG

I know, I know, first rule of PRNG club is don’t roll your own, just use the library. I’m pretty sure my Math chops are up to understanding this stuff well enough to bend that rule a bit, and I just don’t like the standard library for this application. Xoshiro crate is better, but contains a lot of stuff I don’t need.

Implementations

impl Random

pub fn new() -> Self

Create a new randomizer object. Will be lazily initialized and seeded on first use.

pub fn seeded(self, seed: u64) -> Self

Seed with given number for reproducibility.

pub fn next64(&mut self) -> u64

Execute one round of the xoshiro256** 64-bit PRNG.

pub fn jump(&mut self)

Jump is equivalent to 2^128 calls to next(); it can be used to generate non-overlapping subsequences for parallel computations.

pub fn next32(&mut self) -> u32

Get 32 random bits.

pub fn next16(&mut self) -> u16

Get 16 random bits.

pub fn uniform32(&mut self, limit: usize) -> usize

Faster, but not precisely uniform, using Lemire’s method.

pub fn uniform16(&mut self, limit: usize) -> usize

Slower, but precisely uniform, using rejection sampling with mask.

Trait Implementations

impl Clone for Random

fn clone(&self) -> Random

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Random

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

Formats the value using the given formatter.

impl Default for Random

fn default() -> Random

Returns the “default value” for a type.