[][src]Struct rand_core::block::BlockRng64

pub struct BlockRng64<R> where
    R: BlockRngCore + ?Sized
{ pub core: R, // some fields omitted }

A wrapper type implementing [RngCore] for some type implementing [BlockRngCore] with u64 array buffer; i.e. this can be used to implement a full RNG from just a generate function.

This is similar to [BlockRng], but specialized for algorithms that operate on u64 values.

No whole generated u64 values are thrown away and all values are consumed in-order. next_u64 simply takes the next available u64 value. next_u32 is however a bit special: half of a u64 is consumed, leaving the other half in the buffer. If the next function called is next_u32 then the other half is then consumed, however both next_u64 and fill_bytes discard the rest of any half-consumed u64s when called.

fill_bytes and try_fill_bytes consume a whole number of u64 values. If the requested length is not a multiple of 8, some bytes will be discarded.

Fields

core: R

The core part of the RNG, implementing the generate function.

Methods

impl<R> BlockRng64<R> where
    R: BlockRngCore
[src]

pub fn new(core: R) -> BlockRng64<R>[src]

Create a new BlockRng from an existing RNG implementing BlockRngCore. Results will be generated on first use.

pub fn index(&self) -> usize[src]

Get the index into the result buffer.

If this is equal to or larger than the size of the result buffer then the buffer is "empty" and generate() must be called to produce new results.

pub fn reset(&mut self)[src]

Reset the number of available results. This will force a new set of results to be generated on next use.

pub fn generate_and_set(&mut self, index: usize)[src]

Generate a new set of results immediately, setting the index to the given value.

Trait Implementations

impl<R> Debug for BlockRng64<R> where
    R: BlockRngCore + Debug
[src]

impl<R> SeedableRng for BlockRng64<R> where
    R: BlockRngCore + SeedableRng
[src]

type Seed = <R as SeedableRng>::Seed

Seed type, which is restricted to types mutably-dereferencable as u8 arrays (we recommend [u8; N] for some N). Read more

impl<R> RngCore for BlockRng64<R> where
    R: BlockRngCore<Item = u64>,
    <R as BlockRngCore>::Results: AsRef<[u64]>,
    <R as BlockRngCore>::Results: AsMut<[u64]>, 
[src]

impl<R> Clone for BlockRng64<R> where
    R: BlockRngCore + Clone + ?Sized,
    <R as BlockRngCore>::Results: Clone
[src]

Auto Trait Implementations

impl<R: ?Sized> Unpin for BlockRng64<R> where
    R: Unpin,
    <R as BlockRngCore>::Results: Unpin

impl<R: ?Sized> Send for BlockRng64<R> where
    R: Send,
    <R as BlockRngCore>::Results: Send

impl<R: ?Sized> Sync for BlockRng64<R> where
    R: Sync,
    <R as BlockRngCore>::Results: Sync

impl<R: ?Sized> UnwindSafe for BlockRng64<R> where
    R: UnwindSafe,
    <R as BlockRngCore>::Results: UnwindSafe

impl<R: ?Sized> RefUnwindSafe for BlockRng64<R> where
    R: RefUnwindSafe,
    <R as BlockRngCore>::Results: RefUnwindSafe

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.