Struct Digest

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

A hash digest.

Check digest module for usage examples.

Implementations

impl Digest

pub const fn new(digest: [u8; 64]) -> Self

Creates a new digest.

pub const fn as_bytes(&self) -> &[u8]

Returns a byte slice of the digest’s contents.

pub fn into_inner(self) -> [u8; 64]

Consumes the digest, returning the digest bytes.

pub fn to_hex_lowercase(&self) -> String

Returns a string in the lowercase hexadecimal representation.

Example

use chksum_hash_sha2_512 as sha2_512;

#[rustfmt::skip]
let digest = [
    0xCF, 0x83, 0xE1, 0x35,
    0x7E, 0xEF, 0xB8, 0xBD,
    0xF1, 0x54, 0x28, 0x50,
    0xD6, 0x6D, 0x80, 0x07,
    0xD6, 0x20, 0xE4, 0x05,
    0x0B, 0x57, 0x15, 0xDC,
    0x83, 0xF4, 0xA9, 0x21,
    0xD3, 0x6C, 0xE9, 0xCE,
    0x47, 0xD0, 0xD1, 0x3C,
    0x5D, 0x85, 0xF2, 0xB0,
    0xFF, 0x83, 0x18, 0xD2,
    0x87, 0x7E, 0xEC, 0x2F,
    0x63, 0xB9, 0x31, 0xBD,
    0x47, 0x41, 0x7A, 0x81,
    0xA5, 0x38, 0x32, 0x7A,
    0xF9, 0x27, 0xDA, 0x3E,
];
let digest = sha2_512::Digest::new(digest);
assert_eq!(
    digest.to_hex_lowercase(),
    "cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e"
);

pub fn to_hex_uppercase(&self) -> String

Returns a string in the uppercase hexadecimal representation.

Example

use chksum_hash_sha2_512 as sha2_512;

#[rustfmt::skip]
let digest = [
    0xCF, 0x83, 0xE1, 0x35,
    0x7E, 0xEF, 0xB8, 0xBD,
    0xF1, 0x54, 0x28, 0x50,
    0xD6, 0x6D, 0x80, 0x07,
    0xD6, 0x20, 0xE4, 0x05,
    0x0B, 0x57, 0x15, 0xDC,
    0x83, 0xF4, 0xA9, 0x21,
    0xD3, 0x6C, 0xE9, 0xCE,
    0x47, 0xD0, 0xD1, 0x3C,
    0x5D, 0x85, 0xF2, 0xB0,
    0xFF, 0x83, 0x18, 0xD2,
    0x87, 0x7E, 0xEC, 0x2F,
    0x63, 0xB9, 0x31, 0xBD,
    0x47, 0x41, 0x7A, 0x81,
    0xA5, 0x38, 0x32, 0x7A,
    0xF9, 0x27, 0xDA, 0x3E,
];
let digest = sha2_512::Digest::new(digest);
assert_eq!(
    digest.to_hex_uppercase(),
    "CF83E1357EEFB8BDF1542850D66D8007D620E4050B5715DC83F4A921D36CE9CE47D0D13C5D85F2B0FF8318D2877EEC2F63B931BD47417A81A538327AF927DA3E"
);

Trait Implementations

impl AsRef<[u8]> for Digest

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

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

impl Clone for Digest

fn clone(&self) -> Digest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Digest

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

Formats the value using the given formatter.

impl Digest for Digest

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

where Self: AsRef<[u8]>,

Returns the digest as a byte slice.

fn to_hex_lowercase(&self) -> String

where Self: LowerHex,

Returns the digest as a lowercase hexadecimal string.

fn to_hex_uppercase(&self) -> String

where Self: UpperHex,

Returns the digest as an uppercase hexadecimal string.

impl Display for Digest

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

Formats the value using the given formatter.

impl From<[u8; 64]> for Digest

fn from(digest: [u8; 64]) -> Self

Converts to this type from the input type.

impl From<Digest> for [u8; 64]

fn from(digest: Digest) -> Self

Converts to this type from the input type.

impl LowerHex for Digest

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

Formats the value using the given formatter.

impl PartialEq for Digest

fn eq(&self, other: &Digest) -> 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 TryFrom<&str> for Digest

type Error = FormatError

The type returned in the event of a conversion error.

fn try_from(digest: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl UpperHex for Digest

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

Formats the value using the given formatter.

impl Copy for Digest

impl Eq for Digest

impl StructuralPartialEq for Digest