Struct RandomNumberGenerator

pub struct RandomNumberGenerator { /* private fields */ }

Implementations

impl RandomNumberGenerator

pub fn new() -> RandomNumberGenerator

Creates a new RNG from a randomly generated seed

pub fn seeded(seed: u64) -> RandomNumberGenerator

Creates a new RNG from a specific seed

pub fn rand<T>(&mut self) -> T

where Standard: Distribution<T>,

Returns a random value of whatever type you specify

pub fn range<T>(&mut self, min: T, max: T) -> T

where T: SampleUniform + PartialOrd,

Returns a random value in the specified range, of type specified at the call site. This is INCLUSIVE of the first parameter, and EXCLUSIVE of the second. So range(1,6) will give you numbers from 1 to 5.

pub fn roll_dice(&mut self, n: i32, die_type: i32) -> i32

Rolls dice, using the classic 3d6 type of format: n is the number of dice, die_type is the size of the dice.

pub fn next_u64(&mut self) -> u64

Returns the RNG’s next unsigned-64 type

pub fn roll(&mut self, dice: DiceType) -> i32

Rolls dice based on a DiceType struct, including application of the bonus

pub fn roll_str<S>(&mut self, dice: S) -> Result<i32, DiceParseError>

where S: ToString,

Rolls dice based on passing in a string, such as roll_str(“1d12”)

pub fn random_slice_index<T>(&mut self, slice: &[T]) -> Option<usize>

Returns a random index into a slice

pub fn random_slice_entry<'a, T>(&mut self, slice: &'a [T]) -> Option<&'a T>

Returns a random entry in a slice (or none if empty)

pub fn get_rng(&mut self) -> &mut XorShiftRng

Get underlying RNG implementation for use in traits / algorithms exposed by other crates (eg. rand itself)

Trait Implementations

impl Clone for RandomNumberGenerator

fn clone(&self) -> RandomNumberGenerator

Returns a duplicate of the value.

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

Performs copy-assignment from source.