[−][src]Struct rand::rngs::ThreadRng

pub struct ThreadRng { /* fields omitted */ }

The type returned by thread_rng, essentially just a reference to the PRNG in thread-local memory.

ThreadRng uses ReseedingRng wrapping the same PRNG as StdRng, which is reseeded after generating 32 MiB of random data. A single instance is cached per thread and the returned ThreadRng is a reference to this instance — hence ThreadRng is neither Send nor Sync but is safe to use within a single thread. This RNG is seeded and reseeded via EntropyRng as required.

Note that the reseeding is done as an extra precaution against entropy leaks and is in theory unnecessary — to predict ThreadRng's output, an attacker would have to either determine most of the RNG's seed or internal state, or crack the algorithm used.

Like StdRng, ThreadRng is a cryptographically secure PRNG. The current algorithm used is HC-128, which is an array-based PRNG that trades memory usage for better performance. This makes it similar to ISAAC, the algorithm used in ThreadRng before rand 0.5.

Cloning this handle just produces a new reference to the same thread-local generator.

Trait Implementations

`impl Clone for ThreadRng`[src]

`fn clone(&self) -> ThreadRng`[src]

`fn clone_from(&mut self, source: &Self)`
1.0.0
[src]

Performs copy-assignment from source. Read more

`impl Debug for ThreadRng`[src]

`fn fmt(&self, f: &mut Formatter) -> Result`[src]

`impl CryptoRng for ThreadRng`[src]

`impl RngCore for ThreadRng`[src]

`fn next_u32(&mut self) -> u32`[src]

`fn next_u64(&mut self) -> u64`[src]

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

`fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>`[src]

Auto Trait Implementations

`impl !Send for ThreadRng`

`impl !Sync for ThreadRng`

Blanket Implementations

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

`fn gen<T>(&mut self) -> T where Standard: Distribution<T>,` [src]

Return a random value supporting the [Standard] distribution. Read more

`fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T`[src]

Generate a random value in the range [low, high), i.e. inclusive of low and exclusive of high. Read more

`fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T`[src]

Sample a new value, using the given distribution. Read more

ⓘImportant traits for DistIter<'a, D, R, T>
Important traits for DistIter<'a, D, R, T>
`impl<'a, D, R, T> Iterator for DistIter<'a, D, R, T> where D: Distribution<T>, R: Rng + 'a, type Item = T;`
`fn sample_iter<'a, T, D: Distribution<T>>( &'a mut self, distr: &'a D ) -> DistIter<'a, D, Self, T> where Self: Sized,` [src]

Create an iterator that generates values using the given distribution. Read more

`fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)`[src]

Fill dest entirely with random bytes (uniform value distribution), where dest is any type supporting [AsByteSliceMut], namely slices and arrays over primitive integer types (i8, i16, u32, etc.). Read more

`fn try_fill<T: AsByteSliceMut + ?Sized>( &mut self, dest: &mut T ) -> Result<(), Error>`[src]

Fill dest entirely with random bytes (uniform value distribution), where dest is any type supporting [AsByteSliceMut], namely slices and arrays over primitive integer types (i8, i16, u32, etc.). Read more

`fn gen_bool(&mut self, p: f64) -> bool`[src]

Return a bool with a probability p of being true. Read more

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

Return a random element from values. Read more

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

Return a mutable pointer to a random element from values. Read more

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

Shuffle a mutable slice in place. Read more

ⓘImportant traits for Generator<T, R>
Important traits for Generator<T, R>
`impl<T, R: RngCore> Iterator for Generator<T, R> where Standard: Distribution<T>, type Item = T;`
`fn gen_iter<T>(&mut self) -> Generator<T, &mut Self> where Standard: Distribution<T>,` [src]

Deprecated since 0.5.0:

use Rng::sample_iter(&Standard) instead

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

`fn gen_weighted_bool(&mut self, n: u32) -> bool`[src]

Deprecated since 0.5.0:

use gen_bool instead

Return a bool with a 1 in n chance of true Read more

ⓘImportant traits for AsciiGenerator<R>
Important traits for AsciiGenerator<R>
`impl<R: RngCore> Iterator for AsciiGenerator<R> type Item = char;`
`fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>`[src]

Deprecated since 0.5.0:

use sample_iter(&Alphanumeric) instead

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

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

`fn from(t: T) -> T`[src]

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

`fn into(self) -> U`[src]

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

`type Owned = T`

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

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

`type Error = !`

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

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

`fn borrow(&self) -> &T`[src]

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

`fn borrow_mut(&mut self) -> &mut T`[src]

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

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

🔬 This is a nightly-only experimental API. (try_from)

The type returned in the event of a conversion error.

[−][src]Struct rand::rngs::ThreadRng

Trait Implementations

impl Clone for ThreadRng[src]

fn clone(&self) -> ThreadRng[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

impl Debug for ThreadRng[src]

fn fmt(&self, f: &mut Formatter) -> Result[src]

impl CryptoRng for ThreadRng[src]

impl RngCore for ThreadRng[src]

fn next_u32(&mut self) -> u32[src]

fn next_u64(&mut self) -> u64[src]

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

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>[src]

Auto Trait Implementations

impl !Send for ThreadRng

impl !Sync for ThreadRng

Blanket Implementations

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

fn gen<T>(&mut self) -> T where Standard: Distribution<T>, [src]

fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T[src]

fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T[src]

Important traits for DistIter<'a, D, R, T>

fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)[src]

fn try_fill<T: AsByteSliceMut + ?Sized>( &mut self, dest: &mut T) -> Result<(), Error>[src]

fn gen_bool(&mut self, p: f64) -> bool[src]

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

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

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

ⓘImportant traits for Generator<T, R>Important traits for Generator<T, R>impl<T, R: RngCore> Iterator for Generator<T, R> where Standard: Distribution<T>, type Item = T;fn gen_iter<T>(&mut self) -> Generator<T, &mut Self> where Standard: Distribution<T>, [src]

Important traits for Generator<T, R>

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

ⓘImportant traits for AsciiGenerator<R>Important traits for AsciiGenerator<R>impl<R: RngCore> Iterator for AsciiGenerator<R> type Item = char;fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>[src]

Important traits for AsciiGenerator<R>

impl<T> From for T[src]

fn from(t: T) -> T[src]

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

fn into(self) -> U[src]

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

type Owned = T

fn to_owned(&self) -> T[src]

fn clone_into(&self, target: &mut T)[src]

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

type Error = !

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>[src]

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

fn borrow(&self) -> &T[src]

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

fn borrow_mut(&mut self) -> &mut T[src]

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

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

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>[src]

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

fn get_type_id(&self) -> TypeId[src]

`impl Clone for ThreadRng`[src]

`fn clone(&self) -> ThreadRng`[src]

`fn clone_from(&mut self, source: &Self)`
1.0.0
[src]

`impl Debug for ThreadRng`[src]

`fn fmt(&self, f: &mut Formatter) -> Result`[src]

`impl CryptoRng for ThreadRng`[src]

`impl RngCore for ThreadRng`[src]

`fn next_u32(&mut self) -> u32`[src]

`fn next_u64(&mut self) -> u64`[src]

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

`fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>`[src]

`impl !Send for ThreadRng`

`impl !Sync for ThreadRng`

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

`fn gen<T>(&mut self) -> T where Standard: Distribution<T>,` [src]

`fn gen_range<T: PartialOrd + SampleUniform>(&mut self, low: T, high: T) -> T`[src]

`fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T`[src]

`fn fill<T: AsByteSliceMut + ?Sized>(&mut self, dest: &mut T)`[src]

`fn try_fill<T: AsByteSliceMut + ?Sized>( &mut self, dest: &mut T ) -> Result<(), Error>`[src]

`fn gen_bool(&mut self, p: f64) -> bool`[src]

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

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

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

ⓘImportant traits for Generator<T, R>
Important traits for Generator<T, R>
`impl<T, R: RngCore> Iterator for Generator<T, R> where Standard: Distribution<T>, type Item = T;`
`fn gen_iter<T>(&mut self) -> Generator<T, &mut Self> where Standard: Distribution<T>,` [src]

`fn gen_weighted_bool(&mut self, n: u32) -> bool`[src]

ⓘImportant traits for AsciiGenerator<R>
Important traits for AsciiGenerator<R>
`impl<R: RngCore> Iterator for AsciiGenerator<R> type Item = char;`
`fn gen_ascii_chars(&mut self) -> AsciiGenerator<&mut Self>`[src]

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

`fn from(t: T) -> T`[src]

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

`fn into(self) -> U`[src]

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

`type Owned = T`

`fn to_owned(&self) -> T`[src]

`fn clone_into(&self, target: &mut T)`[src]

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

`type Error = !`

`fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>`[src]

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

`fn borrow(&self) -> &T`[src]

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

`fn borrow_mut(&mut self) -> &mut T`[src]

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

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

`fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>`[src]

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

`fn get_type_id(&self) -> TypeId`[src]