Struct bufrng::BufRng

pub struct BufRng<'a> { /* fields omitted */ }

A "random" number generator that yields values from a given buffer (and then zeros after the buffer is exhausted).

See the module documentation for details.

Methods

impl<'_> BufRng<'_>

pub fn new(data: &[u8]) -> BufRng

Construct a new BufRng that yields from the given data buffer.

Example

use bufrng::BufRng;
use rand::prelude::*;

// Create a new `BufRng` by giving it a buffer.
let mut rng = BufRng::new(&[1, 2, 3, 4]);

// It will generate "random" values, which are copied from the buffer.
assert_eq!(rng.gen::<u32>(), (1 << 24) | (2 << 16) | (3 << 8) | 4);

// Once the buffer is exhausted, the RNG will keep yielding `0`.
assert_eq!(rng.gen::<u32>(), 0);
assert_eq!(rng.gen::<u32>(), 0);
assert_eq!(rng.gen::<u32>(), 0);

Trait Implementations

impl<'_> RngCore for BufRng<'_>

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, dest: &mut [u8])

Fill dest with random data.

fn try_fill_bytes(&mut self, dest: &mut [u8]) -> Result<(), Error>

Fill dest entirely with random data.