Enum Error 

#[non_exhaustive]
pub enum Error {
    BufferTooShort {
        need: usize,
        have: usize,
        what: &'static str,
    },
    OutputBufferTooSmall {
        need: usize,
        have: usize,
    },
    UnexpectedApduTag {
        got: u32,
        expected: u32,
        what: &'static str,
    },
    UnexpectedSpduTag {
        got: u8,
        expected: u8,
        what: &'static str,
    },
    UnexpectedTpduTag {
        got: u8,
        expected: u8,
        what: &'static str,
    },
    InvalidLength(&'static str),
    LengthTooLarge(usize),
    LengthMismatch {
        what: &'static str,
        declared: usize,
        actual: usize,
    },
    InvalidObject {
        what: &'static str,
        reason: &'static str,
    },
    UnknownResource {
        resource_id: u32,
    },
}

A Common Interface parse or serialize error.

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.

BufferTooShort

Input shorter than required.

Fields

need: usize

Bytes required.

have: usize

Bytes available.

what: &'static str

What was being parsed.

OutputBufferTooSmall

Output buffer smaller than serialized_len().

Fields

need: usize

Bytes required.

have: usize

Bytes available.

UnexpectedApduTag

An object’s 3-byte apdu_tag did not match the expected value.

Fields

got: u32

The tag read from the wire (24-bit, in the low 3 bytes).

expected: u32

The tag the parser expected.

what: &'static str

The object being parsed.

UnexpectedSpduTag

A 1-byte spdu_tag did not match the expected value.

Fields

got: u8

The tag read from the wire.

expected: u8

The tag the parser expected.

what: &'static str

The object being parsed.

UnexpectedTpduTag

A 1-byte tpdu_tag did not match the expected value.

Fields

got: u8

The tag read from the wire.

expected: u8

The tag the parser expected.

what: &'static str

The object being parsed.

InvalidLength(&'static str)

The ASN.1-style length_field was malformed (truncated, or a declared length running past the buffer).

LengthTooLarge(usize)

A length_field encoded a value too large to represent (the spec caps any length at 65535, i.e. at most 3 length bytes).

LengthMismatch

A declared length_field did not match the actual body length, or the body did not fit the fixed shape the object requires.

Fields

what: &'static str

What was being parsed.

declared: usize

The length_field value.

actual: usize

The body length actually available.

InvalidObject

A fixed-shape object had a body length the spec does not allow.

Fields

what: &'static str

The object being parsed.

reason: &'static str

Why it is invalid.

UnknownResource

A resource_identifier() did not map to any CI-extension resource that crate::ci_ext::CiExtApdu can dispatch.

Fields

resource_id: u32

The 32-bit resource_identifier().

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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 Error

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Error