|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
unitNode Class ReferenceHolds the AST of one translation unit.
More...
|
Garbage collection. | |
bool | mark |
node_list | nodes |
map< Node *, bool > | deleted_nodes |
Public Member Functions | |
unitNode (string input_file, string output_file, const Coord coord=Coord::Unknown) | |
Create a new translation unit from a source file. | |
virtual | ~unitNode () |
Destroy a unitNode. | |
void | parse (str_list *cpp_flags, bool abortOnError=true) |
Parse the input file. | |
void | fixup () |
Run fixup passes. | |
void | merge_in (def_list *defs) |
Merge in external definitions. | |
void | enter_scope () |
Enter a new scope. | |
void | exit_scope () |
Exit scope. | |
virtual void | dataflow (FlowVal *v, FlowProblem &fp) |
Run the dataflow analyzer. | |
virtual Node * | clone () const |
Clone the input node. | |
virtual void | output (output_context &ct, Node *par) |
Generate C code. | |
virtual typeNode * | type () const |
Return the node data type. | |
virtual typeNode * | base_type (bool TdefIndir) const |
Return the base data type of a node. | |
typeNode * | datatype () const |
Call base_type() with the argument true. | |
typeNode * | datatype_superior () const |
Call base_type() with the argument false. | |
Accessors | |
Methods to get and set fields in the class. | |
def_list & | defs () |
const def_list & | defs () const |
int | symbol_level () const |
Identifiers_table * | types () const |
Tags_table * | tags () const |
instruction_list & | instructions () |
string & | input_file () |
string & | output_file () |
int | errors () const |
void | inc_errors () |
int | warnings () const |
void | inc_warnings () |
decl_list & | undef_funcs () |
suespec_list & | suespecs () |
AST Traversal | |
virtual void | visit (Visitor *the_visitor) |
Dispatch a Visitor. | |
virtual void | walk (Walker &the_walker) |
Dispatch a Walker. | |
virtual Node * | change (Changer &the_changer, bool redispatch=false) |
Dispatch a Changer. | |
Accessors | |
Methods to get and set fields in the class. | |
NodeType | typ () const |
Get the node type. | |
Coord | coord () const |
Get the source location. | |
void | coord (const Coord coord) |
Set the source location. | |
bool | parenthesized () const |
Get the parenthesized boolean. | |
void | parenthesized (bool paren) |
Set the parenthesized boolean. | |
annote_list & | annotations () |
Get the annotations list. | |
FlowVal * | gen () const |
Get the "gen" flow value. | |
void | gen (FlowVal *g) |
Set the "gen" flow value. | |
FlowVal * | kill () const |
Get the "kill" flow value. | |
void | kill (FlowVal *k) |
Set the "kill" flow value. | |
Static Public Member Functions | |
void | report () |
Report node count statistics. | |
Private Member Functions | |
FILE * | _open_input_file (str_list *cpp_flags) |
Open the input file. | |
Private Attributes | |
TREE def_list | _defs |
The external definitions. | |
int | _symbol_level |
Depth of the scope. | |
Identifiers_table * | _types |
Table of type names. | |
Tags_table * | _tags |
Table of struct/union tags. | |
instruction_list | _instructions |
List of instructions for this translation unit. | |
string | _input_file |
Source file name. | |
string | _output_file |
The output file name. | |
int | _errors |
The number of errors. | |
int | _warnings |
The number of warnings. | |
TREE decl_list | _undef_funcs |
Undeclared functions. | |
TREE suespec_list | _suespecs |
struct/enum/union contents |
A translation unit corresponds to a single input source file (with all header files included). To parse a source file in, create a unitNode and then call the parse() method. However, this is typically done by the main driver, which also handles the flags provided on the command line.
All instances of unitNode created by the main driver are stored in a global list in the CBZ class.
The NodeType is Unit.
In addition to containing the AST for the code, unitNode contains auxillary information gathered during the parsing. This includes:
Definition at line 469 of file ast.h.
|
Create a new translation unit from a source file. Instantiate a new unitNode with the given input and output source file names. This is typically done automatically by the front-end driver.
Definition at line 54 of file unitnode.cc. References Unit. Referenced by clone(). |
|
Destroy a unitNode.
Definition at line 308 of file unitnode.cc. |
|
Open the input file.
Definition at line 114 of file unitnode.cc. References _input_file, CBZ::preproc, CBZ::Preprocess, and str_list_p. Referenced by parse(). |
|
Get the annotations list. This method returns a modifiable reference to the list of annotations on the node. Users can add new annotations, search for annotations, or remove annotations. Users are responsible for ensuring that every element of the annotation list points to a valid annotation. In particular, no element should be NULL.
Definition at line 276 of file ast.h. References annote_list. |
|
Return the base data type of a node. This method differs from the Node::type() method in two respects. First, it follows some of the simple type inferences. For example, calling it on an idNode will return the type of its declaration. Second, the boolean argument indicates whether or not to follow typedef links.
Reimplemented in declNode, procNode, typeNode, tdefNode, exprNode, idNode, commaNode, callNode, blockNode, and exprstmtNode. Definition at line 152 of file node.cc. Referenced by Node::datatype(), and Node::datatype_superior(). |
|
Dispatch a Changer. This abstract method works much the walker, but allows the tree to be changed.
Implements Node. Definition at line 279 of file unitnode.cc. References Changer::at_unit(), Changer::Both, change_list(), defs(), Changer::order(), Changer::Order, Changer::Postorder, Changer::Preorder, suespecs(), and undef_funcs(). Referenced by Dismantle::at_unit(), StaticToGlobalDismantle::at_unit(), Dismantle::dismantle(), Dismantle::dismantle_control(), cfg_changer::generate_cfg(), ipConstantsChanger::optimize(), constantsChanger::optimize(), and pointers_phase::run(). |
|
Clone the input node. This is not a "deep" clone, so be careful. For a deep clone, use the ref_clone_changer class.
Implements Node. Definition at line 679 of file ast.h. References unitNode(). |
|
Set the source location. This location should indicate the position in the source text that this Node represents, or Coord::Unknown if it does not represent any node in the source text. It is not common to set the source location of a node. Currently, only the compiler error messages actually make use of it.
|
|
|
Run the dataflow analyzer. Each subclass overrides this method to define it's semantics for dataflow analysis. It alters the input flow value to reflect the effect of the node within the given flow problem, calling dataflow() on it's subtrees as necessary. See the dataflow analysis documentation for more information.
Implements Node. Definition at line 232 of file unitnode.cc. References FlowProblem::flow_unit(), and FlowProblem::forward(). |
|
Call base_type() with the argument true.
Definition at line 157 of file node.cc. References Node::base_type(). Referenced by funcNode::is_void_args(). |
|
Call base_type() with the argument false.
Definition at line 162 of file node.cc. References Node::base_type(). |
|
Definition at line 609 of file ast.h. References def_list. |
|
|
Enter a new scope.
Definition at line 180 of file unitnode.cc. References _symbol_level, SymbolTable< suespecNode * >::enter_scope(), SymbolTable< declNode * >::enter_scope(), tags(), and types(). Referenced by blockNode::output_stmt(), and procNode::procNode(). |
|
Definition at line 619 of file ast.h. Referenced by parse(). |
|
Exit scope.
Definition at line 188 of file unitnode.cc. References _symbol_level, SymbolTable< suespecNode * >::exit_scope(), SymbolTable< declNode * >::exit_scope(), CBZ::SyntaxError(), tags(), and types(). Referenced by procNode::define(), and blockNode::output_stmt(). |
|
Run fixup passes. Run the various fix-up passes, just as we would after parsing. Definition at line 166 of file unitnode.cc. References enum_value_walker::assign(), id_lookup_walker::fixup(), goto_label_walker::fixup(), and set_container_walker::fixup(). Referenced by parse(). |
|
Set the "gen" flow value. This value is used in dataflow analyses to store information that is generated at this node. Note that each node has exactly one "gen" flow value. In order to set the flow value to be empty, call this method with a value of NULL.
|
|
Get the "gen" flow value. This value is used in dataflow analyses to store information that is generated at this node. Note that each node has exactly one "gen" flow value.
|
|
Definition at line 620 of file ast.h. Referenced by CBZ::Error(), and CBZ::SyntaxError(). |
|
Definition at line 623 of file ast.h. Referenced by CBZ::Warning(). |
|
Definition at line 616 of file ast.h. Referenced by asm_gen_walker::at_unit(), NodeInfo::getType(), CBZ::is_file_included(), Linker::link(), vcgCCGPhase::run(), and vcgASTPhase::run(). |
|
Definition at line 614 of file ast.h. References instruction_list. Referenced by lir_gen_walker::at_unit(), asm_gen_walker::at_unit(), and lir_gen_walker::gen_global_decl(). |
|
Set the "kill" flow value. This value is used in dataflow analyses to store information that is killed at this node. Note that each node has exactly one "kill" flow value. To set the flow value to be empty, call this method with a value of NULL.
|
|
Get the "kill" flow value. This value is used in dataflow analyses to store information that is killed at this node. Note that each node has exactly one "kill" flow value.
|
|
Merge in external definitions.
|
|
Generate C code. Each subclass overrides this method to define how to produce the output C code. To use this method, pass an output_context and a null parent.
Implements Node. Definition at line 248 of file unitnode.cc. References _input_file, _symbol_level, def_list, def_list_p, defs(), and CBZ::Files. Referenced by output_c_phase::run(). |
|
Definition at line 617 of file ast.h. Referenced by output_c_phase::run(). |
|
Set the parenthesized boolean. This boolean determines whether this expression will be parenthesized in the output. Note that that the parentheses will always be added when they are needed to disambiguate the output. This variable only controls the use of "un-necessary" parentheses.
|
|
Get the parenthesized boolean.
Definition at line 252 of file ast.h. Referenced by exprNode::parens(), and CBZ::WarnAboutPrecedence(). |
|
Parse the input file. Run the parser on the input file using the given preprocessor flags. The resulting AST is stored in the various unitNode fields ( _defs, _types, etc.).
Definition at line 72 of file unitnode.cc. References _input_file, _open_input_file(), cbin, cbparse(), CBZ::current_unit, errors(), fixup(), CBZ::Preprocess, and CBZ::set_file(). |
|
Report node count statistics. The code can be configured to gather statistics about node usage according to type. This method prints the current state of that accounting information to standard out. Definition at line 184 of file node.cc. References Node::_count, Node::_t_count, Array, Attrib, Binary, Block, Break, Call, Case, Cast, Comma, Const, Continue, Decl, Do, Enum, Expr, For, Func, Goto, Id, If, Initializer, Label, Prim, Proc, Ptr, Return, Struct, sueSpec, Switch, Tdef, Ternary, Text, Unary, Undeclared, Union, and While. |
|
Definition at line 627 of file ast.h. References suespec_list. Referenced by vcgASTWalker::at_unit(), gcWalker::at_unit(), change(), blockNode::output_stmt(), NodeInfo::readsuef(), suespecNode::suespecNode(), and walk(). |
|
Definition at line 611 of file ast.h. Referenced by blockNode::output_stmt(). |
|
Definition at line 613 of file ast.h. Referenced by gcWalker::at_unit(), enter_scope(), exit_scope(), and sueNode::set_name_fields(). |
|
|
Return the node data type. This method returns the C data type of a node. Several different kinds of nodes contain typeNode pointers. This method is just a unified way to access them. It does not attempt to compute the type, it just returns whatever typeNode pointer resides on the node. The subclasses that have types return them, and the others return null.
Reimplemented in declNode, typeNode, exprNode, and operandNode. Definition at line 344 of file ast.h. Referenced by tree_visitor::at_block(), ReturnDismantle::at_return(), asm_gen_walker::doCallerSave(), and briggs_reg_alloc::interfere(). |
|
Definition at line 612 of file ast.h. Referenced by gcWalker::at_unit(), enter_scope(), exit_scope(), and declNode::set_type(). |
|
Definition at line 625 of file ast.h. References decl_list. Referenced by id_lookup_walker::at_call(), vcgASTWalker::at_unit(), gcWalker::at_unit(), change(), and walk(). |
|
Dispatch a Visitor. This abstract method is the entry point for the visitor design pattern. Each node subclass defines a visit() method that calls the appropriate at_ method in the visitor. For more information see the Visitor documentation.
Implements Node. Definition at line 204 of file unitnode.cc. References Visitor::at_unit(). |
|
Dispatch a Walker. This abstract method works much like the visitor, but instead walks the entire underlying subtree calling the appropriate at_ method at each node. For more information see the Walker documentation.
Implements Node. Definition at line 209 of file unitnode.cc. References Walker::at_unit(), Walker::Both, defs(), Walker::depth(), list_walker(), Walker::order(), Walker::Order, Walker::Postorder, Walker::Preorder, Walker::Subtree, suespecs(), and undef_funcs(). Referenced by reachingDefinitionsWalker::analyze(), TreeChecker::at_unit(), TreeChecker::check(), semcheck_walker::check(), clear_ids_walker::clear(), id_lookup_walker::fixup(), id_lookup_walker::fixup_and_return(), cfg_changer::generate_cfg(), Linker::link(), name_mangle_walker::mangle(), vcgCCGPhase::run(), vcgASTPhase::run(), and pointers_phase::run(). |
|
|
|
The external definitions. The list of external definitions (top level) parsed in from the source. This is the top of the AST. |
|
The number of errors. The number of errors encountered during parsing. |
|
Source file name. The name of the source file from which this AST was parsed. Definition at line 516 of file ast.h. Referenced by _open_input_file(), output(), and parse(). |
|
List of instructions for this translation unit. The list of instructions in this translation unit that do not have an associated procedure. Currently this is just global variable declarations and such. |
|
The output file name. The name of the output file to which the resulting code is written (only if the -c-code flag is given). |
|
struct/enum/union contents During parsing, we maintain a separate, global list of the contents of struct/enum/union definitions. The reason is that this avoids the problem of which declaration "owns" the content definition. Instead, all uses of the s/u/e type simply refer to one of the elements of this list. |
|
Depth of the scope.
Definition at line 486 of file ast.h. Referenced by enter_scope(), exit_scope(), and output(). |
|
Table of struct/union tags.
|
|
Table of type names.
|
|
Undeclared functions. This list will contain a function declaration for any functions not explicitly declared in the source. |
|
The number of warnings. The number of warnings encountered during parsing. |
|
Definition at line 116 of file node.cc. Referenced by gcWalker::delete_nodes(), and Node::~Node(). |
|
Definition at line 170 of file ast.h. Referenced by gcWalker::at_binary(), gcWalker::at_node(), gcWalker::delete_nodes(), and SymbolTable< T >::mark_nodes(). |
|
Definition at line 115 of file node.cc. Referenced by gcWalker::delete_nodes(), gcWalker::gcWalker(), and Node::Node(). |
Generated on August 27, 2003
Back to the C-Breeze home page