Enum ParseFailure

pub enum ParseFailure<'a> {
    Error(ParseError<'a>),
    Unrecognized(UnrecognizedToken<'a>),
}

Value’s failed parsing result

The parsing process can fail in two different ways:

• The input stream contains invalid tokens: the number, order, or contents of tokens is incorrect. Such errors are represented by the ParseError struct.
• The input may be correct, but the current parser does not recognize the input stream’s first token. In such case, another parser may recognize this token. Such situations arise when dealing with optional fields, variable number of fields, etc. Such situations are represented by the UnexpectedToken struct.

ParseFailure enum’s variants encapsulates both these structs.

Variants

Error(ParseError<'a>)

The parsing failed with an unrecoverable error

Unrecognized(UnrecognizedToken<'a>)

The token is not recognized by the parser

Implementations

impl<'a> ParseFailure<'a>

pub fn as_error(&self) -> Option<&ParseError<'a>>

Returns a reference to the ParseError if this ParseFailure corresponds to an error or None otherwise.

pub fn as_unrecognized(&self) -> Option<&UnrecognizedToken<'a>>

Returns a reference to the UnrecognizedToken if this ParseFailure corresponds to a failure due to an unrecognized token or None otherwise.

Trait Implementations

impl<'a> Debug for ParseFailure<'a>

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

Formats the value using the given formatter.

impl<'a, E: Into<ParseError<'a>>> From<E> for ParseFailure<'a>

fn from(error: E) -> Self

Converts to this type from the input type.

impl<'a> From<UnrecognizedToken<'a>> for ParseFailure<'a>

fn from(unrecognized: UnrecognizedToken<'a>) -> Self

Converts to this type from the input type.