Enum Ident 

pub enum Ident<T, Repr> {
    Known(T),
    Reserved(Repr),
}

A container that holds either a known variant, or an integer value with unknown meaning.

Example

#[repr(u8)]
enum KnownColor {
    Red = 0,
    Green = 1,
    Blue = 2,
}

// This can be autogenerated using something like `num_enum::TryFromPrimitive`.
impl TryFrom<u8> for KnownColor {
    type Error = Unrecognized;

    fn try_from(value: u8) -> Result<Self, Self::Error> {
        match value {
            0 => Ok(KnownColor::Red),
            1 => Ok(KnownColor::Green),
            2 => Ok(KnownColor::Blue),
            _ => Err(Unrecognized),
        }
    }
}
struct Unrecognized;

type Color = Ident<KnownColor, u8>;

let green = Color::from_integer(1);
assert!(matches!(green, Color::Known(KnownColor::Green)));

let orange = Color::from_integer(5);
assert!(matches!(orange, Color::Reserved(5)));

Variants

Known(T)

A well-known value.

Reserved(Repr)

A reserved value.

This can be used to identify vendor-specific types.

Implementations

impl<T, Repr> Ident<T, Repr>

pub fn is_reserved(&self) -> bool

Test if the value is reserved.

impl<T, Repr> Ident<T, Repr>

where T: TryFrom<Repr>, Repr: Clone + Copy,

pub fn from_integer(value: Repr) -> Self

Try to decode a known identifier; if that fails store the raw number as a “reserved” value.

impl<T, Repr> Ident<T, Repr>

where T: Into<Repr>,

pub fn to_integer(self) -> Repr

Convert the identifier to an integer.

Trait Implementations

impl<T: Clone, Repr: Clone> Clone for Ident<T, Repr>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy, Repr: Copy> Copy for Ident<T, Repr>

impl<T, Repr> Debug for Ident<T, Repr>

where T: Clone + Copy + PartialEq + Debug, Repr: Clone + Copy + PartialEq + Debug + UpperHex,

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

Formats the value using the given formatter.

impl<T, Repr> From<T> for Ident<T, Repr>

Conversion from the “known” type to the Ident::Known variant.

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: PartialEq, Repr: PartialEq> PartialEq for Ident<T, Repr>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: PartialEq, Repr: PartialEq> StructuralPartialEq for Ident<T, Repr>