Struct DrawSource 

pub struct DrawSource { /* private fields */ }

The random source of TData::new_with_draws, TData::save_with_draws and TData::migrate_with_draws: the operating system’s CSPRNG, or, as a testing hook, recorded draws (sized by draw_plan) replayed in order.

The first failure is kept and every later draw is zero-filled, so the caller discards whatever was built; DrawSource::finish reports it. Debug prints draw counts only, never draw bytes, and replayed bytes are overwritten when the source is dropped.

Implementations

impl DrawSource

pub fn os() -> Self

The operating system’s CSPRNG.

pub fn replay(draws: Vec<Vec<u8>>) -> Self

A replay of exactly draws, in order.

pub fn new(draws: Option<Vec<Vec<u8>>>) -> Self

The replay of draws when given, else the operating system’s CSPRNG: the optional draws argument of the bindings.

pub fn is_replay(&self) -> bool

Whether the draws are a replay rather than the operating system’s CSPRNG.

pub fn fill(&mut self, buf: &mut [u8])

Fills buf with the next draw; after a failure, and on the failing draw, buf is zero-filled instead.

pub fn finish(self) -> Result<()>

The first failure, else a replay whose draws were not all used.

Errors

• Error::Io when the operating system’s CSPRNG failed.
• Error::InvalidInput with what "draws" when the replay did not match what was drawn; reason is one of draw {i} has {n} bytes, but {m} were drawn, draw {i} of {m} bytes was not given ({n} draws given) and {k} of {n} draws were left unused, the texts the bindings show after draws: .

Trait Implementations

impl Debug for DrawSource

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

Formats the value using the given formatter.

impl Drop for DrawSource

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.