|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--antlr.CodeGenerator | +--antlr.CppCodeGenerator
Untamed: Generate MyParser.cpp, MyParser.hpp, MyLexer.cpp, MyLexer.hpp and MyParserTokenTypes.hpp
Field Summary | |
(package private) int |
astVarNumber
|
static int |
caseSizeThreshold
Enabled: |
(package private) String |
commonExtraArgs
|
(package private) String |
commonExtraParams
|
(package private) String |
commonLocalVars
|
(package private) String |
currentASTResult
|
(package private) RuleBlock |
currentRule
|
(package private) String |
exceptionThrown
|
protected boolean |
genAST
|
protected boolean |
genHashLines
|
(package private) String |
labeledElementASTInit
|
(package private) String |
labeledElementASTType
|
(package private) String |
labeledElementInit
|
(package private) String |
labeledElementType
|
(package private) String |
lt1Value
|
private static NameSpace |
nameSpace
|
private static String |
namespaceAntlr
|
private static String |
namespaceStd
|
protected static String |
NONUNIQUE
|
protected String |
outputFile
|
protected int |
outputLine
|
private static String |
postIncludeCpp
|
private static String |
postIncludeHpp
|
private static String |
preIncludeCpp
|
private static String |
preIncludeHpp
|
protected boolean |
saveText
|
private Vector |
semPreds
|
protected int |
syntacticPredLevel
|
(package private) String |
throwNoViable
|
(package private) Hashtable |
treeVariableMap
|
(package private) boolean |
usingCustomAST
|
Fields inherited from class antlr.CodeGenerator |
analyzer, behavior, bitsetsUsed, bitsetTestThreshold, charFormatter, currentOutput, DEBUG_CODE_GENERATOR, DEFAULT_BITSET_TEST_THRESHOLD, DEFAULT_MAKE_SWITCH_THRESHOLD, grammar, makeSwitchThreshold, tabs, TokenTypesFileExt, TokenTypesFileSuffix, tool |
Constructor Summary | |
CppCodeGenerator()
Enabled: Create a C++ code-generator using the given Grammar. |
Method Summary | |
protected void |
_print(String s)
Output a String to the currentOutput stream. |
protected void |
_printAction(String s)
Print an action without leading tabs, attempting to preserve the current indentation level for multi-line actions Ignored if string is null. |
protected void |
_println(String s)
Output a String followed by newline, to the currentOutput stream. |
protected int |
addSemPred(String predicate)
Adds a semantic predicate string to the sem pred vector These strings will be used to build an array of sem pred names when building a debugging parser. |
protected int |
countLines(String s)
|
void |
exitIfError()
Enabled: |
private String |
fixNameSpaceOption(String ns)
|
void |
gen()
Enabled: Generate the parser, lexer, treeparser, and token types in C++ |
void |
gen(ActionElement action)
Enabled: Generate code for the given grammar element. |
void |
gen(AlternativeBlock blk)
Enabled: Generate code for the given grammar element. |
void |
gen(BlockEndElement end)
Enabled: Generate code for the given grammar element. |
void |
gen(CharLiteralElement atom)
Enabled: Generate code for the given grammar element. |
void |
gen(CharRangeElement r)
Enabled: Generate code for the given grammar element. |
void |
gen(LexerGrammar g)
Enabled: Generate the lexer C++ files |
void |
gen(OneOrMoreBlock blk)
Enabled: Generate code for the given grammar element. |
void |
gen(ParserGrammar g)
Enabled: Generate the parser C++ file |
void |
gen(RuleRefElement rr)
Enabled: Generate code for the given grammar element. |
void |
gen(StringLiteralElement atom)
Enabled: Generate code for the given grammar element. |
void |
gen(TokenRangeElement r)
Enabled: Generate code for the given grammar element. |
void |
gen(TokenRefElement atom)
Enabled: Generate code for the given grammar element. |
void |
gen(TreeElement t)
Enabled: |
void |
gen(TreeWalkerGrammar g)
Enabled: Generate the tree-parser C++ files |
void |
gen(WildcardElement wc)
Enabled: Generate code for the given grammar element. |
void |
gen(ZeroOrMoreBlock blk)
Enabled: Generate code for the given grammar element. |
protected void |
genAlt(Alternative alt,
AlternativeBlock blk)
Generate an alternative. |
protected void |
genBitsets(Vector bitsetList,
int maxVocabulary,
String prefix,
boolean dumpSets)
Generate all the bitsets to be used in the parser or lexer Generate the raw bitset data like "long _tokenSet1_data[] = {...};" and the BitSet object declarations like "BitSet _tokenSet1 = new BitSet(_tokenSet1_data);" Note that most languages do not support object initialization inside a class definition, so other code-generators may have to separate the bitset declarations from the initializations (e.g., put the initializations in the generated constructor instead). |
protected void |
genBitsetsHeader(Vector bitsetList,
int maxVocabulary)
|
private void |
genBlockFinish(CppBlockFinishingInfo howToFinish,
String noViableAction)
Generate the finish of a block, using a combination of the info returned from genCommonBlock() and the action to perform when no alts were taken |
protected void |
genBlockPreamble(AlternativeBlock blk)
Generate the header for a block, which may be a RuleBlock or a plain AlternativeBLock. |
void |
genBody(LexerGrammar g)
Enabled: |
void |
genBody(ParserGrammar g)
Enabled: |
void |
genBody(TreeWalkerGrammar g)
Enabled: |
protected void |
genCases(BitSet p)
Generate a series of case statements that implement a BitSet test. |
CppBlockFinishingInfo |
genCommonBlock(AlternativeBlock blk,
boolean noTestForSingle)
Enabled: Generate common code for a block of alternatives; return a postscript that needs to be generated at the end of the block. |
private void |
genElementAST(AlternativeElement el)
Generate code to link an element reference into the AST |
private void |
genErrorCatchForElement(AlternativeElement el)
Close the try block and generate catch phrases if the element has a labeled handler in the rule |
private void |
genErrorHandler(ExceptionSpec ex)
Generate the catch phrases for a user-specified error handler |
private void |
genErrorTryForElement(AlternativeElement el)
Generate a try { opening if the element has a labeled handler in the rule |
protected void |
genHeader(String fileName)
Generate a header that is common to all C++ files |
void |
genInclude(LexerGrammar g)
Enabled: |
void |
genInclude(ParserGrammar g)
Enabled: |
void |
genInclude(TreeWalkerGrammar g)
Enabled: |
void |
genLineNo(GrammarElement el)
Enabled: Generate a #line or // line depending on options |
void |
genLineNo(int line)
Enabled: Generate a #line or // line depending on options |
void |
genLineNo(Token t)
Enabled: Generate a #line or // line depending on options |
void |
genLineNo2()
Enabled: Generate a #line or // line depending on options |
private void |
genLiteralsTest()
|
private void |
genLiteralsTestForPartialToken()
|
protected void |
genMatch(BitSet b)
|
protected void |
genMatch(GrammarAtom atom)
|
protected void |
genMatchUsingAtomText(GrammarAtom atom)
|
protected void |
genMatchUsingAtomTokenType(GrammarAtom atom)
|
void |
genNextToken()
Enabled: Generate the nextToken() rule. |
void |
genRule(RuleSymbol s,
boolean startSymbol,
int ruleNum,
String prefix)
Enabled: Gen a named rule block. |
void |
genRuleHeader(RuleSymbol s,
boolean startSymbol)
Enabled: |
private void |
GenRuleInvocation(RuleRefElement rr)
|
protected void |
genSemPred(String pred,
int line)
|
protected void |
genSemPredMap(String prefix)
Write an array of Strings which are the semantic predicate expressions. |
protected void |
genSynPred(SynPredBlock blk,
String lookaheadExpr)
|
void |
genTokenStrings(String prefix)
Enabled: Generate a static array containing the names of the tokens, indexed by the token type values. |
protected void |
genTokenTypes(TokenManager tm)
Generate the token types C++ file |
String |
getASTCreateString(GrammarAtom atom,
String str)
Enabled: Get a string for an expression to generate creating of an AST node |
String |
getASTCreateString(String str)
Enabled: Get a string for an expression to generate creating of an AST node |
String |
getASTCreateString(Vector v)
Enabled: Get a string for an expression to generate creation of an AST subtree. |
protected String |
getLookaheadTestExpression(Alternative alt,
int maxDepth)
Generate a lookahead test expression for an alternate. |
protected String |
getLookaheadTestExpression(Lookahead[] look,
int k)
|
protected String |
getLookaheadTestTerm(int k,
BitSet p)
Generate a depth==1 lookahead test expression given the BitSet. |
String |
getRangeExpression(int k,
int[] elems)
Enabled: Return an expression for testing a contiguous renage of elements |
private String |
getValueString(int value)
getValueString: get a string representation of a token or char value |
protected boolean |
lookaheadIsEmpty(Alternative alt,
int maxDepth)
Is the lookahead for this alt empty? |
private String |
lookaheadString(int k)
|
private String |
mangleLiteral(String s)
Mangle a string literal into a meaningful token name. |
String |
mapTreeId(String idParam,
ActionTransInfo transInfo)
Enabled: Map an identifier to it's corresponding tree-node variable. |
private void |
mapTreeVariable(AlternativeElement e,
String name)
Given an element and the name of an associated AST variable, create a mapping between the element "name" and the variable name. |
void |
printAction(Token t)
Enabled: Print an action stored in a token surrounded by #line stuff |
void |
printHeaderAction(String name)
Enabled: Print a header action by #line stuff |
protected void |
println(String s)
Output tab indent followed by a String followed by newline, to the currentOutput stream. |
protected String |
processActionForTreeSpecifiers(String actionStr,
int line,
RuleBlock currentRule,
ActionTransInfo tInfo)
Lexically process tree-specifiers in the action. |
String |
processStringForASTConstructor(String str)
Enabled: Process a string for an simple expression for use in xx/action.g it is used to cast simple tokens/references to the right type for the generated language. |
private void |
setupGrammarParameters(Grammar g)
|
private static boolean |
suitableForCaseExpression(Alternative a)
|
private String |
textOrChar(String text)
|
Methods inherited from class antlr.CodeGenerator |
elementsAreRange, extractIdOfAction, extractIdOfAction, extractTypeOfAction, extractTypeOfAction, genTokenInterchange, getBitsetName, lexerRuleName, markBitsetForGen, print, printAction, printTabs, removeAssignmentFromDeclaration, reverseLexerRuleName, setAnalyzer, setBehavior, setGrammar, setTool |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected int syntacticPredLevel
protected boolean genAST
protected boolean saveText
protected boolean genHashLines
protected int outputLine
protected String outputFile
boolean usingCustomAST
String labeledElementType
String labeledElementASTType
String labeledElementASTInit
String labeledElementInit
String commonExtraArgs
String commonExtraParams
String commonLocalVars
String lt1Value
String exceptionThrown
String throwNoViable
RuleBlock currentRule
String currentASTResult
Hashtable treeVariableMap
int astVarNumber
protected static final String NONUNIQUE
public static final int caseSizeThreshold
private Vector semPreds
private static String namespaceStd
private static String namespaceAntlr
private static NameSpace nameSpace
private static final String preIncludeCpp
private static final String preIncludeHpp
private static final String postIncludeCpp
private static final String postIncludeHpp
Constructor Detail |
public CppCodeGenerator()
Method Detail |
protected int addSemPred(String predicate)
public void exitIfError()
protected int countLines(String s)
protected void _print(String s)
_print
in class CodeGenerator
s
- The string to outputprotected void _printAction(String s)
_printAction
in class CodeGenerator
s
- The action string to outputpublic void printAction(Token t)
public void printHeaderAction(String name)
name
- The name of the header partprotected void _println(String s)
_println
in class CodeGenerator
s
- The string to outputprotected void println(String s)
println
in class CodeGenerator
s
- The string to outputpublic void genLineNo(int line)
public void genLineNo(GrammarElement el)
public void genLineNo(Token t)
public void genLineNo2()
public void gen()
gen
in class CodeGenerator
public void gen(ActionElement action)
gen
in class CodeGenerator
action
- The {...} action to generatepublic void gen(AlternativeBlock blk)
gen
in class CodeGenerator
blk
- The "x|y|z|..." block to generatepublic void gen(BlockEndElement end)
gen
in class CodeGenerator
end
- The block-end element to generate. Block-end
elements are synthesized by the grammar parser to represent
the end of a block.public void gen(CharLiteralElement atom)
gen
in class CodeGenerator
atom
- The character literal reference to generatepublic void gen(CharRangeElement r)
gen
in class CodeGenerator
r
- The character-range reference to generatepublic void gen(LexerGrammar g) throws IOException
gen
in class CodeGenerator
IOException
public void gen(OneOrMoreBlock blk)
gen
in class CodeGenerator
blk
- The (...)+ block to generatepublic void gen(ParserGrammar g) throws IOException
gen
in class CodeGenerator
IOException
public void gen(RuleRefElement rr)
gen
in class CodeGenerator
rr
- The rule-reference to generatepublic void gen(StringLiteralElement atom)
gen
in class CodeGenerator
atom
- The string-literal reference to generatepublic void gen(TokenRangeElement r)
gen
in class CodeGenerator
r
- The token-range reference to generatepublic void gen(TokenRefElement atom)
gen
in class CodeGenerator
atom
- The token-reference to generatepublic void gen(TreeElement t)
gen
in class CodeGenerator
public void gen(TreeWalkerGrammar g) throws IOException
gen
in class CodeGenerator
IOException
public void gen(WildcardElement wc)
gen
in class CodeGenerator
wc
- The wildcard element to generatepublic void gen(ZeroOrMoreBlock blk)
gen
in class CodeGenerator
blk
- The (...)* block to generateprotected void genAlt(Alternative alt, AlternativeBlock blk)
alt
- The alternative to generateblk
- The block to which the alternative belongsprotected void genBitsets(Vector bitsetList, int maxVocabulary, String prefix, boolean dumpSets)
bitsetList
- The list of bitsets to generate.maxVocabulary
- Ensure that each generated bitset can contain at least this value.dumpSets
- Dump out the token definitions of the contents of the bitset
only for grammars/parsers.protected void genBitsetsHeader(Vector bitsetList, int maxVocabulary)
private void genBlockFinish(CppBlockFinishingInfo howToFinish, String noViableAction)
howToFinish
- The return of genCommonBlock()noViableAction
- What to generate when no alt is takenprotected void genBlockPreamble(AlternativeBlock blk)
public void genBody(LexerGrammar g) throws IOException
IOException
public void genBody(ParserGrammar g) throws IOException
IOException
public void genBody(TreeWalkerGrammar g) throws IOException
IOException
protected void genCases(BitSet p)
p
- The Bitset for which cases are to be generatedpublic CppBlockFinishingInfo genCommonBlock(AlternativeBlock blk, boolean noTestForSingle)
blk
- The block to generatenoTestForSingle
- If true, then it does not generate a test for a single alternative.private static boolean suitableForCaseExpression(Alternative a)
private void genElementAST(AlternativeElement el)
private void genErrorCatchForElement(AlternativeElement el)
private void genErrorHandler(ExceptionSpec ex)
private void genErrorTryForElement(AlternativeElement el)
protected void genHeader(String fileName)
public void genInclude(LexerGrammar g) throws IOException
IOException
public void genInclude(ParserGrammar g) throws IOException
IOException
public void genInclude(TreeWalkerGrammar g) throws IOException
IOException
private void genLiteralsTest()
private void genLiteralsTestForPartialToken()
protected void genMatch(BitSet b)
protected void genMatch(GrammarAtom atom)
protected void genMatchUsingAtomText(GrammarAtom atom)
protected void genMatchUsingAtomTokenType(GrammarAtom atom)
public void genNextToken()
public void genRule(RuleSymbol s, boolean startSymbol, int ruleNum, String prefix)
startSymbol
- true if the rule is a start symbol (i.e., not referenced elsewhere)public void genRuleHeader(RuleSymbol s, boolean startSymbol)
private void GenRuleInvocation(RuleRefElement rr)
protected void genSemPred(String pred, int line)
protected void genSemPredMap(String prefix)
protected void genSynPred(SynPredBlock blk, String lookaheadExpr)
public void genTokenStrings(String prefix)
protected void genTokenTypes(TokenManager tm) throws IOException
IOException
public String processStringForASTConstructor(String str)
processStringForASTConstructor
in class CodeGenerator
str
- A String.public String getASTCreateString(Vector v)
getASTCreateString
in class CodeGenerator
v
- A Vector of String, where each element is an expression in the target language yielding an AST node.public String getASTCreateString(GrammarAtom atom, String str)
getASTCreateString
in class CodeGenerator
str
- The arguments to the AST constructorpublic String getASTCreateString(String str)
str
- The arguments to the AST constructorprotected String getLookaheadTestExpression(Lookahead[] look, int k)
protected String getLookaheadTestExpression(Alternative alt, int maxDepth)
protected String getLookaheadTestTerm(int k, BitSet p)
k
- The lookahead levelp
- The lookahead set for level kpublic String getRangeExpression(int k, int[] elems)
k
- The lookahead levelelems
- The elements representing the set, usually from BitSet.toArray().
private String getValueString(int value)
value
- The token or char valueprotected boolean lookaheadIsEmpty(Alternative alt, int maxDepth)
private String lookaheadString(int k)
private String mangleLiteral(String s)
public String mapTreeId(String idParam, ActionTransInfo transInfo)
mapTreeId
in class CodeGenerator
idParam
- The identifier name to map
private void mapTreeVariable(AlternativeElement e, String name)
protected String processActionForTreeSpecifiers(String actionStr, int line, RuleBlock currentRule, ActionTransInfo tInfo)
processActionForTreeSpecifiers
in class CodeGenerator
private String fixNameSpaceOption(String ns)
private void setupGrammarParameters(Grammar g)
private String textOrChar(String text)
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |