LLVM  14.0.0git
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | List of all members
llvm::AAValueConstantRange Struct Referenceabstract

An abstract interface for range value analysis. More...

#include "llvm/Transforms/IPO/Attributor.h"

Inheritance diagram for llvm::AAValueConstantRange:
Inheritance graph
[legend]
Collaboration diagram for llvm::AAValueConstantRange:
Collaboration graph
[legend]

Public Types

using Base = StateWrapper< IntegerRangeState, AbstractAttribute, uint32_t >
 
- Public Types inherited from llvm::StateWrapper< IntegerRangeState, AbstractAttribute, uint32_t >
using StateType = IntegerRangeState
 Provide static access to the type of the state. More...
 
- Public Types inherited from llvm::AbstractAttribute
using StateType = AbstractState
 
- Public Types inherited from llvm::IRPosition
enum  Kind : char {
  IRP_INVALID, IRP_FLOAT, IRP_RETURNED, IRP_CALL_SITE_RETURNED,
  IRP_FUNCTION, IRP_CALL_SITE, IRP_ARGUMENT, IRP_CALL_SITE_ARGUMENT
}
 The positions we distinguish in the IR. More...
 
using CallBaseContext = CallBase
 
- Public Types inherited from llvm::AADepGraphNode
using DepTy = PointerIntPair< AADepGraphNode *, 1 >
 
using iterator = mapped_iterator< TinyPtrVector< DepTy >::iterator, decltype(&DepGetVal)>
 
using aaiterator = mapped_iterator< TinyPtrVector< DepTy >::iterator, decltype(&DepGetValAA)>
 

Public Member Functions

 AAValueConstantRange (const IRPosition &IRP, Attributor &A)
 
IntegerRangeStategetState () override
 See AbstractAttribute::getState(...). More...
 
const IntegerRangeStategetState () const override
 
virtual ConstantRange getAssumedConstantRange (Attributor &A, const Instruction *CtxI=nullptr) const =0
 Return an assumed range for the associated value a program point CtxI. More...
 
virtual ConstantRange getKnownConstantRange (Attributor &A, const Instruction *CtxI=nullptr) const =0
 Return a known range for the associated value at a program point CtxI. More...
 
Optional< ConstantInt * > getAssumedConstantInt (Attributor &A, const Instruction *CtxI=nullptr) const
 Return an assumed constant for the associated value a program point CtxI. More...
 
const std::string getName () const override
 See AbstractAttribute::getName() More...
 
const char * getIdAddr () const override
 See AbstractAttribute::getIdAddr() More...
 
- Public Member Functions inherited from llvm::StateWrapper< IntegerRangeState, AbstractAttribute, uint32_t >
 StateWrapper (const IRPosition &IRP, Ts... Args)
 
StateTypegetState () override
 See AbstractAttribute::getState(...). More...
 
const StateTypegetState () const override
 See AbstractAttribute::getState(...). More...
 
- Public Member Functions inherited from llvm::AbstractAttribute
 AbstractAttribute (const IRPosition &IRP)
 
virtual ~AbstractAttribute ()
 Virtual destructor. More...
 
virtual void initialize (Attributor &A)
 Initialize the state with the information in the Attributor A. More...
 
const IRPositiongetIRPosition () const
 Return an IR position, see struct IRPosition. More...
 
IRPositiongetIRPosition ()
 
void print (raw_ostream &OS) const override
 Helper functions, for debug purposes only. More...
 
virtual void printWithDeps (raw_ostream &OS) const
 
void dump () const
 
virtual const std::string getAsStr () const =0
 This function should return the "summarized" assumed state as string. More...
 
- Public Member Functions inherited from llvm::IRPosition
 IRPosition ()
 Default constructor available to create invalid positions implicitly. More...
 
bool operator== (const IRPosition &RHS) const
 
bool operator!= (const IRPosition &RHS) const
 
ValuegetAnchorValue () const
 Return the value this abstract attribute is anchored with. More...
 
FunctiongetAssociatedFunction () const
 Return the associated function, if any. More...
 
ArgumentgetAssociatedArgument () const
 Return the associated argument, if any. More...
 
bool isFnInterfaceKind () const
 Return true if the position refers to a function interface, that is the function scope, the function return, or an argument. More...
 
FunctiongetAnchorScope () const
 Return the Function surrounding the anchor value. More...
 
InstructiongetCtxI () const
 Return the context instruction, if any. More...
 
ValuegetAssociatedValue () const
 Return the value this abstract attribute is associated with. More...
 
TypegetAssociatedType () const
 Return the type this abstract attribute is associated with. More...
 
int getCalleeArgNo () const
 Return the callee argument number of the associated value if it is an argument or call site argument, otherwise a negative value. More...
 
int getCallSiteArgNo () const
 Return the call site argument number of the associated value if it is an argument or call site argument, otherwise a negative value. More...
 
unsigned getAttrIdx () const
 Return the index in the attribute list for this position. More...
 
Kind getPositionKind () const
 Return the associated position kind. More...
 
bool hasAttr (ArrayRef< Attribute::AttrKind > AKs, bool IgnoreSubsumingPositions=false, Attributor *A=nullptr) const
 TODO: Figure out if the attribute related helper functions should live here or somewhere else. More...
 
void getAttrs (ArrayRef< Attribute::AttrKind > AKs, SmallVectorImpl< Attribute > &Attrs, bool IgnoreSubsumingPositions=false, Attributor *A=nullptr) const
 Return the attributes of any kind in AKs existing in the IR at a position that will affect this one. More...
 
void removeAttrs (ArrayRef< Attribute::AttrKind > AKs) const
 Remove the attribute of kind AKs existing in the IR at this position. More...
 
bool isAnyCallSitePosition () const
 
bool isArgumentPosition () const
 Return true if the position is an argument or call site argument. More...
 
IRPosition stripCallBaseContext () const
 Return the same position without the call base context. More...
 
const CallBaseContextgetCallBaseContext () const
 Get the call base context from the position. More...
 
bool hasCallBaseContext () const
 Check if the position has any call base context. More...
 
 operator void * () const
 } More...
 
- Public Member Functions inherited from llvm::AADepGraphNode
virtual ~AADepGraphNode ()
 
aaiterator begin ()
 
aaiterator end ()
 
iterator child_begin ()
 
iterator child_end ()
 
TinyPtrVector< DepTy > & getDeps ()
 
- Public Member Functions inherited from llvm::IntegerRangeState
 IntegerRangeState (uint32_t BitWidth)
 
 IntegerRangeState (const ConstantRange &CR)
 
uint32_t getBitWidth () const
 Return associated values' bit width. More...
 
bool isValidState () const override
 See AbstractState::isValidState() More...
 
bool isAtFixpoint () const override
 See AbstractState::isAtFixpoint() More...
 
ChangeStatus indicateOptimisticFixpoint () override
 See AbstractState::indicateOptimisticFixpoint(...) More...
 
ChangeStatus indicatePessimisticFixpoint () override
 See AbstractState::indicatePessimisticFixpoint(...) More...
 
ConstantRange getKnown () const
 Return the known state encoding. More...
 
ConstantRange getAssumed () const
 Return the assumed state encoding. More...
 
void unionAssumed (const ConstantRange &R)
 Unite assumed range with the passed state. More...
 
void unionAssumed (const IntegerRangeState &R)
 See IntegerRangeState::unionAssumed(..). More...
 
void unionKnown (const ConstantRange &R)
 Unite known range with the passed state. More...
 
void unionKnown (const IntegerRangeState &R)
 See IntegerRangeState::unionKnown(..). More...
 
void intersectKnown (const ConstantRange &R)
 Intersect known range with the passed state. More...
 
void intersectKnown (const IntegerRangeState &R)
 See IntegerRangeState::intersectKnown(..). More...
 
bool operator== (const IntegerRangeState &R) const
 Equality for IntegerRangeState. More...
 
IntegerRangeState operator^= (const IntegerRangeState &R)
 "Clamp" this state with R. More...
 
IntegerRangeState operator&= (const IntegerRangeState &R)
 
- Public Member Functions inherited from llvm::AbstractState
virtual ~AbstractState ()
 

Static Public Member Functions

static AAValueConstantRangecreateForPosition (const IRPosition &IRP, Attributor &A)
 Create an abstract attribute view for the position IRP. More...
 
static bool classof (const AbstractAttribute *AA)
 This function should return true if the type of the AA is AAValueConstantRange. More...
 
- Static Public Member Functions inherited from llvm::AbstractAttribute
static bool classof (const AADepGraphNode *DGN)
 This function is used to identify if an DGN is of type AbstractAttribute so that the dyn_cast and cast can use such information to cast an AADepGraphNode to an AbstractAttribute. More...
 
- Static Public Member Functions inherited from llvm::IRPosition
static const IRPosition value (const Value &V, const CallBaseContext *CBContext=nullptr)
 Create a position describing the value of V. More...
 
static const IRPosition function (const Function &F, const CallBaseContext *CBContext=nullptr)
 Create a position describing the function scope of F. More...
 
static const IRPosition returned (const Function &F, const CallBaseContext *CBContext=nullptr)
 Create a position describing the returned value of F. More...
 
static const IRPosition argument (const Argument &Arg, const CallBaseContext *CBContext=nullptr)
 Create a position describing the argument Arg. More...
 
static const IRPosition callsite_function (const CallBase &CB)
 Create a position describing the function scope of CB. More...
 
static const IRPosition callsite_returned (const CallBase &CB)
 Create a position describing the returned value of CB. More...
 
static const IRPosition callsite_argument (const CallBase &CB, unsigned ArgNo)
 Create a position describing the argument of CB at position ArgNo. More...
 
static const IRPosition callsite_argument (AbstractCallSite ACS, unsigned ArgNo)
 Create a position describing the argument of ACS at position ArgNo. More...
 
static const IRPosition function_scope (const IRPosition &IRP, const CallBaseContext *CBContext=nullptr)
 Create a position with function scope matching the "context" of IRP. More...
 
- Static Public Member Functions inherited from llvm::IntegerRangeState
static ConstantRange getWorstState (uint32_t BitWidth)
 Return the worst possible representable state. More...
 
static ConstantRange getBestState (uint32_t BitWidth)
 Return the best possible representable state. More...
 
static ConstantRange getBestState (const IntegerRangeState &IRS)
 

Static Public Attributes

static const char ID = 0
 Unique ID (due to the unique address) More...
 
- Static Public Attributes inherited from llvm::IRPosition
static const IRPosition EmptyKey
 Special DenseMap key values. More...
 
static const IRPosition TombstoneKey
 

Additional Inherited Members

- Public Attributes inherited from llvm::IntegerRangeState
uint32_t BitWidth
 Bitwidth of the associated value. More...
 
ConstantRange Assumed
 State representing assumed range, initially set to empty. More...
 
ConstantRange Known
 State representing known range, initially set to [-inf, inf]. More...
 
- Protected Member Functions inherited from llvm::AbstractAttribute
ChangeStatus update (Attributor &A)
 Hook for the Attributor to trigger an update of the internal state. More...
 
virtual ChangeStatus manifest (Attributor &A)
 Hook for the Attributor to trigger the manifestation of the information represented by the abstract attribute in the LLVM-IR. More...
 
virtual void trackStatistics () const =0
 Hook to enable custom statistic tracking, called after manifest that resulted in a change if statistics are enabled. More...
 
virtual ChangeStatus updateImpl (Attributor &A)=0
 The actual update/transfer function which has to be implemented by the derived classes. More...
 
- Protected Member Functions inherited from llvm::AADepGraphNode
 operator AbstractAttribute * ()
 
- Static Protected Member Functions inherited from llvm::AADepGraphNode
static AADepGraphNodeDepGetVal (DepTy &DT)
 
static AbstractAttributeDepGetValAA (DepTy &DT)
 
- Protected Attributes inherited from llvm::AADepGraphNode
TinyPtrVector< DepTyDeps
 Set of dependency graph nodes which should be updated if this one is updated. More...
 

Detailed Description

An abstract interface for range value analysis.

Definition at line 3928 of file Attributor.h.

Member Typedef Documentation

◆ Base

Definition at line 3930 of file Attributor.h.

Constructor & Destructor Documentation

◆ AAValueConstantRange()

llvm::AAValueConstantRange::AAValueConstantRange ( const IRPosition IRP,
Attributor A 
)
inline

Definition at line 3931 of file Attributor.h.

Member Function Documentation

◆ classof()

static bool llvm::AAValueConstantRange::classof ( const AbstractAttribute AA)
inlinestatic

This function should return true if the type of the AA is AAValueConstantRange.

Definition at line 3976 of file Attributor.h.

References llvm::AbstractAttribute::getIdAddr(), and ID.

◆ createForPosition()

static AAValueConstantRange& llvm::AAValueConstantRange::createForPosition ( const IRPosition IRP,
Attributor A 
)
static

Create an abstract attribute view for the position IRP.

◆ getAssumedConstantInt()

Optional<ConstantInt *> llvm::AAValueConstantRange::getAssumedConstantInt ( Attributor A,
const Instruction CtxI = nullptr 
) const
inline

◆ getAssumedConstantRange()

virtual ConstantRange llvm::AAValueConstantRange::getAssumedConstantRange ( Attributor A,
const Instruction CtxI = nullptr 
) const
pure virtual

Return an assumed range for the associated value a program point CtxI.

If I is nullptr, simply return an assumed range.

Referenced by getAssumedConstantInt().

◆ getIdAddr()

const char* llvm::AAValueConstantRange::getIdAddr ( ) const
inlineoverridevirtual

See AbstractAttribute::getIdAddr()

Implements llvm::AbstractAttribute.

Definition at line 3972 of file Attributor.h.

References ID.

◆ getKnownConstantRange()

virtual ConstantRange llvm::AAValueConstantRange::getKnownConstantRange ( Attributor A,
const Instruction CtxI = nullptr 
) const
pure virtual

Return a known range for the associated value at a program point CtxI.

If I is nullptr, simply return a known range.

◆ getName()

const std::string llvm::AAValueConstantRange::getName ( ) const
inlineoverridevirtual

See AbstractAttribute::getName()

Implements llvm::AbstractAttribute.

Definition at line 3969 of file Attributor.h.

◆ getState() [1/2]

const IntegerRangeState& llvm::AAValueConstantRange::getState ( ) const
inlineoverridevirtual

Implements llvm::AbstractAttribute.

Definition at line 3936 of file Attributor.h.

◆ getState() [2/2]

IntegerRangeState& llvm::AAValueConstantRange::getState ( )
inlineoverridevirtual

See AbstractAttribute::getState(...).

Implements llvm::AbstractAttribute.

Definition at line 3935 of file Attributor.h.

Member Data Documentation

◆ ID

const char AAValueConstantRange::ID = 0
static

Unique ID (due to the unique address)

Definition at line 3981 of file Attributor.h.

Referenced by classof(), and getIdAddr().


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