Struct rand::rngs::ThreadRng

pub struct ThreadRng {
    rng: Rc<UnsafeCell<ReseedingRng<ChaCha12Core, OsRng>>>,
}

A reference to the thread-local generator

An instance can be obtained via thread_rng or via ThreadRng::default(). This handle is safe to use everywhere (including thread-local destructors), though it is recommended not to use inside a fork handler. The handle cannot be passed between threads (is not Send or Sync).

ThreadRng uses the same PRNG as StdRng for security and performance and is automatically seeded from OsRng.

Unlike StdRng, ThreadRng uses the ReseedingRng wrapper to reseed the PRNG from fresh entropy every 64 kiB of random data as well as after a fork on Unix (though not quite immediately; see documentation of ReseedingRng). Note that the reseeding is done as an extra precaution against side-channel attacks and mis-use (e.g. if somehow weak entropy were supplied initially). The PRNG algorithms used are assumed to be secure.

Fields

rng: Rc<UnsafeCell<ReseedingRng<ChaCha12Core, OsRng>>>

Trait Implementations

impl Clone for ThreadRng

fn clone(&self) -> ThreadRng

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ThreadRng

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

Formats the value using the given formatter.

impl Default for ThreadRng

fn default() -> ThreadRng

Returns the “default value” for a type.

impl RngCore for ThreadRng

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

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

Fill dest with random data.

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

Fill dest entirely with random data.

impl CryptoRng for ThreadRng