org.antlr.v4.runtime

Interface ANTLRErrorStrategy

All Known Implementing Classes:

BailErrorStrategy, DefaultErrorStrategy

public interface ANTLRErrorStrategy

The interface for defining strategies to deal with syntax errors encountered during a parse by ANTLR-generated parsers. We distinguish between three different kinds of errors:

• The parser could not figure out which path to take in the ATN (none of the available alternatives could possibly match)
• The current input does not match what we were looking for
• A predicate evaluated to false

Implementations of this interface report syntax errors by calling Parser.notifyErrorListeners(java.lang.String).

TODO: what to do about lexers

Method Summary

Methods

Modifier and Type	Method and Description
boolean	inErrorRecoveryMode(Parser recognizer) Tests whether or not recognizer is in the process of recovering from an error.
void	recover(Parser recognizer, RecognitionException e) This method is called to recover from exception e.
Token	recoverInline(Parser recognizer) This method is called when an unexpected symbol is encountered during an inline match operation, such as Parser.match(int).
void	reportError(Parser recognizer, RecognitionException e) Report any kind of RecognitionException.
void	reportMatch(Parser recognizer) This method is called by when the parser successfully matches an input symbol.
void	reset(Parser recognizer) Reset the error handler state for the specified recognizer.
void	sync(Parser recognizer) This method provides the error handler with an opportunity to handle syntactic or semantic errors in the input stream before they result in a RecognitionException.

Method Detail

reset

void reset(Parser recognizer)

Reset the error handler state for the specified recognizer.

Parameters:

recognizer - the parser instance

recoverInline

Token recoverInline(Parser recognizer)
                    throws RecognitionException

This method is called when an unexpected symbol is encountered during an inline match operation, such as Parser.match(int). If the error strategy successfully recovers from the match failure, this method returns the Token instance which should be treated as the successful result of the match.

This method handles the consumption of any tokens - the caller should not call Parser.consume() after a successful recovery.

Note that the calling code will not report an error if this method returns successfully. The error strategy implementation is responsible for calling Parser.notifyErrorListeners(java.lang.String) as appropriate.

Parameters:

recognizer - the parser instance

Throws:

RecognitionException - if the error strategy was not able to recover from the unexpected input symbol

recover

void recover(Parser recognizer,
           RecognitionException e)
             throws RecognitionException

This method is called to recover from exception e. This method is called after reportError(org.antlr.v4.runtime.Parser, org.antlr.v4.runtime.RecognitionException) by the default exception handler generated for a rule method.

Parameters:

recognizer - the parser instance

e - the recognition exception to recover from

Throws:

RecognitionException - if the error strategy could not recover from the recognition exception

See Also:

reportError(org.antlr.v4.runtime.Parser, org.antlr.v4.runtime.RecognitionException)

sync

void sync(Parser recognizer)
          throws RecognitionException

This method provides the error handler with an opportunity to handle syntactic or semantic errors in the input stream before they result in a RecognitionException.

The generated code currently contains calls to sync(org.antlr.v4.runtime.Parser) after entering the decision state of a closure block ((...)* or (...)+).

For an implementation based on Jim Idle's "magic sync" mechanism, see DefaultErrorStrategy.sync(org.antlr.v4.runtime.Parser).

Parameters:

recognizer - the parser instance

Throws:

RecognitionException - if an error is detected by the error strategy but cannot be automatically recovered at the current state in the parsing process

See Also:

DefaultErrorStrategy.sync(org.antlr.v4.runtime.Parser)

inErrorRecoveryMode

boolean inErrorRecoveryMode(Parser recognizer)

Tests whether or not recognizer is in the process of recovering from an error. In error recovery mode, Parser.consume() adds symbols to the parse tree by calling ParserRuleContext.addErrorNode(Token) instead of ParserRuleContext.addChild(Token).

Parameters:

recognizer - the parser instance

Returns:

true if the parser is currently recovering from a parse error, otherwise false

reportMatch

void reportMatch(Parser recognizer)

This method is called by when the parser successfully matches an input symbol.

Parameters:

recognizer - the parser instance

reportError

void reportError(Parser recognizer,
               RecognitionException e)

Report any kind of RecognitionException. This method is called by the default exception handler generated for a rule method.

Parameters:

recognizer - the parser instance

e - the recognition exception to report