Struct rand::rngs::ThreadRng

pub struct ThreadRng { /* private fields */ }

Available on crate features std and std_rng only.

A reference to the thread-local generator

This type is a reference to a lazily-initialized 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 CSPRNG as StdRng, ChaCha12. As with StdRng, the algorithm may be changed, subject to reasonable expectations of security and performance.

ThreadRng is automatically seeded from OsRng with periodic reseeding (every 64 kiB, as well as “soon” after a fork on Unix — see ReseedingRng documentation for details).

Security must be considered relative to a threat model and validation requirements. ThreadRng attempts to meet basic security considerations for producing unpredictable random numbers: use a CSPRNG, use a recommended platform-specific seed (OsRng), and avoid leaking internal secrets e.g. via Debug implementation or serialization. Memory is not zeroized on drop.

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

Debug implementation does not leak internal state

fn fmt(&self, fmt: &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.

fn read_adapter(&mut self) -> RngReadAdapter<'_, Self>where Self: Sized,

Convert an RngCore to a RngReadAdapter.

impl CryptoRng for ThreadRng