Struct Sha256 

pub struct Sha256 { /* private fields */ }

SHA-256 hash function (RFC 6234 / FIPS 180-4).

Implements the Hasher trait.

One-shot API

use crypto::{Hasher, sha2::Sha256};

let hash = Sha256::hash(b"hello world");

Incremental API

use crypto::{Hasher, sha2::Sha256};

let mut hasher = Sha256::new();
hasher.update(b"hello ");
hasher.update(b"world");
let hash = hasher.sum();

Message length limit

FIPS 180-4 permits messages with ℓ < 2^64 bits, i.e. up to 2^61 - 1 bytes. The length is counted by a 64-bit byte counter and encoded in the 64-bit field mandated by the spec, so a message of 2^61 bytes or more produces undefined result. Such lengths are around 2 EiB and are unreachable in practice; they are neither rejected nor signalled, so no panic or error is returned for them.

Trait Implementations

impl Clone for Sha256

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Sha256

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.

impl Hasher for Sha256

const BLOCK_SIZE: usize = 64

The internal block size of the hash function

const OUTPUT_SIZE: usize = 32

The output size of the hash function.

fn new() -> Self

fn update(&mut self, data: &[u8])

fn sum(self) -> Hash

fn hash(data: &[u8]) -> Hash

impl Zeroize for Sha256

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.