ASTFactory.hpp
上传用户:afrynkmhm
上传日期:2007-01-06
资源大小:1262k
文件大小:4k
源码类别:

编译器/解释器

开发平台:

Others

  1. #ifndef INC_ASTFactory_hpp__
  2. #define INC_ASTFactory_hpp__
  3. /**
  4.  * <b>SOFTWARE RIGHTS</b>
  5.  * <p>
  6.  * ANTLR 2.6.0 MageLang Insitute, 1999
  7.  * <p>
  8.  * We reserve no legal rights to the ANTLR--it is fully in the
  9.  * public domain. An individual or company may do whatever
  10.  * they wish with source code distributed with ANTLR or the
  11.  * code generated by ANTLR, including the incorporation of
  12.  * ANTLR, or its output, into commerical software.
  13.  * <p>
  14.  * We encourage users to develop software with ANTLR. However,
  15.  * we do ask that credit is given to us for developing
  16.  * ANTLR. By "credit", we mean that if you use ANTLR or
  17.  * incorporate any source code into one of your programs
  18.  * (commercial product, research project, or otherwise) that
  19.  * you acknowledge this fact somewhere in the documentation,
  20.  * research report, etc... If you like ANTLR and have
  21.  * developed a nice tool with the output, please mention that
  22.  * you developed it using ANTLR. In addition, we ask that the
  23.  * headers remain intact in our source code. As long as these
  24.  * guidelines are kept, we expect to continue enhancing this
  25.  * system and expect to make other tools available as they are
  26.  * completed.
  27.  * <p>
  28.  * The ANTLR gang:
  29.  * @version ANTLR 2.6.0 MageLang Insitute, 1999
  30.  * @author Terence Parr, <a href=http://www.MageLang.com>MageLang Institute</a>
  31.  * @author <br>John Lilley, <a href=http://www.Empathy.com>Empathy Software</a>
  32.  * @author <br><a href="mailto:pete@yamuna.demon.co.uk">Pete Wells</a>
  33.  */
  34. #include "antlr/config.hpp"
  35. #include "antlr/AST.hpp"
  36. #include "antlr/ASTArray.hpp"
  37. #include "antlr/ASTPair.hpp"
  38. ANTLR_BEGIN_NAMESPACE(antlr)
  39. /** AST Support code shared by TreeParser and Parser.
  40.  *  We use delegation to share code (and have only one
  41.  *  bit of code to maintain) rather than subclassing
  42.  *  or superclassing (forces AST support code to be
  43.  *  loaded even when you don't want to do AST stuff).
  44.  *
  45.  *  Typically, setASTNodeType is used to specify the
  46.  *  type of node to create, but you can override
  47.  *  create to make heterogeneous nodes etc...
  48.  */
  49. class ASTFactory {
  50. public:
  51. typedef RefAST (*factory_type)();
  52. protected:
  53. /** Name of AST class to create during tree construction.
  54.  *  Null implies that the create method should create
  55.  *  a default AST type such as CommonAST.
  56.  */
  57. factory_type nodeFactory;
  58. public:
  59. ASTFactory();
  60. /** Add a child to the current AST */
  61. void addASTChild(ASTPair& currentAST, RefAST child);
  62. /** Create a new empty AST node; if the user did not specify
  63.  *  an AST node type, then create a default one: CommonAST.
  64.  */
  65. virtual RefAST create();
  66. RefAST create(int type);
  67. RefAST create(int type, const ANTLR_USE_NAMESPACE(std)string& txt);
  68. /** Create a new empty AST node; if the user did not specify
  69.  *  an AST node type, then create a default one: CommonAST.
  70.  */
  71. RefAST create(RefAST tr);
  72. RefAST create(RefToken tok);
  73. /** Copy a single node.  clone() is not used because
  74.  *  we want to return an AST not a plain object...a type
  75.  *  safety issue.  Further, we want to have all AST node
  76.  *  creation go through the factory so creation can be
  77.  *  tracked.  Returns null if t is null.
  78.  */
  79. RefAST dup(RefAST t);
  80. /** Duplicate tree including siblings of root. */
  81. RefAST dupList(RefAST t);
  82. /**Duplicate a tree, assuming this is a root node of a tree--
  83.  * duplicate that node and what's below; ignore siblings of root node.
  84.  */
  85. RefAST dupTree(RefAST t);
  86. /** Make a tree from a list of nodes.  The first element in the
  87.  *  array is the root.  If the root is null, then the tree is
  88.  *  a simple list not a tree.  Handles null children nodes correctly.
  89.  *  For example, build(a, b, null, c) yields tree (a b c).  build(null,a,b)
  90.  *  yields tree (nil a b).
  91.  */
  92. RefAST make(ANTLR_USE_NAMESPACE(std)vector<RefAST> nodes);
  93. /** Make a tree from a list of nodes, where the nodes are contained
  94.   * in an ASTArray object
  95.   */
  96. RefAST make(ASTArray* nodes);
  97. /** Make an AST the root of current AST */
  98. void makeASTRoot(ASTPair& currentAST, RefAST root);
  99. void setASTNodeFactory(factory_type factory);
  100. virtual ~ASTFactory() {}
  101. };
  102. ANTLR_END_NAMESPACE
  103. #endif //INC_ASTFactory_hpp__