Subprogram description. More...

#include "llvm/IR/DebugInfoMetadata.h"

Inheritance diagram for llvm::DISubprogram:

[legend]

Collaboration diagram for llvm::DISubprogram:

[legend]

Public Types
enum	DISPFlags : uint32_t { SPFlagNonvirtual = SPFlagZero, SPFlagVirtuality = SPFlagVirtual \| SPFlagPureVirtual }
	Debug info subprogram flags. More...

Public Types inherited from llvm::DINode
enum	DIFlags : uint32_t { FlagAccessibility = FlagPrivate \| FlagProtected \| FlagPublic, FlagPtrToMemberRep }
	Debug info flags. More...

Public Types inherited from llvm::MDNode
using	op_iterator = const MDOperand *

using	op_range = iterator_range< op_iterator >

Public Types inherited from llvm::Metadata
enum	MetadataKind

Public Member Functions
	DEFINE_MDNODE_GET (DISubprogram,(DIScopeRef Scope, StringRef Name, StringRef LinkageName, DIFile File, unsigned Line, DISubroutineType Type, unsigned ScopeLine, DITypeRef ContainingType, unsigned VirtualIndex, int ThisAdjustment, DIFlags Flags, DISPFlags SPFlags, DICompileUnit Unit, DITemplateParameterArray TemplateParams=nullptr, DISubprogram Declaration=nullptr, DINodeArray RetainedNodes=nullptr, DITypeArray ThrownTypes=nullptr),(Scope, Name, LinkageName, File, Line, Type, ScopeLine, ContainingType, VirtualIndex, ThisAdjustment, Flags, SPFlags, Unit, TemplateParams, Declaration, RetainedNodes, ThrownTypes)) DEFINE_MDNODE_GET(DISubprogram

Public Member Functions inherited from llvm::DILocalScope
DISubprogram *	getSubprogram () const
	Get the subprogram for this scope. More...

DILocalScope *	getNonLexicalBlockFileScope () const
	Get the first non DILexicalBlockFile scope of this scope. More...

Public Member Functions inherited from llvm::DIScope
DIFile *	getFile () const

StringRef	getFilename () const

StringRef	getDirectory () const

Optional< StringRef >	getSource () const

StringRef	getName () const

DIScopeRef	getScope () const

Metadata *	getRawFile () const
	Return the raw underlying file. More...

Public Member Functions inherited from llvm::DINode
unsigned	getTag () const

Public Member Functions inherited from llvm::MDNode
	MDNode (const MDNode &)=delete

void	operator= (const MDNode &)=delete

void *	operator new (size_t)=delete

TempMDNode	clone () const
	Create a (temporary) clone of this. More...

LLVMContext &	getContext () const

void	replaceOperandWith (unsigned I, Metadata *New)
	Replace a specific operand. More...

bool	isResolved () const
	Check if node is fully resolved. More...

bool	isUniqued () const

bool	isDistinct () const

bool	isTemporary () const

void	replaceAllUsesWith (Metadata *MD)
	RAUW a temporary. More...

void	resolveCycles ()
	Resolve cycles. More...

void	resolve ()
	Resolve a unique, unresolved node. More...

op_iterator	op_begin () const

op_iterator	op_end () const

op_range	operands () const

const MDOperand &	getOperand (unsigned I) const

unsigned	getNumOperands () const
	Return number of MDNode operands. More...

bool	isTBAAVtableAccess () const
	Check whether MDNode is a vtable access. More...

Public Member Functions inherited from llvm::Metadata
unsigned	getMetadataID () const

void	dump () const
	User-friendly dump. More...

void	dump (const Module *M) const

void	print (raw_ostream &OS, const Module *M=nullptr, bool IsForDebug=false) const
	Print. More...

void	print (raw_ostream &OS, ModuleSlotTracker &MST, const Module *M=nullptr, bool IsForDebug=false) const

void	printAsOperand (raw_ostream &OS, const Module *M=nullptr) const
	Print as operand. More...

void	printAsOperand (raw_ostream &OS, ModuleSlotTracker &MST, const Module *M=nullptr) const

Static Public Member Functions
static DISPFlags	getFlag (StringRef Flag)

static StringRef	getFlagString (DISPFlags Flag)

static DISPFlags	splitFlags (DISPFlags Flags, SmallVectorImpl< DISPFlags > &SplitFlags)
	Split up a flags bitfield for easier printing. More...

static DISPFlags	toSPFlags (bool IsLocalToUnit, bool IsDefinition, bool IsOptimized, unsigned Virtuality=SPFlagNonvirtual, bool IsMainSubprogram=false)

static bool	classof (const Metadata *MD)

Static Public Member Functions inherited from llvm::DILocalScope
static bool	classof (const Metadata *MD)

Static Public Member Functions inherited from llvm::DIScope
static bool	classof (const Metadata *MD)

Static Public Member Functions inherited from llvm::DINode
static DIFlags	getFlag (StringRef Flag)

static StringRef	getFlagString (DIFlags Flag)

static DIFlags	splitFlags (DIFlags Flags, SmallVectorImpl< DIFlags > &SplitFlags)
	Split up a flags bitfield. More...

static bool	classof (const Metadata *MD)

Static Public Member Functions inherited from llvm::MDNode
static MDTuple *	get (LLVMContext &Context, ArrayRef< Metadata *> MDs)

static MDTuple *	getIfExists (LLVMContext &Context, ArrayRef< Metadata *> MDs)

static MDTuple *	getDistinct (LLVMContext &Context, ArrayRef< Metadata *> MDs)

static TempMDTuple	getTemporary (LLVMContext &Context, ArrayRef< Metadata *> MDs)

static void	deleteTemporary (MDNode *N)
	Deallocate a node created by getTemporary. More...

template<class T >
static std::enable_if< std::is_base_of< MDNode, T >::value, T * >::type	replaceWithPermanent (std::unique_ptr< T, TempMDNodeDeleter > N)
	Replace a temporary node with a permanent one. More...

template<class T >
static std::enable_if< std::is_base_of< MDNode, T >::value, T * >::type	replaceWithUniqued (std::unique_ptr< T, TempMDNodeDeleter > N)
	Replace a temporary node with a uniqued one. More...

template<class T >
static std::enable_if< std::is_base_of< MDNode, T >::value, T * >::type	replaceWithDistinct (std::unique_ptr< T, TempMDNodeDeleter > N)
	Replace a temporary node with a distinct one. More...

static bool	classof (const Metadata *MD)
	Methods for support type inquiry through isa, cast, and dyn_cast: More...

static MDNode *	concatenate (MDNode A, MDNode B)
	Methods for metadata merging. More...

static MDNode *	intersect (MDNode A, MDNode B)

static MDNode *	getMostGenericTBAA (MDNode A, MDNode B)

static MDNode *	getMostGenericFPMath (MDNode A, MDNode B)

static MDNode *	getMostGenericRange (MDNode A, MDNode B)

static MDNode *	getMostGenericAliasScope (MDNode A, MDNode B)

static MDNode *	getMostGenericAlignmentOrDereferenceable (MDNode A, MDNode B)

Public Attributes
Metadata *	Scope

Metadata MDString *	Name

Metadata MDString MDString *	LinkageName

Metadata MDString MDString Metadata *	File

Metadata MDString MDString Metadata unsigned	Line

Metadata MDString MDString Metadata unsigned Metadata *	Type

Metadata MDString MDString Metadata unsigned Metadata unsigned	ScopeLine

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata *	ContainingType

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned	VirtualIndex

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int	ThisAdjustment

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags	Flags

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags	SPFlags

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags Metadata *	Unit

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags Metadata Metadata *	TemplateParams = nullptr

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags Metadata Metadata Metadata *	Declaration = nullptr

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags Metadata Metadata Metadata Metadata *	RetainedNodes = nullptr

Metadata MDString MDString Metadata unsigned Metadata unsigned Metadata unsigned int DIFlags DISPFlags Metadata Metadata Metadata Metadata Metadata *	ThrownTypes

Friends
class	LLVMContextImpl

class	MDNode

Additional Inherited Members
Protected Types inherited from llvm::MDNode
using	mutable_op_range = iterator_range< MDOperand * >

Protected Types inherited from llvm::Metadata
enum	StorageType { Uniqued, Distinct, Temporary }
	Active type of storage. More...

Protected Member Functions inherited from llvm::DILocalScope
	DILocalScope (LLVMContext &C, unsigned ID, StorageType Storage, unsigned Tag, ArrayRef< Metadata *> Ops)

	~DILocalScope ()=default

Protected Member Functions inherited from llvm::DIScope
	DIScope (LLVMContext &C, unsigned ID, StorageType Storage, unsigned Tag, ArrayRef< Metadata *> Ops)

	~DIScope ()=default

Protected Member Functions inherited from llvm::DINode
	DINode (LLVMContext &C, unsigned ID, StorageType Storage, unsigned Tag, ArrayRef< Metadata > Ops1, ArrayRef< Metadata > Ops2=None)

	~DINode ()=default

template<class Ty >
Ty *	getOperandAs (unsigned I) const

StringRef	getStringOperand (unsigned I) const

void	setTag (unsigned Tag)
	Allow subclasses to mutate the tag. More...

Protected Member Functions inherited from llvm::MDNode
	MDNode (LLVMContext &Context, unsigned ID, StorageType Storage, ArrayRef< Metadata > Ops1, ArrayRef< Metadata > Ops2=None)

	~MDNode ()=default

void *	operator new (size_t Size, unsigned NumOps)

void	operator delete (void *Mem)

void	operator delete (void *, unsigned)
	Required by std, but never called. More...

void	operator delete (void *, unsigned, bool)
	Required by std, but never called. More...

void	dropAllReferences ()

MDOperand *	mutable_begin ()

MDOperand *	mutable_end ()

mutable_op_range	mutable_operands ()

void	setOperand (unsigned I, Metadata *New)
	Set an operand. More...

void	storeDistinctInContext ()

Protected Member Functions inherited from llvm::Metadata
	Metadata (unsigned ID, StorageType Storage)

	~Metadata ()=default

void	handleChangedOperand (void , Metadata )
	Default handling of a changed operand, which asserts. More...

Static Protected Member Functions inherited from llvm::DINode
static MDString *	getCanonicalMDString (LLVMContext &Context, StringRef S)

Static Protected Member Functions inherited from llvm::MDNode
template<class T , class StoreT >
static T *	storeImpl (T *N, StorageType Storage, StoreT &Store)

template<class T >
static T *	storeImpl (T *N, StorageType Storage)

Protected Attributes inherited from llvm::Metadata
unsigned char	Storage: 7
	Storage flag for non-uniqued, otherwise unowned, metadata. More...

unsigned char	ImplicitCode: 1

unsigned short	SubclassData16 = 0

unsigned	SubclassData32 = 0

Detailed Description

Subprogram description.

TODO: Remove DisplayName. It's always equal to Name. TODO: Split up flags.

Definition at line 1643 of file DebugInfoMetadata.h.

Member Enumeration Documentation

◆ DISPFlags

enum llvm::DISubprogram::DISPFlags : uint32_t

Debug info subprogram flags.

Enumerator
SPFlagNonvirtual
SPFlagVirtuality

Definition at line 1658 of file DebugInfoMetadata.h.

Member Function Documentation

◆ classof()

static bool llvm::DISubprogram::classof ( const Metadata * MD )

inlinestatic

Definition at line 1885 of file DebugInfoMetadata.h.

References llvm::Metadata::getMetadataID().

◆ DEFINE_MDNODE_GET()

llvm::DISubprogram::DEFINE_MDNODE_GET	(	DISubprogram	,
		(DIScopeRef Scope, StringRef Name, StringRef LinkageName, DIFile File, unsigned Line, DISubroutineType Type, unsigned ScopeLine, DITypeRef ContainingType, unsigned VirtualIndex, int ThisAdjustment, DIFlags Flags, DISPFlags SPFlags, DICompileUnit Unit, DITemplateParameterArray TemplateParams=nullptr, DISubprogram Declaration=nullptr, DINodeArray RetainedNodes=nullptr, DITypeArray ThrownTypes=nullptr)	,
		(Scope, Name, LinkageName, File, Line, Type, ScopeLine, ContainingType, VirtualIndex, ThisAdjustment, Flags, SPFlags, Unit, TemplateParams, Declaration, RetainedNodes, ThrownTypes)
	)

◆ getFlag()

DISubprogram::DISPFlags DISubprogram::getFlag ( StringRef Flag )

static

Definition at line 592 of file DebugInfoMetadata.cpp.

References HANDLE_DISP_FLAG.

Referenced by FunctionNumber().

◆ getFlagString()

StringRef DISubprogram::getFlagString ( DISPFlags Flag )

static

Definition at line 599 of file DebugInfoMetadata.cpp.

◆ splitFlags()

DISubprogram::DISPFlags DISubprogram::splitFlags	(	DISPFlags	Flags,
		SmallVectorImpl< DISPFlags > &	SplitFlags
	)

static

Split up a flags bitfield for easier printing.

Split Flags into SplitFlags, a vector of its components. Returns any remaining (unrecognized) bits.

Definition at line 613 of file DebugInfoMetadata.cpp.

References adjustColumn(), Arg, assert(), DEFINE_GETIMPL_LOOKUP, DEFINE_GETIMPL_STORE, DEFINE_GETIMPL_STORE_N, DEFINE_GETIMPL_STORE_NO_CONSTRUCTOR_ARGS, llvm::StringRef::empty(), F(), File, getLinkageName(), getName(), llvm::Value::getName(), llvm::Function::getSubprogram(), isCanonical(), llvm::LinkageName, Name, llvm::SmallVectorTemplateBase< T >::pop_back(), llvm::DILocation::Scope, and llvm::SmallVectorBase::size().

◆ toSPFlags()

static DISPFlags llvm::DISubprogram::toSPFlags	(	bool	IsLocalToUnit,
		bool	IsDefinition,
		bool	IsOptimized,
		unsigned	Virtuality = `SPFlagNonvirtual`,
		bool	IsMainSubprogram = `false`
	)