Enum Error 

pub enum Error {
    Parse(ParseError),
    Preprocess(PreprocessError),
    InvalidGrammar(String),
    AstBuild(BuilderError),
    FeaturesDisabled(Vec<FeatureGateError>),
    DepthLimit {
        limit: usize,
        span: Span,
    },
    AnnotationLimit {
        limit: usize,
        span: Span,
    },
}

High-level error of the top-level parser.

Unifies lexer, recognition and builder errors under one type, so that consumers only have to handle one error variant.

Variants

Parse(ParseError)

Lexer or recognition error. Contains the existing ParseError variant for token/EOF diagnostics.

Preprocess(PreprocessError)

Preprocessor error (#include, #define, #error, …). Only produced by the bundled parse_source function.

InvalidGrammar(String)

Grammar construction error. Occurs only on a corrupt build of the grammar constant — should never happen for IDL_42.

AstBuild(BuilderError)

AST builder error. Indicates a bug in the builder or grammar drift.

FeaturesDisabled(Vec<FeatureGateError>)

A used construct requires a feature that is off in ParserConfig::features. List of all violations.

DepthLimit

{/} nesting exceeds MAX_NESTING_DEPTH. Protection against stack overflow in the recursive CST builder (TS-1 finding 1).

Fields

limit: usize

Current cap.

span: Span

Position of the { token that exceeded the cap.

AnnotationLimit

Consecutive @ annotations exceed MAX_CONSECUTIVE_ANNOTATIONS. Protection against quadratic behavior in the left-recursive annotation-sequence CST build (TS-1 finding 2).

Fields

limit: usize

Current cap.

span: Span

Position of the @ token that exceeded the cap.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Eq for Error

impl Error for Error

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.

impl From<BuilderError> for Error

fn from(e: BuilderError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(e: ParseError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Error