LLVM 20.0.0git
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Friends | List of all members
llvm::Function Class Reference

#include "llvm/IR/Function.h"

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

Classes

class  ProfileCount
 Class to represent profile counts. More...
 

Public Types

enum  ProfileCountType { PCT_Real , PCT_Synthetic }
 
using BasicBlockListType = SymbolTableList< BasicBlock >
 
using iterator = BasicBlockListType::iterator
 
using const_iterator = BasicBlockListType::const_iterator
 
using arg_iterator = Argument *
 
using const_arg_iterator = const Argument *
 
- Public Types inherited from llvm::GlobalObject
enum  VCallVisibility { VCallVisibilityPublic = 0 , VCallVisibilityLinkageUnit = 1 , VCallVisibilityTranslationUnit = 2 }
 
- Public Types inherited from llvm::GlobalValue
enum  LinkageTypes {
  ExternalLinkage = 0 , AvailableExternallyLinkage , LinkOnceAnyLinkage , LinkOnceODRLinkage ,
  WeakAnyLinkage , WeakODRLinkage , AppendingLinkage , InternalLinkage ,
  PrivateLinkage , ExternalWeakLinkage , CommonLinkage
}
 An enumeration for the kinds of linkage for global values. More...
 
enum  VisibilityTypes { DefaultVisibility = 0 , HiddenVisibility , ProtectedVisibility }
 An enumeration for the kinds of visibility of global values. More...
 
enum  DLLStorageClassTypes { DefaultStorageClass = 0 , DLLImportStorageClass = 1 , DLLExportStorageClass = 2 }
 Storage classes of global values for PE targets. More...
 
enum  ThreadLocalMode {
  NotThreadLocal = 0 , GeneralDynamicTLSModel , LocalDynamicTLSModel , InitialExecTLSModel ,
  LocalExecTLSModel
}
 
enum class  UnnamedAddr { None , Local , Global }
 
using GUID = uint64_t
 Declare a type to represent a global unique identifier for a global value.
 
- Public Types inherited from llvm::User
using op_iterator = Use *
 
using const_op_iterator = const Use *
 
using op_range = iterator_range< op_iterator >
 
using const_op_range = iterator_range< const_op_iterator >
 
- Public Types inherited from llvm::Value
enum  ValueTy
 Concrete subclass of this. More...
 
using use_iterator = use_iterator_impl< Use >
 
using const_use_iterator = use_iterator_impl< const Use >
 
using user_iterator = user_iterator_impl< User >
 
using const_user_iterator = user_iterator_impl< const User >
 

Public Member Functions

bool hasLazyArguments () const
 hasLazyArguments/CheckLazyArguments - The argument list of a function is built on demand, so that the list isn't allocated until the first client needs it.
 
void convertToNewDbgValues ()
 
void convertFromNewDbgValues ()
 
void setIsNewDbgInfoFormat (bool NewVal)
 
void setNewDbgInfoFormatFlag (bool NewVal)
 
 Function (const Function &)=delete
 
void operator= (const Function &)=delete
 
 ~Function ()
 
const FunctiongetFunction () const
 
 DECLARE_TRANSPARENT_OPERAND_ACCESSORS (Value)
 
unsigned getInstructionCount () const
 Returns the number of non-debug IR instructions in this function.
 
FunctionTypegetFunctionType () const
 Returns the FunctionType for me.
 
TypegetReturnType () const
 Returns the type of the ret val.
 
LLVMContextgetContext () const
 getContext - Return a reference to the LLVMContext associated with this function.
 
const DataLayoutgetDataLayout () const
 Get the data layout of the module this function belongs to.
 
bool isVarArg () const
 isVarArg - Return true if this function takes a variable number of arguments.
 
bool isMaterializable () const
 
void setIsMaterializable (bool V)
 
Intrinsic::ID getIntrinsicID () const LLVM_READONLY
 getIntrinsicID - This method returns the ID number of the specified function, or Intrinsic::not_intrinsic if the function is not an intrinsic, or if the pointer is null.
 
bool isIntrinsic () const
 isIntrinsic - Returns true if the function's name starts with "llvm.".
 
bool isTargetIntrinsic () const
 isTargetIntrinsic - Returns true if this function is an intrinsic and the intrinsic is specific to a certain target.
 
bool isConstrainedFPIntrinsic () const
 Returns true if the function is one of the "Constrained Floating-Point Intrinsics".
 
void updateAfterNameChange ()
 Update internal caches that depend on the function name (such as the intrinsic ID and libcall cache).
 
CallingConv::ID getCallingConv () const
 getCallingConv()/setCallingConv(CC) - These method get and set the calling convention of this function.
 
void setCallingConv (CallingConv::ID CC)
 
void setEntryCount (ProfileCount Count, const DenseSet< GlobalValue::GUID > *Imports=nullptr)
 Set the entry count for this function.
 
void setEntryCount (uint64_t Count, ProfileCountType Type=PCT_Real, const DenseSet< GlobalValue::GUID > *Imports=nullptr)
 A convenience wrapper for setting entry count.
 
std::optional< ProfileCountgetEntryCount (bool AllowSynthetic=false) const
 Get the entry count for this function.
 
bool hasProfileData (bool IncludeSynthetic=false) const
 Return true if the function is annotated with profile data.
 
DenseSet< GlobalValue::GUIDgetImportGUIDs () const
 Returns the set of GUIDs that needs to be imported to the function for sample PGO, to enable the same inlines as the profiled optimized binary.
 
void setSectionPrefix (StringRef Prefix)
 Set the section prefix for this function.
 
std::optional< StringRefgetSectionPrefix () const
 Get the section prefix for this function.
 
bool hasGC () const
 hasGC/getGC/setGC/clearGC - The name of the garbage collection algorithm to use during code generation.
 
const std::string & getGC () const
 
void setGC (std::string Str)
 
void clearGC ()
 
AttributeList getAttributes () const
 Return the attribute list for this Function.
 
void setAttributes (AttributeList Attrs)
 Set the attribute list for this Function.
 
void addAttributeAtIndex (unsigned i, Attribute Attr)
 adds the attribute to the list of attributes.
 
void addFnAttr (Attribute::AttrKind Kind)
 Add function attributes to this function.
 
void addFnAttr (StringRef Kind, StringRef Val=StringRef())
 Add function attributes to this function.
 
void addFnAttr (Attribute Attr)
 Add function attributes to this function.
 
void addFnAttrs (const AttrBuilder &Attrs)
 Add function attributes to this function.
 
void addRetAttr (Attribute::AttrKind Kind)
 Add return value attributes to this function.
 
void addRetAttr (Attribute Attr)
 Add return value attributes to this function.
 
void addRetAttrs (const AttrBuilder &Attrs)
 Add return value attributes to this function.
 
void addParamAttr (unsigned ArgNo, Attribute::AttrKind Kind)
 adds the attribute to the list of attributes for the given arg.
 
void addParamAttr (unsigned ArgNo, Attribute Attr)
 adds the attribute to the list of attributes for the given arg.
 
void addParamAttrs (unsigned ArgNo, const AttrBuilder &Attrs)
 adds the attributes to the list of attributes for the given arg.
 
void removeAttributeAtIndex (unsigned i, Attribute::AttrKind Kind)
 removes the attribute from the list of attributes.
 
void removeAttributeAtIndex (unsigned i, StringRef Kind)
 removes the attribute from the list of attributes.
 
void removeFnAttr (Attribute::AttrKind Kind)
 Remove function attributes from this function.
 
void removeFnAttr (StringRef Kind)
 Remove function attribute from this function.
 
void removeFnAttrs (const AttributeMask &Attrs)
 
void removeRetAttr (Attribute::AttrKind Kind)
 removes the attribute from the return value list of attributes.
 
void removeRetAttr (StringRef Kind)
 removes the attribute from the return value list of attributes.
 
void removeRetAttrs (const AttributeMask &Attrs)
 removes the attributes from the return value list of attributes.
 
void removeParamAttr (unsigned ArgNo, Attribute::AttrKind Kind)
 removes the attribute from the list of attributes.
 
void removeParamAttr (unsigned ArgNo, StringRef Kind)
 removes the attribute from the list of attributes.
 
void removeParamAttrs (unsigned ArgNo, const AttributeMask &Attrs)
 removes the attribute from the list of attributes.
 
bool hasFnAttribute (Attribute::AttrKind Kind) const
 Return true if the function has the attribute.
 
bool hasFnAttribute (StringRef Kind) const
 Return true if the function has the attribute.
 
bool hasRetAttribute (Attribute::AttrKind Kind) const
 check if an attribute is in the list of attributes for the return value.
 
bool hasParamAttribute (unsigned ArgNo, Attribute::AttrKind Kind) const
 check if an attributes is in the list of attributes.
 
bool hasParamAttribute (unsigned ArgNo, StringRef Kind) const
 Check if an attribute is in the list of attributes.
 
Attribute getAttributeAtIndex (unsigned i, Attribute::AttrKind Kind) const
 gets the attribute from the list of attributes.
 
Attribute getAttributeAtIndex (unsigned i, StringRef Kind) const
 gets the attribute from the list of attributes.
 
bool hasAttributeAtIndex (unsigned Idx, Attribute::AttrKind Kind) const
 Check if attribute of the given kind is set at the given index.
 
Attribute getFnAttribute (Attribute::AttrKind Kind) const
 Return the attribute for the given attribute kind.
 
Attribute getFnAttribute (StringRef Kind) const
 Return the attribute for the given attribute kind.
 
Attribute getRetAttribute (Attribute::AttrKind Kind) const
 Return the attribute for the given attribute kind for the return value.
 
uint64_t getFnAttributeAsParsedInteger (StringRef Kind, uint64_t Default=0) const
 For a string attribute Kind, parse attribute as an integer.
 
Attribute getParamAttribute (unsigned ArgNo, Attribute::AttrKind Kind) const
 gets the specified attribute from the list of attributes.
 
MaybeAlign getFnStackAlign () const
 Return the stack alignment for the function.
 
bool hasStackProtectorFnAttr () const
 Returns true if the function has ssp, sspstrong, or sspreq fn attrs.
 
void addDereferenceableParamAttr (unsigned ArgNo, uint64_t Bytes)
 adds the dereferenceable attribute to the list of attributes for the given arg.
 
void addDereferenceableOrNullParamAttr (unsigned ArgNo, uint64_t Bytes)
 adds the dereferenceable_or_null attribute to the list of attributes for the given arg.
 
void addRangeRetAttr (const ConstantRange &CR)
 adds the range attribute to the list of attributes for the return value.
 
MaybeAlign getParamAlign (unsigned ArgNo) const
 
MaybeAlign getParamStackAlign (unsigned ArgNo) const
 
TypegetParamByValType (unsigned ArgNo) const
 Extract the byval type for a parameter.
 
TypegetParamStructRetType (unsigned ArgNo) const
 Extract the sret type for a parameter.
 
TypegetParamInAllocaType (unsigned ArgNo) const
 Extract the inalloca type for a parameter.
 
TypegetParamByRefType (unsigned ArgNo) const
 Extract the byref type for a parameter.
 
TypegetParamPreallocatedType (unsigned ArgNo) const
 Extract the preallocated type for a parameter.
 
uint64_t getParamDereferenceableBytes (unsigned ArgNo) const
 Extract the number of dereferenceable bytes for a parameter.
 
uint64_t getParamDereferenceableOrNullBytes (unsigned ArgNo) const
 Extract the number of dereferenceable_or_null bytes for a parameter.
 
FPClassTest getParamNoFPClass (unsigned ArgNo) const
 Extract the nofpclass attribute for a parameter.
 
bool isPresplitCoroutine () const
 Determine if the function is presplit coroutine.
 
void setPresplitCoroutine ()
 
void setSplittedCoroutine ()
 
bool isCoroOnlyDestroyWhenComplete () const
 
void setCoroDestroyOnlyWhenComplete ()
 
MemoryEffects getMemoryEffects () const
 
void setMemoryEffects (MemoryEffects ME)
 
bool doesNotAccessMemory () const
 Determine if the function does not access memory.
 
void setDoesNotAccessMemory ()
 
bool onlyReadsMemory () const
 Determine if the function does not access or only reads memory.
 
void setOnlyReadsMemory ()
 
bool onlyWritesMemory () const
 Determine if the function does not access or only writes memory.
 
void setOnlyWritesMemory ()
 
bool onlyAccessesArgMemory () const
 Determine if the call can access memmory only using pointers based on its arguments.
 
void setOnlyAccessesArgMemory ()
 
bool onlyAccessesInaccessibleMemory () const
 Determine if the function may only access memory that is inaccessible from the IR.
 
void setOnlyAccessesInaccessibleMemory ()
 
bool onlyAccessesInaccessibleMemOrArgMem () const
 Determine if the function may only access memory that is either inaccessible from the IR or pointed to by its arguments.
 
void setOnlyAccessesInaccessibleMemOrArgMem ()
 
bool doesNotReturn () const
 Determine if the function cannot return.
 
void setDoesNotReturn ()
 
bool doesNoCfCheck () const
 Determine if the function should not perform indirect branch tracking.
 
bool doesNotThrow () const
 Determine if the function cannot unwind.
 
void setDoesNotThrow ()
 
bool cannotDuplicate () const
 Determine if the call cannot be duplicated.
 
void setCannotDuplicate ()
 
bool isConvergent () const
 Determine if the call is convergent.
 
void setConvergent ()
 
void setNotConvergent ()
 
bool isSpeculatable () const
 Determine if the call has sideeffects.
 
void setSpeculatable ()
 
bool doesNotFreeMemory () const
 Determine if the call might deallocate memory.
 
void setDoesNotFreeMemory ()
 
bool hasNoSync () const
 Determine if the call can synchroize with other threads.
 
void setNoSync ()
 
bool doesNotRecurse () const
 Determine if the function is known not to recurse, directly or indirectly.
 
void setDoesNotRecurse ()
 
bool mustProgress () const
 Determine if the function is required to make forward progress.
 
void setMustProgress ()
 
bool willReturn () const
 Determine if the function will return.
 
void setWillReturn ()
 
UWTableKind getUWTableKind () const
 Get what kind of unwind table entry to generate for this function.
 
bool hasUWTable () const
 True if the ABI mandates (or the user requested) that this function be in a unwind table.
 
void setUWTableKind (UWTableKind K)
 
bool needsUnwindTableEntry () const
 True if this function needs an unwind table.
 
bool hasStructRetAttr () const
 Determine if the function returns a structure through first or second pointer argument.
 
bool returnDoesNotAlias () const
 Determine if the parameter or return value is marked with NoAlias attribute.
 
void setReturnDoesNotAlias ()
 
bool hasOptNone () const
 Do not optimize this function (-O0).
 
bool hasMinSize () const
 Optimize this function for minimum size (-Oz).
 
bool hasOptSize () const
 Optimize this function for size (-Os) or minimum size (-Oz).
 
DenormalMode getDenormalMode (const fltSemantics &FPType) const
 Returns the denormal handling type for the default rounding mode of the function.
 
DenormalMode getDenormalModeRaw () const
 Return the representational value of "denormal-fp-math".
 
DenormalMode getDenormalModeF32Raw () const
 Return the representational value of "denormal-fp-math-f32".
 
void copyAttributesFrom (const Function *Src)
 copyAttributesFrom - copy all additional attributes (those not needed to create a Function) from the Function Src to this one.
 
void deleteBody ()
 deleteBody - This method deletes the body of the function, and converts the linkage to external.
 
void removeFromParent ()
 removeFromParent - This method unlinks 'this' from the containing module, but does not delete it.
 
void eraseFromParent ()
 eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
 
void stealArgumentListFrom (Function &Src)
 Steal arguments from another function.
 
Function::iterator insert (Function::iterator Position, BasicBlock *BB)
 Insert BB in the basic block list at Position.
 
void splice (Function::iterator ToIt, Function *FromF)
 Transfer all blocks from FromF to this function at ToIt.
 
void splice (Function::iterator ToIt, Function *FromF, Function::iterator FromIt)
 Transfer one BasicBlock from FromF at FromIt to this function at ToIt.
 
void splice (Function::iterator ToIt, Function *FromF, Function::iterator FromBeginIt, Function::iterator FromEndIt)
 Transfer a range of basic blocks that belong to FromF from FromBeginIt to FromEndIt, to this function at ToIt.
 
Function::iterator erase (Function::iterator FromIt, Function::iterator ToIt)
 Erases a range of BasicBlocks from FromIt to (not including) ToIt.
 
const BasicBlockgetEntryBlock () const
 
BasicBlockgetEntryBlock ()
 
ValueSymbolTablegetValueSymbolTable ()
 getSymbolTable() - Return the symbol table if any, otherwise nullptr.
 
const ValueSymbolTablegetValueSymbolTable () const
 
unsigned getMaxBlockNumber () const
 Return a value larger than the largest block number.
 
void renumberBlocks ()
 Renumber basic blocks into a dense value range starting from 0.
 
unsigned getBlockNumberEpoch () const
 Return the "epoch" of current block numbers.
 
iterator begin ()
 
const_iterator begin () const
 
iterator end ()
 
const_iterator end () const
 
size_t size () const
 
bool empty () const
 
const BasicBlockfront () const
 
BasicBlockfront ()
 
const BasicBlockback () const
 
BasicBlockback ()
 
size_t arg_size () const
 
bool arg_empty () const
 
bool hasPersonalityFn () const
 Check whether this function has a personality function.
 
ConstantgetPersonalityFn () const
 Get the personality function associated with this function.
 
void setPersonalityFn (Constant *Fn)
 
bool hasPrefixData () const
 Check whether this function has prefix data.
 
ConstantgetPrefixData () const
 Get the prefix data associated with this function.
 
void setPrefixData (Constant *PrefixData)
 
bool hasPrologueData () const
 Check whether this function has prologue data.
 
ConstantgetPrologueData () const
 Get the prologue data associated with this function.
 
void setPrologueData (Constant *PrologueData)
 
void print (raw_ostream &OS, AssemblyAnnotationWriter *AAW=nullptr, bool ShouldPreserveUseListOrder=false, bool IsForDebug=false) const
 Print the function to an output stream with an optional AssemblyAnnotationWriter.
 
void viewCFG () const
 viewCFG - This function is meant for use from the debugger.
 
void viewCFG (const char *OutputFileName) const
 viewCFG - This function is meant for use from the debugger.
 
void viewCFG (bool ViewCFGOnly, const BlockFrequencyInfo *BFI, const BranchProbabilityInfo *BPI, const char *OutputFileName=nullptr) const
 Extended form to print edge weights.
 
void viewCFGOnly () const
 viewCFGOnly - This function is meant for use from the debugger.
 
void viewCFGOnly (const char *OutputFileName) const
 viewCFG - This function is meant for use from the debugger.
 
void viewCFGOnly (const BlockFrequencyInfo *BFI, const BranchProbabilityInfo *BPI) const
 Extended form to print edge weights.
 
void dropAllReferences ()
 dropAllReferences() - This method causes all the subinstructions to "let go" of all references that they are maintaining.
 
bool hasAddressTaken (const User **=nullptr, bool IgnoreCallbackUses=false, bool IgnoreAssumeLikeCalls=true, bool IngoreLLVMUsed=false, bool IgnoreARCAttachedCall=false, bool IgnoreCastedDirectCall=false) const
 hasAddressTaken - returns true if there are any uses of this function other than direct calls or invokes to it, or blockaddress expressions.
 
bool isDefTriviallyDead () const
 isDefTriviallyDead - Return true if it is trivially safe to remove this function definition from the module (because it isn't externally visible, does not have its address taken, and has no callers).
 
bool callsFunctionThatReturnsTwice () const
 callsFunctionThatReturnsTwice - Return true if the function has a call to setjmp or other function that gcc recognizes as "returning twice".
 
void setSubprogram (DISubprogram *SP)
 Set the attached subprogram.
 
DISubprogramgetSubprogram () const
 Get the attached subprogram.
 
bool shouldEmitDebugInfoForProfiling () const
 Returns true if we should emit debug info for profiling.
 
bool nullPointerIsDefined () const
 Check if null pointer dereferencing is considered undefined behavior for the function.
 
Function Argument Iteration
arg_iterator arg_begin ()
 
const_arg_iterator arg_begin () const
 
arg_iterator arg_end ()
 
const_arg_iterator arg_end () const
 
ArgumentgetArg (unsigned i) const
 
iterator_range< arg_iteratorargs ()
 
iterator_range< const_arg_iteratorargs () const
 
- Public Member Functions inherited from llvm::GlobalObject
 GlobalObject (const GlobalObject &)=delete
 
uint64_t getAlignment () const
 FIXME: Remove this function once transition to Align is over.
 
MaybeAlign getAlign () const
 Returns the alignment of the given variable or function.
 
void setAlignment (Align Align)
 Sets the alignment attribute of the GlobalObject.
 
void setAlignment (MaybeAlign Align)
 Sets the alignment attribute of the GlobalObject.
 
unsigned getGlobalObjectSubClassData () const
 
void setGlobalObjectSubClassData (unsigned Val)
 
bool hasSection () const
 Check if this global has a custom object file section.
 
StringRef getSection () const
 Get the custom section of this global if it has one.
 
void setSection (StringRef S)
 Change the section for this global.
 
bool hasComdat () const
 
const ComdatgetComdat () const
 
ComdatgetComdat ()
 
void setComdat (Comdat *C)
 
void copyMetadata (const GlobalObject *Src, unsigned Offset)
 Copy metadata from Src, adjusting offsets by Offset.
 
void addTypeMetadata (unsigned Offset, Metadata *TypeID)
 
void setVCallVisibilityMetadata (VCallVisibility Visibility)
 
VCallVisibility getVCallVisibility () const
 
bool canIncreaseAlignment () const
 Returns true if the alignment of the value can be unilaterally increased.
 
void addMetadata (unsigned KindID, MDNode &MD)
 Add a metadata attachment.
 
void addMetadata (StringRef Kind, MDNode &MD)
 
void clearMetadata ()
 Erase all metadata attached to this Value.
 
bool eraseMetadata (unsigned KindID)
 Erase all metadata attachments with the given kind.
 
void eraseMetadataIf (function_ref< bool(unsigned, MDNode *)> Pred)
 Erase all metadata attachments matching the given predicate.
 
void getAllMetadata (SmallVectorImpl< std::pair< unsigned, MDNode * > > &MDs) const
 Appends all metadata attached to this value to MDs, sorting by KindID.
 
MDNodegetMetadata (unsigned KindID) const
 Get the current metadata attachments for the given kind, if any.
 
MDNodegetMetadata (StringRef Kind) const
 
void getMetadata (unsigned KindID, SmallVectorImpl< MDNode * > &MDs) const
 Appends all attachments with the given ID to MDs in insertion order.
 
void getMetadata (StringRef Kind, SmallVectorImpl< MDNode * > &MDs) const
 
bool hasMetadata () const
 Return true if this value has any metadata attached to it.
 
bool hasMetadata (unsigned KindID) const
 Return true if this value has the given type of metadata attached.
 
bool hasMetadata (StringRef Kind) const
 
void setMetadata (unsigned KindID, MDNode *Node)
 Set a particular kind of metadata attachment.
 
void setMetadata (StringRef Kind, MDNode *Node)
 
- Public Member Functions inherited from llvm::GlobalValue
 GlobalValue (const GlobalValue &)=delete
 
unsigned getAddressSpace () const
 
bool hasGlobalUnnamedAddr () const
 
bool hasAtLeastLocalUnnamedAddr () const
 Returns true if this value's address is not significant in this module.
 
UnnamedAddr getUnnamedAddr () const
 
void setUnnamedAddr (UnnamedAddr Val)
 
bool hasComdat () const
 
const ComdatgetComdat () const
 
ComdatgetComdat ()
 
VisibilityTypes getVisibility () const
 
bool hasDefaultVisibility () const
 
bool hasHiddenVisibility () const
 
bool hasProtectedVisibility () const
 
void setVisibility (VisibilityTypes V)
 
bool isThreadLocal () const
 If the value is "Thread Local", its value isn't shared by the threads.
 
void setThreadLocal (bool Val)
 
void setThreadLocalMode (ThreadLocalMode Val)
 
ThreadLocalMode getThreadLocalMode () const
 
DLLStorageClassTypes getDLLStorageClass () const
 
bool hasDLLImportStorageClass () const
 
bool hasDLLExportStorageClass () const
 
void setDLLStorageClass (DLLStorageClassTypes C)
 
bool hasSection () const
 
StringRef getSection () const
 
PointerTypegetType () const
 Global values are always pointers.
 
TypegetValueType () const
 
bool isImplicitDSOLocal () const
 
void setDSOLocal (bool Local)
 
bool isDSOLocal () const
 
bool hasPartition () const
 
StringRef getPartition () const
 
void setPartition (StringRef Part)
 
bool hasSanitizerMetadata () const
 
const SanitizerMetadatagetSanitizerMetadata () const
 
void setSanitizerMetadata (SanitizerMetadata Meta)
 
void removeSanitizerMetadata ()
 
void setNoSanitizeMetadata ()
 
bool isTagged () const
 
bool isDefinitionExact () const
 Return true if the currently visible definition of this global (if any) is exactly the definition we will see at runtime.
 
bool hasExactDefinition () const
 Return true if this global has an exact defintion.
 
bool isInterposable () const
 Return true if this global's definition can be substituted with an arbitrary definition at link time or load time.
 
bool canBenefitFromLocalAlias () const
 
bool hasExternalLinkage () const
 
bool hasAvailableExternallyLinkage () const
 
bool hasLinkOnceLinkage () const
 
bool hasLinkOnceAnyLinkage () const
 
bool hasLinkOnceODRLinkage () const
 
bool hasWeakLinkage () const
 
bool hasWeakAnyLinkage () const
 
bool hasWeakODRLinkage () const
 
bool hasAppendingLinkage () const
 
bool hasInternalLinkage () const
 
bool hasPrivateLinkage () const
 
bool hasLocalLinkage () const
 
bool hasExternalWeakLinkage () const
 
bool hasCommonLinkage () const
 
bool hasValidDeclarationLinkage () const
 
void setLinkage (LinkageTypes LT)
 
LinkageTypes getLinkage () const
 
bool isDiscardableIfUnused () const
 
bool isWeakForLinker () const
 
std::string getGlobalIdentifier () const
 Return the modified name for this global value suitable to be used as the key for a global lookup (e.g.
 
GUID getGUID () const
 Return a 64-bit global unique ID constructed from global value name (i.e.
 
bool isDeclaration () const
 Return true if the primary definition of this global value is outside of the current translation unit.
 
bool isDeclarationForLinker () const
 
bool isStrongDefinitionForLinker () const
 Returns true if this global's definition will be the one chosen by the linker.
 
const GlobalObjectgetAliaseeObject () const
 
GlobalObjectgetAliaseeObject ()
 
bool isAbsoluteSymbolRef () const
 Returns whether this is a reference to an absolute symbol.
 
std::optional< ConstantRangegetAbsoluteSymbolRange () const
 If this is an absolute symbol reference, returns the range of the symbol, otherwise returns std::nullopt.
 
void removeFromParent ()
 This method unlinks 'this' from the containing module, but does not delete it.
 
void eraseFromParent ()
 This method unlinks 'this' from the containing module and deletes it.
 
ModulegetParent ()
 Get the module that this global value is contained inside of...
 
const ModulegetParent () const
 
const DataLayoutgetDataLayout () const
 Get the data layout of the module this global belongs to.
 
bool canBeOmittedFromSymbolTable () const
 True if GV can be left out of the object symbol table.
 
bool isMaterializable () const
 If this function's Module is being lazily streamed in functions from disk or some other source, this method can be used to check to see if the function has been read in yet or not.
 
Error materialize ()
 Make sure this GlobalValue is fully read.
 
- Public Member Functions inherited from llvm::Constant
void operator= (const Constant &)=delete
 
 Constant (const Constant &)=delete
 
bool isNullValue () const
 Return true if this is the value that would be returned by getNullValue.
 
bool isOneValue () const
 Returns true if the value is one.
 
bool isNotOneValue () const
 Return true if the value is not the one value, or, for vectors, does not contain one value elements.
 
bool isAllOnesValue () const
 Return true if this is the value that would be returned by getAllOnesValue.
 
bool isNegativeZeroValue () const
 Return true if the value is what would be returned by getZeroValueForNegation.
 
bool isZeroValue () const
 Return true if the value is negative zero or null value.
 
bool isNotMinSignedValue () const
 Return true if the value is not the smallest signed value, or, for vectors, does not contain smallest signed value elements.
 
bool isMinSignedValue () const
 Return true if the value is the smallest signed value.
 
bool isFiniteNonZeroFP () const
 Return true if this is a finite and non-zero floating-point scalar constant or a fixed width vector constant with all finite and non-zero elements.
 
bool isNormalFP () const
 Return true if this is a normal (as opposed to denormal, infinity, nan, or zero) floating-point scalar constant or a vector constant with all normal elements.
 
bool hasExactInverseFP () const
 Return true if this scalar has an exact multiplicative inverse or this vector has an exact multiplicative inverse for each element in the vector.
 
bool isNaN () const
 Return true if this is a floating-point NaN constant or a vector floating-point constant with all NaN elements.
 
bool isElementWiseEqual (Value *Y) const
 Return true if this constant and a constant 'Y' are element-wise equal.
 
bool containsUndefOrPoisonElement () const
 Return true if this is a vector constant that includes any undef or poison elements.
 
bool containsPoisonElement () const
 Return true if this is a vector constant that includes any poison elements.
 
bool containsUndefElement () const
 Return true if this is a vector constant that includes any strictly undef (not poison) elements.
 
bool containsConstantExpression () const
 Return true if this is a fixed width vector constant that includes any constant expressions.
 
bool isThreadDependent () const
 Return true if the value can vary between threads.
 
bool isDLLImportDependent () const
 Return true if the value is dependent on a dllimport variable.
 
bool isConstantUsed () const
 Return true if the constant has users other than constant expressions and other dangling things.
 
bool needsRelocation () const
 This method classifies the entry according to whether or not it may generate a relocation entry (either static or dynamic).
 
bool needsDynamicRelocation () const
 
ConstantgetAggregateElement (unsigned Elt) const
 For aggregates (struct/array/vector) return the constant that corresponds to the specified element if possible, or null if not.
 
ConstantgetAggregateElement (Constant *Elt) const
 
ConstantgetSplatValue (bool AllowPoison=false) const
 If all elements of the vector constant have the same value, return that value.
 
const APIntgetUniqueInteger () const
 If C is a constant integer then return its value, otherwise C must be a vector of constant integers, all equal, and the common value is returned.
 
ConstantRange toConstantRange () const
 Convert constant to an approximate constant range.
 
void destroyConstant ()
 Called if some element of this constant is no longer valid.
 
void handleOperandChange (Value *, Value *)
 This method is a special form of User::replaceUsesOfWith (which does not work on constants) that does work on constants.
 
void removeDeadConstantUsers () const
 If there are any dead constant users dangling off of this constant, remove them.
 
bool hasOneLiveUse () const
 Return true if the constant has exactly one live use.
 
bool hasZeroLiveUses () const
 Return true if the constant has no live uses.
 
const ConstantstripPointerCasts () const
 
ConstantstripPointerCasts ()
 
bool isManifestConstant () const
 Return true if a constant is ConstantData or a ConstantAggregate or ConstantExpr that contain only ConstantData.
 
- Public Member Functions inherited from llvm::User
 User (const User &)=delete
 
void operator delete (void *Usr)
 Free memory allocated for User and Use objects.
 
void operator delete (void *Usr, HungOffOperandsAllocMarker)
 Placement delete - required by std, called if the ctor throws.
 
void operator delete (void *Usr, IntrusiveOperandsAllocMarker)
 Placement delete - required by std, called if the ctor throws.
 
void operator delete (void *Usr, IntrusiveOperandsAndDescriptorAllocMarker)
 Placement delete - required by std, called if the ctor throws.
 
const UsegetOperandList () const
 
UsegetOperandList ()
 
ValuegetOperand (unsigned i) const
 
void setOperand (unsigned i, Value *Val)
 
const UsegetOperandUse (unsigned i) const
 
UsegetOperandUse (unsigned i)
 
unsigned getNumOperands () const
 
ArrayRef< const uint8_tgetDescriptor () const
 Returns the descriptor co-allocated with this User instance.
 
MutableArrayRef< uint8_tgetDescriptor ()
 Returns the descriptor co-allocated with this User instance.
 
void setNumHungOffUseOperands (unsigned NumOps)
 Subclasses with hung off uses need to manage the operand count themselves.
 
bool isDroppable () const
 A droppable user is a user for which uses can be dropped without affecting correctness and should be dropped rather than preventing a transformation from happening.
 
op_iterator op_begin ()
 
const_op_iterator op_begin () const
 
op_iterator op_end ()
 
const_op_iterator op_end () const
 
op_range operands ()
 
const_op_range operands () const
 
value_op_iterator value_op_begin ()
 
value_op_iterator value_op_end ()
 
iterator_range< value_op_iteratoroperand_values ()
 
const_value_op_iterator value_op_begin () const
 
const_value_op_iterator value_op_end () const
 
iterator_range< const_value_op_iteratoroperand_values () const
 
void dropAllReferences ()
 Drop all references to operands.
 
bool replaceUsesOfWith (Value *From, Value *To)
 Replace uses of one Value with another.
 
- Public Member Functions inherited from llvm::Value
 Value (const Value &)=delete
 
Valueoperator= (const Value &)=delete
 
void deleteValue ()
 Delete a pointer to a generic Value.
 
void dump () const
 Support for debugging, callable in GDB: V->dump()
 
TypegetType () const
 All values are typed, get the type of this value.
 
LLVMContextgetContext () const
 All values hold a context through their type.
 
bool hasName () const
 
ValueNamegetValueName () const
 
void setValueName (ValueName *VN)
 
StringRef getName () const
 Return a constant reference to the value's name.
 
void setName (const Twine &Name)
 Change the name of the value.
 
void takeName (Value *V)
 Transfer the name from V to this value.
 
std::string getNameOrAsOperand () const
 
void replaceAllUsesWith (Value *V)
 Change all uses of this to point to a new Value.
 
void replaceNonMetadataUsesWith (Value *V)
 Change non-metadata uses of this to point to a new Value.
 
void replaceUsesWithIf (Value *New, llvm::function_ref< bool(Use &U)> ShouldReplace)
 Go through the uses list for this definition and make each use point to "V" if the callback ShouldReplace returns true for the given Use.
 
void replaceUsesOutsideBlock (Value *V, BasicBlock *BB)
 replaceUsesOutsideBlock - Go through the uses list for this definition and make each use point to "V" instead of "this" when the use is outside the block.
 
void assertModuleIsMaterializedImpl () const
 
void assertModuleIsMaterialized () const
 
bool use_empty () const
 
bool materialized_use_empty () const
 
use_iterator materialized_use_begin ()
 
const_use_iterator materialized_use_begin () const
 
use_iterator use_begin ()
 
const_use_iterator use_begin () const
 
use_iterator use_end ()
 
const_use_iterator use_end () const
 
iterator_range< use_iteratormaterialized_uses ()
 
iterator_range< const_use_iteratormaterialized_uses () const
 
iterator_range< use_iteratoruses ()
 
iterator_range< const_use_iteratoruses () const
 
bool user_empty () const
 
user_iterator materialized_user_begin ()
 
const_user_iterator materialized_user_begin () const
 
user_iterator user_begin ()
 
const_user_iterator user_begin () const
 
user_iterator user_end ()
 
const_user_iterator user_end () const
 
Useruser_back ()
 
const Useruser_back () const
 
iterator_range< user_iteratormaterialized_users ()
 
iterator_range< const_user_iteratormaterialized_users () const
 
iterator_range< user_iteratorusers ()
 
iterator_range< const_user_iteratorusers () const
 
bool hasOneUse () const
 Return true if there is exactly one use of this value.
 
bool hasNUses (unsigned N) const
 Return true if this Value has exactly N uses.
 
bool hasNUsesOrMore (unsigned N) const
 Return true if this value has N uses or more.
 
bool hasOneUser () const
 Return true if there is exactly one user of this value.
 
UsegetSingleUndroppableUse ()
 Return true if there is exactly one use of this value that cannot be dropped.
 
const UsegetSingleUndroppableUse () const
 
UsergetUniqueUndroppableUser ()
 Return true if there is exactly one unique user of this value that cannot be dropped (that user can have multiple uses of this value).
 
const UsergetUniqueUndroppableUser () const
 
bool hasNUndroppableUses (unsigned N) const
 Return true if there this value.
 
bool hasNUndroppableUsesOrMore (unsigned N) const
 Return true if this value has N uses or more.
 
void dropDroppableUses (llvm::function_ref< bool(const Use *)> ShouldDrop=[](const Use *) { return true;})
 Remove every uses that can safely be removed.
 
void dropDroppableUsesIn (User &Usr)
 Remove every use of this value in User that can safely be removed.
 
bool isUsedInBasicBlock (const BasicBlock *BB) const
 Check if this value is used in the specified basic block.
 
unsigned getNumUses () const
 This method computes the number of uses of this Value.
 
void addUse (Use &U)
 This method should only be used by the Use class.
 
unsigned getValueID () const
 Return an ID for the concrete type of this object.
 
unsigned getRawSubclassOptionalData () const
 Return the raw optional flags value contained in this value.
 
void clearSubclassOptionalData ()
 Clear the optional flags contained in this value.
 
bool hasSameSubclassOptionalData (const Value *V) const
 Check the optional flags for equality.
 
bool hasValueHandle () const
 Return true if there is a value handle associated with this value.
 
bool isUsedByMetadata () const
 Return true if there is metadata referencing this value.
 
bool isSwiftError () const
 Return true if this value is a swifterror value.
 
const ValuestripPointerCasts () const
 Strip off pointer casts, all-zero GEPs and address space casts.
 
ValuestripPointerCasts ()
 
const ValuestripPointerCastsAndAliases () const
 Strip off pointer casts, all-zero GEPs, address space casts, and aliases.
 
ValuestripPointerCastsAndAliases ()
 
const ValuestripPointerCastsSameRepresentation () const
 Strip off pointer casts, all-zero GEPs and address space casts but ensures the representation of the result stays the same.
 
ValuestripPointerCastsSameRepresentation ()
 
const ValuestripPointerCastsForAliasAnalysis () const
 Strip off pointer casts, all-zero GEPs, single-argument phi nodes and invariant group info.
 
ValuestripPointerCastsForAliasAnalysis ()
 
const ValuestripInBoundsConstantOffsets () const
 Strip off pointer casts and all-constant inbounds GEPs.
 
ValuestripInBoundsConstantOffsets ()
 
const ValuestripAndAccumulateConstantOffsets (const DataLayout &DL, APInt &Offset, bool AllowNonInbounds, bool AllowInvariantGroup=false, function_ref< bool(Value &Value, APInt &Offset)> ExternalAnalysis=nullptr) const
 Accumulate the constant offset this value has compared to a base pointer.
 
ValuestripAndAccumulateConstantOffsets (const DataLayout &DL, APInt &Offset, bool AllowNonInbounds, bool AllowInvariantGroup=false, function_ref< bool(Value &Value, APInt &Offset)> ExternalAnalysis=nullptr)
 
const ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset) const
 This is a wrapper around stripAndAccumulateConstantOffsets with the in-bounds requirement set to false.
 
ValuestripAndAccumulateInBoundsConstantOffsets (const DataLayout &DL, APInt &Offset)
 
const ValuestripInBoundsOffsets (function_ref< void(const Value *)> Func=[](const Value *) {}) const
 Strip off pointer casts and inbounds GEPs.
 
ValuestripInBoundsOffsets (function_ref< void(const Value *)> Func=[](const Value *) {})
 
std::optional< int64_t > getPointerOffsetFrom (const Value *Other, const DataLayout &DL) const
 If this ptr is provably equal to Other plus a constant offset, return that offset in bytes.
 
bool canBeFreed () const
 Return true if the memory object referred to by V can by freed in the scope for which the SSA value defining the allocation is statically defined.
 
uint64_t getPointerDereferenceableBytes (const DataLayout &DL, bool &CanBeNull, bool &CanBeFreed) const
 Returns the number of bytes known to be dereferenceable for the pointer value.
 
Align getPointerAlignment (const DataLayout &DL) const
 Returns an alignment of the pointer value.
 
const ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB) const
 Translate PHI node to its predecessor from the given basic block.
 
ValueDoPHITranslation (const BasicBlock *CurBB, const BasicBlock *PredBB)
 
void mutateType (Type *Ty)
 Mutate the type of this Value to be of the specified type.
 
template<class Compare >
void sortUseList (Compare Cmp)
 Sort the use-list.
 
void reverseUseList ()
 Reverse the use-list.
 
void print (raw_ostream &O, bool IsForDebug=false) const
 Implement operator<< on Value.
 
void print (raw_ostream &O, ModuleSlotTracker &MST, bool IsForDebug=false) const
 
void printAsOperand (raw_ostream &O, bool PrintType=true, const Module *M=nullptr) const
 Print the name of this Value out to the specified raw_ostream.
 
void printAsOperand (raw_ostream &O, bool PrintType, ModuleSlotTracker &MST) const
 
- Public Member Functions inherited from llvm::ilist_node_impl< OptionsT >
self_iterator getIterator ()
 
const_self_iterator getIterator () const
 
reverse_self_iterator getReverseIterator ()
 
const_reverse_self_iterator getReverseIterator () const
 
bool isSentinel () const
 Check whether this is the sentinel node.
 
- Public Member Functions inherited from llvm::ilist_detail::node_parent_access< ilist_node_impl< OptionsT >, OptionsT::parent_ty >
const OptionsT::parent_ty * getParent () const
 
OptionsT::parent_ty * getParent ()
 
void setParent (OptionsT::parent_ty *Parent)
 

Static Public Member Functions

static FunctionCreate (FunctionType *Ty, LinkageTypes Linkage, unsigned AddrSpace, const Twine &N="", Module *M=nullptr)
 
static FunctionCreate (FunctionType *Ty, LinkageTypes Linkage, const Twine &N="", Module *M=nullptr)
 
static FunctionCreate (FunctionType *Ty, LinkageTypes Linkage, const Twine &N, Module &M)
 Creates a new function and attaches it to a module.
 
static FunctioncreateWithDefaultAttr (FunctionType *Ty, LinkageTypes Linkage, unsigned AddrSpace, const Twine &N="", Module *M=nullptr)
 Creates a function with some attributes recorded in llvm.module.flags and the LLVMContext applied.
 
static bool classof (const Value *V)
 Methods for support type inquiry through isa, cast, and dyn_cast:
 
- Static Public Member Functions inherited from llvm::GlobalObject
static bool classof (const Value *V)
 
- Static Public Member Functions inherited from llvm::GlobalValue
static UnnamedAddr getMinUnnamedAddr (UnnamedAddr A, UnnamedAddr B)
 
static LinkageTypes getLinkOnceLinkage (bool ODR)
 
static LinkageTypes getWeakLinkage (bool ODR)
 
static bool isExternalLinkage (LinkageTypes Linkage)
 
static bool isAvailableExternallyLinkage (LinkageTypes Linkage)
 
static bool isLinkOnceAnyLinkage (LinkageTypes Linkage)
 
static bool isLinkOnceODRLinkage (LinkageTypes Linkage)
 
static bool isLinkOnceLinkage (LinkageTypes Linkage)
 
static bool isWeakAnyLinkage (LinkageTypes Linkage)
 
static bool isWeakODRLinkage (LinkageTypes Linkage)
 
static bool isWeakLinkage (LinkageTypes Linkage)
 
static bool isAppendingLinkage (LinkageTypes Linkage)
 
static bool isInternalLinkage (LinkageTypes Linkage)
 
static bool isPrivateLinkage (LinkageTypes Linkage)
 
static bool isLocalLinkage (LinkageTypes Linkage)
 
static bool isExternalWeakLinkage (LinkageTypes Linkage)
 
static bool isCommonLinkage (LinkageTypes Linkage)
 
static bool isValidDeclarationLinkage (LinkageTypes Linkage)
 
static bool isInterposableLinkage (LinkageTypes Linkage)
 Whether the definition of this global may be replaced by something non-equivalent at link time.
 
static bool isDiscardableIfUnused (LinkageTypes Linkage)
 Whether the definition of this global may be discarded if it is not used in its compilation unit.
 
static bool isWeakForLinker (LinkageTypes Linkage)
 Whether the definition of this global may be replaced at link time.
 
static StringRef dropLLVMManglingEscape (StringRef Name)
 If the given string begins with the GlobalValue name mangling escape character '\1', drop it.
 
static std::string getGlobalIdentifier (StringRef Name, GlobalValue::LinkageTypes Linkage, StringRef FileName)
 Return the modified name for a global value suitable to be used as the key for a global lookup (e.g.
 
static GUID getGUID (StringRef GlobalName)
 Return a 64-bit global unique ID constructed from global value name (i.e.
 
static bool classof (const Value *V)
 
- Static Public Member Functions inherited from llvm::Constant
static bool classof (const Value *V)
 
static ConstantgetNullValue (Type *Ty)
 Constructor to create a '0' constant of arbitrary type.
 
static ConstantgetAllOnesValue (Type *Ty)
 
static ConstantgetIntegerValue (Type *Ty, const APInt &V)
 Return the value for an integer or pointer constant, or a vector thereof, with the given scalar value.
 
static ConstantreplaceUndefsWith (Constant *C, Constant *Replacement)
 Try to replace undefined constant C or undefined elements in C with Replacement.
 
static ConstantmergeUndefsWith (Constant *C, Constant *Other)
 Merges undefs of a Constant with another Constant, along with the undefs already present.
 
- Static Public Member Functions inherited from llvm::User
static bool classof (const Value *V)
 
- Static Public Member Functions inherited from llvm::Value
static void dropDroppableUse (Use &U)
 Remove the droppable use U.
 

Public Attributes

bool IsNewDbgInfoFormat
 Is this function using intrinsics to record the position of debugging information, or non-intrinsic records? See IsNewDbgInfoFormat in BasicBlock.
 

Friends

class SymbolTableListTraits< Function >
 
class TargetLibraryInfoImpl
 
template<class BB_t , class BB_i_t , class BI_t , class II_t >
class InstIterator
 
class llvm::SymbolTableListTraits< llvm::BasicBlock >
 
class llvm::ilist_node_with_parent< llvm::BasicBlock, llvm::Function >
 
void BasicBlock::setParent (Function *)
 
void BasicBlock::removeFromParent ()
 
iplist< BasicBlock >::iterator BasicBlock::eraseFromParent ()
 

Additional Inherited Members

- Static Public Attributes inherited from llvm::Value
static constexpr unsigned MaxAlignmentExponent = 32
 The maximum alignment for instructions.
 
static constexpr uint64_t MaximumAlignment = 1ULL << MaxAlignmentExponent
 
- Protected Types inherited from llvm::GlobalObject
enum  { LastAlignmentBit = 5 , LastCodeModelBit = 8 , HasSectionHashEntryBit , GlobalObjectBits }
 
- Protected Types inherited from llvm::Value
enum  : unsigned { NumUserOperandsBits = 27 }
 The number of operands in the subclass. More...
 
- Protected Types inherited from llvm::ilist_node_impl< OptionsT >
using self_iterator = typename ilist_select_iterator_type< OptionsT::has_iterator_bits, OptionsT, false, false >::type
 
using const_self_iterator = typename ilist_select_iterator_type< OptionsT::has_iterator_bits, OptionsT, false, true >::type
 
using reverse_self_iterator = typename ilist_select_iterator_type< OptionsT::has_iterator_bits, OptionsT, true, false >::type
 
using const_reverse_self_iterator = typename ilist_select_iterator_type< OptionsT::has_iterator_bits, OptionsT, true, true >::type
 
- Protected Member Functions inherited from llvm::GlobalObject
 GlobalObject (Type *Ty, ValueTy VTy, AllocInfo AllocInfo, LinkageTypes Linkage, const Twine &Name, unsigned AddressSpace=0)
 
 ~GlobalObject ()
 
void copyAttributesFrom (const GlobalObject *Src)
 
- Protected Member Functions inherited from llvm::GlobalValue
 GlobalValue (Type *Ty, ValueTy VTy, AllocInfo AllocInfo, LinkageTypes Linkage, const Twine &Name, unsigned AddressSpace)
 
unsigned getGlobalValueSubClassData () const
 
void setGlobalValueSubClassData (unsigned V)
 
void setParent (Module *parent)
 
 ~GlobalValue ()
 
void copyAttributesFrom (const GlobalValue *Src)
 Copy all additional attributes (those not needed to create a GlobalValue) from the GlobalValue Src to this one.
 
- Protected Member Functions inherited from llvm::Constant
 Constant (Type *ty, ValueTy vty, AllocInfo AllocInfo)
 
 ~Constant ()=default
 
- Protected Member Functions inherited from llvm::User
void * operator new (size_t Size)=delete
 
void * operator new (size_t Size, HungOffOperandsAllocMarker)
 Allocate a User with an operand pointer co-allocated.
 
void * operator new (size_t Size, IntrusiveOperandsAllocMarker allocTrait)
 Allocate a User with the operands co-allocated.
 
void * operator new (size_t Size, IntrusiveOperandsAndDescriptorAllocMarker allocTrait)
 Allocate a User with the operands co-allocated.
 
 User (Type *ty, unsigned vty, AllocInfo AllocInfo)
 
void allocHungoffUses (unsigned N, bool IsPhi=false)
 Allocate the array of Uses, followed by a pointer (with bottom bit set) to the User.
 
void growHungoffUses (unsigned N, bool IsPhi=false)
 Grow the number of hung off uses.
 
 ~User ()=default
 
template<int Idx>
UseOp ()
 
template<int Idx>
const UseOp () const
 
- Protected Member Functions inherited from llvm::Value
 Value (Type *Ty, unsigned scid)
 
 ~Value ()
 Value's destructor should be virtual by design, but that would require that Value and all of its subclasses have a vtable that effectively duplicates the information in the value ID.
 
void getAllMetadata (SmallVectorImpl< std::pair< unsigned, MDNode * > > &MDs) const
 Appends all metadata attached to this value to MDs, sorting by KindID.
 
bool hasMetadata () const
 Return true if this value has any metadata attached to it.
 
bool eraseMetadata (unsigned KindID)
 Erase all metadata attachments with the given kind.
 
void eraseMetadataIf (function_ref< bool(unsigned, MDNode *)> Pred)
 Erase all metadata attachments matching the given predicate.
 
void clearMetadata ()
 Erase all metadata attached to this Value.
 
MDNodegetMetadataImpl (unsigned KindID) const
 Get metadata for the given kind, if any.
 
unsigned short getSubclassDataFromValue () const
 
void setValueSubclassData (unsigned short D)
 
MDNodegetMetadata (unsigned KindID) const
 Get the current metadata attachments for the given kind, if any.
 
MDNodegetMetadata (StringRef Kind) const
 
void getMetadata (unsigned KindID, SmallVectorImpl< MDNode * > &MDs) const
 Appends all attachments with the given ID to MDs in insertion order.
 
void getMetadata (StringRef Kind, SmallVectorImpl< MDNode * > &MDs) const
 
bool hasMetadata (unsigned KindID) const
 Return true if this value has the given type of metadata attached.
 
bool hasMetadata (StringRef Kind) const
 
void setMetadata (unsigned KindID, MDNode *Node)
 Set a particular kind of metadata attachment.
 
void setMetadata (StringRef Kind, MDNode *Node)
 
void addMetadata (unsigned KindID, MDNode &MD)
 Add a metadata attachment.
 
void addMetadata (StringRef Kind, MDNode &MD)
 
- Protected Member Functions inherited from llvm::ilist_node_impl< OptionsT >
 ilist_node_impl ()=default
 
- Static Protected Member Functions inherited from llvm::User
template<int Idx, typename U >
static UseOpFrom (const U *that)
 
- Protected Attributes inherited from llvm::GlobalObject
ComdatObjComdat = nullptr
 
- Protected Attributes inherited from llvm::GlobalValue
TypeValueType
 
unsigned Linkage: 4
 
unsigned Visibility: 2
 
unsigned UnnamedAddrVal: 2
 
unsigned DllStorageClass: 2
 
unsigned ThreadLocal: 3
 
unsigned HasLLVMReservedName: 1
 True if the function's name starts with "llvm.".
 
unsigned IsDSOLocal: 1
 If true then there is a definition within the same linkage unit and that definition cannot be runtime preempted.
 
unsigned HasPartition: 1
 True if this symbol has a partition name assigned (see https://lld.llvm.org/Partitions.html).
 
unsigned HasSanitizerMetadata: 1
 True if this symbol has sanitizer metadata available.
 
Intrinsic::ID IntID = (Intrinsic::ID)0U
 The intrinsic ID for this subclass (which must be a Function).
 
ModuleParent = nullptr
 
- Protected Attributes inherited from llvm::Value
unsigned char SubclassOptionalData: 7
 Hold subclass data that can be dropped.
 
unsigned NumUserOperands: NumUserOperandsBits
 
unsigned IsUsedByMD: 1
 
unsigned HasName: 1
 
unsigned HasMetadata: 1
 
unsigned HasHungOffUses: 1
 
unsigned HasDescriptor: 1
 
- Static Protected Attributes inherited from llvm::GlobalObject
static const unsigned GlobalObjectSubClassDataBits
 
- Static Protected Attributes inherited from llvm::GlobalValue
static const unsigned GlobalValueSubClassDataBits = 15
 

Detailed Description

Definition at line 63 of file Function.h.

Member Typedef Documentation

◆ arg_iterator

Definition at line 71 of file Function.h.

◆ BasicBlockListType

Definition at line 65 of file Function.h.

◆ const_arg_iterator

Definition at line 72 of file Function.h.

◆ const_iterator

Definition at line 69 of file Function.h.

◆ iterator

Definition at line 68 of file Function.h.

Member Enumeration Documentation

◆ ProfileCountType

Enumerator
PCT_Real 
PCT_Synthetic 

Definition at line 287 of file Function.h.

Constructor & Destructor Documentation

◆ Function()

llvm::Function::Function ( const Function )
delete

◆ ~Function()

Function::~Function ( )

Definition at line 521 of file Function.cpp.

Member Function Documentation

◆ addAttributeAtIndex()

void Function::addAttributeAtIndex ( unsigned  i,
Attribute  Attr 
)

adds the attribute to the list of attributes.

Definition at line 637 of file Function.cpp.

◆ addDereferenceableOrNullParamAttr()

void Function::addDereferenceableOrNullParamAttr ( unsigned  ArgNo,
uint64_t  Bytes 
)

adds the dereferenceable_or_null attribute to the list of attributes for the given arg.

Definition at line 797 of file Function.cpp.

◆ addDereferenceableParamAttr()

void Function::addDereferenceableParamAttr ( unsigned  ArgNo,
uint64_t  Bytes 
)

adds the dereferenceable attribute to the list of attributes for the given arg.

Definition at line 726 of file Function.cpp.

◆ addFnAttr() [1/3]

void Function::addFnAttr ( Attribute  Attr)

Add function attributes to this function.

Definition at line 649 of file Function.cpp.

◆ addFnAttr() [2/3]

void Function::addFnAttr ( Attribute::AttrKind  Kind)

◆ addFnAttr() [3/3]

void Function::addFnAttr ( StringRef  Kind,
StringRef  Val = StringRef() 
)

Add function attributes to this function.

Definition at line 645 of file Function.cpp.

◆ addFnAttrs()

void Function::addFnAttrs ( const AttrBuilder Attrs)

Add function attributes to this function.

Definition at line 653 of file Function.cpp.

◆ addParamAttr() [1/2]

void Function::addParamAttr ( unsigned  ArgNo,
Attribute  Attr 
)

adds the attribute to the list of attributes for the given arg.

Definition at line 673 of file Function.cpp.

◆ addParamAttr() [2/2]

void Function::addParamAttr ( unsigned  ArgNo,
Attribute::AttrKind  Kind 
)

adds the attribute to the list of attributes for the given arg.

Definition at line 669 of file Function.cpp.

Referenced by llvm::OpenMPIRBuilder::emitUserDefinedMapper(), hostParallelCallback(), and targetParallelCallback().

◆ addParamAttrs()

void Function::addParamAttrs ( unsigned  ArgNo,
const AttrBuilder Attrs 
)

adds the attributes to the list of attributes for the given arg.

Definition at line 677 of file Function.cpp.

◆ addRangeRetAttr()

void Function::addRangeRetAttr ( const ConstantRange CR)

adds the range attribute to the list of attributes for the return value.

Definition at line 803 of file Function.cpp.

◆ addRetAttr() [1/2]

void Function::addRetAttr ( Attribute  Attr)

Add return value attributes to this function.

Definition at line 661 of file Function.cpp.

◆ addRetAttr() [2/2]

void Function::addRetAttr ( Attribute::AttrKind  Kind)

Add return value attributes to this function.

Definition at line 657 of file Function.cpp.

◆ addRetAttrs()

void Function::addRetAttrs ( const AttrBuilder Attrs)

Add return value attributes to this function.

Definition at line 665 of file Function.cpp.

◆ arg_begin() [1/2]

arg_iterator llvm::Function::arg_begin ( )
inline

◆ arg_begin() [2/2]

const_arg_iterator llvm::Function::arg_begin ( ) const
inline

Definition at line 872 of file Function.h.

References Arguments.

◆ arg_empty()

bool llvm::Function::arg_empty ( ) const
inline

Definition at line 902 of file Function.h.

◆ arg_end() [1/2]

arg_iterator llvm::Function::arg_end ( )
inline

◆ arg_end() [2/2]

const_arg_iterator llvm::Function::arg_end ( ) const
inline

Definition at line 881 of file Function.h.

References Arguments.

◆ arg_size()

size_t llvm::Function::arg_size ( ) const
inline

◆ args() [1/2]

iterator_range< arg_iterator > llvm::Function::args ( )
inline

◆ args() [2/2]

iterator_range< const_arg_iterator > llvm::Function::args ( ) const
inline

Definition at line 895 of file Function.h.

References llvm::make_range().

◆ back() [1/2]

BasicBlock & llvm::Function::back ( )
inline

◆ back() [2/2]

const BasicBlock & llvm::Function::back ( ) const
inline

◆ begin() [1/2]

iterator llvm::Function::begin ( )
inline

◆ begin() [2/2]

const_iterator llvm::Function::begin ( ) const
inline

◆ callsFunctionThatReturnsTwice()

bool Function::callsFunctionThatReturnsTwice ( ) const

callsFunctionThatReturnsTwice - Return true if the function has a call to setjmp or other function that gcc recognizes as "returning twice".

Definition at line 1039 of file Function.cpp.

◆ cannotDuplicate()

bool llvm::Function::cannotDuplicate ( ) const
inline

Determine if the call cannot be duplicated.

Definition at line 603 of file Function.h.

◆ classof()

static bool llvm::Function::classof ( const Value V)
inlinestatic

Methods for support type inquiry through isa, cast, and dyn_cast:

Definition at line 970 of file Function.h.

◆ clearGC()

void Function::clearGC ( )

Definition at line 845 of file Function.cpp.

◆ convertFromNewDbgValues()

void Function::convertFromNewDbgValues ( )
See also
BasicBlock::convertFromNewDbgValues.

Definition at line 98 of file Function.cpp.

◆ convertToNewDbgValues()

void Function::convertToNewDbgValues ( )
See also
BasicBlock::convertToNewDbgValues.

Definition at line 91 of file Function.cpp.

◆ copyAttributesFrom()

void Function::copyAttributesFrom ( const Function Src)

copyAttributesFrom - copy all additional attributes (those not needed to create a Function) from the Function Src to this one.

Copy all additional attributes (those not needed to create a Function) from the Function Src to this one.

Definition at line 860 of file Function.cpp.

Referenced by addVariantDeclaration(), llvm::CloneFunctionAttributesInto(), llvm::orc::cloneFunctionDecl(), llvm::CloneModule(), createMergedFunction(), doPromotion(), getTLIFunction(), and moveFunctionAdaptingType().

◆ Create() [1/3]

Function * Function::Create ( FunctionType Ty,
LinkageTypes  Linkage,
const Twine N,
Module M 
)
static

Creates a new function and attaches it to a module.

Places the function in the program address space as specified by the module's data layout.

Definition at line 385 of file Function.cpp.

◆ Create() [2/3]

static Function * llvm::Function::Create ( FunctionType Ty,
LinkageTypes  Linkage,
const Twine N = "",
Module M = nullptr 
)
inlinestatic

Definition at line 180 of file Function.h.

References Linkage, and N.

◆ Create() [3/3]

static Function * llvm::Function::Create ( FunctionType Ty,
LinkageTypes  Linkage,
unsigned  AddrSpace,
const Twine N = "",
Module M = nullptr 
)
inlinestatic

◆ createWithDefaultAttr()

Function * Function::createWithDefaultAttr ( FunctionType Ty,
LinkageTypes  Linkage,
unsigned  AddrSpace,
const Twine N = "",
Module M = nullptr 
)
static

Creates a function with some attributes recorded in llvm.module.flags and the LLVMContext applied.

Use this when synthesizing new functions that need attributes that would have been set by command line options.

This function should not be called from backends or the LTO pipeline. If it is called from one of those places, some default attributes will not be applied to the function.

Definition at line 390 of file Function.cpp.

Referenced by llvm::createSanitizerCtor().

◆ DECLARE_TRANSPARENT_OPERAND_ACCESSORS()

llvm::Function::DECLARE_TRANSPARENT_OPERAND_ACCESSORS ( Value  )

◆ deleteBody()

void llvm::Function::deleteBody ( )
inline

deleteBody - This method deletes the body of the function, and converts the linkage to external.

Definition at line 731 of file Function.h.

Referenced by llvm::CallGraphUpdater::removeFunction().

◆ doesNoCfCheck()

bool llvm::Function::doesNoCfCheck ( ) const
inline

Determine if the function should not perform indirect branch tracking.

Definition at line 592 of file Function.h.

◆ doesNotAccessMemory()

bool Function::doesNotAccessMemory ( ) const

Determine if the function does not access memory.

Definition at line 884 of file Function.cpp.

◆ doesNotFreeMemory()

bool llvm::Function::doesNotFreeMemory ( ) const
inline

Determine if the call might deallocate memory.

Definition at line 630 of file Function.h.

◆ doesNotRecurse()

bool llvm::Function::doesNotRecurse ( ) const
inline

Determine if the function is known not to recurse, directly or indirectly.

Definition at line 647 of file Function.h.

◆ doesNotReturn()

bool llvm::Function::doesNotReturn ( ) const
inline

Determine if the function cannot return.

Definition at line 584 of file Function.h.

◆ doesNotThrow()

bool llvm::Function::doesNotThrow ( ) const
inline

Determine if the function cannot unwind.

Definition at line 595 of file Function.h.

Referenced by llvm::VPRecipeBase::mayHaveSideEffects(), llvm::EscapeEnumerator::Next(), and llvm::InstCombinerImpl::visitCallInst().

◆ dropAllReferences()

void llvm::Function::dropAllReferences ( )
inline

dropAllReferences() - This method causes all the subinstructions to "let go" of all references that they are maintaining.

This allows one to 'delete' a whole module at a time, even though there may be circular references... first all references are dropped, and all use counts go to zero. Then everything is deleted for real. Note that no operations are valid on an object that has "dropped all references", except operator delete.

Since no other object in the module can have references into the body of a function, dropping all references deletes the entire body of the function, including any contained basic blocks.

Definition at line 986 of file Function.h.

◆ empty()

bool llvm::Function::empty ( ) const
inline

◆ end() [1/2]

iterator llvm::Function::end ( )
inline

◆ end() [2/2]

const_iterator llvm::Function::end ( ) const
inline

Definition at line 856 of file Function.h.

References llvm::SmallVectorTemplateCommon< T, typename >::end().

◆ erase()

Function::iterator Function::erase ( Function::iterator  FromIt,
Function::iterator  ToIt 
)

Erases a range of BasicBlocks from FromIt to (not including) ToIt.

\Returns ToIt.

Definition at line 474 of file Function.cpp.

◆ eraseFromParent()

void Function::eraseFromParent ( )

eraseFromParent - This method unlinks 'this' from the containing module and deletes it.

Definition at line 458 of file Function.cpp.

Referenced by llvm::ArgumentPromotionPass::run(), stripDebugDeclareImpl(), llvm::stripDebugifyMetadata(), llvm::UpgradeARCRuntime(), and llvm::PredicateInfo::~PredicateInfo().

◆ front() [1/2]

BasicBlock & llvm::Function::front ( )
inline

◆ front() [2/2]

const BasicBlock & llvm::Function::front ( ) const
inline

◆ getArg()

Argument * llvm::Function::getArg ( unsigned  i) const
inline

◆ getAttributeAtIndex() [1/2]

Attribute Function::getAttributeAtIndex ( unsigned  i,
Attribute::AttrKind  Kind 
) const

gets the attribute from the list of attributes.

Definition at line 752 of file Function.cpp.

◆ getAttributeAtIndex() [2/2]

Attribute Function::getAttributeAtIndex ( unsigned  i,
StringRef  Kind 
) const

gets the attribute from the list of attributes.

Definition at line 757 of file Function.cpp.

◆ getAttributes()

AttributeList llvm::Function::getAttributes ( ) const
inline

Return the attribute list for this Function.

Definition at line 353 of file Function.h.

Referenced by llvm::OpenMPIRBuilder::addAttributes(), llvm::TargetLowering::BuildSDIVPow2(), llvm::TargetLowering::BuildSREMPow2(), llvm::CloneAndPruneIntoFromInst(), llvm::CloneFunctionAttributesInto(), llvm::FunctionComparator::compareSignature(), llvm::coro::BaseCloner::create(), llvm::OpenMPIRBuilder::createReductionsGPU(), createThunk(), doPromotion(), llvm::AArch64FrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::XCoreFrameLowering::emitPrologue(), fillOverallFunction(), llvm::IRPosition::getAttrList(), llvm::SystemZELFRegisters::getCalleeSavedRegs(), llvm::AArch64RegisterInfo::getCalleeSavedRegs(), llvm::SystemZELFRegisters::getCallPreservedMask(), llvm::AArch64RegisterInfo::getCallPreservedMask(), llvm::ARMBaseRegisterInfo::getCallPreservedMask(), getCopyFromParts(), llvm::AArch64RegisterInfo::getDarwinCalleeSavedRegs(), llvm::AArch64RegisterInfo::getDarwinCallPreservedMask(), getFixedObjectSize(), getMemcpyLoadsAndStores(), getMemmoveLoadsAndStores(), getMemsetStores(), insertSinCosCall(), llvm::PPCInstrInfo::isSignOrZeroExtended(), llvm::Attributor::isValidFunctionSignatureRewrite(), moveFunctionAdaptingType(), optimizeDoubleFP(), llvm::BasicTTIImplBase< T >::preferToKeepConstantsAttached(), produceCompactUnwindFrame(), llvm::RISCVTargetLowering::ReplaceNodeResults(), llvm::FunctionLoweringInfo::set(), llvm::TargetLowering::SimplifySetCC(), and llvm::PPCTargetLowering::supportsTailCallFor().

◆ getBlockNumberEpoch()

unsigned llvm::Function::getBlockNumberEpoch ( ) const
inline

Return the "epoch" of current block numbers.

This will return a different value after every renumbering. The intention is: if something (e.g., an analysis) uses block numbers, it also stores the number epoch and then can assert later on that the epoch didn't change (indicating that the numbering is still valid). If the epoch changed, blocks might have been assigned new numbers and previous uses of the numbers needs to be invalidated. This is solely intended as a debugging feature.

Definition at line 842 of file Function.h.

◆ getCallingConv()

CallingConv::ID llvm::Function::getCallingConv ( ) const
inline

getCallingConv()/setCallingConv(CC) - These method get and set the calling convention of this function.

The enum values for the known calling conventions are defined in CallingConv.h.

Definition at line 277 of file Function.h.

Referenced by llvm::SIMachineFunctionInfo::allocateVGPRSpillToAGPR(), llvm::AMDGPUTargetLowering::analyzeFormalArgumentsCompute(), llvm::AMDGPUCallLowering::areCalleeOutgoingArgsTailCallable(), llvm::FunctionComparator::compareSignature(), computeCalleeSaveRegisterPairs(), llvm::computeSignatureVTs(), llvm::coro::createMustTailCall(), createThunk(), llvm::AArch64FrameLowering::determineCalleeSaves(), llvm::AMDGPUCallLowering::doCallerAndCalleePassArgsTheSameWay(), llvm::AArch64FrameLowering::emitEpilogue(), llvm::ARMFrameLowering::emitEpilogue(), llvm::LoongArchFrameLowering::emitEpilogue(), llvm::PPCFrameLowering::emitEpilogue(), llvm::RISCVFrameLowering::emitEpilogue(), llvm::SystemZELFFrameLowering::emitEpilogue(), llvm::AArch64FrameLowering::emitPrologue(), llvm::ARMFrameLowering::emitPrologue(), llvm::LoongArchFrameLowering::emitPrologue(), llvm::RISCVFrameLowering::emitPrologue(), llvm::SystemZELFFrameLowering::emitPrologue(), llvm::X86FrameLowering::emitPrologue(), llvm::X86FrameLowering::enableShrinkWrapping(), findScratchNonCalleeSaveRegister(), llvm::MCResourceInfo::gatherResourceInfo(), llvm::SystemZELFRegisters::getCalleeSavedRegs(), llvm::AArch64RegisterInfo::getCalleeSavedRegs(), llvm::SIRegisterInfo::getCalleeSavedRegs(), llvm::LoongArchRegisterInfo::getCalleeSavedRegs(), llvm::PPCRegisterInfo::getCalleeSavedRegs(), llvm::RISCVRegisterInfo::getCalleeSavedRegs(), llvm::VERegisterInfo::getCalleeSavedRegs(), llvm::AArch64RegisterInfo::getCalleeSavedRegsViaCopy(), llvm::ARMBaseRegisterInfo::getCalleeSavedRegsViaCopy(), llvm::X86RegisterInfo::getCalleeSavedRegsViaCopy(), llvm::AArch64RegisterInfo::getDarwinCalleeSavedRegs(), llvm::SIInstrInfo::getDSShaderTypeValue(), llvm::X86FrameLowering::getFrameIndexReference(), llvm::SIMachineFunctionInfo::getGITPtrLoReg(), llvm::Mangler::getNameWithPrefix(), llvm::M68kRegisterInfo::getReservedRegs(), llvm::RISCVRegisterInfo::getReservedRegs(), llvm::X86RegisterInfo::getReservedRegs(), llvm::coro::Shape::getResumeFunctionCC(), GetScratchRegister(), llvm::AArch64RegisterInfo::getStrictlyReservedRegs(), llvm::X86FrameLowering::has128ByteRedZone(), llvm::InlineFunction(), llvm::AArch64RegisterInfo::isArgumentRegister(), llvm::X86RegisterInfo::isArgumentRegister(), isCallableFunction(), llvm::TargetRegisterInfo::isCalleeSavedPhysReg(), llvm::AArch64CallLowering::isEligibleForTailCallOptimization(), llvm::AMDGPUCallLowering::isEligibleForTailCallOptimization(), llvm::HexagonTargetLowering::IsEligibleForTailCallOptimization(), llvm::SITargetLowering::isEligibleForTailCallOptimization(), llvm::SIInstrInfo::legalizeOperands(), LowerVACOPY(), llvm::SITargetLowering::mayBeEmittedAsTailCall(), produceCompactUnwindFrame(), reservePrivateMemoryRegs(), llvm::AArch64FrameLowering::resolveFrameOffsetReference(), llvm::FunctionLoweringInfo::set(), llvm::X86RegisterInfo::shouldRealignStack(), llvm::AArch64TargetLowering::supportSplitCSR(), llvm::PPCTargetLowering::supportsTailCallFor(), llvm::SystemZELFFrameLowering::usePackedStack(), llvm::SIMachineFunctionInfo::usesAGPRs(), llvm::R600InstrInfo::usesTextureCache(), and llvm::R600InstrInfo::usesVertexCache().

◆ getContext()

LLVMContext & Function::getContext ( ) const

getContext - Return a reference to the LLVMContext associated with this function.

Definition at line 369 of file Function.cpp.

Referenced by AddAliasScopeMetadata(), llvm::OpenMPIRBuilder::addAttributes(), addBoundsChecking(), AddParamAndFnBasicAttributes(), AddReturnAttributes(), llvm::ARMFrameLowering::adjustForSegmentedStacks(), llvm::MachineOptimizationRemarkEmitter::allowExtraAnalysis(), llvm::AMDGPUCallLowering::areCalleeOutgoingArgsTailCallable(), llvm::MachineIRBuilder::buildFConstant(), llvm::buildNDRange(), llvm::AArch64CallLowering::canLowerReturn(), llvm::RISCVCallLowering::canLowerReturn(), llvm::X86CallLowering::canLowerReturn(), llvm::CloneFunctionAttributesInto(), collectCallSiteParameters(), llvm::SITargetLowering::computeKnownAlignForTargetInstr(), convertImplicitDefToConstZero(), createAndInsertBasicBlocks(), createAtomicLibcall(), createFPFnStub(), llvm::createMemLibcall(), llvm::TargetInstrInfo::describeLoadedValue(), duplicateCPV(), llvm::OptimizationRemarkEmitter::emit(), llvm::MachineOptimizationRemarkEmitter::emit(), emitEntryMD(), emitErrorMsg(), llvm::MachineInstr::emitGenericError(), llvm::MachineInstr::emitInlineAsmError(), EmitInlineAsmStr(), llvm::ARMBaseRegisterInfo::emitLoadConstPool(), llvm::RISCVFrameLowering::emitPrologue(), emitThumb1LoadConstPool(), emitThumb2LoadConstPool(), emitUnsupportedError(), llvm::OptimizationRemarkEmitter::enabled(), llvm::GIMatchTableExecutor::executeMatchTable(), llvm::FastISel::fastEmit_ri_(), fixupDebugInfoPostExtraction(), fixupLineNumbers(), llvm::X86InstrInfo::foldMemoryOperandImpl(), getBBAddrMapFeature(), llvm::MachineIRBuilder::getContext(), getEntryPropAsMetadata(), llvm::RegAllocBase::getErrorAssignment(), getFuncAddrForProfData(), llvm::CSKYInstrInfo::getGlobalBaseReg(), llvm::OpenMPIRBuilder::getOrCreateRuntimeFunction(), llvm::SPIRVGlobalRegistry::getOrCreateSPIRVBoolType(), llvm::getOrCreateSPIRVDeviceEventPointer(), llvm::SPIRVGlobalRegistry::getOrCreateSPIRVFloatType(), llvm::SPIRVGlobalRegistry::getOrCreateSPIRVIntegerType(), llvm::SPIRVGlobalRegistry::getOrCreateSPIRVType(), llvm::SPIRVGlobalRegistry::getOrCreateSPIRVTypeByName(), getPointeeTypeByCallInst(), getRegistersForValue(), llvm::FunctionLoweringInfo::getValueFromVirtualReg(), llvm::SelectionDAG::init(), INITIALIZE_PASS(), InsertCall(), insertCallBeforeInstruction(), llvm::XtensaInstrInfo::insertIndirectBranch(), insertInlineAsmProcess(), interpretValues(), llvm::MachineOptimizationRemark::isEnabled(), llvm::MachineOptimizationRemarkMissed::isEnabled(), llvm::MachineOptimizationRemarkAnalysis::isEnabled(), llvm::OptimizationRemark::isEnabled(), llvm::OptimizationRemarkMissed::isEnabled(), llvm::OptimizationRemarkAnalysis::isEnabled(), llvm::PPCTargetLowering::isFMAFasterThanFMulAndFAdd(), llvm::AMDGPULegalizerInfo::legalizeAddrSpaceCast(), llvm::ARMLegalizerInfo::legalizeCustom(), llvm::AMDGPULegalizerInfo::legalizeGlobalValue(), llvm::RISCVLegalizerInfo::legalizeIntrinsic(), llvm::AMDGPULegalizerInfo::legalizeSBufferLoad(), llvm::LegalizerHelper::libcall(), llvm::XtensaInstrInfo::loadImmediate(), llvm::XCoreInstrInfo::loadImmediate(), llvm::AArch64CallLowering::lowerCall(), llvm::RISCVTargetLowering::LowerCall(), LowerFPToInt(), llvm::LegalizerHelper::lowerLoad(), llvm::lowerObjectSizeCall(), llvm::RISCVTargetLowering::LowerReturn(), llvm::LegalizerHelper::lowerStore(), llvm::LegalizerHelper::lowerThreewayCompare(), llvm::LegalizerHelper::lowerVAArg(), llvm::CombinerHelper::matchCombineExtractedVectorLoad(), llvm::CombinerHelper::matchHoistLogicOpWithSameOpcodeHands(), llvm::CombinerHelper::matchLoadOrCombine(), moveFunctionAdaptingType(), llvm::MIPrinter::print(), llvm::MachineInstr::print(), processBlockAddr(), reportIllegalCopy(), llvm::MachineOptimizationRemarkEmitterAnalysis::run(), llvm::ExecutionEngine::runFunctionAsMain(), llvm::ConstantHoistingPass::runImpl(), llvm::OptimizationRemarkEmitterWrapperPass::runOnFunction(), llvm::SelectionDAGISel::runOnMachineFunction(), llvm::MachineOptimizationRemarkEmitterPass::runOnMachineFunction(), llvm::NVPTXDAGToDAGISel::runOnMachineFunction(), llvm::FastISel::selectExtractValue(), llvm::RAGreedy::selectOrSplit(), llvm::FunctionLoweringInfo::set(), tryToOptimizeStoreOfAllocationToGlobal(), updateNVPTXMetadata(), validateGroupWaitEventsPtr(), validateLifetimeStart(), and llvm::LegalizerHelper::widenScalar().

◆ getDataLayout()

const DataLayout & Function::getDataLayout ( ) const

◆ getDenormalMode()

DenormalMode Function::getDenormalMode ( const fltSemantics FPType) const

Returns the denormal handling type for the default rounding mode of the function.

Definition at line 807 of file Function.cpp.

Referenced by atomicIgnoresDenormalModeOrFPModeIsFTZ(), computeKnownFPClass(), llvm::MachineFunction::getDenormalMode(), and getInstrDenormalMode().

◆ getDenormalModeF32Raw()

DenormalMode Function::getDenormalModeF32Raw ( ) const

Return the representational value of "denormal-fp-math-f32".

Code interested in the semantics of the function should use getDenormalMode instead.

Definition at line 825 of file Function.cpp.

◆ getDenormalModeRaw()

DenormalMode Function::getDenormalModeRaw ( ) const

Return the representational value of "denormal-fp-math".

Code interested in the semantics of the function should use getDenormalMode instead.

Definition at line 819 of file Function.cpp.

◆ getEntryBlock() [1/2]

BasicBlock & llvm::Function::getEntryBlock ( )
inline

Definition at line 810 of file Function.h.

◆ getEntryBlock() [2/2]

const BasicBlock & llvm::Function::getEntryBlock ( ) const
inline

◆ getEntryCount()

std::optional< ProfileCount > Function::getEntryCount ( bool  AllowSynthetic = false) const

Get the entry count for this function.

Entry count is the number of times the function was executed. When AllowSynthetic is false, only pgo_data will be returned.

Definition at line 1133 of file Function.cpp.

Referenced by llvm::AsmPrinter::emitBBAddrMapSection(), and llvm::InlineFunction().

◆ getFnAttribute() [1/2]

Attribute Function::getFnAttribute ( Attribute::AttrKind  Kind) const

◆ getFnAttribute() [2/2]

Attribute Function::getFnAttribute ( StringRef  Kind) const

Return the attribute for the given attribute kind.

Definition at line 770 of file Function.cpp.

◆ getFnAttributeAsParsedInteger()

uint64_t Function::getFnAttributeAsParsedInteger ( StringRef  Kind,
uint64_t  Default = 0 
) const

For a string attribute Kind, parse attribute as an integer.

Returns
Default if attribute is not present.
Default if there is an error parsing the attribute integer, and error is emitted to the LLVMContext

Definition at line 778 of file Function.cpp.

Referenced by llvm::GCNSubtarget::getNSAThreshold(), llvm::PPCTargetLowering::getStackProbeSize(), llvm::SystemZTargetLowering::getStackProbeSize(), llvm::X86TargetLowering::getStackProbeSize(), llvm::RISCVTargetLowering::getStackProbeSize(), llvm::OpenMPIRBuilder::readTeamBoundsForKernel(), llvm::OpenMPIRBuilder::readThreadBoundsForKernel(), and llvm::StackProtector::runOnFunction().

◆ getFnStackAlign()

MaybeAlign llvm::Function::getFnStackAlign ( ) const
inline

Return the stack alignment for the function.

Definition at line 470 of file Function.h.

References llvm::AttributeList::getFnStackAlignment().

◆ getFunction()

const Function & llvm::Function::getFunction ( ) const
inline

◆ getFunctionType()

FunctionType * llvm::Function::getFunctionType ( ) const
inline

Returns the FunctionType for me.

Definition at line 216 of file Function.h.

References getValueType().

Referenced by llvm::FunctionComparator::compareSignature(), llvm::VPWidenCallRecipe::computeCost(), llvm::MatrixBuilder::CreateColumnMajorLoad(), llvm::MatrixBuilder::CreateColumnMajorStore(), llvm::DbgVariableRecord::createDebugIntrinsic(), llvm::IRBuilderBase::CreateLaunderInvariantGroup(), llvm::MatrixBuilder::CreateMatrixMultiply(), llvm::MatrixBuilder::CreateMatrixTranspose(), llvm::coro::createMustTailCall(), llvm::IRBuilderBase::CreateStripInvariantGroup(), createThunk(), llvm::AArch64TargetLowering::emitStoreConditional(), llvm::ARMTargetLowering::emitStoreConditional(), emitTPIDR2Save(), llvm::InstCombinerImpl::EvaluateInDifferentType(), llvm::VPWidenCallRecipe::execute(), llvm::TargetLibraryInfoImpl::getLibFunc(), llvm::Mangler::getNameWithPrefix(), llvm::OpenMPIRBuilder::getOrCreateRuntimeFunction(), llvm::coro::Shape::getResumeFunctionType(), llvm::coro::Shape::getRetconResultTypes(), llvm::coro::Shape::getRetconResumeTypes(), llvm::LoopVectorizationCostModel::getVectorIntrinsicCost(), llvm::coro::AnyRetconABI::init(), llvm::InlineFunction(), llvm::IntrinsicCostAttributes::IntrinsicCostAttributes(), llvm::SITargetLowering::LowerFormalArguments(), llvm::HexagonTargetLowering::LowerFormalArguments(), llvm::lowerGlobalIFuncUsersAsGlobalCtor(), llvm::DiagnosticInfoUnsupported::print(), processCall(), llvm::Intrinsic::remangleIntrinsicFunction(), replaceCalledFunction(), llvm::ExecutionEngine::runFunctionAsMain(), llvm::CallBase::setCalledFunction(), llvm::LoopVectorizationCostModel::setVectorizedCallDecision(), llvm::UpgradeARCRuntime(), and llvm::UpgradeIntrinsicCall().

◆ getGC()

const std::string & Function::getGC ( ) const

◆ getImportGUIDs()

DenseSet< GlobalValue::GUID > Function::getImportGUIDs ( ) const

Returns the set of GUIDs that needs to be imported to the function for sample PGO, to enable the same inlines as the profiled optimized binary.

Definition at line 1155 of file Function.cpp.

◆ getInstructionCount()

unsigned Function::getInstructionCount ( ) const

Returns the number of non-debug IR instructions in this function.

This is equivalent to the sum of the sizes of each basic block contained within this function.

Definition at line 377 of file Function.cpp.

◆ getIntrinsicID()

Intrinsic::ID llvm::Function::getIntrinsicID ( ) const
inline

getIntrinsicID - This method returns the ID number of the specified function, or Intrinsic::not_intrinsic if the function is not an intrinsic, or if the pointer is null.

This value is always defined to be zero to allow easy checking for whether a function is intrinsic or not. The particular intrinsic functions which correspond to this value are defined in llvm/Intrinsics.h.

Definition at line 251 of file Function.h.

Referenced by addIntrinsicToSummary(), llvm::calculateCXXStateForAsynchEH(), llvm::calculateSEHStateForAsynchEH(), llvm::findDevirtualizableCallsForTypeCheckedLoad(), llvm::findDevirtualizableCallsForTypeTest(), FindPreallocatedCall(), llvm::IntrinsicInst::getIntrinsicID(), handleBrSelExpect(), handlePhiDef(), handleSwitchExpect(), hasOnlyColdCalls(), isIntrinsic(), lowerAwaitSuspend(), lowerExpectIntrinsic(), optimizeDoubleFP(), shouldCheckArgs(), and llvm::UpgradeIntrinsicCall().

◆ getMaxBlockNumber()

unsigned llvm::Function::getMaxBlockNumber ( ) const
inline

Return a value larger than the largest block number.

Intended to allocate a vector that is sufficiently large to hold all blocks indexed by their number.

Definition at line 828 of file Function.h.

Referenced by llvm::FunctionLoweringInfo::set().

◆ getMemoryEffects()

MemoryEffects Function::getMemoryEffects ( ) const

Definition at line 876 of file Function.cpp.

◆ getParamAlign()

MaybeAlign llvm::Function::getParamAlign ( unsigned  ArgNo) const
inline

◆ getParamAttribute()

Attribute Function::getParamAttribute ( unsigned  ArgNo,
Attribute::AttrKind  Kind 
) const

gets the specified attribute from the list of attributes.

Definition at line 792 of file Function.cpp.

◆ getParamByRefType()

Type * llvm::Function::getParamByRefType ( unsigned  ArgNo) const
inline

Extract the byref type for a parameter.

Definition at line 512 of file Function.h.

References llvm::AttributeList::getParamByRefType().

◆ getParamByValType()

Type * llvm::Function::getParamByValType ( unsigned  ArgNo) const
inline

Extract the byval type for a parameter.

Definition at line 497 of file Function.h.

References llvm::AttributeList::getParamByValType().

◆ getParamDereferenceableBytes()

uint64_t llvm::Function::getParamDereferenceableBytes ( unsigned  ArgNo) const
inline

Extract the number of dereferenceable bytes for a parameter.

Parameters
ArgNoIndex of an argument, with 0 being the first function arg.

Definition at line 523 of file Function.h.

References llvm::AttributeList::getParamDereferenceableBytes().

Referenced by getFrameLayout(), and llvm::CoroAnnotationElidePass::run().

◆ getParamDereferenceableOrNullBytes()

uint64_t llvm::Function::getParamDereferenceableOrNullBytes ( unsigned  ArgNo) const
inline

Extract the number of dereferenceable_or_null bytes for a parameter.

Parameters
ArgNoAttributeList ArgNo, referring to an argument.

Definition at line 530 of file Function.h.

References llvm::AttributeList::getParamDereferenceableOrNullBytes().

◆ getParamInAllocaType()

Type * llvm::Function::getParamInAllocaType ( unsigned  ArgNo) const
inline

Extract the inalloca type for a parameter.

Definition at line 507 of file Function.h.

References llvm::AttributeList::getParamInAllocaType().

◆ getParamNoFPClass()

FPClassTest llvm::Function::getParamNoFPClass ( unsigned  ArgNo) const
inline

Extract the nofpclass attribute for a parameter.

Definition at line 535 of file Function.h.

References llvm::AttributeList::getParamNoFPClass().

◆ getParamPreallocatedType()

Type * llvm::Function::getParamPreallocatedType ( unsigned  ArgNo) const
inline

Extract the preallocated type for a parameter.

Definition at line 517 of file Function.h.

References llvm::AttributeList::getParamPreallocatedType().

◆ getParamStackAlign()

MaybeAlign llvm::Function::getParamStackAlign ( unsigned  ArgNo) const
inline

Definition at line 492 of file Function.h.

References llvm::AttributeList::getParamStackAlignment().

◆ getParamStructRetType()

Type * llvm::Function::getParamStructRetType ( unsigned  ArgNo) const
inline

Extract the sret type for a parameter.

Definition at line 502 of file Function.h.

References llvm::AttributeList::getParamStructRetType().

◆ getPersonalityFn()

Constant * Function::getPersonalityFn ( ) const

◆ getPrefixData()

Constant * Function::getPrefixData ( ) const

Get the prefix data associated with this function.

Definition at line 1058 of file Function.cpp.

Referenced by llvm::CloneFunctionAttributesInto().

◆ getPrologueData()

Constant * Function::getPrologueData ( ) const

Get the prologue data associated with this function.

Definition at line 1068 of file Function.cpp.

Referenced by llvm::CloneFunctionAttributesInto().

◆ getRetAttribute()

Attribute Function::getRetAttribute ( Attribute::AttrKind  Kind) const

Return the attribute for the given attribute kind for the return value.

Definition at line 774 of file Function.cpp.

◆ getReturnType()

Type * llvm::Function::getReturnType ( ) const
inline

◆ getSectionPrefix()

std::optional< StringRef > Function::getSectionPrefix ( ) const

Get the section prefix for this function.

Definition at line 1173 of file Function.cpp.

Referenced by llvm::TargetInstrInfo::isFunctionSafeToSplit().

◆ getSubprogram()

DISubprogram * Function::getSubprogram ( ) const

◆ getUWTableKind()

UWTableKind llvm::Function::getUWTableKind ( ) const
inline

Get what kind of unwind table entry to generate for this function.

Definition at line 666 of file Function.h.

References llvm::AttributeList::getUWTableKind().

◆ getValueSymbolTable() [1/2]

ValueSymbolTable * llvm::Function::getValueSymbolTable ( )
inline

getSymbolTable() - Return the symbol table if any, otherwise nullptr.

Definition at line 817 of file Function.h.

Referenced by parseIRValue().

◆ getValueSymbolTable() [2/2]

const ValueSymbolTable * llvm::Function::getValueSymbolTable ( ) const
inline

Definition at line 818 of file Function.h.

◆ hasAddressTaken()

bool Function::hasAddressTaken ( const User **  PutOffender = nullptr,
bool  IgnoreCallbackUses = false,
bool  IgnoreAssumeLikeCalls = true,
bool  IgnoreLLVMUsed = false,
bool  IgnoreARCAttachedCall = false,
bool  IgnoreCastedDirectCall = false 
) const

hasAddressTaken - returns true if there are any uses of this function other than direct calls or invokes to it, or blockaddress expressions.

hasAddressTaken - returns true if there are any uses of this function other than direct calls or invokes to it.

Optionally passes back an offending user for diagnostic purposes, ignores callback uses, assume like pointer annotation calls, references in llvm.used and llvm.compiler.used variables, operand bundle "clang.arc.attachedcall", and direct calls with a different call site signature (the function is implicitly casted).

Optionally ignores callback uses, assume like pointer annotation calls, and references in llvm.used and llvm.compiler.used variables.

Definition at line 955 of file Function.cpp.

◆ hasAttributeAtIndex()

bool Function::hasAttributeAtIndex ( unsigned  Idx,
Attribute::AttrKind  Kind 
) const

Check if attribute of the given kind is set at the given index.

Definition at line 761 of file Function.cpp.

◆ hasFnAttribute() [1/2]

bool Function::hasFnAttribute ( Attribute::AttrKind  Kind) const

Return true if the function has the attribute.

Definition at line 731 of file Function.cpp.

Referenced by llvm::CodeViewDebug::beginFunctionImpl(), llvm::AArch64TargetLowering::canMergeStoresTo(), llvm::X86TargetLowering::canMergeStoresTo(), canTransformToMemCmp(), checkNumAlignedDPRCS2Regs(), combineVectorSizedSetCCEquality(), llvm::CSKYFrameLowering::determineCalleeSaves(), llvm::TargetFrameLowering::determineCalleeSaves(), llvm::PPCFrameLowering::determineFrameLayout(), llvm::PPCRegisterInfo::eliminateFrameIndex(), llvm::PPCTargetLowering::emitEHSjLjSetJmp(), llvm::MipsSEFrameLowering::emitEpilogue(), llvm::MipsAsmPrinter::emitFunctionBodyStart(), llvm::CSKYFrameLowering::emitPrologue(), llvm::MipsSEFrameLowering::emitPrologue(), emitSCSEpilogue(), emitSCSPrologue(), llvm::TargetFrameLowering::enableCalleeSaveSkip(), llvm::ARMFrameLowering::enableCalleeSaveSkip(), llvm::X86FrameLowering::enableShrinkWrapping(), llvm::expandAtomicRMWToCmpXchg(), fixupLineNumbers(), foldLogOpOfMaskedICmps_NotAllZeros_BMask_Mixed(), llvm::AArch64Subtarget::getAuthenticatedLRCheckMethod(), llvm::CSKYRegisterInfo::getCalleeSavedRegs(), llvm::RISCVRegisterInfo::getCalleeSavedRegs(), llvm::X86RegisterInfo::getCalleeSavedRegs(), llvm::AArch64RegisterInfo::getCallPreservedMask(), llvm::AArch64FrameLowering::getFrameIndexReference(), llvm::AArch64Subtarget::getPtrAuthBlockAddressDiscriminatorIfEnabled(), llvm::MipsRegisterInfo::getReservedRegs(), llvm::X86TargetLowering::getStackProbeSymbolName(), llvm::AArch64RegisterInfo::getStrictlyReservedRegs(), getVScaleForTuning(), llvm::X86FrameLowering::has128ByteRedZone(), llvm::TargetFrameLowering::hasFP(), llvm::PPCTargetLowering::hasInlineStackProbe(), llvm::RISCVTargetLowering::hasInlineStackProbe(), llvm::SystemZTargetLowering::hasInlineStackProbe(), llvm::X86TargetLowering::hasInlineStackProbe(), hasReturnsTwiceAttr(), llvm::AArch64RegisterInfo::isAsmClobberable(), llvm::ScalarEvolution::isKnownToBeAPowerOfTwo(), isNoReturnDef(), llvm::omp::isOpenMPKernel(), isPotentiallyReachable(), EnumAttr::isSet(), LowerATOMIC_STORE(), llvm::lowerAtomicRMWInst(), llvm::InlineAsmLowering::lowerInlineAsm(), llvm::TargetInstrInfo::mergeOutliningCandidateAttributes(), llvm::ARMBaseInstrInfo::mergeOutliningCandidateAttributes(), llvm::PPCFrameLowering::needsFP(), llvm::AArch64FunctionInfo::needsShadowCallStackPrologueEpilogue(), performBRCONDCombine(), llvm::X86TargetLowering::ReplaceNodeResults(), llvm::PPCFrameLowering::restoreCalleeSavedRegisters(), llvm::JumpThreadingPass::runImpl(), llvm::Attributor::shouldInitialize(), llvm::MachineFunction::shouldSplitStack(), llvm::PPCFrameLowering::spillCalleeSavedRegisters(), llvm::AArch64TargetLowering::supportSplitCSR(), llvm::JumpThreadingPass::tryToUnfoldSelectInCurrBB(), llvm::SystemZELFFrameLowering::usePackedStack(), llvm::RISCVMachineFunctionInfo::useSaveRestoreLibCalls(), llvm::InstCombinerImpl::visitAnd(), llvm::InstCombinerImpl::visitOr(), llvm::InstCombinerImpl::visitSExt(), llvm::InstCombinerImpl::visitTrunc(), llvm::InstCombinerImpl::visitXor(), and llvm::InstCombinerImpl::visitZExt().

◆ hasFnAttribute() [2/2]

bool Function::hasFnAttribute ( StringRef  Kind) const

Return true if the function has the attribute.

Definition at line 735 of file Function.cpp.

◆ hasGC()

bool llvm::Function::hasGC ( ) const
inline

hasGC/getGC/setGC/clearGC - The name of the garbage collection algorithm to use during code generation.

Definition at line 345 of file Function.h.

Referenced by llvm::FunctionComparator::compareSignature(), llvm::SelectionDAGISel::initializeAnalysisResults(), and llvm::InlineFunction().

◆ hasLazyArguments()

bool llvm::Function::hasLazyArguments ( ) const
inline

hasLazyArguments/CheckLazyArguments - The argument list of a function is built on demand, so that the list isn't allocated until the first client needs it.

The hasLazyArguments predicate returns true if the arg list hasn't been set up yet.

Definition at line 122 of file Function.h.

◆ hasMinSize()

bool llvm::Function::hasMinSize ( ) const
inline

◆ hasNoSync()

bool llvm::Function::hasNoSync ( ) const
inline

Determine if the call can synchroize with other threads.

Definition at line 638 of file Function.h.

◆ hasOptNone()

bool llvm::Function::hasOptNone ( ) const
inline

◆ hasOptSize()

bool llvm::Function::hasOptSize ( ) const
inline

◆ hasParamAttribute() [1/2]

bool Function::hasParamAttribute ( unsigned  ArgNo,
Attribute::AttrKind  Kind 
) const

check if an attributes is in the list of attributes.

Definition at line 743 of file Function.cpp.

◆ hasParamAttribute() [2/2]

bool Function::hasParamAttribute ( unsigned  ArgNo,
StringRef  Kind 
) const

Check if an attribute is in the list of attributes.

Definition at line 748 of file Function.cpp.

◆ hasPersonalityFn()

bool llvm::Function::hasPersonalityFn ( ) const
inline

◆ hasPrefixData()

bool llvm::Function::hasPrefixData ( ) const
inline

Check whether this function has prefix data.

Definition at line 914 of file Function.h.

Referenced by llvm::CloneFunctionAttributesInto().

◆ hasProfileData()

bool llvm::Function::hasProfileData ( bool  IncludeSynthetic = false) const
inline

Return true if the function is annotated with profile data.

Presence of entry counts from a profile run implies the function has profile annotations. If IncludeSynthetic is false, only return true when the profile data is real.

Definition at line 329 of file Function.h.

Referenced by llvm::CodeViewDebug::beginFunctionImpl(), getLayoutSuccessorProbThreshold(), llvm::ProfileSummaryInfo::isColdCallSite(), and sinkLoopInvariantInstructions().

◆ hasPrologueData()

bool llvm::Function::hasPrologueData ( ) const
inline

Check whether this function has prologue data.

Definition at line 923 of file Function.h.

Referenced by llvm::CloneFunctionAttributesInto().

◆ hasRetAttribute()

bool Function::hasRetAttribute ( Attribute::AttrKind  Kind) const

check if an attribute is in the list of attributes for the return value.

Definition at line 739 of file Function.cpp.

◆ hasStackProtectorFnAttr()

bool Function::hasStackProtectorFnAttr ( ) const

Returns true if the function has ssp, sspstrong, or sspreq fn attrs.

Definition at line 852 of file Function.cpp.

Referenced by llvm::CodeViewDebug::beginFunctionImpl().

◆ hasStructRetAttr()

bool llvm::Function::hasStructRetAttr ( ) const
inline

Determine if the function returns a structure through first or second pointer argument.

Definition at line 688 of file Function.h.

References llvm::AttributeList::hasParamAttr().

Referenced by llvm::Mangler::getNameWithPrefix(), llvm::HexagonTargetLowering::LowerCall(), llvm::SparcTargetLowering::LowerFormalArguments_32(), and llvm::SparcTargetLowering::LowerReturn_32().

◆ hasUWTable()

bool llvm::Function::hasUWTable ( ) const
inline

True if the ABI mandates (or the user requested) that this function be in a unwind table.

Definition at line 672 of file Function.h.

◆ insert()

Function::iterator llvm::Function::insert ( Function::iterator  Position,
BasicBlock BB 
)
inline

Insert BB in the basic block list at Position.

\Returns an iterator to the newly inserted BB.

Definition at line 754 of file Function.h.

References llvm::SmallVectorImpl< T >::insert(), and llvm::BasicBlock::setIsNewDbgInfoFormat().

Referenced by llvm::OpenMPIRBuilder::emitBlock(), and LLVMInsertExistingBasicBlockAfterInsertBlock().

◆ isConstrainedFPIntrinsic()

bool Function::isConstrainedFPIntrinsic ( ) const

Returns true if the function is one of the "Constrained Floating-Point Intrinsics".

Returns false if not, and returns false when getIntrinsicID() returns Intrinsic::not_intrinsic.

Definition at line 557 of file Function.cpp.

◆ isConvergent()

bool llvm::Function::isConvergent ( ) const
inline

Determine if the call is convergent.

Definition at line 611 of file Function.h.

◆ isCoroOnlyDestroyWhenComplete()

bool llvm::Function::isCoroOnlyDestroyWhenComplete ( ) const
inline

Definition at line 546 of file Function.h.

Referenced by llvm::coro::BaseCloner::handleFinalSuspend().

◆ isDefTriviallyDead()

bool Function::isDefTriviallyDead ( ) const

isDefTriviallyDead - Return true if it is trivially safe to remove this function definition from the module (because it isn't externally visible, does not have its address taken, and has no callers).

To make this more accurate, call removeDeadConstantUsers first.

Definition at line 1023 of file Function.cpp.

◆ isIntrinsic()

bool llvm::Function::isIntrinsic ( ) const
inline

◆ isMaterializable()

bool llvm::Function::isMaterializable ( ) const
inline

Definition at line 236 of file Function.h.

◆ isPresplitCoroutine()

bool llvm::Function::isPresplitCoroutine ( ) const
inline

Determine if the function is presplit coroutine.

Definition at line 540 of file Function.h.

◆ isSpeculatable()

bool llvm::Function::isSpeculatable ( ) const
inline

Determine if the call has sideeffects.

Definition at line 622 of file Function.h.

◆ isTargetIntrinsic()

bool Function::isTargetIntrinsic ( ) const

isTargetIntrinsic - Returns true if this function is an intrinsic and the intrinsic is specific to a certain target.

If this is not an intrinsic or a generic intrinsic, false is returned.

Definition at line 935 of file Function.cpp.

◆ isVarArg()

bool llvm::Function::isVarArg ( ) const
inline

◆ mustProgress()

bool llvm::Function::mustProgress ( ) const
inline

Determine if the function is required to make forward progress.

Definition at line 655 of file Function.h.

◆ needsUnwindTableEntry()

bool llvm::Function::needsUnwindTableEntry ( ) const
inline

◆ nullPointerIsDefined()

bool Function::nullPointerIsDefined ( ) const

Check if null pointer dereferencing is considered undefined behavior for the function.

Return value: false => null pointer dereference is undefined. Return value: true => null pointer dereference is not undefined.

Definition at line 1183 of file Function.cpp.

◆ onlyAccessesArgMemory()

bool Function::onlyAccessesArgMemory ( ) const

Determine if the call can access memmory only using pointers based on its arguments.

Definition at line 909 of file Function.cpp.

◆ onlyAccessesInaccessibleMemOrArgMem()

bool Function::onlyAccessesInaccessibleMemOrArgMem ( ) const

Determine if the function may only access memory that is either inaccessible from the IR or pointed to by its arguments.

Definition at line 927 of file Function.cpp.

◆ onlyAccessesInaccessibleMemory()

bool Function::onlyAccessesInaccessibleMemory ( ) const

Determine if the function may only access memory that is inaccessible from the IR.

Definition at line 918 of file Function.cpp.

◆ onlyReadsMemory()

bool Function::onlyReadsMemory ( ) const

Determine if the function does not access or only reads memory.

Definition at line 892 of file Function.cpp.

Referenced by HandleByValArgument().

◆ onlyWritesMemory()

bool Function::onlyWritesMemory ( ) const

Determine if the function does not access or only writes memory.

Definition at line 900 of file Function.cpp.

◆ operator=()

void llvm::Function::operator= ( const Function )
delete

◆ print()

void Function::print ( raw_ostream OS,
AssemblyAnnotationWriter AAW = nullptr,
bool  ShouldPreserveUseListOrder = false,
bool  IsForDebug = false 
) const

Print the function to an output stream with an optional AssemblyAnnotationWriter.

Definition at line 4890 of file AsmWriter.cpp.

References llvm::GlobalValue::getParent(), and OS.

Referenced by llvm::StackLifetime::print().

◆ removeAttributeAtIndex() [1/2]

void Function::removeAttributeAtIndex ( unsigned  i,
Attribute::AttrKind  Kind 
)

removes the attribute from the list of attributes.

Definition at line 681 of file Function.cpp.

◆ removeAttributeAtIndex() [2/2]

void Function::removeAttributeAtIndex ( unsigned  i,
StringRef  Kind 
)

removes the attribute from the list of attributes.

Definition at line 685 of file Function.cpp.

◆ removeFnAttr() [1/2]

void Function::removeFnAttr ( Attribute::AttrKind  Kind)

Remove function attributes from this function.

Definition at line 689 of file Function.cpp.

Referenced by llvm::AMDGPU::removeFnAttrFromReachable(), and EnumAttr::set().

◆ removeFnAttr() [2/2]

void Function::removeFnAttr ( StringRef  Kind)

Remove function attribute from this function.

Definition at line 693 of file Function.cpp.

◆ removeFnAttrs()

void Function::removeFnAttrs ( const AttributeMask Attrs)

Definition at line 697 of file Function.cpp.

◆ removeFromParent()

void Function::removeFromParent ( )

removeFromParent - This method unlinks 'this' from the containing module, but does not delete it.

Definition at line 454 of file Function.cpp.

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

◆ removeParamAttr() [1/2]

void Function::removeParamAttr ( unsigned  ArgNo,
Attribute::AttrKind  Kind 
)

removes the attribute from the list of attributes.

Definition at line 713 of file Function.cpp.

◆ removeParamAttr() [2/2]

void Function::removeParamAttr ( unsigned  ArgNo,
StringRef  Kind 
)

removes the attribute from the list of attributes.

Definition at line 717 of file Function.cpp.

◆ removeParamAttrs()

void Function::removeParamAttrs ( unsigned  ArgNo,
const AttributeMask Attrs 
)

removes the attribute from the list of attributes.

Definition at line 721 of file Function.cpp.

◆ removeRetAttr() [1/2]

void Function::removeRetAttr ( Attribute::AttrKind  Kind)

removes the attribute from the return value list of attributes.

Definition at line 701 of file Function.cpp.

◆ removeRetAttr() [2/2]

void Function::removeRetAttr ( StringRef  Kind)

removes the attribute from the return value list of attributes.

Definition at line 705 of file Function.cpp.

◆ removeRetAttrs()

void Function::removeRetAttrs ( const AttributeMask Attrs)

removes the attributes from the return value list of attributes.

Definition at line 709 of file Function.cpp.

Referenced by llvm::CloneAndPruneIntoFromInst().

◆ renumberBlocks()

void Function::renumberBlocks ( )

Renumber basic blocks into a dense value range starting from 0.

Be aware that other data structures and analyses (e.g., DominatorTree) may depend on the value numbers and need to be updated or invalidated.

Definition at line 70 of file Function.cpp.

◆ returnDoesNotAlias()

bool llvm::Function::returnDoesNotAlias ( ) const
inline

Determine if the parameter or return value is marked with NoAlias attribute.

Definition at line 695 of file Function.h.

References llvm::AttributeList::hasRetAttr().

◆ setAttributes()

void llvm::Function::setAttributes ( AttributeList  Attrs)
inline

◆ setCallingConv()

void llvm::Function::setCallingConv ( CallingConv::ID  CC)
inline

Definition at line 281 of file Function.h.

References assert(), and CC.

Referenced by getOrCreateFunction(), llvm::InlineFunction(), and llvm::Intrinsic::remangleIntrinsicFunction().

◆ setCannotDuplicate()

void llvm::Function::setCannotDuplicate ( )
inline

Definition at line 606 of file Function.h.

◆ setConvergent()

void llvm::Function::setConvergent ( )
inline

Definition at line 614 of file Function.h.

◆ setCoroDestroyOnlyWhenComplete()

void llvm::Function::setCoroDestroyOnlyWhenComplete ( )
inline

Definition at line 549 of file Function.h.

◆ setDoesNotAccessMemory()

void Function::setDoesNotAccessMemory ( )

Definition at line 887 of file Function.cpp.

◆ setDoesNotFreeMemory()

void llvm::Function::setDoesNotFreeMemory ( )
inline

Definition at line 633 of file Function.h.

◆ setDoesNotRecurse()

void llvm::Function::setDoesNotRecurse ( )
inline

Definition at line 650 of file Function.h.

◆ setDoesNotReturn()

void llvm::Function::setDoesNotReturn ( )
inline

Definition at line 587 of file Function.h.

◆ setDoesNotThrow()

void llvm::Function::setDoesNotThrow ( )
inline

Definition at line 598 of file Function.h.

◆ setEntryCount() [1/2]

void Function::setEntryCount ( ProfileCount  Count,
const DenseSet< GlobalValue::GUID > *  Imports = nullptr 
)

Set the entry count for this function.

Entry count is the number of times this function was executed based on pgo data. Imports points to a set of GUIDs that needs to be imported by the function for sample PGO, to enable the same inlines as the profiled optimized binary.

Definition at line 1111 of file Function.cpp.

Referenced by llvm::SampleProfileLoaderBaseImpl< FT >::finalizeWeightPropagation(), and llvm::SampleProfileLoaderBaseImpl< FT >::initWeightPropagation().

◆ setEntryCount() [2/2]

void Function::setEntryCount ( uint64_t  Count,
Function::ProfileCountType  Type = PCT_Real,
const DenseSet< GlobalValue::GUID > *  Imports = nullptr 
)

A convenience wrapper for setting entry count.

Definition at line 1128 of file Function.cpp.

◆ setGC()

void Function::setGC ( std::string  Str)

Definition at line 840 of file Function.cpp.

◆ setIsMaterializable()

void llvm::Function::setIsMaterializable ( bool  V)
inline

Definition at line 239 of file Function.h.

◆ setIsNewDbgInfoFormat()

void Function::setIsNewDbgInfoFormat ( bool  NewVal)

Definition at line 105 of file Function.cpp.

Referenced by llvm::CloneFunction(), llvm::CloneFunctionInto(), and doPromotion().

◆ setMemoryEffects()

void Function::setMemoryEffects ( MemoryEffects  ME)

Definition at line 879 of file Function.cpp.

◆ setMustProgress()

void llvm::Function::setMustProgress ( )
inline

Definition at line 659 of file Function.h.

◆ setNewDbgInfoFormatFlag()

void Function::setNewDbgInfoFormatFlag ( bool  NewVal)

Definition at line 111 of file Function.cpp.

◆ setNoSync()

void llvm::Function::setNoSync ( )
inline

Definition at line 641 of file Function.h.

◆ setNotConvergent()

void llvm::Function::setNotConvergent ( )
inline

Definition at line 617 of file Function.h.

◆ setOnlyAccessesArgMemory()

void Function::setOnlyAccessesArgMemory ( )

Definition at line 912 of file Function.cpp.

◆ setOnlyAccessesInaccessibleMemOrArgMem()

void Function::setOnlyAccessesInaccessibleMemOrArgMem ( )

Definition at line 930 of file Function.cpp.

◆ setOnlyAccessesInaccessibleMemory()

void Function::setOnlyAccessesInaccessibleMemory ( )

Definition at line 921 of file Function.cpp.

◆ setOnlyReadsMemory()

void Function::setOnlyReadsMemory ( )

Definition at line 895 of file Function.cpp.

◆ setOnlyWritesMemory()

void Function::setOnlyWritesMemory ( )

Definition at line 903 of file Function.cpp.

◆ setPersonalityFn()

void Function::setPersonalityFn ( Constant Fn)

Definition at line 1053 of file Function.cpp.

Referenced by llvm::CloneFunctionAttributesInto(), and LLVMBuildLandingPad().

◆ setPrefixData()

void Function::setPrefixData ( Constant PrefixData)

Definition at line 1063 of file Function.cpp.

Referenced by llvm::CloneFunctionAttributesInto().

◆ setPresplitCoroutine()

void llvm::Function::setPresplitCoroutine ( )
inline

Definition at line 543 of file Function.h.

◆ setPrologueData()

void Function::setPrologueData ( Constant PrologueData)

Definition at line 1073 of file Function.cpp.

Referenced by llvm::CloneFunctionAttributesInto().

◆ setReturnDoesNotAlias()

void llvm::Function::setReturnDoesNotAlias ( )
inline

Definition at line 698 of file Function.h.

◆ setSectionPrefix()

void Function::setSectionPrefix ( StringRef  Prefix)

Set the section prefix for this function.

Definition at line 1167 of file Function.cpp.

◆ setSpeculatable()

void llvm::Function::setSpeculatable ( )
inline

Definition at line 625 of file Function.h.

◆ setSplittedCoroutine()

void llvm::Function::setSplittedCoroutine ( )
inline

Definition at line 544 of file Function.h.

◆ setSubprogram()

void Function::setSubprogram ( DISubprogram SP)

Set the attached subprogram.

Calls setMetadata() with LLVMContext::MD_dbg.

Definition at line 1870 of file Metadata.cpp.

References llvm::GlobalObject::setMetadata().

Referenced by buildDebugInfoForNoopResumeDestroyFunc(), createMergedFunction(), and fixupDebugInfoPostExtraction().

◆ setUWTableKind()

void llvm::Function::setUWTableKind ( UWTableKind  K)
inline

Definition at line 675 of file Function.h.

◆ setWillReturn()

void llvm::Function::setWillReturn ( )
inline

Definition at line 663 of file Function.h.

◆ shouldEmitDebugInfoForProfiling()

bool Function::shouldEmitDebugInfoForProfiling ( ) const

Returns true if we should emit debug info for profiling.

Definition at line 1878 of file Metadata.cpp.

References getSubprogram().

Referenced by llvm::VPTransformState::setDebugLocFrom().

◆ size()

size_t llvm::Function::size ( ) const
inline

◆ splice() [1/3]

void llvm::Function::splice ( Function::iterator  ToIt,
Function FromF 
)
inline

Transfer all blocks from FromF to this function at ToIt.

Definition at line 761 of file Function.h.

References begin(), and end().

Referenced by createMergedFunction(), and doPromotion().

◆ splice() [2/3]

void Function::splice ( Function::iterator  ToIt,
Function FromF,
Function::iterator  FromBeginIt,
Function::iterator  FromEndIt 
)

Transfer a range of basic blocks that belong to FromF from FromBeginIt to FromEndIt, to this function at ToIt.

Definition at line 462 of file Function.cpp.

◆ splice() [3/3]

void llvm::Function::splice ( Function::iterator  ToIt,
Function FromF,
Function::iterator  FromIt 
)
inline

Transfer one BasicBlock from FromF at FromIt to this function at ToIt.

Definition at line 767 of file Function.h.

◆ stealArgumentListFrom()

void Function::stealArgumentListFrom ( Function Src)

Steal arguments from another function.

Drop this function's arguments and splice in the ones from Src. Requires that this has no function body.

Definition at line 570 of file Function.cpp.

◆ updateAfterNameChange()

void Function::updateAfterNameChange ( )

Update internal caches that depend on the function name (such as the intrinsic ID and libcall cache).

Note, this method does not need to be called directly, as it is called from Value::setName() whenever the name of this function changes.

Definition at line 939 of file Function.cpp.

Referenced by moveFunctionAdaptingType().

◆ viewCFG() [1/3]

void Function::viewCFG ( ) const

viewCFG - This function is meant for use from the debugger.

You can just say 'call F->viewCFG()' and a ghostview window should pop up from the program, displaying the CFG of the current function with the code for each basic block inside. This depends on there being a 'dot' and 'gv' program in your path.

You can just say 'call F->viewCFG()' and a ghostview window should pop up from the program, displaying the CFG of the current function. This depends on there being a 'dot' and 'gv' program in your path.

Definition at line 137 of file CFGPrinter.cpp.

References viewCFG().

Referenced by viewCFG(), and viewCFGOnly().

◆ viewCFG() [2/3]

void Function::viewCFG ( bool  ViewCFGOnly,
const BlockFrequencyInfo BFI,
const BranchProbabilityInfo BPI,
const char OutputFileName = nullptr 
) const

Extended form to print edge weights.

Definition at line 143 of file CFGPrinter.cpp.

References CFGFuncName, contains(), llvm::getMaxFreq(), llvm::Value::getName(), and llvm::ViewGraph().

◆ viewCFG() [3/3]

void Function::viewCFG ( const char OutputFileName) const

viewCFG - This function is meant for use from the debugger.

It works just like viewCFG(), but generates the dot file with the given file name.

Definition at line 139 of file CFGPrinter.cpp.

References viewCFG().

◆ viewCFGOnly() [1/3]

void Function::viewCFGOnly ( ) const

viewCFGOnly - This function is meant for use from the debugger.

It works just like viewCFG, but it does not include the contents of basic blocks into the nodes, just the label. If you are only interested in the CFG this can make the graph smaller.

Definition at line 158 of file CFGPrinter.cpp.

References viewCFGOnly().

Referenced by viewCFGOnly().

◆ viewCFGOnly() [2/3]

void Function::viewCFGOnly ( const BlockFrequencyInfo BFI,
const BranchProbabilityInfo BPI 
) const

Extended form to print edge weights.

Definition at line 164 of file CFGPrinter.cpp.

References viewCFG().

◆ viewCFGOnly() [3/3]

void Function::viewCFGOnly ( const char OutputFileName) const

viewCFG - This function is meant for use from the debugger.

It works just like viewCFGOnly(), but generates the dot file with the given file name.

Definition at line 160 of file CFGPrinter.cpp.

References viewCFG().

◆ willReturn()

bool llvm::Function::willReturn ( ) const
inline

Determine if the function will return.

Definition at line 662 of file Function.h.

Referenced by llvm::VPRecipeBase::mayHaveSideEffects().

Friends And Related Function Documentation

◆ BasicBlock::eraseFromParent

◆ BasicBlock::removeFromParent

◆ BasicBlock::setParent

void BasicBlock::setParent ( Function )
friend

◆ InstIterator

template<class BB_t , class BB_i_t , class BI_t , class II_t >
friend class InstIterator
friend

Definition at line 791 of file Function.h.

◆ llvm::ilist_node_with_parent< llvm::BasicBlock, llvm::Function >

Definition at line 791 of file Function.h.

◆ llvm::SymbolTableListTraits< llvm::BasicBlock >

Definition at line 791 of file Function.h.

◆ SymbolTableListTraits< Function >

friend class SymbolTableListTraits< Function >
friend

Definition at line 90 of file Function.h.

◆ TargetLibraryInfoImpl

friend class TargetLibraryInfoImpl
friend

Definition at line 136 of file Function.h.

Member Data Documentation

◆ IsNewDbgInfoFormat

bool llvm::Function::IsNewDbgInfoFormat

Is this function using intrinsics to record the position of debugging information, or non-intrinsic records? See IsNewDbgInfoFormat in BasicBlock.

Definition at line 116 of file Function.h.

Referenced by llvm::CloneFunctionInto(), llvm::CodeExtractor::extractCodeRegion(), llvm::Attributor::internalizeFunctions(), and moveFunctionAdaptingType().


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