Enum Error 

#[non_exhaustive]
pub enum Error {
    Truncated {
        got: usize,
        need: usize,
    },
    LengthMismatch {
        declared: usize,
        actual: usize,
    },
    BadCrc {
        expected: u16,
        actual: u16,
    },
    DeviceStatus(u32),
    ClassRefused {
        class: ObjectClass,
        status: u32,
    },
    UnexpectedResponse {
        expected: u32,
        got: u32,
    },
    UnexpectedLocation {
        requested: Location,
        reported: Location,
    },
    UnexpectedPartition {
        requested: u32,
        reported: u32,
    },
    Enumeration {
        bank: u32,
        answered: Location,
        slots: u32,
    },
    ScanLimit {
        bank: u32,
        limit: u32,
    },
    Transport(String),
    Envelope(String),
    Replay(String),
    InvalidArgument(String),
    Io(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.

Truncated

Fields

got: usize

need: usize

LengthMismatch

Fields

declared: usize

actual: usize

BadCrc

Fields

expected: u16

actual: u16

DeviceStatus(u32)

ClassRefused

The device refused SESSION_OPEN for this class: it does not serve the class. A refusal of any other command stays a Error::DeviceStatus.

Fields

class: ObjectClass

status: u32

UnexpectedResponse

Fields

expected: u32

got: u32

UnexpectedLocation

Fields

requested: Location

reported: Location

UnexpectedPartition

Fields

requested: u32

reported: u32

Enumeration

An inventory walk contradicted the geometry declared by the instrument.

Fields

bank: u32

answered: Location

slots: u32

ScanLimit

Fields

bank: u32

limit: u32

Transport(String)

The byte pipe itself failed — a USB transfer error, a missing device, a claim refusal. Nothing about message content belongs here.

Envelope(String)

The CBIN header around an entity body is wrong: bad magic, a checksum that does not match the body, a malformed format tag.

Replay(String)

A replay script that could not be parsed or was contradicted by the code under test. Only produced by the replay feature’s transport.

InvalidArgument(String)

Io(Error)

Implementations

impl Error

pub fn expect_kind(&self) -> ErrKind

This failure’s kind in a replay script’s expect: err <kind> header.

The vocabulary is short on purpose — it exists to tell one expected refusal from another — so a failure it does not name is reported as the nearest kind rather than left out, where the script would claim the operation succeeded. A script that names the wrong kind fails the sweep, which is the report; a script that names none passes silently, which is not.

The match is exhaustive so that a new variant is given a kind rather than defaulting into one, and ErrKind::matches is its inverse.

Trait Implementations

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 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 From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.