Struct rand::rngs::ThreadRng [−][src]
pub struct ThreadRng { /* fields omitted */ }
Expand description
The type returned by thread_rng
, essentially just a reference to the
PRNG in thread-local memory.
ThreadRng
uses the same PRNG as StdRng
for security and performance.
As hinted by the name, the generator is thread-local. ThreadRng
is a
handle to this generator and thus supports Copy
, but not Send
or Sync
.
Unlike StdRng
, ThreadRng
uses the ReseedingRng
wrapper to reseed
the PRNG from fresh entropy every 64 kiB of random data.
OsRng
is used to provide seed data.
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.
Trait Implementations
Auto Trait Implementations
impl RefUnwindSafe for ThreadRng
impl UnwindSafe for ThreadRng
Blanket Implementations
Mutably borrows from an owned value. Read more
fn gen_range<T: SampleUniform, B1, B2>(&mut self, low: B1, high: B2) -> T where
B1: SampleBorrow<T> + Sized,
B2: SampleBorrow<T> + Sized,
[src]
fn gen_range<T: SampleUniform, B1, B2>(&mut self, low: B1, high: B2) -> T where
B1: SampleBorrow<T> + Sized,
B2: SampleBorrow<T> + Sized,
[src]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
fn sample_iter<T, D>(self, distr: D) -> DistIter<D, Self, T>ⓘ where
D: Distribution<T>,
Self: Sized,
[src]
fn sample_iter<T, D>(self, distr: D) -> DistIter<D, Self, T>ⓘ where
D: Distribution<T>,
Self: Sized,
[src]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 bool with a probability of numerator/denominator
of being
true. I.e. gen_ratio(2, 3)
has chance of 2 in 3, or about 67%, of
returning true. If numerator == denominator
, then the returned value
is guaranteed to be true
. If numerator == 0
, then the returned
value is guaranteed to be false
. Read more