Struct rand::read::ReadRng

pub struct ReadRng<R> { /* fields omitted */ }

An RNG that reads random bytes straight from a Read. This will work best with an infinite reader, but this is not required.

Panics

It will panic if it there is insufficient data to fulfill a request.

Example

use rand::{read, Rng};

let data = vec![1, 2, 3, 4, 5, 6, 7, 8];
let mut rng = read::ReadRng::new(&data[..]);
println!("{:x}", rng.gen::<u32>());

Methods

impl<R> ReadRng<R> where
    R: Read, 

pub fn new(r: R) -> ReadRng<R>

Create a new ReadRng from a Read.

Trait Implementations

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

fn next_u32(&mut self) -> u32

Return the next random u32.

fn next_u64(&mut self) -> u64

Return the next random u64.

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

Fill dest with random data.

fn next_f32(&mut self) -> f32

Return the next random f32 selected from the half-open interval [0, 1).

fn next_f64(&mut self) -> f64

Return the next random f64 selected from the half-open interval [0, 1).

fn gen<T>(&mut self) -> T where
    T: Rand, 

Return a random value of a Rand type.

Important traits for Generator<'a, T, R>

impl<'a, T, R> Iterator for Generator<'a, T, R> where
    R: Rng,
    T: Rand,  type Item = T;

fn gen_iter<T>(&'a mut self) -> Generator<'a, T, Self> where
    T: Rand, 

Return an iterator that will yield an infinite number of randomly generated items.

fn gen_range<T>(&mut self, low: T, high: T) -> T where
    T: SampleRange + PartialOrd<T>, 

Generate a random value in the range [low, high).

fn gen_weighted_bool(&mut self, n: u32) -> bool

Return a bool with a 1 in n chance of true

Important traits for AsciiGenerator<'a, R>

impl<'a, R> Iterator for AsciiGenerator<'a, R> where
    R: Rng,  type Item = char;

fn gen_ascii_chars(&'a mut self) -> AsciiGenerator<'a, Self>

Return an iterator of random characters from the set A-Z,a-z,0-9.

fn choose<T>(&mut self, values: &'a [T]) -> Option<&'a T>

Return a random element from values.

fn choose_mut<T>(&mut self, values: &'a mut [T]) -> Option<&'a mut T>

Return a mutable pointer to a random element from values.

fn shuffle<T>(&mut self, values: &mut [T])

Shuffle a mutable slice in place.

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

fn fmt(&self, __arg_0: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.