Struct Sha3_512State 

pub struct Sha3_512State { /* private fields */ }

Sha3_512State represents the state of a SHA3-512 hashing process.

It maintains the intermediate hash computations. It’s crucial to understand that initiating a hashing process from an arbitrary Sha3_512State doesn’t equate to resuming the original process that yielded that state. Instead, it commences a new hashing process with a distinct set of initial values.

Thus, a Sha3_512State derived from a Sha3_512Hasher should not be utilized with the intention of continuing the hashing operation from where it left off in the original Sha3_512Hasher. It merely provides a snapshot of a particular stage in the process, rather than a mechanism to continue the process.

Example

This example demonstrates how to persist the state of a SHA3-512 hash operation:

let hello = b"hello";
let world = b" world";
let default_sha3_512state = Sha3_512State::default();

let mut default_sha3_512hasher = default_sha3_512state.build_hasher();
default_sha3_512hasher.write(hello);

let intermediate_state: Sha3_512State = default_sha3_512hasher.clone().into();

default_sha3_512hasher.write(world);

let mut from_sha3_512state: Sha3_512Hasher = intermediate_state.into();
from_sha3_512state.write(world);

let default_hello_world_result = default_sha3_512hasher.finish();
let from_arbitrary_state_result = from_sha3_512state.finish();
assert_ne!(default_hello_world_result, from_arbitrary_state_result);

Note

In this example, even though the internal states are the same between default_sha3_512hasher and from_sha3_512state before the Hasher::finish call, the results differ due to from_sha3_512state starting with an empty pad while the default_sha3_512hasher’s pad is already populated with b"hello".

Trait Implementations

impl BuildHasher for Sha3_512State

type Hasher = Sha3_512Hasher

Type of the hasher that will be created.

fn build_hasher(&self) -> <Sha3_512State as BuildHasher>::Hasher

Creates a new hasher.

fn hash_one<T>(&self, x: T) -> u64

where T: Hash, Self: Sized, Self::Hasher: Hasher,

Calculates the hash of a single value.

impl BytesLen for Sha3_512State

fn len() -> usize

impl Clone for Sha3_512State

fn clone(&self) -> Sha3_512State

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sha3_512State

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

Formats the value using the given formatter.

impl Default for Sha3_512State

fn default() -> Sha3_512State

Returns the “default value” for a type.

impl ExtendedOutputFunction<rs_sha3_512::::sha3_512state::{impl#0}::{constant#0}> for Sha3_512State

fn squeeze_u64(&self) -> u64

fn squeeze(&mut self) -> [u8; 64]

Squeezes the output data from the sponge

impl From<Sha3_512Hasher> for Sha3_512State

fn from(value: Sha3_512Hasher) -> Sha3_512State

Converts to this type from the input type.

impl From<Sha3_512State> for Sha3_512Hasher

fn from(value: Sha3_512State) -> Sha3_512Hasher

Converts to this type from the input type.

impl Hash for Sha3_512State

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl HashAlgorithm for Sha3_512State

type Padding = GenericPad<KeccakU128Size, rs_sha3_512::::sha3_512state::{impl#4}::Padding::{constant#1}, 6>

type Output = ByteArrayWrapper<rs_sha3_512::::sha3_512state::{impl#4}::Output::{constant#0}>

fn hash_block(&mut self, bytes: &[u8])

fn state_to_u64(&self) -> u64

impl PartialEq for Sha3_512State

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Sha3_512State

impl StructuralPartialEq for Sha3_512State