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.
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more
Fill dest entirely with random data. Read more
Return a random value supporting the [Standard] distribution. Read more
Generate a random value in the range [low, high), i.e. inclusive of low and exclusive of high. Read more
Sample a new value, using the given distribution. Read more
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;
Create an iterator that generates values using the given distribution. Read more
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
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
Return a bool with a probability p of being true. Read more
Return a random element from values. Read more
Return a mutable pointer to a random element from values. Read more
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
Deprecated since 0.5.0
: use gen_bool instead
Return a bool with a 1 in n chance of true Read more
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
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (try_from)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from)
[+]
🔬 This is a nightly-only experimental API. (get_type_id)
this method will likely be replaced by an associated static