LLVM 20.0.0git
Public Member Functions | Friends | List of all members
llvm::LoopInfo Class Reference

#include "llvm/Analysis/LoopInfo.h"

Inheritance diagram for llvm::LoopInfo:
Inheritance graph
[legend]

Public Member Functions

 LoopInfo ()=default
 
 LoopInfo (const DominatorTreeBase< BasicBlock, false > &DomTree)
 
 LoopInfo (LoopInfo &&Arg)
 
LoopInfooperator= (LoopInfo &&RHS)
 
bool invalidate (Function &F, const PreservedAnalyses &PA, FunctionAnalysisManager::Invalidator &)
 Handle invalidation explicitly.
 
void erase (Loop *L)
 Update LoopInfo after removing the last backedge from a loop.
 
bool replacementPreservesLCSSAForm (Instruction *From, Value *To)
 Returns true if replacing From with To everywhere is guaranteed to preserve LCSSA form.
 
bool movementPreservesLCSSAForm (Instruction *Inst, Instruction *NewLoc)
 Checks if moving a specific instruction can break LCSSA in any loop.
 
bool wouldBeOutOfLoopUseRequiringLCSSA (const Value *V, const BasicBlock *ExitBB) const
 
- Public Member Functions inherited from llvm::LoopInfoBase< BasicBlock, Loop >
LoopInfoBaseoperator= (LoopInfoBase &&RHS)
 
 LoopInfoBase ()=default
 
 LoopInfoBase (LoopInfoBase &&Arg)
 
 ~LoopInfoBase ()
 
void releaseMemory ()
 
LoopAllocateLoop (ArgsTy &&...Args)
 
iterator begin () const
 
iterator end () const
 
reverse_iterator rbegin () const
 
reverse_iterator rend () const
 
bool empty () const
 
SmallVector< Loop *, 4 > getLoopsInPreorder () const
 Return all of the loops in the function in preorder across the loop nests, with siblings in forward program order.
 
SmallVector< Loop *, 4 > getLoopsInReverseSiblingPreorder () const
 Return all of the loops in the function in preorder across the loop nests, with siblings in reverse program order.
 
LoopgetLoopFor (const BasicBlock *BB) const
 Return the inner most loop that BB lives in.
 
const Loopoperator[] (const BasicBlock *BB) const
 Same as getLoopFor.
 
unsigned getLoopDepth (const BasicBlock *BB) const
 Return the loop nesting level of the specified block.
 
bool isLoopHeader (const BasicBlock *BB) const
 
const std::vector< Loop * > & getTopLevelLoops () const
 Return the top-level loops.
 
std::vector< Loop * > & getTopLevelLoopsVector ()
 Return the top-level loops.
 
LoopremoveLoop (iterator I)
 This removes the specified top-level loop from this loop info object.
 
void changeLoopFor (BasicBlock *BB, Loop *L)
 Change the top-level loop that contains BB to the specified loop.
 
void changeTopLevelLoop (Loop *OldLoop, Loop *NewLoop)
 Replace the specified loop in the top-level loops list with the indicated loop.
 
void addTopLevelLoop (Loop *New)
 This adds the specified loop to the collection of top-level loops.
 
void removeBlock (BasicBlock *BB)
 This method completely removes BB from all data structures, including all of the Loop objects it is nested in and our mapping from BasicBlocks to loops.
 
void analyze (const DominatorTreeBase< BasicBlock, false > &DomTree)
 Create the loop forest using a stable algorithm.
 
void print (raw_ostream &OS) const
 
void verify (const DominatorTreeBase< BasicBlock, false > &DomTree) const
 
void destroy (Loop *L)
 Destroy a loop that has been removed from the LoopInfo nest.
 

Friends

class LoopBase< BasicBlock, Loop >
 

Additional Inherited Members

- Public Types inherited from llvm::LoopInfoBase< BasicBlock, Loop >
typedef std::vector< Loop * >::const_iterator iterator
 iterator/begin/end - The interface to the top-level loops in the current function.
 
typedef std::vector< Loop * >::const_reverse_iterator reverse_iterator
 
- Static Public Member Functions inherited from llvm::LoopInfoBase< BasicBlock, Loop >
static bool isNotAlreadyContainedIn (const Loop *SubLoop, const Loop *ParentLoop)
 

Detailed Description

Definition at line 412 of file LoopInfo.h.

Constructor & Destructor Documentation

◆ LoopInfo() [1/3]

llvm::LoopInfo::LoopInfo ( )
default

◆ LoopInfo() [2/3]

llvm::LoopInfo::LoopInfo ( const DominatorTreeBase< BasicBlock, false > &  DomTree)
explicit

◆ LoopInfo() [3/3]

llvm::LoopInfo::LoopInfo ( LoopInfo &&  Arg)
inline

Definition at line 424 of file LoopInfo.h.

Member Function Documentation

◆ erase()

void LoopInfo::erase ( Loop L)

◆ invalidate()

bool LoopInfo::invalidate ( Function F,
const PreservedAnalyses PA,
FunctionAnalysisManager::Invalidator  
)

Handle invalidation explicitly.

Definition at line 878 of file LoopInfo.cpp.

References llvm::PreservedAnalyses::getChecker().

◆ movementPreservesLCSSAForm()

bool llvm::LoopInfo::movementPreservesLCSSAForm ( Instruction Inst,
Instruction NewLoc 
)
inline

Checks if moving a specific instruction can break LCSSA in any loop.

Return true if moving Inst to before NewLoc will break LCSSA, assuming that the function containing Inst and NewLoc is currently in LCSSA form.

Definition at line 470 of file LoopInfo.h.

References assert(), llvm::Instruction::getFunction(), llvm::ilist_detail::node_parent_access< NodeTy, ParentTy >::getParent(), llvm::User::operands(), and llvm::Value::uses().

Referenced by llvm::SCEVExpander::hoistIVInc().

◆ operator=()

LoopInfo & llvm::LoopInfo::operator= ( LoopInfo &&  RHS)
inline

Definition at line 425 of file LoopInfo.h.

References RHS.

◆ replacementPreservesLCSSAForm()

bool llvm::LoopInfo::replacementPreservesLCSSAForm ( Instruction From,
Value To 
)
inline

Returns true if replacing From with To everywhere is guaranteed to preserve LCSSA form.

Definition at line 444 of file LoopInfo.h.

References llvm::LoopBase< BlockT, LoopT >::contains(), From, and I.

Referenced by loadCSE(), replaceLoopPHINodesWithPreheaderValues(), llvm::rewriteLoopExitValues(), llvm::simplifyLoopAfterUnroll(), simplifyLoopInst(), simplifyOneLoop(), and llvm::UnrollRuntimeLoopRemainder().

◆ wouldBeOutOfLoopUseRequiringLCSSA()

bool LoopInfo::wouldBeOutOfLoopUseRequiringLCSSA ( const Value V,
const BasicBlock ExitBB 
) const

Definition at line 943 of file LoopInfo.cpp.

References I.

Referenced by cloneInstructionInExitBlock().

Friends And Related Function Documentation

◆ LoopBase< BasicBlock, Loop >

friend class LoopBase< BasicBlock, Loop >
friend

Definition at line 413 of file LoopInfo.h.


The documentation for this class was generated from the following files: