Indicates whether the error strategy is currently "recovering from an error". This is used to suppress reporting multiple error messages while attempting to recover from a detected syntax error.
The index into the input stream where the last error occurred. This is used to prevent infinite loops where an error is found but no token is consumed during recovery...another error is found, ad nauseum. This is a failsafe mechanism to guarantee that at least one token/tree node is consumed for two errors.
This field is used to propagate information about the lookahead following the previous match. Since prediction prefers completing the current rule to error recovery efforts, error reporting may occur later than the original point where it was discoverable. The original context is used to compute the true expected sets as though the reporting occurred as early as possible.
@see #nextTokensContext
<p>The default implementation simply calls {@link #endErrorCondition} to ensure that the handler is not in error recovery mode.</p>
This method is called to enter error recovery mode when a recognition exception is reported.
This method is called to leave error recovery mode after recovering from a recognition exception.
{@inheritDoc}
{@inheritDoc}
{@inheritDoc}
The default implementation of {@link ANTLRErrorStrategy#sync} makes sure that the current lookahead symbol is consistent with what were expecting at this point in the ATN. You can call this anytime but ANTLR only generates code to check before subrules/loops and each iteration.
This is called by {@link #reportError} when the exception is a {@link NoViableAltException}.
This is called by {@link #reportError} when the exception is an {@link InputMismatchException}.
This is called by {@link #reportError} when the exception is a {@link FailedPredicateException}.
This method is called to report a syntax error which requires the removal of a token from the input stream. At the time this method is called, the erroneous symbol is current {@code LT(1)} symbol and has not yet been removed from the input stream. When this method returns, {@code recognizer} is in error recovery mode.
This method is called to report a syntax error which requires the insertion of a missing token into the input stream. At the time this method is called, the missing token has not yet been inserted. When this method returns, {@code recognizer} is in error recovery mode.
{@inheritDoc}
This method implements the single-token insertion inline error recovery strategy. It is called by {@link #recoverInline} if the single-token deletion strategy fails to recover from the mismatched input. If this method returns {@code true}, {@code recognizer} will be in error recovery mode.
This method implements the single-token deletion inline error recovery strategy. It is called by {@link #recoverInline} to attempt to recover from mismatched input. If this method returns null, the parser and error handler state will not have changed. If this method returns non-null, {@code recognizer} will <em>not</em> be in error recovery mode since the returned token was a successful match.
Conjure up a missing token during error recovery.
How should a token be displayed in an error message? The default is to display just the text, but during development you might want to have a lot of information spit out. Override in that case to use t.toString() (which, for CommonToken, dumps everything about the token). This is better than forcing you to override a method in your token objects because you don't have to go modify your lexer so that it creates a new Java type.
Compute the error recovery set for the current rule. During rule invocation, the parser pushes the set of tokens that can follow that rule reference on the stack; this amounts to computing FIRST of what follows the rule reference in the enclosing rule. See LinearApproximator.FIRST(). This local follow set only includes tokens from within the rule; i.e., the FIRST computation done by ANTLR stops at the end of a rule.
Consume tokens until one matches the given token set.
TODO add class description