Trait `VariableOutput`

trait VariableOutput: Sized + Update

Trait for hash functions with variable-size output.

Required Methods

fn new(output_size: usize) -> Result<Self, InvalidOutputSize>

Create new hasher instance with the given output size.

It will return Err(InvalidOutputSize) in case if hasher can not return hash of the specified output size.

fn output_size(self: &Self) -> usize

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

fn finalize_variable(self: Self, out: &mut [u8]) -> Result<(), InvalidBufferSize>

Write result into the output buffer.

Returns Err(InvalidOutputSize) if out size is not equal to self.output_size().

fn digest_variable<impl AsRef<[u8]>: AsRef<[u8]>>(input: impl AsRef<[u8]>, output: &mut [u8]) -> Result<(), InvalidOutputSize>

Compute hash of data and write it to output.

Length of the output hash is determined by output. If output is bigger than Self::MAX_OUTPUT_SIZE, this method returns InvalidOutputSize.

fn finalize_boxed(self: Self) -> Box<[u8]>

Retrieve result into a boxed slice and consume hasher.

Box<[u8]> is used instead of Vec<u8> to save stack space, since they have size of 2 and 3 words respectively.