[][src]Struct rand::rngs::SmallRng

pub struct SmallRng(_);

An RNG recommended when small state, cheap initialization and good performance are required. The PRNG algorithm in SmallRng is chosen to be efficient on the current platform, without consideration for cryptography or security. The size of its state is much smaller than for StdRng.

Reproducibility of output from this generator is however not required, thus future library versions may use a different internal generator with different output. Further, this generator may not be portable and can produce different output depending on the architecture. If you require reproducible output, use a named RNG. Refer to The Book.

The current algorithm is [Pcg64Mcg][rand_pcg::Pcg64Mcg] on 64-bit platforms with Rust version 1.26 and later, or [Pcg32][rand_pcg::Pcg32] otherwise. Both are found in the rand_pcg crate.

Examples

Initializing SmallRng with a random seed can be done using FromEntropy:

use rand::FromEntropy;
use rand::rngs::SmallRng;

// Create small, cheap to initialize and fast RNG with a random seed.
// The randomness is supplied by the operating system.
let mut small_rng = SmallRng::from_entropy();

When initializing a lot of SmallRng's, using thread_rng can be more efficient:

use std::iter;
use rand::{SeedableRng, thread_rng};
use rand::rngs::SmallRng;

// Create a big, expensive to initialize and slower, but unpredictable RNG.
// This is cached and done only once per thread.
let mut thread_rng = thread_rng();
// Create small, cheap to initialize and fast RNGs with random seeds.
// One can generally assume this won't fail.
let rngs: Vec<SmallRng> = iter::repeat(())
    .map(|()| SmallRng::from_rng(&mut thread_rng).unwrap())
    .take(10)
    .collect();

Trait Implementations

impl Clone for SmallRng[src]

impl Debug for SmallRng[src]

impl RngCore for SmallRng[src]

impl SeedableRng for SmallRng[src]

type Seed = <Pcg64Mcg as SeedableRng>::Seed

Seed type, which is restricted to types mutably-dereferencable as u8 arrays (we recommend [u8; N] for some N). Read more

Auto Trait Implementations

impl Send for SmallRng

impl Unpin for SmallRng

impl Sync for SmallRng

impl UnwindSafe for SmallRng

impl RefUnwindSafe for SmallRng

Blanket Implementations

impl<R> Rng for R where
    R: RngCore + ?Sized
[src]

impl<R> FromEntropy for R where
    R: SeedableRng
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> From<T> for T[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]