Struct urandom::rng::ReadRng

pub struct ReadRng<R>(pub R);

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.

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 panic in case of an error.

Examples

let data = [1, 2, 3, 4, 5, 6, 7, 8];
let mut rng = urandom::rng::ReadRng::new(&data[..]);

println!("{:x}", rng.next::<u32>());

Tuple Fields

0: R

Implementations

impl<R> ReadRng<R>

pub fn new(reader: R) -> Random<ReadRng<R>>

Creates a new ReadRng from a Read.

Trait Implementations

impl<R: Clone> Clone for ReadRng<R>

fn clone(&self) -> ReadRng<R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<R: Debug> Debug for ReadRng<R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<R: Read> Rng for ReadRng<R>

fn next_u32(&mut self) -> u32

Returns the next u32 in the sequence.

fn next_u64(&mut self) -> u64

Returns the next u64 in the sequence.

fn fill_u32(&mut self, buffer: &mut [u32])

Fills the next u32 elements in the sequence.

fn fill_u64(&mut self, buffer: &mut [u64])

Fills the next u64 elements in the sequence.

fn fill_bytes(&mut self, buffer: &mut [u8])

Fills the byte slice with uniform random bytes.

fn jump(&mut self)

Advances the internal state significantly.

fn next_f32(&mut self) -> f32

Returns a uniform random f32 in the half-open interval [1.0, 2.0).

fn next_f64(&mut self) -> f64

Returns a uniform random f64 in the half-open interval [1.0, 2.0).