LLVM  10.0.0svn
llvm::AssumptionCache Class Reference

A cache of @llvm.assume calls within a function. More...

#include "llvm/Analysis/AssumptionCache.h"

## Public Member Functions

AssumptionCache (Function &F)
Construct an AssumptionCache from a function by scanning all of its instructions. More...

bool invalidate (Function &, const PreservedAnalyses &, FunctionAnalysisManager::Invalidator &)
This cache is designed to be self-updating and so it should never be invalidated. More...

void registerAssumption (CallInst *CI)
Add an @llvm.assume intrinsic to this function's cache. More...

void unregisterAssumption (CallInst *CI)
Remove an @llvm.assume intrinsic from this function's cache if it has been added to the cache earlier. More...

void updateAffectedValues (CallInst *CI)
Update the cache of values being affected by this assumption (i.e. More...

void clear ()
Clear the cache of @llvm.assume intrinsics for a function. More...

MutableArrayRef< WeakTrackingVHassumptions ()
Access the list of assumption handles currently tracked for this function. More...

MutableArrayRef< WeakTrackingVHassumptionsFor (const Value *V)
Access the list of assumptions which affect this value. More...

## Detailed Description

A cache of @llvm.assume calls within a function.

This cache provides fast lookup of assumptions within a function by caching them and amortizing the cost of scanning for them across all queries. Passes that create new assumptions are required to call registerAssumption() to register any new @llvm.assume calls that they create. Deletions of @llvm.assume calls do not require special handling.

Definition at line 41 of file AssumptionCache.h.

## ◆ AssumptionCache()

 llvm::AssumptionCache::AssumptionCache ( Function & F )
inline

Construct an AssumptionCache from a function by scanning all of its instructions.

Definition at line 91 of file AssumptionCache.h.

Referenced by llvm::AssumptionAnalysis::run().

## ◆ assumptions()

 MutableArrayRef llvm::AssumptionCache::assumptions ( )
inline

Access the list of assumption handles currently tracked for this function.

Note that these produce weak handles that may be null. The caller must handle that case. FIXME: We should replace this with pointee_iterator<filter_iterator<...>> when we can write that to filter out the null values. Then caller code will become simpler.

Definition at line 131 of file AssumptionCache.h.

## ◆ assumptionsFor()

 MutableArrayRef llvm::AssumptionCache::assumptionsFor ( const Value * V )
inline

Access the list of assumptions which affect this value.

Definition at line 138 of file AssumptionCache.h.

## ◆ clear()

 void llvm::AssumptionCache::clear ( )
inline

Clear the cache of @llvm.assume intrinsics for a function.

It will be re-scanned the next time it is requested.

Definition at line 117 of file AssumptionCache.h.

## ◆ invalidate()

 bool llvm::AssumptionCache::invalidate ( Function & , const PreservedAnalyses & , FunctionAnalysisManager::Invalidator & )
inline

This cache is designed to be self-updating and so it should never be invalidated.

Definition at line 95 of file AssumptionCache.h.

References registerAssumption(), unregisterAssumption(), and updateAffectedValues().

## ◆ registerAssumption()

 void AssumptionCache::registerAssumption ( CallInst * CI )

Add an @llvm.assume intrinsic to this function's cache.

The call passed in must be an instruction within this function and must not already be in the cache.

Definition at line 189 of file AssumptionCache.cpp.

## ◆ unregisterAssumption()

 void AssumptionCache::unregisterAssumption ( CallInst * CI )

Remove an @llvm.assume intrinsic from this function's cache if it has been added to the cache earlier.

Definition at line 124 of file AssumptionCache.cpp.

Referenced by llvm::CodeExtractor::extractCodeRegion(), and invalidate().

## ◆ updateAffectedValues()

 void AssumptionCache::updateAffectedValues ( CallInst * CI )

Update the cache of values being affected by this assumption (i.e.

the values about which this assumption provides information).

Definition at line 113 of file AssumptionCache.cpp.

References llvm::find(), and findAffectedValues().

Referenced by invalidate().

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