pub struct ReadRng<R> { /* private fields */ }
๐Deprecated since 0.8.4: removal due to lack of usage
Available on crate feature
std
only.Expand description
An RNG that reads random bytes straight from any type supporting
std::io::Read
, for example files.
This will work best with an infinite reader, but that is not required.
This can be used with /dev/urandom
on Unix but it is recommended to use
OsRng
instead.
ยงPanics
ReadRng
uses std::io::Read::read_exact
, which retries on interrupts.
All other errors from the underlying reader, including when it does not
have enough data, will only be reported through try_fill_bytes
.
The other RngCore
methods will panic in case of an error.
Implementationsยง
Trait Implementationsยง
Auto Trait Implementationsยง
impl<R> Freeze for ReadRng<R>where
R: Freeze,
impl<R> RefUnwindSafe for ReadRng<R>where
R: RefUnwindSafe,
impl<R> Send for ReadRng<R>where
R: Send,
impl<R> Sync for ReadRng<R>where
R: Sync,
impl<R> Unpin for ReadRng<R>where
R: Unpin,
impl<R> UnwindSafe for ReadRng<R>where
R: UnwindSafe,
Blanket Implementationsยง
sourceยงimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
sourceยงfn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceยงimpl<R> Rng for R
impl<R> Rng for R
sourceยงfn gen<T>(&mut self) -> Twhere
Standard: Distribution<T>,
fn gen<T>(&mut self) -> Twhere
Standard: Distribution<T>,
sourceยงfn gen_range<T, R>(&mut self, range: R) -> Twhere
T: SampleUniform,
R: SampleRange<T>,
fn gen_range<T, R>(&mut self, range: R) -> Twhere
T: SampleUniform,
R: SampleRange<T>,
Generate a random value in the given range. Read more
sourceยงfn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T
fn sample<T, D: Distribution<T>>(&mut self, distr: D) -> T
Sample a new value, using the given distribution. Read more
sourceยงfn sample_iter<T, D>(self, distr: D) -> DistIter<D, Self, T> โwhere
D: Distribution<T>,
Self: Sized,
fn sample_iter<T, D>(self, distr: D) -> DistIter<D, Self, T> โwhere
D: Distribution<T>,
Self: Sized,
Create an iterator that generates values using the given distribution. Read more
sourceยงfn gen_bool(&mut self, p: f64) -> bool
fn gen_bool(&mut self, p: f64) -> bool
Return a bool with a probability
p
of being true. Read moresourceยงfn gen_ratio(&mut self, numerator: u32, denominator: u32) -> bool
fn gen_ratio(&mut self, numerator: u32, denominator: u32) -> bool
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