org.antlr.v4.runtime

Class RecognitionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.antlr.v4.runtime.RecognitionException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

FailedPredicateException, InputMismatchException, LexerNoViableAltException, NoViableAltException

public class RecognitionException
extends RuntimeException

The root of the ANTLR exception hierarchy. In general, ANTLR tracks just 3 kinds of errors: prediction errors, failed predicate errors, and mismatched input errors. In each case, the parser knows where it is in the input, where it is in the ATN, the rule invocation stack, and what kind of problem occurred.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RecognitionException(Recognizer<?,?> recognizer, IntStream input, ParserRuleContext ctx)
RecognitionException(String message, Recognizer<?,?> recognizer, IntStream input, ParserRuleContext ctx)

Method Summary

Methods

Modifier and Type	Method and Description
RuleContext	getCtx() Gets the RuleContext at the time this exception was thrown.
IntervalSet	getExpectedTokens() Gets the set of input symbols which could potentially follow the previously matched symbol at the time this exception was thrown.
IntStream	getInputStream() Gets the input stream which is the symbol source for the recognizer where this exception was thrown.
int	getOffendingState() Get the ATN state number the parser was in at the time the error occurred.
Token	getOffendingToken()
Recognizer<?,?>	getRecognizer() Gets the Recognizer where this exception occurred.
protected void	setOffendingState(int offendingState)
protected void	setOffendingToken(Token offendingToken)

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RecognitionException

public RecognitionException(@Nullable
                    Recognizer<?,?> recognizer,
                    @Nullable
                    IntStream input,
                    @Nullable
                    ParserRuleContext ctx)

RecognitionException

public RecognitionException(String message,
                    @Nullable
                    Recognizer<?,?> recognizer,
                    @Nullable
                    IntStream input,
                    @Nullable
                    ParserRuleContext ctx)

Method Detail

getOffendingState

public int getOffendingState()

Get the ATN state number the parser was in at the time the error occurred. For NoViableAltException and LexerNoViableAltException exceptions, this is the DecisionState number. For others, it is the state whose outgoing edge we couldn't match.

If the state number is not known, this method returns -1.

setOffendingState

protected final void setOffendingState(int offendingState)

getExpectedTokens

@Nullable
public IntervalSet getExpectedTokens()

Gets the set of input symbols which could potentially follow the previously matched symbol at the time this exception was thrown.

If the set of expected tokens is not known and could not be computed, this method returns null.

Returns:

The set of token types that could potentially follow the current state in the ATN, or null if the information is not available.

getCtx

@Nullable
public RuleContext getCtx()

Gets the RuleContext at the time this exception was thrown.

If the context is not available, this method returns null.

Returns:

The RuleContext at the time this exception was thrown. If the context is not available, this method returns null.

getInputStream

@Nullable
public IntStream getInputStream()

Gets the input stream which is the symbol source for the recognizer where this exception was thrown.

If the input stream is not available, this method returns null.

Returns:

The input stream which is the symbol source for the recognizer where this exception was thrown, or null if the stream is not available.

getOffendingToken

@Nullable
public Token getOffendingToken()

setOffendingToken

protected final void setOffendingToken(@Nullable
                     Token offendingToken)

getRecognizer

@Nullable
public Recognizer<?,?> getRecognizer()

Gets the Recognizer where this exception occurred.

If the recognizer is not available, this method returns null.

Returns:

The recognizer where this exception occurred, or null if the recognizer is not available.