Enum Sha256DigestError 

#[non_exhaustive]
pub enum Sha256DigestError {
    #[non_exhaustive]
    WrongLength {
        got: u32,
    },
    #[non_exhaustive]
    NonHexLowercase {
        at: u32,
        byte: u8,
    },
}

Parse error produced by Sha256::from_hex and the Sha256 Deserialize impl.

The enum is #[non_exhaustive] at the type level and every variant is #[non_exhaustive] so future field additions and variant additions both remain semver-additive (bd:JMAP-sf5h.21 ratified the single-tier shape — no wrapper struct is needed because no extra context lives on the wrapper).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

#[non_exhaustive]

WrongLength

The candidate had a length other than 64 UTF-8 bytes.

got is the actual byte length. The spec ABNF (64( %x30-39 / %x61-66 )) is fixed-length and admits no other length.

got is u32 (saturating, capped at u32::MAX) rather than usize to avoid leaking a platform-dependent integer width into the public error contract — the value is realistically bounded by the input string length and any candidate over 4 GiB would have been rejected earlier in the parsing pipeline.

Per-variant #[non_exhaustive] so future field additions remain semver-additive.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

got: u32

The candidate’s actual byte length, saturated at u32::MAX for inputs larger than 4 GiB.

#[non_exhaustive]

NonHexLowercase

The candidate contained a byte outside the lowercase-hex set [0-9 a-f] at the given 0-based position.

Uppercase hex is intentionally rejected — the spec ABNF %x61-66 is the lowercase subset only.

at is u32 (saturating, capped at u32::MAX) rather than usize; byte is the offending UTF-8 byte itself so the diagnostic can report 0x41 ('A') for an uppercase candidate without the caller having to re-index the input.

Per-variant #[non_exhaustive] so future field additions remain semver-additive.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

at: u32

0-based byte index of the first offending character, saturated at u32::MAX for inputs larger than 4 GiB.

byte: u8

The offending UTF-8 byte value at at.

Trait Implementations

impl Clone for Sha256DigestError

fn clone(&self) -> Sha256DigestError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sha256DigestError

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

Formats the value using the given formatter.

impl Display for Sha256DigestError

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

Formats the value using the given formatter.

impl Eq for Sha256DigestError

impl Error for Sha256DigestError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Sha256DigestError

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