Enum binread::error::Error

#[non_exhaustive]pub enum Error {
    BadMagic {
        pos: usize,
        found: Box<dyn Any>,
    },
    AssertFail {
        pos: usize,
        message: String,
    },
    Io(Error),
    Custom {
        pos: usize,
        err: Box<dyn Any>,
    },
    NoVariantMatch {
        pos: usize,
    },
    EnumErrors {
        pos: usize,
        variant_errors: Vec<(&'static str, Error)>,
    },
}

An error while parsing a BinRead type

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.

BadMagic

The magic value did not match the provided one

Fields of BadMagic

pos: usizefound: Box<dyn Any>

AssertFail

The condition of an assertion without a custom type failed

Fields of AssertFail

pos: usizemessage: String

Io(Error)

An error that occured while reading from, or seeking within, the reader

Custom

A custom error, most often given from the second value passed into an assert

Fields of Custom

pos: usizeerr: Box<dyn Any>

NoVariantMatch

No variant in the enum was successful in parsing the data

Fields of NoVariantMatch

pos: usize

EnumErrors

Fields of EnumErrors

pos: usizevariant_errors: Vec<(&'static str, Error)>

Implementations

impl Error

pub fn custom_err<T: Any>(&self) -> Option<&T>

Gets a custom error of type T from the Error. Returns None if the error type is not custom or if the contained error is not of the desired type.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

if let Err(e) = "xc".parse::<u32>() { // Print e itself, no need for description(). eprintln!("Error: {}", e); }

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

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl From<Error> for Error

fn from(err: Error) -> Self

Performs the conversion.