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
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
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
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