Struct Writer

pub struct Writer<D>(/* private fields */);

A wrapper around Digest type that allows to use Write trait for hashing

Example

extern crate sha2;
extern crate digest;
extern crate digest_writer;
use std::fs::File;
use std::io::{self, Write};
use digest::FixedOutput;
use digest_writer::Writer;
let mut digest = Writer::new(sha2::Sha256::default());
let mut f = File::open("LICENSE-MIT").unwrap();
io::copy(&mut f, &mut digest).unwrap();
digest.fixed_result();

Implementations

impl<D: Input + FixedOutput> Writer<D>

pub fn new(d: D) -> Writer<D>

Wrap a Digest into a Writer

pub fn get_ref(&self) -> &D

Returns a reference to underlying Digest object

pub fn get_mut(&mut self) -> &mut D

Returns a mutable reference to underlying Digest object

pub fn into_inner(self) -> D

Return the original Digest

Trait Implementations

impl<D> BlockInput for Writer<D>

where D: BlockInput, D::BlockSize: ArrayLength<u8>,

type BlockSize = <D as BlockInput>::BlockSize

impl<D: Clone> Clone for Writer<D>

fn clone(&self) -> Writer<D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<D: Debug> Debug for Writer<D>

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

Formats the value using the given formatter.

impl<D: Default> Default for Writer<D>

fn default() -> Writer<D>

Returns the “default value” for a type.

impl<D> FixedOutput for Writer<D>

where D: FixedOutput, D::OutputSize: ArrayLength<u8>,

type OutputSize = <D as FixedOutput>::OutputSize

fn fixed_result(self) -> GenericArray<u8, Self::OutputSize>

Retrieve the digest result. This method consumes digest instance.

impl<D: Input> Input for Writer<D>

fn process(&mut self, input: &[u8])

Digest input data. This method can be called repeatedly for use with streaming messages.

impl<D: VariableOutput> VariableOutput for Writer<D>

fn new(output_size: usize) -> Result<Writer<D>, InvalidLength>

Create new hasher instance with given output size. Will return Err(InvalidLength) in case if hasher can not work with the given output size. Will always return an error if output size equals to zero.

fn output_size(&self) -> usize

Get output size of the hasher instance provided to the new method

fn variable_result(self, buffer: &mut [u8]) -> Result<&[u8], InvalidLength>

Retrieve the digest result into provided buffer. Length of the buffer must be equal to output size provided to the new method, otherwise Err(InvalidLength) will be returned

impl<D: Input> Write for Writer<D>

fn write(&mut self, buf: &[u8]) -> Result<usize>

Writes a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

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

Determines if this Writer has an efficient write_vectored implementation.

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

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

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

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.