Struct chksum_hash_sha2_384::Update

pub struct Update { /* private fields */ }

A hash state containing an internal buffer that can handle an unknown amount of input data.

Example

use chksum_hash_sha2_384 as sha2_384;

// Create a new hash instance
let mut hash = sha2_384::Update::new();

// Fill with data
hash.update("data");

// Finalize and create a digest
let digest = hash.finalize().digest();
assert_eq!(
    digest.to_hex_lowercase(),
    "2039e0f0b92728499fb88e23ebc3cfd0554b28400b0ed7b753055c88b5865c3c2aa72c6a1a9ae0a755d87900a4a6ff41"
);

// Reset to default values
hash.reset();

// Produce a hash digest using internal finalization
let digest = hash.digest();
assert_eq!(
    digest.to_hex_lowercase(),
    "38b060a751ac96384cd9327eb1b1e36a21fdb71114be07434c0cc7bf63f6e1da274edebfe76f65fbd51ad2f14898b95b"
);

Implementations

impl Update

pub fn new() -> Self

Creates a new hash.

pub fn update(&mut self, data: impl AsRef<[u8]>) -> &mut Self

Updates the internal state with an input data.

Performance issues

To achieve maximum performance, the length of incoming data parts should be a multiple of the block length.

In any other case, an internal buffer is used, which can cause a speed decrease in performance.

pub fn finalize(&self) -> Finalize

Applies padding and produces the finalized state.

pub fn reset(&mut self) -> &mut Self

Resets the internal state to default values.

pub fn digest(&self) -> Digest

Produces the hash digest using internal finalization.

Trait Implementations

impl<'arbitrary> Arbitrary<'arbitrary> for Update

fn arbitrary(u: &mut Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'arbitrary>) -> Result<Self>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for Update

fn clone(&self) -> Update

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Update

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

Formats the value using the given formatter.

impl Default for Update

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Update

fn eq(&self, other: &Update) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Update for Update

type Digest = Digest

The type representing the digest produced by finalizing the hash.

type Finalize = Finalize

The type representing the finalized state, which can be converted into a digest.

fn update(&mut self, data: impl AsRef<[u8]>)

Updates the hash state with an input data.

fn finalize(&self) -> Self::Finalize

Finalizes the hash state.

fn reset(&mut self)

Resets the hash state to its initial state.

fn digest(&self) -> Self::Digest

Produces the hash digest using internal finalization.

impl Eq for Update

impl StructuralPartialEq for Update