LLVM
8.0.1
|
A single entry single exit Region. More...
#include "llvm/Analysis/RegionInfo.h"
Classes | |
class | block_iterator_wrapper |
Public Types | |
enum | PrintStyle { PrintNone, PrintBB, PrintRN } |
PrintStyle - Print region in difference ways. More... | |
Public Types inherited from llvm::RegionNodeBase< Tr > | |
using | BlockT = typename Tr::BlockT |
using | RegionT = typename Tr::RegionT |
Public Member Functions | |
RegionBase (BlockT *Entry, BlockT *Exit, RegionInfoT *RI, DomTreeT *DT, RegionT *Parent=nullptr) | |
Create a new region. More... | |
RegionBase (const RegionBase &)=delete | |
RegionBase & | operator= (const RegionBase &)=delete |
~RegionBase () | |
Delete the Region and all its subregions. More... | |
BlockT * | getEntry () const |
Get the entry BasicBlock of the Region. More... | |
void | replaceEntry (BlockT *BB) |
Replace the entry basic block of the region with the new basic block. More... | |
void | replaceExit (BlockT *BB) |
Replace the exit basic block of the region with the new basic block. More... | |
void | replaceEntryRecursive (BlockT *NewEntry) |
Recursively replace the entry basic block of the region. More... | |
void | replaceExitRecursive (BlockT *NewExit) |
Recursively replace the exit basic block of the region. More... | |
BlockT * | getExit () const |
Get the exit BasicBlock of the Region. More... | |
RegionT * | getParent () const |
Get the parent of the Region. More... | |
RegionNodeT * | getNode () const |
Get the RegionNode representing the current Region. More... | |
unsigned | getDepth () const |
Get the nesting level of this Region. More... | |
bool | isTopLevelRegion () const |
Check if a Region is the TopLevel region. More... | |
RegionT * | getExpandedRegion () const |
Return a new (non-canonical) region, that is obtained by joining this region with its predecessors. More... | |
BlockT * | getEnteringBlock () const |
Return the first block of this region's single entry edge, if existing. More... | |
BlockT * | getExitingBlock () const |
Return the first block of this region's single exit edge, if existing. More... | |
bool | getExitingBlocks (SmallVectorImpl< BlockT *> &Exitings) const |
Collect all blocks of this region's single exit edge, if existing. More... | |
bool | isSimple () const |
Is this a simple region? More... | |
std::string | getNameStr () const |
Returns the name of the Region. More... | |
RegionInfoT * | getRegionInfo () const |
Return the RegionInfo object, that belongs to this Region. More... | |
void | print (raw_ostream &OS, bool printTree=true, unsigned level=0, PrintStyle Style=PrintNone) const |
Print the region. More... | |
void | dump () const |
Print the region to stderr. More... | |
bool | contains (const BlockT *BB) const |
Check if the region contains a BasicBlock. More... | |
bool | contains (const RegionT *SubRegion) const |
Check if the region contains another region. More... | |
bool | contains (const InstT *Inst) const |
Check if the region contains an Instruction. More... | |
bool | contains (const LoopT *L) const |
Check if the region contains a loop. More... | |
LoopT * | outermostLoopInRegion (LoopT *L) const |
Get the outermost loop in the region that contains a loop. More... | |
LoopT * | outermostLoopInRegion (LoopInfoT *LI, BlockT *BB) const |
Get the outermost loop in the region that contains a basic block. More... | |
RegionT * | getSubRegionNode (BlockT *BB) const |
Get the subregion that starts at a BasicBlock. More... | |
RegionNodeT * | getNode (BlockT *BB) const |
Get the RegionNode for a BasicBlock. More... | |
RegionNodeT * | getBBNode (BlockT *BB) const |
Get the BasicBlock RegionNode for a BasicBlock. More... | |
void | addSubRegion (RegionT *SubRegion, bool moveChildren=false) |
Add a new subregion to this Region. More... | |
RegionT * | removeSubRegion (RegionT *SubRegion) |
Remove a subregion from this Region. More... | |
void | transferChildrenTo (RegionT *To) |
Move all direct child nodes of this Region to another Region. More... | |
void | verifyRegion () const |
Verify if the region is a correct region. More... | |
void | clearNodeCache () |
Clear the cache for BB RegionNodes. More... | |
Public Member Functions inherited from llvm::RegionNodeBase< Tr > | |
RegionNodeBase (const RegionNodeBase &)=delete | |
RegionNodeBase & | operator= (const RegionNodeBase &)=delete |
RegionT * | getParent () const |
Get the parent Region of this RegionNode. More... | |
BlockT * | getEntry () const |
Get the entry BasicBlock of this RegionNode. More... | |
template<class T > | |
T * | getNodeAs () const |
Get the content of this RegionNode. More... | |
bool | isSubRegion () const |
Is this RegionNode a subregion? More... | |
template<> | |
BasicBlock * | getNodeAs () const |
template<> | |
Region * | getNodeAs () const |
template<> | |
MachineBasicBlock * | getNodeAs () const |
template<> | |
MachineRegion * | getNodeAs () const |
Friends | |
class | RegionInfoBase< Tr > |
Subregion Iterators | |
These iterators iterator over all subregions of this Region. | |
using | iterator = typename RegionSet::iterator |
using | const_iterator = typename RegionSet::const_iterator |
iterator | begin () |
iterator | end () |
const_iterator | begin () const |
const_iterator | end () const |
BasicBlock Iterators | |
These iterators iterate over all BasicBlocks that are contained in this Region. The iterator also iterates over BasicBlocks that are elements of a subregion of this Region. It is therefore called a flat iterator. | |
using | block_iterator = block_iterator_wrapper< false > |
using | const_block_iterator = block_iterator_wrapper< true > |
using | block_range = iterator_range< block_iterator > |
using | const_block_range = iterator_range< const_block_iterator > |
block_iterator | block_begin () |
block_iterator | block_end () |
const_block_iterator | block_begin () const |
const_block_iterator | block_end () const |
block_range | blocks () |
Returns a range view of the basic blocks in the region. More... | |
const_block_range | blocks () const |
Returns a range view of the basic blocks in the region. More... | |
Element Iterators | |
These iterators iterate over all BasicBlock and subregion RegionNodes that are direct children of this Region. It does not iterate over any RegionNodes that are also element of a subregion of this Region. | |
using | element_iterator = df_iterator< RegionNodeT *, df_iterator_default_set< RegionNodeT * >, false, GraphTraits< RegionNodeT * > > |
using | const_element_iterator = df_iterator< const RegionNodeT *, df_iterator_default_set< const RegionNodeT * >, false, GraphTraits< const RegionNodeT * > > |
element_iterator | element_begin () |
element_iterator | element_end () |
iterator_range< element_iterator > | elements () |
const_element_iterator | element_begin () const |
const_element_iterator | element_end () const |
iterator_range< const_element_iterator > | elements () const |
Additional Inherited Members | |
Protected Member Functions inherited from llvm::RegionNodeBase< Tr > | |
RegionNodeBase (RegionT *Parent, BlockT *Entry, bool isSubRegion=false) | |
Create a RegionNode. More... | |
A single entry single exit Region.
A Region is a connected subgraph of a control flow graph that has exactly two connections to the remaining graph. It can be used to analyze or optimize parts of the control flow graph.
A simple Region is connected to the remaining graph by just two edges. One edge entering the Region and another one leaving the Region.
An extended Region (or just Region) is a subgraph that can be transform into a simple Region. The transformation is done by adding BasicBlocks that merge several entry or exit edges so that after the merge just one entry and one exit edge exists.
The Entry of a Region is the first BasicBlock that is passed after entering the Region. It is an element of the Region. The entry BasicBlock dominates all BasicBlocks in the Region.
The Exit of a Region is the first BasicBlock that is passed after leaving the Region. It is not an element of the Region. The exit BasicBlock, postdominates all BasicBlocks in the Region.
A canonical Region cannot be constructed by combining smaller Regions.
Region A is the parent of Region B, if B is completely contained in A.
Two canonical Regions either do not intersect at all or one is the parent of the other.
The Program Structure Tree is a graph (V, E) where V is the set of Regions in the control flow graph and E is the parent relation of these Regions.
Example:
/// A simple control flow graph, that contains two regions. /// /// 1 /// / | /// 2 | /// / \ 3 /// 4 5 | /// | | | /// 6 7 8 /// \ | / /// \ |/ Region A: 1 -> 9 {1,2,3,4,5,6,7,8} /// 9 Region B: 2 -> 9 {2,4,5,6,7} ///
You can obtain more examples by either calling <tt> "opt -regions -analyze anyprogram.ll" </tt> or <tt> "opt -view-regions-only anyprogram.ll" </tt> on any LLVM file you are interested in. The first call returns a textual representation of the program structure tree, the second one creates a graphical representation using graphviz.
Definition at line 68 of file RegionInfo.h.
using llvm::RegionBase< Tr >::block_iterator = block_iterator_wrapper<false> |
Definition at line 609 of file RegionInfo.h.
using llvm::RegionBase< Tr >::block_range = iterator_range<block_iterator> |
Definition at line 621 of file RegionInfo.h.
using llvm::RegionBase< Tr >::const_block_iterator = block_iterator_wrapper<true> |
Definition at line 610 of file RegionInfo.h.
using llvm::RegionBase< Tr >::const_block_range = iterator_range<const_block_iterator> |
Definition at line 622 of file RegionInfo.h.
using llvm::RegionBase< Tr >::const_element_iterator = df_iterator<const RegionNodeT *, df_iterator_default_set<const RegionNodeT *>, false, GraphTraits<const RegionNodeT *> > |
Definition at line 650 of file RegionInfo.h.
using llvm::RegionBase< Tr >::const_iterator = typename RegionSet::const_iterator |
Definition at line 560 of file RegionInfo.h.
using llvm::RegionBase< Tr >::element_iterator = df_iterator<RegionNodeT *, df_iterator_default_set<RegionNodeT *>, false, GraphTraits<RegionNodeT *> > |
Definition at line 645 of file RegionInfo.h.
using llvm::RegionBase< Tr >::iterator = typename RegionSet::iterator |
Definition at line 559 of file RegionInfo.h.
enum llvm::RegionBase::PrintStyle |
PrintStyle - Print region in difference ways.
Enumerator | |
---|---|
PrintNone | |
PrintBB | |
PrintRN |
Definition at line 431 of file RegionInfo.h.
llvm::RegionBase< Tr >::RegionBase | ( | BlockT * | Entry, |
BlockT * | Exit, | ||
RegionInfoT * | RI, | ||
DomTreeT * | DT, | ||
RegionT * | Parent = nullptr |
||
) |
Create a new region.
Entry | The entry basic block of the region. |
Exit | The exit basic block of the region. |
RI | The region info object that is managing this region. |
DT | The dominator tree of the current function. |
Parent | The surrounding region or NULL if this is a top level region. |
|
delete |
llvm::RegionBase< Tr >::~RegionBase | ( | ) |
Delete the Region and all its subregions.
Definition at line 51 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::addSubRegion | ( | RegionT * | SubRegion, |
bool | moveChildren = false |
||
) |
Add a new subregion to this Region.
SubRegion | The new subregion that will be added. |
moveChildren | Move the children of this region, that are also contained in SubRegion into SubRegion. |
Definition at line 394 of file RegionInfoImpl.h.
|
inline |
Definition at line 562 of file RegionInfo.h.
Referenced by getBranchInsertPoint().
|
inline |
Definition at line 565 of file RegionInfo.h.
|
inline |
Definition at line 612 of file RegionInfo.h.
|
inline |
Definition at line 616 of file RegionInfo.h.
|
inline |
Definition at line 614 of file RegionInfo.h.
|
inline |
Definition at line 619 of file RegionInfo.h.
|
inline |
Returns a range view of the basic blocks in the region.
Definition at line 625 of file RegionInfo.h.
Referenced by llvm::RGPassManager::dumpPassStructure(), and hasOnlyUniformBranches().
|
inline |
Returns a range view of the basic blocks in the region.
This is the 'const' version of the range view.
Definition at line 632 of file RegionInfo.h.
void llvm::RegionBase< Tr >::clearNodeCache | ( | ) |
Clear the cache for BB RegionNodes.
After calling this function the BasicBlock RegionNodes will be stored at different memory locations. RegionNodes obtained before this function is called are therefore not comparable to RegionNodes abtained afterwords.
Definition at line 533 of file RegionInfoImpl.h.
bool llvm::RegionBase< Tr >::contains | ( | const BlockT * | BB | ) | const |
Check if the region contains a BasicBlock.
BB | The BasicBlock that might be contained in this Region. |
Definition at line 105 of file RegionInfoImpl.h.
Referenced by assertBranchOrSelectConditionHoisted(), llvm::createControlHeightReductionLegacyPass(), getBranchInsertPoint(), and SortBlocks().
|
inline |
Check if the region contains another region.
SubRegion | The region that might be contained in this Region. |
Definition at line 456 of file RegionInfo.h.
|
inline |
Check if the region contains an Instruction.
Inst | The Instruction that might be contained in this region. |
Definition at line 471 of file RegionInfo.h.
Referenced by llvm::RegionBase< RegionTraits< Function > >::contains().
bool llvm::RegionBase< Tr >::contains | ( | const LoopT * | L | ) | const |
Check if the region contains a loop.
L | The loop that might be contained in this region. |
Definition at line 122 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::dump | ( | ) | const |
Print the region to stderr.
Definition at line 527 of file RegionInfoImpl.h.
RegionBase< Tr >::element_iterator llvm::RegionBase< Tr >::element_begin | ( | ) |
Definition at line 315 of file RegionInfoImpl.h.
RegionBase< Tr >::const_element_iterator llvm::RegionBase< Tr >::element_begin | ( | ) | const |
Definition at line 326 of file RegionInfoImpl.h.
RegionBase< Tr >::element_iterator llvm::RegionBase< Tr >::element_end | ( | ) |
Definition at line 320 of file RegionInfoImpl.h.
RegionBase< Tr >::const_element_iterator llvm::RegionBase< Tr >::element_end | ( | ) | const |
Definition at line 333 of file RegionInfoImpl.h.
|
inline |
Definition at line 654 of file RegionInfo.h.
Referenced by getBranchInsertPoint(), and hasOnlyUniformBranches().
|
inline |
Definition at line 660 of file RegionInfo.h.
|
inline |
Definition at line 563 of file RegionInfo.h.
Referenced by getBranchInsertPoint().
|
inline |
Definition at line 566 of file RegionInfo.h.
Tr::RegionNodeT * llvm::RegionBase< Tr >::getBBNode | ( | BlockT * | BB | ) | const |
Get the BasicBlock RegionNode for a BasicBlock.
BB | The BasicBlock for which the RegionNode is requested. |
Definition at line 360 of file RegionInfoImpl.h.
unsigned llvm::RegionBase< Tr >::getDepth | ( | ) | const |
Get the nesting level of this Region.
An toplevel Region has depth 0.
Definition at line 450 of file RegionInfoImpl.h.
Referenced by llvm::DOTGraphTraits< RegionInfo * >::printRegionCluster().
RegionBase< Tr >::BlockT * llvm::RegionBase< Tr >::getEnteringBlock | ( | ) | const |
Return the first block of this region's single entry edge, if existing.
Definition at line 164 of file RegionInfoImpl.h.
|
inline |
Get the entry BasicBlock of the Region.
Definition at line 324 of file RegionInfo.h.
Referenced by assertBranchOrSelectConditionHoisted(), getBranchInsertPoint(), llvm::VPBlockBase::getEntryBasicBlock(), hasAtLeastTwoBiasedBranches(), hasOnlyUniformBranches(), hoistScopeConditions(), llvm::RGPassManager::runOnFunction(), and llvm::RegionPass::skipRegion().
|
inline |
Get the exit BasicBlock of the Region.
Definition at line 361 of file RegionInfo.h.
Referenced by assertBranchOrSelectConditionHoisted(), checkBiasedBranch(), getBranchInsertPoint(), and llvm::VPBlockBase::getExitBasicBlock().
RegionBase< Tr >::BlockT * llvm::RegionBase< Tr >::getExitingBlock | ( | ) | const |
Return the first block of this region's single exit edge, if existing.
Definition at line 205 of file RegionInfoImpl.h.
bool llvm::RegionBase< Tr >::getExitingBlocks | ( | SmallVectorImpl< BlockT *> & | Exitings | ) | const |
Collect all blocks of this region's single exit edge, if existing.
Definition at line 182 of file RegionInfoImpl.h.
Tr::RegionT * llvm::RegionBase< Tr >::getExpandedRegion | ( | ) | const |
Return a new (non-canonical) region, that is obtained by joining this region with its predecessors.
Definition at line 460 of file RegionInfoImpl.h.
std::string llvm::RegionBase< Tr >::getNameStr | ( | ) | const |
Returns the name of the Region.
Definition at line 231 of file RegionInfoImpl.h.
Referenced by getBranchInsertPoint(), getSelectsInScope(), and llvm::RGPassManager::runOnFunction().
|
inline |
Get the RegionNode representing the current Region.
Definition at line 372 of file RegionInfo.h.
Tr::RegionNodeT * llvm::RegionBase< Tr >::getNode | ( | BlockT * | BB | ) | const |
Get the RegionNode for a BasicBlock.
BB | The BasicBlock at which the RegionNode should start. |
Definition at line 376 of file RegionInfoImpl.h.
|
inline |
Get the parent of the Region.
Definition at line 366 of file RegionInfo.h.
Referenced by createBBSelectReg(), and llvm::createControlHeightReductionLegacyPass().
|
inline |
Return the RegionInfo object, that belongs to this Region.
Definition at line 428 of file RegionInfo.h.
Tr::RegionT * llvm::RegionBase< Tr >::getSubRegionNode | ( | BlockT * | BB | ) | const |
Get the subregion that starts at a BasicBlock.
BB | The BasicBlock the subregion should start. |
Definition at line 339 of file RegionInfoImpl.h.
bool llvm::RegionBase< Tr >::isSimple | ( | ) | const |
Is this a simple region?
A region is simple if it has exactly one exit and one entry edge.
Definition at line 226 of file RegionInfoImpl.h.
Referenced by llvm::DOTGraphTraits< RegionInfo * >::printRegionCluster(), llvm::MachineRegionInfo::updateStatistics(), and llvm::RegionInfo::updateStatistics().
|
inline |
Check if a Region is the TopLevel region.
The toplevel region represents the whole function.
Definition at line 387 of file RegionInfo.h.
Referenced by getBranchInsertPoint(), and hasOnlyUniformBranches().
|
delete |
Tr::LoopT * llvm::RegionBase< Tr >::outermostLoopInRegion | ( | LoopT * | L | ) | const |
Get the outermost loop in the region that contains a loop.
Find for a Loop L the outermost loop OuterL that is a parent loop of L and is itself contained in the region.
L | The loop the lookup is started. |
Definition at line 144 of file RegionInfoImpl.h.
Tr::LoopT * llvm::RegionBase< Tr >::outermostLoopInRegion | ( | LoopInfoT * | LI, |
BlockT * | BB | ||
) | const |
Get the outermost loop in the region that contains a basic block.
Find for a basic block BB the outermost loop L that contains BB and is itself contained in the region.
LI | A pointer to a LoopInfo analysis. |
BB | The basic block surrounded by the loop. |
Definition at line 156 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::print | ( | raw_ostream & | OS, |
bool | printTree = true , |
||
unsigned | level = 0 , |
||
PrintStyle | Style = PrintNone |
||
) | const |
Print the region.
OS | The output stream the Region is printed to. |
printTree | Print also the tree of subregions. |
level | The indentation level used for printing. |
Definition at line 491 of file RegionInfoImpl.h.
Tr::RegionT * llvm::RegionBase< Tr >::removeSubRegion | ( | RegionT * | SubRegion | ) |
Remove a subregion from this Region.
The subregion is not deleted, as it will probably be inserted into another region.
SubRegion | The SubRegion that will be removed. |
Definition at line 437 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::replaceEntry | ( | BlockT * | BB | ) |
Replace the entry basic block of the region with the new basic block.
BB | The new entry basic block of the region. |
Definition at line 58 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::replaceEntryRecursive | ( | BlockT * | NewEntry | ) |
Recursively replace the entry basic block of the region.
This function replaces the entry basic block with a new basic block. It also updates all child regions that have the same entry basic block as this region.
NewEntry | The new entry basic block. |
Definition at line 69 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::replaceExit | ( | BlockT * | BB | ) |
Replace the exit basic block of the region with the new basic block.
BB | The new exit basic block of the region. |
Definition at line 63 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::replaceExitRecursive | ( | BlockT * | NewExit | ) |
Recursively replace the exit basic block of the region.
This function replaces the exit basic block with a new basic block. It also updates all child regions that have the same exit basic block as this region.
NewExit | The new exit basic block. |
Definition at line 87 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::transferChildrenTo | ( | RegionT * | To | ) |
Move all direct child nodes of this Region to another Region.
To | The Region the child nodes will be transferred to. |
Definition at line 385 of file RegionInfoImpl.h.
void llvm::RegionBase< Tr >::verifyRegion | ( | ) | const |
Verify if the region is a correct region.
Check if this is a correctly build Region. This is an expensive check, as the complete CFG of the Region will be walked.
Definition at line 295 of file RegionInfoImpl.h.
Referenced by llvm::RGPassManager::runOnFunction().
|
friend |
Definition at line 257 of file RegionInfo.h.