Struct Sha512_256

pub struct Sha512_256(/* private fields */);

SHA-512-256: Alias for the sha512_256::Hash hash type. Output of the SHA512/256 hash function.

SHA512/256 is a hash function that uses the sha512 algorithm but it truncates the output to 256 bits. It has different initial constants than sha512 so it produces an entirely different hash compared to sha512. More information at https://eprint.iacr.org/2010/548.pdf.

Implementations

impl Hash

pub const fn from_byte_array(bytes: [u8; 32]) -> Self

Constructs a hash from the underlying byte array.

pub fn from_bytes_ref(bytes: &[u8; 32]) -> &Self

Zero cost conversion between a fixed length byte array shared reference and a shared reference to this Hash type.

pub fn from_bytes_mut(bytes: &mut [u8; 32]) -> &mut Self

Zero cost conversion between a fixed length byte array exclusive reference and an exclusive reference to this Hash type.

pub fn from_slice(sl: &[u8]) -> Result<Hash, FromSliceError>

Copies a byte slice into a hash object.

pub const fn to_byte_array(self) -> [u8; 32]

Returns the underlying byte array.

pub const fn as_byte_array(&self) -> &[u8; 32]

Returns a reference to the underlying byte array.

impl Hash

pub fn from_engine(e: HashEngine) -> Hash

Produces a hash from the current state of a given engine.

pub fn engine() -> HashEngine

Constructs a new engine.

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

Hashes some bytes.

pub fn hash_byte_chunks<B, I>(byte_slices: I) -> Self

where B: AsRef<[u8]>, I: IntoIterator<Item = B>,

Hashes all the byte slices retrieved from the iterator together.

pub fn hash_reader<R: BufRead>(reader: &mut R) -> Result<Self, Error>

Available on crate feature bitcoin-io only.

Hashes the entire contents of the reader.

Trait Implementations

impl AsRef<[u8]> for Hash

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<[u8; 32]> for Hash

fn as_ref(&self) -> &[u8; 32]

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<[u8]> for Hash

fn borrow(&self) -> &[u8]

Immutably borrows from an owned value.

impl Clone for Hash

fn clone(&self) -> Hash

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Hash

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Hash

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Hash, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Hash

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

Formats the value using the given formatter.

impl FromStr for Hash

type Err = HexToArrayError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl GeneralHash for Hash

type Engine = HashEngine

A hashing engine which bytes can be serialized into. It is expected to implement the io::Write trait, and to never return errors under any conditions.

fn from_engine(e: HashEngine) -> Hash

Produces a hash from the current state of a given engine.

fn engine() -> Self::Engine

where Self::Engine: Default,

Constructs a new engine.

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

where Self::Engine: Default,

Hashes some bytes.

fn hash_byte_chunks<B, I>(byte_slices: I) -> Self

where B: AsRef<[u8]>, I: IntoIterator<Item = B>, Self::Engine: Default,

Hashes all the byte slices retrieved from the iterator together.

fn hash_reader<R: BufRead>(reader: &mut R) -> Result<Self, Error>

where Self::Engine: Default,

Available on crate feature bitcoin-io only.

Hashes the entire contents of the reader.

impl Hash for Hash

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

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 Hash for Hash

const DISPLAY_BACKWARD: bool = false

Flag indicating whether user-visible serializations of this hash should be backward.

type Bytes = [u8; 32]

The byte array that represents the hash internally.

fn from_byte_array(bytes: Self::Bytes) -> Self

Constructs a hash from the underlying byte array.

fn from_slice(sl: &[u8]) -> Result<Hash, FromSliceError>

👎Deprecated since 0.15.0: use from_byte_array instead

Copies a byte slice into a hash object.

fn to_byte_array(self) -> Self::Bytes

Returns the underlying byte array.

fn as_byte_array(&self) -> &Self::Bytes

Returns a reference to the underlying byte array.

const LEN: usize = <Self::Bytes>::LEN

Length of the hash, in bytes.

impl LowerHex for Hash

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

Formats the value using the given formatter.

impl Ord for Hash

fn cmp(&self, other: &Hash) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Hash

fn eq(&self, other: &Hash) -> 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 PartialOrd for Hash

fn partial_cmp(&self, other: &Hash) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Hash

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl UpperHex for Hash

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

Formats the value using the given formatter.

impl Copy for Hash

impl Eq for Hash

impl StructuralPartialEq for Hash