LLVM  4.0.0
Classes | Public Member Functions | Static Public Member Functions | List of all members
llvm::PreservedAnalyses Class Reference

A set of analyses that are preserved following a run of a transformation pass. More...

#include <PassManager.h>

Classes

class  PreservedAnalysisChecker
 A checker object that makes it easy to query for whether an analysis or some set covering it is preserved. More...
 

Public Member Functions

template<typename AnalysisT >
void preserve ()
 Mark an analysis as preserved. More...
 
void preserve (AnalysisKey *ID)
 Given an analysis's ID, mark the analysis as preserved, adding it to the set. More...
 
template<typename AnalysisSetT >
void preserveSet ()
 Mark an analysis set as preserved. More...
 
void preserveSet (AnalysisSetKey *ID)
 Mark an analysis set as preserved using its ID. More...
 
template<typename AnalysisT >
void abandon ()
 Mark an analysis as abandoned. More...
 
void abandon (AnalysisKey *ID)
 Mark an analysis as abandoned using its ID. More...
 
void intersect (const PreservedAnalyses &Arg)
 Intersect this set with another in place. More...
 
void intersect (PreservedAnalyses &&Arg)
 Intersect this set with a temporary other set in place. More...
 
template<typename AnalysisT >
PreservedAnalysisChecker getChecker () const
 Build a checker for this PreservedAnalyses and the specified analysis type. More...
 
PreservedAnalysisChecker getChecker (AnalysisKey *ID) const
 Build a checker for this PreservedAnalyses and the specified analysis ID. More...
 
bool areAllPreserved () const
 Test whether all analyses are preserved (and none are abandoned). More...
 
template<typename AnalysisSetT >
bool allAnalysesInSetPreserved () const
 Directly test whether a set of analyses is preserved. More...
 
bool allAnalysesInSetPreserved (AnalysisSetKey *SetID) const
 Directly test whether a set of analyses is preserved. More...
 

Static Public Member Functions

static PreservedAnalyses none ()
 Convenience factory function for the empty preserved set. More...
 
static PreservedAnalyses all ()
 Construct a special preserved set that preserves all passes. More...
 

Detailed Description

A set of analyses that are preserved following a run of a transformation pass.

Transformation passes build and return these objects to communicate which analyses are still valid after the transformation. For most passes this is fairly simple: if they don't change anything all analyses are preserved, otherwise only a short list of analyses that have been explicitly updated are preserved.

This class also lets transformation passes mark abstract sets of analyses as preserved. A transformation that (say) does not alter the CFG can indicate such by marking a particular AnalysisSetKey as preserved, and then analyses can query whether that AnalysisSetKey is preserved.

Finally, this class can represent an "abandoned" analysis, which is not preserved even if it would be covered by some abstract set of analyses.

Given a PreservedAnalyses object, an analysis will typically want to figure out whether it is preserved. In the example below, MyAnalysisType is preserved if it's not abandoned, and (a) it's explicitly marked as preserved, (b), the set AllAnalysesOn<MyIRUnit> is preserved, or (c) both AnalysisSetA and AnalysisSetB are preserved.

``` auto PAC = PA.getChecker<MyAnalysisType>(); if (PAC.preserved() || PAC.preservedSet<AllAnalysesOn<MyIRUnit>>() || (PAC.preservedSet<AnalysisSetA>() && PAC.preservedSet<AnalysisSetB>())) { // The analysis has been successfully preserved ... } ```

Definition at line 107 of file PassManager.h.

Member Function Documentation

template<typename AnalysisT >
void llvm::PreservedAnalyses::abandon ( )
inline

Mark an analysis as abandoned.

An abandoned analysis is not preserved, even if it is nominally covered by some other set or was previously explicitly marked as preserved.

Note that you can only abandon a specific analysis, not a set of analyses.

Definition at line 153 of file PassManager.h.

References abandon().

Referenced by abandon(), and llvm::InvalidateAnalysisPass< AnalysisT >::run().

void llvm::PreservedAnalyses::abandon ( AnalysisKey ID)
inline

Mark an analysis as abandoned using its ID.

An abandoned analysis is not preserved, even if it is nominally covered by some other set or was previously explicitly marked as preserved.

Note that you can only abandon a specific analysis, not a set of analyses.

Definition at line 162 of file PassManager.h.

References llvm::SmallPtrSetImpl< PtrType >::erase().

static PreservedAnalyses llvm::PreservedAnalyses::all ( )
inlinestatic

Construct a special preserved set that preserves all passes.

Definition at line 113 of file PassManager.h.

References llvm::SmallPtrSetImpl< PtrType >::insert().

Referenced by INITIALIZE_PASS(), llvm::CorrelatedValuePropagationPass::run(), llvm::LowerGuardIntrinsicPass::run(), llvm::NewGVNPass::run(), llvm::LibCallsShrinkWrapPass::run(), llvm::SampleProfileLoaderPass::run(), llvm::GCOVProfilerPass::run(), llvm::PromotePass::run(), llvm::CrossDSOCFIPass::run(), llvm::ForceFunctionAttrsPass::run(), llvm::LowerAtomicPass::run(), llvm::LowerInvokePass::run(), llvm::PGOInstrumentationGen::run(), llvm::DCEPass::run(), llvm::IVUsersPrinterPass::run(), llvm::AddDiscriminatorsPass::run(), llvm::LoopAccessInfoPrinterPass::run(), llvm::LoopInstSimplifyPass::run(), llvm::LoopUnrollPass::run(), llvm::BreakCriticalEdgesPass::run(), llvm::PartialInlinerPass::run(), llvm::PartiallyInlineLibCallsPass::run(), llvm::IndVarSimplifyPass::run(), llvm::SinkingPass::run(), llvm::LoopDistributePass::run(), llvm::EliminateAvailableExternallyPass::run(), llvm::Float2IntPass::run(), llvm::LoopRotatePass::run(), llvm::GlobalSplitPass::run(), llvm::GlobalOptPass::run(), llvm::GuardWideningPass::run(), llvm::NameAnonGlobalPass::run(), llvm::InferFunctionAttrsPass::run(), llvm::InstSimplifierPass::run(), llvm::StripDeadPrototypesPass::run(), llvm::BDCEPass::run(), llvm::LoopDataPrefetchPass::run(), llvm::LoopDeletionPass::run(), llvm::LoopIdiomRecognizePass::run(), llvm::LoopSimplifyCFGPass::run(), llvm::GlobalDCEPass::run(), llvm::AlignmentFromAssumptionsPass::run(), llvm::DSEPass::run(), llvm::ConstantMergePass::run(), llvm::AlwaysInlinerPass::run(), llvm::PGOInstrumentationUse::run(), llvm::IPSCCPPass::run(), llvm::ADCEPass::run(), llvm::LowerExpectIntrinsicPass::run(), llvm::SCCPPass::run(), llvm::PostOrderFunctionAttrsPass::run(), llvm::CFGViewerPass::run(), llvm::UnreachableBlockElimPass::run(), llvm::EarlyCSEPass::run(), llvm::LoopStrengthReducePass::run(), llvm::MergedLoadStoreMotionPass::run(), llvm::InstrProfiling::run(), llvm::PassManager< IRUnitT, AnalysisManagerT, ExtraArgTs >::run(), llvm::InstCombinePass::run(), llvm::SimplifyCFGPass::run(), llvm::LCSSAPass::run(), llvm::MemCpyOptPass::run(), llvm::PGOIndirectCallPromotion::run(), llvm::LICMPass::run(), llvm::GVN::run(), llvm::LoopSimplifyPass::run(), llvm::PostDominatorTreePrinterPass::run(), llvm::ReversePostOrderFunctionAttrsPass::run(), llvm::AAEvaluator::run(), llvm::SLPVectorizerPass::run(), llvm::TailCallElimPass::run(), llvm::ReassociatePass::run(), llvm::InternalizePass::run(), llvm::BitcodeWriterPass::run(), llvm::PrintModulePass::run(), llvm::FunctionImportPass::run(), llvm::SpeculativeExecutionPass::run(), llvm::PrintFunctionPass::run(), llvm::RequireAnalysisPass< AnalysisT, Loop, LoopAnalysisManager, LoopStandardAnalysisResults &, LPMUpdater & >::run(), llvm::LoopVectorizePass::run(), llvm::JumpThreadingPass::run(), llvm::NaryReassociatePass::run(), llvm::ConstantHoistingPass::run(), llvm::ProfileSummaryPrinterPass::run(), llvm::DemandedBitsPrinterPass::run(), llvm::BlockFrequencyPrinterPass::run(), llvm::DeadArgumentEliminationPass::run(), llvm::RewriteSymbolPass::run(), llvm::VerifierPass::run(), llvm::RequireAnalysisPass< AnalysisT, LazyCallGraph::SCC, CGSCCAnalysisManager, LazyCallGraph &, CGSCCUpdateResult & >::run(), llvm::AssumptionPrinterPass::run(), llvm::DominanceFrontierPrinterPass::run(), llvm::BranchProbabilityPrinterPass::run(), llvm::LowerTypeTestsPass::run(), llvm::DominatorTreePrinterPass::run(), llvm::DominatorTreeVerifierPass::run(), llvm::WholeProgramDevirtPass::run(), llvm::GVNHoistPass::run(), llvm::FunctionToLoopPassAdaptor< LoopPassT >::run(), llvm::ModuleToPostOrderCGSCCPassAdaptor< CGSCCPassT >::run(), llvm::CallGraphPrinterPass::run(), llvm::PrintLoopPass::run(), llvm::CGSCCToFunctionPassAdaptor< FunctionPassT >::run(), llvm::DevirtSCCRepeatedPass< PassT >::run(), llvm::MemorySSAPrinterPass::run(), llvm::MemorySSAVerifierPass::run(), llvm::LoopPrinterPass::run(), llvm::LoopVerifierPass::run(), llvm::RegionInfoPrinterPass::run(), llvm::RegionInfoVerifierPass::run(), llvm::LazyCallGraphPrinterPass::run(), llvm::LazyCallGraphDOTPrinterPass::run(), and llvm::ScalarEvolutionPrinterPass::run().

template<typename AnalysisSetT >
bool llvm::PreservedAnalyses::allAnalysesInSetPreserved ( ) const
inline

Directly test whether a set of analyses is preserved.

This is only true when no analyses have been explicitly abandoned.

Definition at line 275 of file PassManager.h.

Referenced by llvm::AnalysisManager< IRUnitT, ExtraArgTs >::invalidate().

bool llvm::PreservedAnalyses::allAnalysesInSetPreserved ( AnalysisSetKey SetID) const
inline

Directly test whether a set of analyses is preserved.

This is only true when no analyses have been explicitly abandoned.

Definition at line 282 of file PassManager.h.

References llvm::SmallPtrSetImpl< PtrType >::count().

bool llvm::PreservedAnalyses::areAllPreserved ( ) const
inline

Test whether all analyses are preserved (and none are abandoned).

This is used primarily to optimize for the common case of a transformation which makes no changes to the IR.

Definition at line 267 of file PassManager.h.

References llvm::SmallPtrSetImpl< PtrType >::count().

Referenced by intersect(), preserve(), and preserveSet().

template<typename AnalysisT >
PreservedAnalysisChecker llvm::PreservedAnalyses::getChecker ( ) const
inline

Build a checker for this PreservedAnalyses and the specified analysis type.

You can use the returned object to query whether an analysis was preserved. See the example in the comment on PreservedAnalysis.

Definition at line 250 of file PassManager.h.

Referenced by llvm::AAResults::invalidate(), llvm::MemoryDependenceResults::invalidate(), and llvm::ScalarEvolution::invalidate().

PreservedAnalysisChecker llvm::PreservedAnalyses::getChecker ( AnalysisKey ID) const
inline

Build a checker for this PreservedAnalyses and the specified analysis ID.

You can use the returned object to query whether an analysis was preserved. See the example in the comment on PreservedAnalysis.

Definition at line 259 of file PassManager.h.

void llvm::PreservedAnalyses::intersect ( const PreservedAnalyses Arg)
inline
void llvm::PreservedAnalyses::intersect ( PreservedAnalyses &&  Arg)
inline

Intersect this set with a temporary other set in place.

This is a mutating operation on this preserved set, removing all preserved passes which are not also preserved in the argument.

Definition at line 193 of file PassManager.h.

References areAllPreserved(), and llvm::SmallPtrSetImpl< PtrType >::erase().

static PreservedAnalyses llvm::PreservedAnalyses::none ( )
inlinestatic
template<typename AnalysisT >
void llvm::PreservedAnalyses::preserve ( )
inline
void llvm::PreservedAnalyses::preserve ( AnalysisKey ID)
inline

Given an analysis's ID, mark the analysis as preserved, adding it to the set.

Definition at line 124 of file PassManager.h.

References areAllPreserved(), and llvm::SmallPtrSetImpl< PtrType >::insert().

template<typename AnalysisSetT >
void llvm::PreservedAnalyses::preserveSet ( )
inline
void llvm::PreservedAnalyses::preserveSet ( AnalysisSetKey ID)
inline

Mark an analysis set as preserved using its ID.

Definition at line 140 of file PassManager.h.

References areAllPreserved(), and llvm::SmallPtrSetImpl< PtrType >::insert().


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