Struct Error

pub struct Error<'a> {
    pub span: Range,
    pub errors: Vec<ErrorKind>,
    pub contexts: Vec<(Range, &'static str)>,
    pub backtrace: &'a Backtrace,
}

This error type accumulates errors and their position when backtracking through a parse tree. This take a deepest error at alt combinator.

Fields

span: Range

The span of the next token of the last valid one when encountering an error.

errors: Vec<ErrorKind>

List of errors tried in various branches that consumed the same (farthest) length of input.

contexts: Vec<(Range, &'static str)>

The backtrace stack of the error.

backtrace: &'a Backtrace

The extra backtrace of error in optional branches.

Implementations

impl<'a> Error<'a>

pub fn from_error_kind(input: Input<'a>, kind: ErrorKind) -> Self

Trait Implementations

impl<'a> Clone for Error<'a>

fn clone(&self) -> Error<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> ContextError<Input<'a>> for Error<'a>

fn add_context(input: Input<'a>, ctx: &'static str, other: Self) -> Self

Creates a new error from an input position, a static string and an existing error. This is used mainly in the context combinator, to add user friendly information to errors when backtracking through a parse tree

impl<'a> Debug for Error<'a>

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

Formats the value using the given formatter.

impl<'a> ParseError<Input<'a>> for Error<'a>

fn from_error_kind(i: Input<'a>, _: ErrorKind) -> Self

Creates an error from the input position and an ErrorKind

fn append(_: Input<'a>, _: ErrorKind, other: Self) -> Self

Combines an existing error with a new one created from the input position and an ErrorKind. This is useful when backtracking through a parse tree, accumulating error context on the way

fn from_char(_: Input<'a>, _: char) -> Self

Creates an error from an input position and an expected character

fn or(self, other: Self) -> Self

Combines two existing errors. This function is used to compare errors generated in various branches of alt.