|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
basicblockNode Class ReferenceBasic block.
More...
|
Garbage collection. | |
bool | mark |
node_list | nodes |
map< Node *, bool > | deleted_nodes |
Public Member Functions | |
basicblockNode (decl_list *decls, stmt_list *stmts, const Coord left_coord=Coord::Unknown, const Coord right_brace=Coord::Unknown) | |
Create a new basic block. | |
virtual | ~basicblockNode () |
Destroy a basicblockNode. | |
virtual Node * | clone () const |
Clone the input node. | |
typeNode * | base_type (bool TdefIndir) const |
Return the base data type of a node. | |
virtual void | dataflow (FlowVal *v, FlowProblem &fp) |
Run the dataflow analyzer. | |
virtual void | output_stmt (output_context &ct, Node *par) |
Output a statement. | |
virtual void | output (output_context &ct, Node *par) |
Generate C code. | |
void | output_comment (output_context &ct) |
virtual typeNode * | type () const |
Return the node data type. | |
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. | |
basicblock_list & | preds () |
const basicblock_list & | preds () const |
basicblock_list & | succs () |
const basicblock_list & | succs () const |
basicblockNode * | parent () const |
void | parent (basicblockNode *par) |
basicblock_list & | children () |
const basicblock_list & | children () const |
algorithm_info * | info () const |
void | info (algorithm_info *i) |
int | dfn () const |
void | dfn (int d) |
FlowVal * | at_entry () const |
void | at_entry (FlowVal *ae) |
FlowVal * | at_exit () const |
void | at_exit (FlowVal *ae) |
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. | |
decl_list & | decls () |
const decl_list & | decls () const |
stmt_list & | stmts () |
const stmt_list & | stmts () const |
Coord | right_brace () const |
void | right_brace (const Coord right_brace) |
Accessors | |
Methods to get and set fields in the class. | |
string & | comment () |
text_list & | pragmas () |
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 | |
blockNode * | toBlock (stmtNode *stmt, Coord coord) |
Convert to block. | |
void | report () |
Report node count statistics. | |
Private Attributes | |
basicblock_list | _preds |
the control-flow predecessors | |
basicblock_list | _succs |
the control-flow successors | |
basicblockNode * | _parent |
the parent in the dominator tree | |
basicblock_list | _children |
the children in the dominator tree | |
algorithm_info * | _info |
algorithm info | |
int | _dfn |
depth-first numbering | |
FlowVal * | _at_entry |
dataflow analysis entry value | |
FlowVal * | _at_exit |
dataflow analysis exit value |
This subclass of blockNode represents code in basic block form to support the construction of a control-flow graph and algorithms based on that graph. Initial parsing does not produce this form. To convert the AST into a control-flow graph, first dismantle the code (using the Dismantle class) then invoke the control-flow graph algorithm (using the cfg_changer). This form also supports several other analysis algorithms, such as dominators (using the Dominators class), dominance frontiers (using the DominanceFrontiers class) and pointer analysis (using the Pointers class).
Each basicblockNode has added fields for specifying control-flow predecessors and successors, as well as fields for representing a dominator tree.
The NodeType is Block (from the superclass)
Definition at line 4571 of file ast.h.
|
Create a new basic block. The basic block has the given declarations and statements (see the constructor for blockNode). By default, all the lists are empty, and the other references are null.
Definition at line 43 of file basicblocknode.cc. Referenced by clone(). |
|
Destroy a basicblockNode.
Definition at line 60 of file basicblocknode.cc. |
|
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. |
|
|
|
|
|
Reimplemented from stmtNode. |
|
Reimplemented from stmtNode. |
|
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 from Node. Definition at line 83 of file blocknode.cc. |
|
Dispatch a Changer. This abstract method works much the walker, but allows the tree to be changed.
Reimplemented from blockNode. Definition at line 86 of file basicblocknode.cc. References Changer::at_basicblock(), Changer::Both, change_list(), blockNode::decls(), Changer::order(), Changer::Order, Changer::Postorder, Changer::Preorder, and blockNode::stmts(). |
|
Definition at line 4667 of file ast.h. References basicblock_list. |
|
Definition at line 4666 of file ast.h. References basicblock_list. Referenced by Pointers::analyze_procedure(), DominanceFrontiers::compute_dominance_frontiers(), DFPreds::compute_dominance_frontiers(), procedureInfo::dfs_dominators(), Dominators::dominator_tree(), and SSA::search(). |
|
Clone the input node. This is not a "deep" clone, so be careful. For a deep clone, use the ref_clone_changer class.
Reimplemented from blockNode. Definition at line 4700 of file ast.h. References basicblockNode(). Referenced by reachingDefinitionsWalker::at_basicblock(), and reachingDefinitionsWalker::at_proc(). |
|
Definition at line 4368 of file ast.h. Referenced by DefUseWalker::at_basicblock(), reachingGenKillWalker::at_proc(), copyPropChanger::at_proc(), deadcodeChanger::at_threeAddr(), LivenessComments::comment_stmt(), loopTree::depthFirstSearch(), loopTree::findBody(), stmtNode::output_comment(), and Dominators::print(). |
|
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 120 of file blocknode.cc. References dataflow_forward_list(), dataflow_reverse_list(), blockNode::decls(), FlowProblem::flow_block(), FlowProblem::forward(), and blockNode::stmts(). Referenced by whileNode::dataflow(), switchNode::dataflow(), procNode::dataflow(), labelNode::dataflow(), ifNode::dataflow(), forNode::dataflow(), doNode::dataflow(), and caseNode::dataflow(). |
|
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 4504 of file ast.h. References decl_list. |
|
|
|
|
|
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 4669 of file ast.h. Referenced by Dominators::depth_first_search(), Dominators::Dominators(), and SSA::SSA(). |
|
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.
|
|
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 55 of file stmtnode.cc. References Block, output_context::new_line(), stmtNode::output_comment(), stmtNode::output_stmt(), and Node::typ(). Referenced by Pointers::analyze_procedure(), deadcodeChanger::at_threeAddr(), procedureInfo::block_position(), procNode::output(), whileNode::output_stmt(), switchNode::output_stmt(), loopTreeNode::output_stmt(), labelNode::output_stmt(), ifNode::output_stmt(), forNode::output_stmt(), doNode::output_stmt(), caseNode::output_stmt(), precisionAnalyzer::record(), and precisionAnalyzer::report(). |
|
Definition at line 65 of file stmtnode.cc. References stmtNode::comment(), output_context::indent_in(), output_context::indent_out(), and output_context::new_line(). Referenced by stmtNode::output(), and blockNode::output_stmt(). |
|
Output a statement.
Implements stmtNode. Definition at line 144 of file blocknode.cc. References Block, CBZ::current_unit, blockNode::decls(), unitNode::enter_scope(), unitNode::exit_scope(), If, output_context::indent_in(), output_context::indent_out(), output_context::new_line(), NodeType, stmtNode::output_comment(), output_list(), Proc, blockNode::stmts(), suespec_list_p, unitNode::suespecs(), unitNode::symbol_level(), and Node::typ(). |
|
|
|
Definition at line 4663 of file ast.h. Referenced by loopTree::commonDominator(), Dominators::dominates(), Dominators::dominator_tree(), Dominators::print(), and procLocation::procLocation(). |
|
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(). |
|
Definition at line 4377 of file ast.h. References text_list. |
|
Definition at line 4658 of file ast.h. References basicblock_list. |
|
|
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 4507 of file ast.h. References stmt_list. |
|
|
Definition at line 4661 of file ast.h. References basicblock_list. |
|
|
Convert to block. This method is used primarily by the parser to make sure that all branch bodies and loop bodies are represented by blockNodes, even if they aren't in the source code. For example:
if (cond) x = x + 1;
Even though the body of the branch is just a single statement, we build a block containing that one statement:
if (cond) { x = x + 1; }
This simplifies many other kinds of processing. For example, it makes it easy to add statements to the branch body. The method looks at the type of the input statement. If it is already a compound statement, it is return unchanged. Otherwise, it creates a compound statement, puts the statement in it, and then returns the compound statement.
Definition at line 68 of file blocknode.cc. References Block, blockNode::blockNode(), stmt_list, blockNode::stmts(), and Node::typ(). |
|
|
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(). |
|
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.
Reimplemented from blockNode. Definition at line 62 of file basicblocknode.cc. References Visitor::at_basicblock(). |
|
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.
Reimplemented from blockNode. Definition at line 67 of file basicblocknode.cc. References Walker::at_basicblock(), Walker::Both, blockNode::decls(), Walker::depth(), list_walker(), Walker::order(), Walker::Order, Walker::Postorder, Walker::Preorder, blockNode::stmts(), and Walker::Subtree. Referenced by SSA::place_phi_functions(). |
|
dataflow analysis entry value This field is used by the dataflow analysis framework to accumulate the flow-value coming into the basic block from it's predecessors. Sometimes, it's referred to as IN[B]. |
|
dataflow analysis exit value This field is used by the dataflow analysis framework to hold the flow value exiting the basic block. It is typically computed by passing the _at_entry through the transfer functions of the statements in the block. Sometimes, it's referred to as OUT[B]. Reimplemented from stmtNode. |
|
the children in the dominator tree This is the set of basic blocks that are immediately dominated by this one. |
|
depth-first numbering Each basic block can be assignmed a number, usually in depth-first order. This is useful for building a bit-vector representation of sets of basic blocks. |
|
algorithm info This field is used by various algorithms to temporarily attach some information to a basic block. |
|
the parent in the dominator tree This is the immediate dominator of this basic block. |
|
the control-flow predecessors
|
|
the control-flow successors
|
|
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