This class holds the attributes for a particular argument, parameter, function, or return value. More...

#include "llvm/IR/Attributes.h"

Public Types
using	iterator = const Attribute *

Public Member Functions
	AttributeSet ()=default
	AttributeSet is a trivially copyable value type.
	AttributeSet (const AttributeSet &)=default
	~AttributeSet ()=default
bool	operator== (const AttributeSet &O) const
bool	operator!= (const AttributeSet &O) const
LLVM_ABI AttributeSet	addAttribute (LLVMContext &C, Attribute::AttrKind Kind) const
	Add an argument attribute.
LLVM_ABI AttributeSet	addAttribute (LLVMContext &C, StringRef Kind, StringRef Value=StringRef()) const
	Add a target-dependent attribute.
LLVM_ABI AttributeSet	addAttributes (LLVMContext &C, AttributeSet AS) const
	Add attributes to the attribute set.
AttributeSet	addAttributes (LLVMContext &C, const AttrBuilder &B) const
	Add attributes to the attribute set.
LLVM_ABI AttributeSet	removeAttribute (LLVMContext &C, Attribute::AttrKind Kind) const
	Remove the specified attribute from this set.
LLVM_ABI AttributeSet	removeAttribute (LLVMContext &C, StringRef Kind) const
	Remove the specified attribute from this set.
LLVM_ABI AttributeSet	removeAttributes (LLVMContext &C, const AttributeMask &AttrsToRemove) const
	Remove the specified attributes from this set.
LLVM_ABI std::optional< AttributeSet >	intersectWith (LLVMContext &C, AttributeSet Other) const
	Try to intersect this AttributeSet with Other.
LLVM_ABI unsigned	getNumAttributes () const
	Return the number of attributes in this set.
bool	hasAttributes () const
	Return true if attributes exists in this set.
LLVM_ABI bool	hasAttribute (Attribute::AttrKind Kind) const
	Return true if the attribute exists in this set.
LLVM_ABI bool	hasAttribute (StringRef Kind) const
	Return true if the attribute exists in this set.
LLVM_ABI Attribute	getAttribute (Attribute::AttrKind Kind) const
	Return the attribute object.
LLVM_ABI Attribute	getAttribute (StringRef Kind) const
	Return the target-dependent attribute object.
LLVM_ABI MaybeAlign	getAlignment () const
LLVM_ABI MaybeAlign	getStackAlignment () const
LLVM_ABI uint64_t	getDereferenceableBytes () const
LLVM_ABI DeadOnReturnInfo	getDeadOnReturnInfo () const
LLVM_ABI uint64_t	getDereferenceableOrNullBytes () const
LLVM_ABI Type *	getByValType () const
LLVM_ABI Type *	getStructRetType () const
LLVM_ABI Type *	getByRefType () const
LLVM_ABI Type *	getPreallocatedType () const
LLVM_ABI Type *	getInAllocaType () const
LLVM_ABI Type *	getElementType () const
LLVM_ABI std::optional< std::pair< unsigned, std::optional< unsigned > > >	getAllocSizeArgs () const
LLVM_ABI unsigned	getVScaleRangeMin () const
LLVM_ABI std::optional< unsigned >	getVScaleRangeMax () const
LLVM_ABI UWTableKind	getUWTableKind () const
LLVM_ABI AllocFnKind	getAllocKind () const
LLVM_ABI MemoryEffects	getMemoryEffects () const
LLVM_ABI CaptureInfo	getCaptureInfo () const
LLVM_ABI FPClassTest	getNoFPClass () const
LLVM_ABI std::string	getAsString (bool InAttrGrp=false) const
LLVM_ABI bool	hasParentContext (LLVMContext &C) const
	Return true if this attribute set belongs to the LLVMContext.
LLVM_ABI iterator	begin () const
LLVM_ABI iterator	end () const
void	dump () const

Static Public Member Functions
static LLVM_ABI AttributeSet	get (LLVMContext &C, const AttrBuilder &B)
static LLVM_ABI AttributeSet	get (LLVMContext &C, ArrayRef< Attribute > Attrs)

Friends
template<typename Ty, typename Enable>
struct	DenseMapInfo

Detailed Description

This class holds the attributes for a particular argument, parameter, function, or return value.

It is an immutable value type that is cheap to copy. Adding and removing enum attributes is intended to be fast, but adding and removing string or integer attributes involves a FoldingSet lookup.

Definition at line 407 of file Attributes.h.

Member Typedef Documentation

◆ iterator

using llvm::AttributeSet::iterator = const Attribute *

Definition at line 516 of file Attributes.h.

Constructor & Destructor Documentation

◆ AttributeSet() [1/2]

llvm::AttributeSet::AttributeSet ( )

default

AttributeSet is a trivially copyable value type.

Referenced by get(), and get().

◆ AttributeSet() [2/2]

llvm::AttributeSet::AttributeSet ( const AttributeSet & )

default

◆ ~AttributeSet()

llvm::AttributeSet::~AttributeSet ( )

default

References B(), llvm::CallingConv::C, and LLVM_ABI.

Member Function Documentation

◆ addAttribute() [1/2]

AttributeSet AttributeSet::addAttribute	(	LLVMContext &	C,
		Attribute::AttrKind	Kind ) const

nodiscard

Add an argument attribute.

Returns a new set because attribute sets are immutable.

Definition at line 977 of file Attributes.cpp.

References addAttributes(), B(), llvm::CallingConv::C, get(), and hasAttribute().

Referenced by llvm::OpenMPIRBuilder::addAttributes().

◆ addAttribute() [2/2]

AttributeSet AttributeSet::addAttribute	(	LLVMContext &	C,
		StringRef	Kind,
		StringRef	Value = StringRef() ) const

nodiscard

Add a target-dependent attribute.

Returns a new set because attribute sets are immutable.

Definition at line 985 of file Attributes.cpp.

References addAttributes(), B(), llvm::CallingConv::C, and get().

◆ addAttributes() [1/2]

AttributeSet AttributeSet::addAttributes	(	LLVMContext &	C,
		AttributeSet	AS ) const

nodiscard

Add attributes to the attribute set.

Returns a new set because attribute sets are immutable.

Definition at line 992 of file Attributes.cpp.

References B(), llvm::CallingConv::C, get(), and hasAttributes().

Referenced by addAttribute(), addAttribute(), and llvm::OpenMPIRBuilder::addAttributes().

◆ addAttributes() [2/2]

AttributeSet AttributeSet::addAttributes	(	LLVMContext &	C,
		const AttrBuilder &	B ) const

Add attributes to the attribute set.

Returns a new set because attribute sets are immutable.

Definition at line 1005 of file Attributes.cpp.

References B(), llvm::CallingConv::C, get(), and hasAttributes().

◆ begin()

AttributeSet::iterator AttributeSet::begin ( ) const

Definition at line 1286 of file Attributes.cpp.

Referenced by intersectWith().

◆ dump()

LLVM_DUMP_METHOD void AttributeSet::dump ( ) const

Definition at line 1295 of file Attributes.cpp.

References llvm::dbgs(), getAsString(), and LLVM_DUMP_METHOD.

◆ end()

AttributeSet::iterator AttributeSet::end ( ) const

Definition at line 1290 of file Attributes.cpp.

Referenced by intersectWith().

◆ get() [1/2]

AttributeSet AttributeSet::get	(	LLVMContext &	C,
		ArrayRef< Attribute >	Attrs )

static

Definition at line 973 of file Attributes.cpp.

References AttributeSet(), llvm::CallingConv::C, and llvm::AttributeSetNode::get().

◆ get() [2/2]

AttributeSet AttributeSet::get	(	LLVMContext &	C,
		const AttrBuilder &	B )

static

Definition at line 969 of file Attributes.cpp.

References AttributeSet(), B(), llvm::CallingConv::C, and llvm::AttributeSetNode::get().

Referenced by addAttribute(), addAttribute(), addAttributes(), addAttributes(), AddParamAndFnBasicAttributes(), intersectWith(), llvm::promoteCall(), removeAttribute(), removeAttribute(), and removeAttributes().

◆ getAlignment()

MaybeAlign AttributeSet::getAlignment ( ) const

Definition at line 1195 of file Attributes.cpp.

◆ getAllocKind()

AllocFnKind AttributeSet::getAllocKind ( ) const

Definition at line 1258 of file Attributes.cpp.

References llvm::Unknown.

◆ getAllocSizeArgs()

std::optional< std::pair< unsigned, std::optional< unsigned > > > AttributeSet::getAllocSizeArgs ( ) const

Definition at line 1240 of file Attributes.cpp.

◆ getAsString()

std::string AttributeSet::getAsString ( bool InAttrGrp = false ) const

Definition at line 1274 of file Attributes.cpp.

Referenced by dump().

◆ getAttribute() [1/2]

Attribute AttributeSet::getAttribute ( Attribute::AttrKind Kind ) const

Return the attribute object.

Definition at line 1187 of file Attributes.cpp.

References llvm::Attribute.

Referenced by addIfNotExistent(), intersectWith(), and llvm::typeIncompatible().

◆ getAttribute() [2/2]

Attribute AttributeSet::getAttribute ( StringRef Kind ) const

Return the target-dependent attribute object.

Definition at line 1191 of file Attributes.cpp.

References llvm::Attribute.

◆ getByRefType()

Type * AttributeSet::getByRefType ( ) const

Definition at line 1215 of file Attributes.cpp.

◆ getByValType()

Type * AttributeSet::getByValType ( ) const

Definition at line 1219 of file Attributes.cpp.

◆ getCaptureInfo()

CaptureInfo AttributeSet::getCaptureInfo ( ) const

Definition at line 1266 of file Attributes.cpp.

References llvm::CaptureInfo::all().

Referenced by llvm::CallBase::getCaptureInfo(), llvm::CallBase::hasArgumentWithAdditionalReturnCaptureComponents(), and llvm::isParamGridConstant().

◆ getDeadOnReturnInfo()

DeadOnReturnInfo AttributeSet::getDeadOnReturnInfo ( ) const

Definition at line 1207 of file Attributes.cpp.

◆ getDereferenceableBytes()

uint64_t AttributeSet::getDereferenceableBytes ( ) const

Definition at line 1203 of file Attributes.cpp.

◆ getDereferenceableOrNullBytes()

uint64_t AttributeSet::getDereferenceableOrNullBytes ( ) const

Definition at line 1211 of file Attributes.cpp.

◆ getElementType()

Type * AttributeSet::getElementType ( ) const

Definition at line 1235 of file Attributes.cpp.

◆ getInAllocaType()

Type * AttributeSet::getInAllocaType ( ) const

Definition at line 1231 of file Attributes.cpp.

◆ getMemoryEffects()

MemoryEffects AttributeSet::getMemoryEffects ( ) const

Definition at line 1262 of file Attributes.cpp.

References llvm::MemoryEffectsBase< IRMemLocation >::unknown().

Referenced by addIfNotExistent(), and llvm::SITargetLowering::getTgtMemIntrinsic().

◆ getNoFPClass()

FPClassTest AttributeSet::getNoFPClass ( ) const

Definition at line 1270 of file Attributes.cpp.

References llvm::fcNone.

◆ getNumAttributes()

unsigned AttributeSet::getNumAttributes ( ) const

Return the number of attributes in this set.

Definition at line 1175 of file Attributes.cpp.

◆ getPreallocatedType()

Type * AttributeSet::getPreallocatedType ( ) const

Definition at line 1227 of file Attributes.cpp.

◆ getStackAlignment()

MaybeAlign AttributeSet::getStackAlignment ( ) const

Definition at line 1199 of file Attributes.cpp.

◆ getStructRetType()

Type * AttributeSet::getStructRetType ( ) const

Definition at line 1223 of file Attributes.cpp.

◆ getUWTableKind()

UWTableKind AttributeSet::getUWTableKind ( ) const

Definition at line 1254 of file Attributes.cpp.

References llvm::None.

◆ getVScaleRangeMax()

std::optional< unsigned > AttributeSet::getVScaleRangeMax ( ) const

Definition at line 1250 of file Attributes.cpp.

◆ getVScaleRangeMin()

unsigned AttributeSet::getVScaleRangeMin ( ) const

Definition at line 1246 of file Attributes.cpp.

◆ hasAttribute() [1/2]

bool AttributeSet::hasAttribute ( Attribute::AttrKind Kind ) const

Return true if the attribute exists in this set.

Definition at line 1179 of file Attributes.cpp.

Referenced by addAttribute(), addIfNotExistent(), llvm::GlobalVariable::hasImplicitSection(), maySpeculateLanes(), printFunctionArgExts(), removeAttribute(), and removeAttribute().

◆ hasAttribute() [2/2]

bool AttributeSet::hasAttribute ( StringRef Kind ) const

Return true if the attribute exists in this set.

Definition at line 1183 of file Attributes.cpp.

◆ hasAttributes()

bool llvm::AttributeSet::hasAttributes ( ) const

inline

Return true if attributes exists in this set.

Definition at line 477 of file Attributes.h.

Referenced by addAttributes(), addAttributes(), and hasParentContext().

◆ hasParentContext()

bool AttributeSet::hasParentContext ( LLVMContext & C ) const

Return true if this attribute set belongs to the LLVMContext.

Definition at line 1278 of file Attributes.cpp.

References assert(), llvm::CallingConv::C, and hasAttributes().

◆ intersectWith()

std::optional< AttributeSet > AttributeSet::intersectWith	(	LLVMContext &	C,
		AttributeSet	Other ) const

nodiscard

Try to intersect this AttributeSet with Other.

Returns std::nullopt if the two lists are inherently incompatible (imply different behavior, not just analysis).

Definition at line 1046 of file Attributes.cpp.

References assert(), begin(), llvm::CallingConv::C, end(), get(), llvm::Attribute::getAlignment(), getAttribute(), llvm::Attribute::getCaptureInfo(), llvm::Attribute::getKindAsEnum(), llvm::Attribute::getMemoryEffects(), llvm::Attribute::getNoFPClass(), llvm::Attribute::getRange(), llvm::Attribute::getValueAsInt(), llvm::Attribute::hasKindAsEnum(), llvm::Attribute::intersectMustPreserve(), llvm::Attribute::intersectWithAnd(), llvm::Attribute::intersectWithCustom(), llvm::Attribute::intersectWithMin(), llvm::Attribute::isEnumAttrKind(), llvm::ConstantRange::isFullSet(), llvm::Attribute::isIntAttrKind(), llvm::Attribute::isValid(), llvm_unreachable, llvm::Other, llvm::ConstantRange::unionWith(), and llvm::MaybeAlign::valueOrOne().

◆ operator!=()

bool llvm::AttributeSet::operator!= ( const AttributeSet & O ) const

inline

Definition at line 431 of file Attributes.h.

◆ operator==()

bool llvm::AttributeSet::operator== ( const AttributeSet & O ) const

inline

Definition at line 430 of file Attributes.h.

◆ removeAttribute() [1/2]

AttributeSet AttributeSet::removeAttribute	(	LLVMContext &	C,
		Attribute::AttrKind	Kind ) const

nodiscard

Remove the specified attribute from this set.

Returns a new set because attribute sets are immutable.

Definition at line 1018 of file Attributes.cpp.

References B(), llvm::CallingConv::C, get(), and hasAttribute().

◆ removeAttribute() [2/2]

AttributeSet AttributeSet::removeAttribute	(	LLVMContext &	C,
		StringRef	Kind ) const

nodiscard

Remove the specified attribute from this set.

Returns a new set because attribute sets are immutable.

Definition at line 1026 of file Attributes.cpp.

References B(), llvm::CallingConv::C, get(), and hasAttribute().

◆ removeAttributes()

AttributeSet AttributeSet::removeAttributes	(	LLVMContext &	C,
		const AttributeMask &	AttrsToRemove ) const

nodiscard

Remove the specified attributes from this set.

Returns a new set because attribute sets are immutable.

Definition at line 1034 of file Attributes.cpp.

References B(), llvm::CallingConv::C, and get().

Referenced by moveFunctionAdaptingType().

◆ DenseMapInfo

template<typename Ty, typename Enable>

friend struct DenseMapInfo

friend

Definition at line 409 of file Attributes.h.

References DenseMapInfo.

Referenced by DenseMapInfo.

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

include/llvm/IR/Attributes.h
lib/IR/Attributes.cpp

Public Types

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ iterator

Constructor & Destructor Documentation

◆ AttributeSet() [1/2]

◆ AttributeSet() [2/2]

◆ ~AttributeSet()

Member Function Documentation

◆ addAttribute() [1/2]

◆ addAttribute() [2/2]

◆ addAttributes() [1/2]

◆ addAttributes() [2/2]

◆ begin()

◆ dump()

◆ end()

◆ get() [1/2]

◆ get() [2/2]

◆ getAlignment()

◆ getAllocKind()

◆ getAllocSizeArgs()

◆ getAsString()

◆ getAttribute() [1/2]

◆ getAttribute() [2/2]

◆ getByRefType()

◆ getByValType()

◆ getCaptureInfo()

◆ getDeadOnReturnInfo()

◆ getDereferenceableBytes()

◆ getDereferenceableOrNullBytes()

◆ getElementType()

◆ getInAllocaType()

◆ getMemoryEffects()

◆ getNoFPClass()

◆ getNumAttributes()

◆ getPreallocatedType()

◆ getStackAlignment()

◆ getStructRetType()

◆ getUWTableKind()

◆ getVScaleRangeMax()

◆ getVScaleRangeMin()

◆ hasAttribute() [1/2]

◆ hasAttribute() [2/2]

◆ hasAttributes()

◆ hasParentContext()

◆ intersectWith()

◆ operator!=()

◆ operator==()

◆ removeAttribute() [1/2]

◆ removeAttribute() [2/2]

◆ removeAttributes()

Friends And Related Symbol Documentation

◆ DenseMapInfo