Struct TypedParseError 

pub struct TypedParseError<'a, G: TypedGrammar>(/* private fields */);

Parse failure for a single statement in grammar G.

Designed for diagnostics:

• Message text (message()).
• Optional source location (offset(), length()).
• Severity/recovery status (kind()).
• Optional recovery tree (recovery_root()).

Recovery model:

• Recovered: this statement is invalid, but the parser skipped ahead (usually to the next ;) so it can continue with later statements.
• The returned recovery_root() can still be useful for diagnostics, but may contain error placeholders where input was skipped.
• Fatal: the parser could not find a safe point to continue from.

Implementations

impl<'a, G: TypedGrammar> TypedParseError<'a, G>

pub fn kind(&self) -> ParseErrorKind

Whether parsing recovered to a statement boundary.

pub fn is_recovered(&self) -> bool

True if this error was recovered and yielded a partial tree.

pub fn is_fatal(&self) -> bool

True if this error is fatal (unrecoverable).

pub fn message(&self) -> &str

Human-readable diagnostic text.

pub fn offset(&self) -> Option<usize>

Returns the byte offset of the error token, or None if unknown.

pub fn length(&self) -> Option<usize>

Returns the byte length of the error token, or None if unknown.

pub fn recovery_root(&'a self) -> Option<G::Node<'a>>

The partial recovery tree, if error recovery produced one.

pub fn parse_source(&self) -> &'a str

The source text bound to this result.

pub fn tokens(&self) -> impl Iterator<Item = TypedParserToken<'a, G>>

Tokens collected during the (partial) parse, if collect_tokens was enabled.

pub fn comments(&self) -> impl Iterator<Item = Comment<'a>>

Comments collected during the (partial) parse, if collect_tokens was enabled.

Trait Implementations

impl<G: TypedGrammar> Debug for TypedParseError<'_, G>

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

Formats the value using the given formatter.

impl<G: TypedGrammar> Display for TypedParseError<'_, G>

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

Formats the value using the given formatter.

impl<G: TypedGrammar> Error for TypedParseError<'_, G>

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.