Package com.ibm.wala.cfg
Interface ControlFlowGraph<I,T extends IBasicBlock<I>>
-
- All Superinterfaces:
EdgeManager<T>,Graph<T>,Iterable<T>,NodeManager<T>,NumberedEdgeManager<T>,NumberedGraph<T>,NumberedNodeManager<T>
- All Known Implementing Classes:
AbstractCFG,AstInducedCFG,AstTranslator.AstCFG,DelegatingCFG,DexCFG,ExplodedControlFlowGraph,InducedCFG,MutableCFG,PrunedCFG,ShrikeCFG,SSACFG
public interface ControlFlowGraph<I,T extends IBasicBlock<I>> extends NumberedGraph<T>
An interface that is common to the Shrike and SSA CFG implementations.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Tentry()Return the entry basic block in the CFGTexit()TgetBlockForInstruction(int index)BitVectorgetCatchBlocks()Collection<T>getExceptionalPredecessors(T b)The order of blocks returned should be arbitrary but deterministic.List<T>getExceptionalSuccessors(T b)The order of blocks returned must indicate the exception-handling scope.I[]getInstructions()IMethodgetMethod()Collection<T>getNormalPredecessors(T b)The order of blocks returned should be arbitrary but deterministic.Collection<T>getNormalSuccessors(T b)The order of blocks returned should be arbitrary but deterministic.intgetProgramCounter(int index)TODO: move this into IR?-
Methods inherited from interface com.ibm.wala.util.graph.EdgeManager
addEdge, getPredNodeCount, getPredNodes, getSuccNodeCount, getSuccNodes, hasEdge, removeAllIncidentEdges, removeEdge, removeIncomingEdges, removeOutgoingEdges
-
Methods inherited from interface com.ibm.wala.util.graph.Graph
removeNodeAndEdges
-
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Methods inherited from interface com.ibm.wala.util.graph.NodeManager
addNode, containsNode, getNumberOfNodes, iterator, removeNode
-
Methods inherited from interface com.ibm.wala.util.graph.NumberedEdgeManager
getPredNodeNumbers, getSuccNodeNumbers
-
Methods inherited from interface com.ibm.wala.util.graph.NumberedNodeManager
getMaxNumber, getNode, getNumber, iterateNodes
-
-
-
-
Method Detail
-
entry
T entry()
Return the entry basic block in the CFG
-
exit
T exit()
- Returns:
- the synthetic exit block for the cfg
-
getCatchBlocks
BitVector getCatchBlocks()
- Returns:
- the indices of the catch blocks, as a bit vector
-
getBlockForInstruction
T getBlockForInstruction(int index)
- Parameters:
index- an instruction index- Returns:
- the basic block which contains this instruction.
-
getInstructions
I[] getInstructions()
- Returns:
- the instructions of this CFG, as an array.
-
getProgramCounter
int getProgramCounter(int index)
TODO: move this into IR?- Parameters:
index- an instruction index- Returns:
- the program counter (bytecode index) corresponding to that instruction
-
getMethod
IMethod getMethod()
- Returns:
- the Method this CFG represents
-
getExceptionalSuccessors
List<T> getExceptionalSuccessors(T b)
The order of blocks returned must indicate the exception-handling scope. So the first block is the first candidate catch block, and so on. With this invariant one can compute the exceptional control flow for a given exception type.- Returns:
- the basic blocks which may be reached from b via exceptional control flow
-
getNormalSuccessors
Collection<T> getNormalSuccessors(T b)
The order of blocks returned should be arbitrary but deterministic.- Returns:
- the basic blocks which may be reached from b via normal control flow
-
getExceptionalPredecessors
Collection<T> getExceptionalPredecessors(T b)
The order of blocks returned should be arbitrary but deterministic.- Returns:
- the basic blocks from which b may be reached via exceptional control flow
-
getNormalPredecessors
Collection<T> getNormalPredecessors(T b)
The order of blocks returned should be arbitrary but deterministic.- Returns:
- the basic blocks from which b may be reached via normal control flow
-
-