Package org.antlr.v4.runtime
Class Recognizer<Symbol,ATNInterpreter extends ATNSimulator>
- java.lang.Object
-
- org.antlr.v4.runtime.Recognizer<Symbol,ATNInterpreter>
-
public abstract class Recognizer<Symbol,ATNInterpreter extends ATNSimulator> extends Object
-
-
Field Summary
Fields Modifier and Type Field Description protected ATNInterpreter_interpstatic intEOF
-
Constructor Summary
Constructors Constructor Description Recognizer()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description voidaction(RuleContext _localctx, int ruleIndex, int actionIndex)voidaddErrorListener(ANTLRErrorListener listener)abstract ATNgetATN()Get theATNused by the recognizer for prediction.StringgetErrorHeader(RecognitionException e)What is the error header, normally line/character position information?ANTLRErrorListenergetErrorListenerDispatch()List<? extends ANTLRErrorListener>getErrorListeners()abstract StringgetGrammarFileName()For debugging and other purposes, might want the grammar name.abstract IntStreamgetInputStream()ATNInterpretergetInterpreter()Get the ATN interpreter used by the recognizer for prediction.ParseInfogetParseInfo()If profiling during the parse/lex, this will return DecisionInfo records for each decision in recognizer in a ParseInfo object.Map<String,Integer>getRuleIndexMap()Get a map from rule names to rule indexes.abstract String[]getRuleNames()StringgetSerializedATN()If this recognizer was generated, it will have a serialized ATN representation of the grammar.intgetState()StringgetTokenErrorDisplay(Token t)Deprecated.This method is not called by the ANTLR 4 Runtime.abstract TokenFactory<?>getTokenFactory()abstract String[]getTokenNames()Deprecated.UsegetVocabulary()instead.intgetTokenType(String tokenName)Map<String,Integer>getTokenTypeMap()Get a map from token names to token types.VocabularygetVocabulary()Get the vocabulary used by the recognizer.booleanprecpred(RuleContext localctx, int precedence)voidremoveErrorListener(ANTLRErrorListener listener)voidremoveErrorListeners()booleansempred(RuleContext _localctx, int ruleIndex, int actionIndex)abstract voidsetInputStream(IntStream input)voidsetInterpreter(ATNInterpreter interpreter)Set the ATN interpreter used by the recognizer for prediction.voidsetState(int atnState)Indicate that the recognizer has changed internal state that is consistent with the ATN state passed in.abstract voidsetTokenFactory(TokenFactory<?> input)
-
-
-
Field Detail
-
EOF
public static final int EOF
- See Also:
- Constant Field Values
-
_interp
protected ATNInterpreter extends ATNSimulator _interp
-
-
Method Detail
-
getTokenNames
@Deprecated public abstract String[] getTokenNames()
Deprecated.UsegetVocabulary()instead.Used to print out token names like ID during debugging and error reporting. The generated parsers implement a method that overrides this to point to their String[] tokenNames.
-
getRuleNames
public abstract String[] getRuleNames()
-
getVocabulary
public Vocabulary getVocabulary()
Get the vocabulary used by the recognizer.- Returns:
- A
Vocabularyinstance providing information about the vocabulary used by the grammar.
-
getTokenTypeMap
public Map<String,Integer> getTokenTypeMap()
Get a map from token names to token types.Used for XPath and tree pattern compilation.
-
getRuleIndexMap
public Map<String,Integer> getRuleIndexMap()
Get a map from rule names to rule indexes.Used for XPath and tree pattern compilation.
-
getTokenType
public int getTokenType(String tokenName)
-
getSerializedATN
public String getSerializedATN()
If this recognizer was generated, it will have a serialized ATN representation of the grammar.For interpreters, we don't know their serialized ATN despite having created the interpreter from it.
-
getGrammarFileName
public abstract String getGrammarFileName()
For debugging and other purposes, might want the grammar name. Have ANTLR generate an implementation for this method.
-
getATN
public abstract ATN getATN()
Get theATNused by the recognizer for prediction.- Returns:
- The
ATNused by the recognizer for prediction.
-
getInterpreter
public ATNInterpreter getInterpreter()
Get the ATN interpreter used by the recognizer for prediction.- Returns:
- The ATN interpreter used by the recognizer for prediction.
-
getParseInfo
public ParseInfo getParseInfo()
If profiling during the parse/lex, this will return DecisionInfo records for each decision in recognizer in a ParseInfo object.- Since:
- 4.3
-
setInterpreter
public void setInterpreter(ATNInterpreter interpreter)
Set the ATN interpreter used by the recognizer for prediction.- Parameters:
interpreter- The ATN interpreter used by the recognizer for prediction.
-
getErrorHeader
public String getErrorHeader(RecognitionException e)
What is the error header, normally line/character position information?
-
getTokenErrorDisplay
@Deprecated public String getTokenErrorDisplay(Token t)
Deprecated.This method is not called by the ANTLR 4 Runtime. Specific implementations ofANTLRErrorStrategymay provide a similar feature when necessary. For example, seeDefaultErrorStrategy.getTokenErrorDisplay(org.antlr.v4.runtime.Token).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.
-
addErrorListener
public void addErrorListener(ANTLRErrorListener listener)
- Throws:
NullPointerException- iflistenerisnull.
-
removeErrorListener
public void removeErrorListener(ANTLRErrorListener listener)
-
removeErrorListeners
public void removeErrorListeners()
-
getErrorListeners
public List<? extends ANTLRErrorListener> getErrorListeners()
-
getErrorListenerDispatch
public ANTLRErrorListener getErrorListenerDispatch()
-
sempred
public boolean sempred(RuleContext _localctx, int ruleIndex, int actionIndex)
-
precpred
public boolean precpred(RuleContext localctx, int precedence)
-
action
public void action(RuleContext _localctx, int ruleIndex, int actionIndex)
-
getState
public final int getState()
-
setState
public final void setState(int atnState)
Indicate that the recognizer has changed internal state that is consistent with the ATN state passed in. This way we always know where we are in the ATN as the parser goes along. The rule context objects form a stack that lets us see the stack of invoking rules. Combine this and we have complete ATN configuration information.
-
getInputStream
public abstract IntStream getInputStream()
-
setInputStream
public abstract void setInputStream(IntStream input)
-
getTokenFactory
public abstract TokenFactory<?> getTokenFactory()
-
setTokenFactory
public abstract void setTokenFactory(TokenFactory<?> input)
-
-