Enum ParseError

pub enum ParseError {
    Unknown(String),
}

Creates C-like enums which preserve unknown (un-enumerated) values.

If you wanted an enum like:

#[repr(u32)]
pub enum HardenedBool {
    True = 0x739,
    False = 0x146,
    Unknown(u32),
}

Where the Unknown discriminator would be the catch-all for any non-enumerated values, you can use with_unknown! as follows:

with_unknown! {
    pub enum HardenedBool: u32 {
        True = 0x739,
        False = 0x14d,
    }
}

This “enum” can be used later in match statements:

match foo {
    HardenedBool::True => do_the_thing(),
    HardenedBool::False => do_the_opposite_thing(),
    HardenedBool(x) => panic!("Oh noes! {} is neither True nor False!", x),
}

Behind the scenes, with_unknown! implements a newtype struct and creates associated constants for each of the enumerated values. The struct also implements Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Debug and Display (including the hex, octal and binary versions).

In addition, serde::Serialize and serde::Deserialize are implemented. The serialized form is a string for known values and an integer for all unknown values.

Variants

Unknown(String)

Trait Implementations

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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.