Struct xoroshiro128::Xoroshiro128Rng

pub struct Xoroshiro128Rng { /* fields omitted */ }

Methods

impl Xoroshiro128Rng

fn new() -> Result<Self>

Creates a new Xoroshiro128Rng instance which is randomly seeded.

Errors

When created this way the initial values of this Rng are seeded using an OsRng. If this fails then this method will pass through the error from OsRng.

Examples

use xoroshiro128::{Rng, Xoroshiro128Rng};

let rng = Xoroshiro128Rng::new();
let x: u32 = rng.unwrap().gen();
println!("{}", x);

fn new_unseeded() -> Self

Creates a new Xoroshiro128Rng instance which is not seeded.

The initial values of this Rng are constants, so all generators created by this function will yield the same stream of random numbers. It is highly recommended that this is created through SeedableRng instead of this function.

Trait Implementations

impl Debug for Xoroshiro128Rng

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for Xoroshiro128Rng

fn clone(&self) -> Xoroshiro128Rng

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Xoroshiro128Rng

impl Rng for Xoroshiro128Rng

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

fn next_f32(&mut self) -> f32

Return the next random f32 selected from the half-open interval [0, 1).

fn next_f64(&mut self) -> f64

Return the next random f64 selected from the half-open interval [0, 1).

fn fill_bytes(&mut self, dest: &mut [u8])

Fill dest with random data.

fn gen<T>(&mut self) -> T where
    T: Rand, 

Return a random value of a Rand type.

fn gen_iter<T>(&'a mut self) -> Generator<'a, T, Self> where
    T: Rand, 

Return an iterator that will yield an infinite number of randomly generated items.

fn gen_range<T>(&mut self, low: T, high: T) -> T where
    T: SampleRange + PartialOrd<T>, 

Generate a random value in the range [low, high).

fn gen_weighted_bool(&mut self, n: u32) -> bool

Return a bool with a 1 in n chance of true

fn gen_ascii_chars(&'a mut self) -> AsciiGenerator<'a, Self>

Return an iterator of random characters from the set A-Z,a-z,0-9.

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

Return a random element from values.

fn choose_mut<T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>

Return a mutable pointer to a random element from values.

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

Shuffle a mutable slice in place.

impl SeedableRng<[u64; 2]> for Xoroshiro128Rng

Seed a Xoroshiro128Rng with a given seed.

Panics

Xoroshiro128Rng is undefined for the seed [0, 0] and will panic if this seed is provided.

fn reseed(&mut self, seed: [u64; 2])

Reseed an RNG with the given seed.

fn from_seed(seed: [u64; 2]) -> Self

Create a new RNG with the given seed.

impl SeedableRng<u64> for Xoroshiro128Rng

fn reseed(&mut self, seed: u64)

Reseed an RNG with the given seed.

fn from_seed(seed: u64) -> Self

Create a new RNG with the given seed.

impl SeedableRng<()> for Xoroshiro128Rng

Seed a Xoroshiro128Rng based on an OsRng.

Panics

If OsRng is unavailable then this will panic. A safer option is Xoroshiro128Rng::new()

fn reseed(&mut self, _: ())

Reseed an RNG with the given seed.

fn from_seed(_: ()) -> Self

Create a new RNG with the given seed.

impl Rand for Xoroshiro128Rng

fn rand<R: Rng>(rng: &mut R) -> Xoroshiro128Rng

Generates a random instance of this type using the specified source of randomness.