Class BailErrorStrategy

  • All Implemented Interfaces:

    public class BailErrorStrategy
    extends DefaultErrorStrategy
    This implementation of ANTLRErrorStrategy responds to syntax errors by immediately canceling the parse operation with a ParseCancellationException. The implementation ensures that the ParserRuleContext.exception field is set for all parse tree nodes that were not completed prior to encountering the error.

    This error strategy is useful in the following scenarios.

    • Two-stage parsing: This error strategy allows the first stage of two-stage parsing to immediately terminate if an error is encountered, and immediately fall back to the second stage. In addition to avoiding wasted work by attempting to recover from errors here, the empty implementation of sync(org.antlr.v4.runtime.Parser) improves the performance of the first stage.
    • Silent validation: When syntax errors are not being reported or logged, and the parse result is simply ignored if errors occur, the BailErrorStrategy avoids wasting work on recovering from errors when the result will be ignored either way.

    myparser.setErrorHandler(new BailErrorStrategy());

    See Also: