This represents a decl that may have a name. More...

#include "clang/AST/Decl.h"

Inheritance diagram for clang::NamedDecl:

[legend]

Public Types
enum	ExplicitVisibilityKind { VisibilityForType , VisibilityForValue }
	Kinds of explicit visibility. More...

Public Types inherited from clang::Decl
enum	Kind
	Lists the kind of concrete classes of Decl. More...

enum	IdentifierNamespace { IDNS_Label = 0x0001 , IDNS_Tag = 0x0002 , IDNS_Type = 0x0004 , IDNS_Member = 0x0008 , IDNS_Namespace = 0x0010 , IDNS_Ordinary = 0x0020 , IDNS_ObjCProtocol = 0x0040 , IDNS_OrdinaryFriend = 0x0080 , IDNS_TagFriend = 0x0100 , IDNS_Using = 0x0200 , IDNS_NonMemberOperator = 0x0400 , IDNS_LocalExtern = 0x0800 , IDNS_OMPReduction = 0x1000 , IDNS_OMPMapper = 0x2000 }
	IdentifierNamespace - The different namespaces in which declarations may appear. More...

enum	ObjCDeclQualifier { OBJC_TQ_None = 0x0 , OBJC_TQ_In = 0x1 , OBJC_TQ_Inout = 0x2 , OBJC_TQ_Out = 0x4 , OBJC_TQ_Bycopy = 0x8 , OBJC_TQ_Byref = 0x10 , OBJC_TQ_Oneway = 0x20 , OBJC_TQ_CSNullability = 0x40 }
	ObjCDeclQualifier - 'Qualifiers' written next to the return and parameter types in method declarations. More...

enum class	ModuleOwnershipKind : unsigned char { Unowned , Visible , VisibleWhenImported , ReachableWhenImported , ModulePrivate }
	The kind of ownership a declaration has, for visibility purposes. More...

enum	FriendObjectKind { FOK_None , FOK_Declared , FOK_Undeclared }

using	attr_iterator = AttrVec::const_iterator

using	attr_range = llvm::iterator_range< attr_iterator >

using	redecl_range = llvm::iterator_range< redecl_iterator >

Public Member Functions
IdentifierInfo *	getIdentifier () const
	Get the identifier that names this declaration, if there is one.

StringRef	getName () const
	Get the name of identifier for this declaration as a StringRef.

std::string	getNameAsString () const
	Get a human-readable name for the declaration, even if it is one of the special kinds of names (C++ constructor, Objective-C selector, etc).

virtual void	printName (raw_ostream &OS, const PrintingPolicy &Policy) const
	Pretty-print the unqualified name of this declaration.

void	printName (raw_ostream &OS) const
	Calls printName() with the ASTContext printing policy from the decl.

DeclarationName	getDeclName () const
	Get the actual, stored name of the declaration, which may be a special name.

void	setDeclName (DeclarationName N)
	Set the name of this declaration.

void	printQualifiedName (raw_ostream &OS) const
	Returns a human-readable qualified name for this declaration, like A::B::i, for i being member of namespace A::B.

void	printQualifiedName (raw_ostream &OS, const PrintingPolicy &Policy) const

void	printNestedNameSpecifier (raw_ostream &OS) const
	Print only the nested name specifier part of a fully-qualified name, including the '::' at the end.

void	printNestedNameSpecifier (raw_ostream &OS, const PrintingPolicy &Policy) const

std::string	getQualifiedNameAsString () const

virtual void	getNameForDiagnostic (raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const
	Appends a human-readable name for this declaration into the given stream.

bool	declarationReplaces (const NamedDecl *OldD, bool IsKnownNewer=true) const
	Determine whether this declaration, if known to be well-formed within its context, will replace the declaration OldD if introduced into scope.

bool	hasLinkage () const
	Determine whether this declaration has linkage.

bool	isCXXClassMember () const
	Determine whether this declaration is a C++ class member.

bool	isCXXInstanceMember () const
	Determine whether the given declaration is an instance member of a C++ class.

ReservedIdentifierStatus	isReserved (const LangOptions &LangOpts) const
	Determine if the declaration obeys the reserved identifier rules of the given language.

Linkage	getLinkageInternal () const
	Determine what kind of linkage this entity has.

Linkage	getFormalLinkage () const
	Get the linkage from a semantic point of view.

bool	hasExternalFormalLinkage () const
	True if this decl has external linkage.

bool	isExternallyVisible () const

bool	isExternallyDeclarable () const
	Determine whether this declaration can be redeclared in a different translation unit.

Visibility	getVisibility () const
	Determines the visibility of this entity.

LinkageInfo	getLinkageAndVisibility () const
	Determines the linkage and visibility of this entity.

std::optional< Visibility >	getExplicitVisibility (ExplicitVisibilityKind kind) const
	If visibility was explicitly specified for this declaration, return that visibility.

bool	isLinkageValid () const
	True if the computed linkage is valid.

bool	hasLinkageBeenComputed () const
	True if something has required us to compute the linkage of this declaration.

bool	isPlaceholderVar (const LangOptions &LangOpts) const

NamedDecl *	getUnderlyingDecl ()
	Looks through UsingDecls and ObjCCompatibleAliasDecls for the underlying named decl.

const NamedDecl *	getUnderlyingDecl () const

NamedDecl *	getMostRecentDecl ()

const NamedDecl *	getMostRecentDecl () const

ObjCStringFormatFamily	getObjCFStringFormattingFamily () const

bool	isModulePrivate () const
	Whether this declaration was marked as being private to the module in which it was defined.

void	setModulePrivate ()
	Specify that this declaration was marked as being private to the module in which it was defined.

Public Member Functions inherited from clang::Decl
	Decl ()=delete

	Decl (const Decl &)=delete

	Decl (Decl &&)=delete

Decl &	operator= (const Decl &)=delete

Decl &	operator= (Decl &&)=delete

virtual SourceRange	getSourceRange () const LLVM_READONLY
	Source range that this declaration covers.

SourceLocation	getBeginLoc () const LLVM_READONLY

SourceLocation	getEndLoc () const LLVM_READONLY

SourceLocation	getLocation () const

void	setLocation (SourceLocation L)

Kind	getKind () const

const char *	getDeclKindName () const

Decl *	getNextDeclInContext ()

const Decl *	getNextDeclInContext () const

DeclContext *	getDeclContext ()

const DeclContext *	getDeclContext () const

DeclContext *	getNonTransparentDeclContext ()
	Return the non transparent context.

const DeclContext *	getNonTransparentDeclContext () const

Decl *	getNonClosureContext ()
	Find the innermost non-closure ancestor of this declaration, walking up through blocks, lambdas, etc.

const Decl *	getNonClosureContext () const

TranslationUnitDecl *	getTranslationUnitDecl ()

const TranslationUnitDecl *	getTranslationUnitDecl () const

bool	isInAnonymousNamespace () const

bool	isInStdNamespace () const

bool	isFileContextDecl () const

ASTContext &	getASTContext () const LLVM_READONLY

const LangOptions &	getLangOpts () const LLVM_READONLY
	Helper to get the language options from the ASTContext.

void	setAccess (AccessSpecifier AS)

AccessSpecifier	getAccess () const

AccessSpecifier	getAccessUnsafe () const
	Retrieve the access specifier for this declaration, even though it may not yet have been properly set.

bool	hasAttrs () const

void	setAttrs (const AttrVec &Attrs)

AttrVec &	getAttrs ()

const AttrVec &	getAttrs () const

void	dropAttrs ()

void	addAttr (Attr *A)

attr_range	attrs () const

attr_iterator	attr_begin () const

attr_iterator	attr_end () const

template<typename... Ts>
void	dropAttrs ()

template<typename T >
void	dropAttr ()

template<typename T >
llvm::iterator_range< specific_attr_iterator< T > >	specific_attrs () const

template<typename T >
specific_attr_iterator< T >	specific_attr_begin () const

template<typename T >
specific_attr_iterator< T >	specific_attr_end () const

template<typename T >
T *	getAttr () const

template<typename T >
bool	hasAttr () const

unsigned	getMaxAlignment () const
	getMaxAlignment - return the maximum alignment specified by attributes on this decl, 0 if there are none.

void	setInvalidDecl (bool Invalid=true)
	setInvalidDecl - Indicates the Decl had a semantic error.

bool	isInvalidDecl () const

bool	isImplicit () const
	isImplicit - Indicates whether the declaration was implicitly generated by the implementation.

void	setImplicit (bool I=true)

bool	isUsed (bool CheckUsedAttr=true) const
	Whether any (re-)declaration of the entity was used, meaning that a definition is required.

void	setIsUsed ()
	Set whether the declaration is used, in the sense of odr-use.

void	markUsed (ASTContext &C)
	Mark the declaration used, in the sense of odr-use.

bool	isReferenced () const
	Whether any declaration of this entity was referenced.

bool	isThisDeclarationReferenced () const
	Whether this declaration was referenced.

void	setReferenced (bool R=true)

bool	isTopLevelDeclInObjCContainer () const
	Whether this declaration is a top-level declaration (function, global variable, etc.) that is lexically inside an objc container definition.

void	setTopLevelDeclInObjCContainer (bool V=true)

ExternalSourceSymbolAttr *	getExternalSourceSymbolAttr () const
	Looks on this and related declarations for an applicable external source symbol attribute.

bool	isModulePrivate () const
	Whether this declaration was marked as being private to the module in which it was defined.

bool	isInExportDeclContext () const
	Whether this declaration was exported in a lexical context.

bool	isInvisibleOutsideTheOwningModule () const

bool	isInAnotherModuleUnit () const
	Whether this declaration comes from another module unit.

bool	isInCurrentModuleUnit () const
	Whether this declaration comes from the same module unit being compiled.

bool	shouldEmitInExternalSource () const
	Whether the definition of the declaration should be emitted in external sources.

bool	isFromExplicitGlobalModule () const
	Whether this declaration comes from explicit global module.

bool	isFromGlobalModule () const
	Whether this declaration comes from global module.

bool	isInNamedModule () const
	Whether this declaration comes from a named module.

bool	hasDefiningAttr () const
	Return true if this declaration has an attribute which acts as definition of the entity, such as 'alias' or 'ifunc'.

const Attr *	getDefiningAttr () const
	Return this declaration's defining attribute if it has one.

void	setFromASTFile ()
	Set the FromASTFile flag.

void	setOwningModuleID (unsigned ID)
	Set the owning module ID.

AvailabilityResult	getAvailability (std::string Message=nullptr, VersionTuple EnclosingVersion=VersionTuple(), StringRef RealizedPlatform=nullptr) const
	Determine the availability of the given declaration.

VersionTuple	getVersionIntroduced () const
	Retrieve the version of the target platform in which this declaration was introduced.

bool	isDeprecated (std::string *Message=nullptr) const
	Determine whether this declaration is marked 'deprecated'.

bool	isUnavailable (std::string *Message=nullptr) const
	Determine whether this declaration is marked 'unavailable'.

bool	isWeakImported () const
	Determine whether this is a weak-imported symbol.

bool	canBeWeakImported (bool &IsDefinition) const
	Determines whether this symbol can be weak-imported, e.g., whether it would be well-formed to add the weak_import attribute.

bool	isFromASTFile () const
	Determine whether this declaration came from an AST file (such as a precompiled header or module) rather than having been parsed.

GlobalDeclID	getGlobalID () const
	Retrieve the global declaration ID associated with this declaration, which specifies where this Decl was loaded from.

unsigned	getOwningModuleID () const
	Retrieve the global ID of the module that owns this particular declaration.

Module *	getImportedOwningModule () const
	Get the imported owning module, if this decl is from an imported (non-local) module.

Module *	getLocalOwningModule () const
	Get the local owning module, if known.

void	setLocalOwningModule (Module *M)

bool	hasOwningModule () const
	Is this declaration owned by some module?

Module *	getOwningModule () const
	Get the module that owns this declaration (for visibility purposes).

Module *	getOwningModuleForLinkage () const
	Get the module that owns this declaration for linkage purposes.

bool	isUnconditionallyVisible () const
	Determine whether this declaration is definitely visible to name lookup, independent of whether the owning module is visible.

bool	isReachable () const

void	setVisibleDespiteOwningModule ()
	Set that this declaration is globally visible, even if it came from a module that is not visible.

ModuleOwnershipKind	getModuleOwnershipKind () const
	Get the kind of module ownership for this declaration.

void	setModuleOwnershipKind (ModuleOwnershipKind MOK)
	Set whether this declaration is hidden from name lookup.

unsigned	getIdentifierNamespace () const

bool	isInIdentifierNamespace (unsigned NS) const

bool	hasTagIdentifierNamespace () const

DeclContext *	getLexicalDeclContext ()
	getLexicalDeclContext - The declaration context where this Decl was lexically declared (LexicalDC).

const DeclContext *	getLexicalDeclContext () const

virtual bool	isOutOfLine () const
	Determine whether this declaration is declared out of line (outside its semantic context).

void	setDeclContext (DeclContext *DC)
	setDeclContext - Set both the semantic and lexical DeclContext to DC.

void	setLexicalDeclContext (DeclContext *DC)

bool	isTemplated () const
	Determine whether this declaration is a templated entity (whether it is.

unsigned	getTemplateDepth () const
	Determine the number of levels of template parameter surrounding this declaration.

bool	isDefinedOutsideFunctionOrMethod () const
	isDefinedOutsideFunctionOrMethod - This predicate returns true if this scoped decl is defined outside the current function or method.

bool	isInLocalScopeForInstantiation () const
	Determine whether a substitution into this declaration would occur as part of a substitution into a dependent local scope.

const DeclContext *	getParentFunctionOrMethod (bool LexicalParent=false) const
	If this decl is defined inside a function/method/block it returns the corresponding DeclContext, otherwise it returns null.

DeclContext *	getParentFunctionOrMethod (bool LexicalParent=false)

virtual Decl *	getCanonicalDecl ()
	Retrieves the "canonical" declaration of the given declaration.

const Decl *	getCanonicalDecl () const

bool	isCanonicalDecl () const
	Whether this particular Decl is a canonical one.

redecl_range	redecls () const
	Returns an iterator range for all the redeclarations of the same decl.

redecl_iterator	redecls_begin () const

redecl_iterator	redecls_end () const

Decl *	getPreviousDecl ()
	Retrieve the previous declaration that declares the same entity as this declaration, or NULL if there is no previous declaration.

const Decl *	getPreviousDecl () const
	Retrieve the previous declaration that declares the same entity as this declaration, or NULL if there is no previous declaration.

bool	isFirstDecl () const
	True if this is the first declaration in its redeclaration chain.

Decl *	getMostRecentDecl ()
	Retrieve the most recent declaration that declares the same entity as this declaration (which may be this declaration).

const Decl *	getMostRecentDecl () const
	Retrieve the most recent declaration that declares the same entity as this declaration (which may be this declaration).

virtual Stmt *	getBody () const
	getBody - If this Decl represents a declaration for a body of code, such as a function or method definition, this method returns the top-level Stmt* of that body.

virtual bool	hasBody () const
	Returns true if this `Decl` represents a declaration for a body of code, such as a function or method definition.

SourceLocation	getBodyRBrace () const
	getBodyRBrace - Gets the right brace of the body, if a body exists.

bool	isTemplateParameter () const
	isTemplateParameter - Determines whether this declaration is a template parameter.

bool	isTemplateParameterPack () const
	isTemplateParameter - Determines whether this declaration is a template parameter pack.

bool	isParameterPack () const
	Whether this declaration is a parameter pack.

bool	isTemplateDecl () const
	returns true if this declaration is a template

bool	isFunctionOrFunctionTemplate () const
	Whether this declaration is a function or function template.

TemplateDecl *	getDescribedTemplate () const
	If this is a declaration that describes some template, this method returns that template declaration.

const TemplateParameterList *	getDescribedTemplateParams () const
	If this is a declaration that describes some template or partial specialization, this returns the corresponding template parameter list.

FunctionDecl *	getAsFunction () LLVM_READONLY
	Returns the function itself, or the templated function if this is a function template.

const FunctionDecl *	getAsFunction () const

void	setLocalExternDecl ()
	Changes the namespace of this declaration to reflect that it's a function-local extern declaration.

bool	isLocalExternDecl () const
	Determine whether this is a block-scope declaration with linkage.

void	setObjectOfFriendDecl (bool PerformFriendInjection=false)
	Changes the namespace of this declaration to reflect that it's the object of a friend declaration.

void	clearIdentifierNamespace ()
	Clears the namespace of this declaration.

FriendObjectKind	getFriendObjectKind () const
	Determines whether this declaration is the object of a friend declaration and, if so, what kind.

void	setNonMemberOperator ()
	Specifies that this declaration is a C++ overloaded non-member.

void	print (raw_ostream &Out, unsigned Indentation=0, bool PrintInstantiation=false) const

void	print (raw_ostream &Out, const PrintingPolicy &Policy, unsigned Indentation=0, bool PrintInstantiation=false) const

void	dump () const

void	dumpColor () const

void	dump (raw_ostream &Out, bool Deserialize=false, ASTDumpOutputFormat OutputFormat=ADOF_Default) const

int64_t	getID () const

const FunctionType *	getFunctionType (bool BlocksToo=true) const
	Looks through the Decl's underlying type to extract a FunctionType when possible.

bool	isFunctionPointerType () const

Static Public Member Functions
static bool	classof (const Decl *D)

static bool	classofKind (Kind K)

Static Public Member Functions inherited from clang::Decl
static bool	isFlexibleArrayMemberLike (ASTContext &Context, const Decl *D, QualType Ty, LangOptions::StrictFlexArraysLevelKind StrictFlexArraysLevel, bool IgnoreTemplateOrMacroSubstitution)
	Whether it resembles a flexible array member.

static unsigned	getIdentifierNamespaceForKind (Kind DK)

static bool	isTagIdentifierNamespace (unsigned NS)

static void	add (Kind k)

static void	EnableStatistics ()

static void	PrintStats ()

static bool	classofKind (Kind K)

static DeclContext *	castToDeclContext (const Decl *)

static Decl *	castFromDeclContext (const DeclContext *)

static void	printGroup (Decl **Begin, unsigned NumDecls, raw_ostream &Out, const PrintingPolicy &Policy, unsigned Indentation=0)

Protected Member Functions
	NamedDecl (Kind DK, DeclContext *DC, SourceLocation L, DeclarationName N)

Protected Member Functions inherited from clang::Decl
void *	operator new (std::size_t Size, const ASTContext &Ctx, GlobalDeclID ID, std::size_t Extra=0)
	Allocate memory for a deserialized declaration.

void *	operator new (std::size_t Size, const ASTContext &Ctx, DeclContext *Parent, std::size_t Extra=0)
	Allocate memory for a non-deserialized declaration.

	Decl (Kind DK, DeclContext *DC, SourceLocation L)

	Decl (Kind DK, EmptyShell Empty)

virtual	~Decl ()

void	updateOutOfDate (IdentifierInfo &II) const
	Update a potentially out-of-date declaration.

Linkage	getCachedLinkage () const

void	setCachedLinkage (Linkage L) const

bool	hasCachedLinkage () const

void	setModulePrivate ()
	Specify that this declaration was marked as being private to the module in which it was defined.

bool	hasLocalOwningModuleStorage () const

virtual Decl *	getNextRedeclarationImpl ()
	Returns the next redeclaration or itself if this is the only decl.

virtual Decl *	getPreviousDeclImpl ()
	Implementation of getPreviousDecl(), to be overridden by any subclass that has a redeclaration chain.

virtual Decl *	getMostRecentDeclImpl ()
	Implementation of getMostRecentDecl(), to be overridden by any subclass that has a redeclaration chain.

ASTMutationListener *	getASTMutationListener () const

Additional Inherited Members
Protected Attributes inherited from clang::Decl
llvm::PointerIntPair< Decl *, 3, ModuleOwnershipKind >	NextInContextAndBits
	The next declaration within the same lexical DeclContext.

unsigned	Access: 2
	Access - Used by C++ decls for the access specifier.

unsigned	FromASTFile: 1
	Whether this declaration was loaded from an AST file.

unsigned	IdentifierNamespace: 14
	IdentifierNamespace - This specifies what IDNS_* namespace this lives in.

unsigned	CacheValidAndLinkage: 3
	If 0, we have not computed the linkage of this declaration.

Detailed Description

This represents a decl that may have a name.

Many decls have names such as ObjCMethodDecl, but not @class, etc.

Note that not every NamedDecl is actually named (e.g., a struct might be anonymous), and not every name is an identifier.

Definition at line 249 of file Decl.h.

Member Enumeration Documentation

◆ ExplicitVisibilityKind

enum clang::NamedDecl::ExplicitVisibilityKind

Kinds of explicit visibility.

Enumerator

VisibilityForType

Do an LV computation for, ultimately, a type.

Visibility may be restricted by type visibility settings and the visibility of template arguments.

VisibilityForValue

Do an LV computation for, ultimately, a non-type declaration.

Visibility may be restricted by value visibility settings and the visibility of template arguments.

Definition at line 427 of file Decl.h.

Constructor & Destructor Documentation

◆ NamedDecl()

clang::NamedDecl::NamedDecl	(	Kind	DK,
		DeclContext *	DC,
		SourceLocation	L,
		DeclarationName	N
	)

inlineprotected

Definition at line 261 of file Decl.h.

Member Function Documentation

◆ classof()

static bool clang::NamedDecl::classof ( const Decl * D )

inlinestatic

Definition at line 485 of file Decl.h.

References classofKind(), and D.

◆ classofKind()

static bool clang::NamedDecl::classofKind ( Kind K )

inlinestatic

Definition at line 486 of file Decl.h.

Referenced by classof(), and clang::tooling::stdlib::Recognizer::operator()().

◆ declarationReplaces()

bool NamedDecl::declarationReplaces	(	const NamedDecl *	OldD,
		bool	IsKnownNewer = `true`
	)		const

Determine whether this declaration, if known to be well-formed within its context, will replace the declaration OldD if introduced into scope.

A declaration will replace another declaration if, for example, it is a redeclaration of the same variable or function, but not if it is a declaration of a different kind (function vs. class) or an overloaded function.

Parameters

IsKnownNewer true if this declaration is known to be newer than OldD (for instance, if this declaration is newly-created).

Definition at line 1835 of file Decl.cpp.

References D, clang::Decl::getASTContext(), clang::Decl::getCanonicalDecl(), clang::ASTContext::getCanonicalNestedNameSpecifier(), clang::Decl::getDeclContext(), getDeclName(), clang::Decl::getKind(), clang::DeclContext::getRedeclContext(), clang::Decl::isCanonicalDecl(), clang::Decl::isFromASTFile(), isRedeclarable(), and clang::Decl::redecls().

◆ getDeclName()

DeclarationName clang::NamedDecl::getDeclName ( ) const

inline

Get the actual, stored name of the declaration, which may be a special name.

Note that generally in diagnostics, the non-null NamedDecl* itself should be sent into the diagnostic instead of using the result of getDeclName().

A DeclarationName in a diagnostic will just be streamed to the output, which will directly result in a call to DeclarationName::print.

A NamedDecl* in a diagnostic will also ultimately result in a call to DeclarationName::print, but with two customisation points along the way (getNameForDiagnostic and printName). These are used to print the template arguments if any, and to provide a user-friendly name for some entities (such as unnamed variables and anonymous records).

Definition at line 315 of file Decl.h.

◆ getExplicitVisibility()

std::optional< Visibility > NamedDecl::getExplicitVisibility ( ExplicitVisibilityKind kind ) const

If visibility was explicitly specified for this declaration, return that visibility.

Definition at line 1304 of file Decl.cpp.

References getExplicitVisibilityAux().

Referenced by clang::Sema::AddPushedVisibilityAttribute().

◆ getFormalLinkage()

Linkage NamedDecl::getFormalLinkage ( ) const

Get the linkage from a semantic point of view.

Entities in anonymous namespaces are external (in c++98).

Definition at line 1200 of file Decl.cpp.

References clang::External, clang::Decl::getCanonicalDecl(), clang::getFormalLinkage(), getLinkageInternal(), isExportedFromModuleInterfaceUnit(), clang::Decl::isInNamedModule(), and clang::Module.

Referenced by clang::Sema::ActOnStartOfFunctionDef(), clang::Sema::AddInitializerToDecl(), clang::Sema::AddOverloadCandidate(), clang::Sema::areMultiversionVariantFunctionsCompatible(), clang::Sema::checkCall(), checkExportedDecl(), clang::Sema::CheckRedeclarationExported(), CheckTemplateArgumentAddressOfObjectOrFunction(), clang::Sema::checkVarDeclRedefinition(), getMultiversionLinkage(), and hasLinkage().

◆ getIdentifier()

IdentifierInfo * clang::NamedDecl::getIdentifier ( ) const

inline

Get the identifier that names this declaration, if there is one.

This will return NULL if this declaration has no name (e.g., for an unnamed class) or if the name is a special name (C++ constructor, Objective-C selector, etc.).

Definition at line 270 of file Decl.h.

◆ getLinkageAndVisibility()

LinkageInfo NamedDecl::getLinkageAndVisibility ( ) const

Determines the linkage and visibility of this entity.

Definition at line 1220 of file Decl.cpp.

References clang::LinkageComputer::getDeclLinkageAndVisibility().

Referenced by clang::CodeGen::CodeGenModule::GetAddrOfTemplateParamObject(), clang::CodeGen::CodeGenModule::GetVCallVisibilityLevel(), getVisibility(), clang::CodeGen::CodeGenModule::HasHiddenLTOVisibility(), and setLinkageForGV().

◆ getLinkageInternal()

Linkage NamedDecl::getLinkageInternal ( ) const

Determine what kind of linkage this entity has.

This is not the linkage as defined by the standard or the codegen notion of linkage. It is just an implementation detail that is used to compute those.

Definition at line 1176 of file Decl.cpp.

References clang::LVComputationKind::forLinkageOnly(), clang::LinkageInfo::getLinkage(), and clang::LinkageComputer::getLVForDecl().

Referenced by getFormalLinkage(), hasExternalFormalLinkage(), clang::ASTNodeImporter::hasSameVisibilityContextAndLinkage(), and isExternallyVisible().

◆ getMostRecentDecl() [1/2]

NamedDecl * clang::NamedDecl::getMostRecentDecl ( )

inline

Definition at line 476 of file Decl.h.

References getMostRecentDecl().

Referenced by clang::Sema::CheckTemplateArgumentList(), compareDeclarations(), diagnoseMissingArgument(), DoEmitAvailabilityWarning(), getExplicitVisibilityAux(), getMostRecentDecl(), clang::Sema::GetTemplateParameterList(), and clang::ValueDecl::isWeak().

◆ getMostRecentDecl() [2/2]

const NamedDecl * clang::NamedDecl::getMostRecentDecl ( ) const

inline

Definition at line 479 of file Decl.h.

References getMostRecentDecl().

◆ getName()

StringRef clang::NamedDecl::getName ( ) const

inline

Get the name of identifier for this declaration as a StringRef.

This requires that the declaration have a name and that it be a simple identifier.

Definition at line 276 of file Decl.h.

References getIdentifier(), and clang::IdentifierInfo::getName().

Referenced by clang::Sema::ActOnFunctionDeclarator(), clang::SemaOpenMP::ActOnOpenMPCall(), clang::SemaObjC::ActOnPropertyImplDecl(), clang::Sema::ActOnSuperScopeSpecifier(), clang::SemaHLSL::ActOnTopLevelFunction(), AddObjCKeyValueCompletions(), AddOverrideResults(), clang::Sema::AddSectionMSAllocText(), clang::SemaObjC::BuildClassMessage(), clang::SemaObjC::BuildInstanceMessage(), buildLambdaCaptureFixit(), clang::threadSafety::BeforeSet::checkBeforeAfter(), clang::Sema::CheckMSVCRTEntryPoint(), clang::Sema::CheckUseOfCXXMethodAsAddressOfOperand(), clang::PredefinedExpr::ComputeName(), createOverloadsForFixedParams(), clang::SemaObjC::DefaultSynthesizeProperties(), DiagnoseBadDeduction(), clang::Sema::DiagnoseMisalignedMembers(), clang::ODRDiagsEmitter::diagnoseMismatch(), clang::ento::CXXBaseObjectRegion::dumpToStream(), clang::ento::CXXDerivedObjectRegion::dumpToStream(), emitAddrOfFieldStorage(), clang::CodeGen::CGDebugInfo::EmitDeclareOfBlockDeclRefVariable(), clang::CodeGen::CGDebugInfo::EmitDeclareOfBlockLiteralArgVariable(), clang::CodeGen::CGOpenMPRuntime::emitDeclareTargetFunction(), EmitDirectCallee(), clang::CodeGen::CGHLSLRuntime::emitEntryFunction(), clang::CodeGen::CGDebugInfo::EmitGlobalVariable(), clang::CodeGen::CGOpenMPRuntime::emitLastprivateConditionalInit(), clang::CodeGen::CGDebugInfo::EmitNamespaceAlias(), clang::SemaOpenMP::EndOpenMPDSABlock(), clang::ento::LikelyFalsePositiveSuppressionBRVisitor::finalizeVisitor(), clang::CodeGen::CodeGenModule::GenKernelArgMetadata(), clang::CodeGen::CGOpenMPRuntime::getAddressOfLocalVariable(), clang::CodeGen::CodeGenFunction::OMPBuilderCBHelpers::getAddressOfLocalVariable(), clang::CodeGen::CGOpenMPRuntimeGPU::getAddressOfLocalVariable(), UPCPreIncrementGadget::getFixits(), UUCAddAssignGadget::getFixits(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForCXXMethod(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForEnum(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForEnumConstant(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForRedeclarableTemplate(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForVar(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForVarTemplate(), clang::CodeGen::CGOpenMPRuntimeGPU::getKmpcAllocShared(), clang::GCCAsmStmt::getLabelName(), getObjCFStringFormattingFamily(), clang::ObjCInterfaceDecl::getObjCRuntimeNameAsString(), clang::ObjCProtocolDecl::getObjCRuntimeNameAsString(), clang::comments::TParamCommandComment::getParamName(), clang::ento::AnyFunctionCall::getRuntimeDefinition(), clang::extractapi::TypedefUnderlyingTypeResolver::getSymbolReferenceForType(), clang::extractapi::impl::ExtractAPIVisitorBase< Derived >::getTypedefName(), clang::SemaObjC::HandleExprPropertyRefExpr(), hasDefaultGetterName(), hasDefaultSetterName(), clang::dataflow::hasOptionalClassName(), clang::Sema::inferGslPointerAttribute(), clang::Sema::inferNullableClassAttribute(), clang::dataflow::isCheckLikeMethod(), IsClangAttr(), IsClangDecl(), IsClangStmt(), IsClangType(), isDefaultStdCall(), isDefinedInClangModule(), clang::CXXRecordDecl::isInterfaceLike(), clang::ento::iterator::isIterator(), clang::CXXMethodDecl::isLambdaStaticInvoker(), clang::FunctionDecl::isMSVCRTEntryPoint(), isSelfDecl(), IsSmallVector(), clang::ento::smartptr::isStdSmartPtr(), IsStdString(), IsStdVector(), clang::dataflow::isTopLevelNamespaceWithName(), clang::MangleContext::mangleObjCMethodName(), maybeAdjustInterfaceForSubscriptingCheck(), methodHasName(), clang::operator<<(), clang::NestedNameSpecifier::print(), print_elem(), clang::Sema::PrintInstantiationStack(), clang::ento::FieldRegion::printPretty(), clang::APValue::printPretty(), clang::ento::NonParamVarRegion::printPrettyAsExpr(), clang::ento::ParamVarRegion::printPrettyAsExpr(), clang::ento::FieldRegion::printPrettyAsExpr(), clang::ento::ObjCIvarRegion::printPrettyAsExpr(), ReplaceWithClasstype(), clang::sema::shouldTrackFirstArgument(), clang::threadSafety::til::Project::slotName(), clang::JSONNodeDumper::VisitAddrLabelExpr(), clang::installapi::InstallAPIVisitor::VisitObjCCategoryDecl(), clang::ento::ConditionBRVisitor::VisitTrueTest(), and clang::extractapi::impl::ExtractAPIVisitorBase< Derived >::VisitTypedefNameDecl().

◆ getNameAsString()

std::string clang::NamedDecl::getNameAsString ( ) const

inline

Get a human-readable name for the declaration, even if it is one of the special kinds of names (C++ constructor, Objective-C selector, etc).

Creating this name requires expensive string manipulation, so it should be called only when performance doesn't matter. For simple declarations, getNameAsCString() should suffice.

Definition at line 292 of file Decl.h.

Referenced by clang::SemaOpenMP::ActOnOpenMPDeclareTargetName(), AddTypedNameChunk(), clang::consumed::ConsumedStmtVisitor::checkCallability(), clang::SemaObjC::CheckObjCBridgeRelatedConversions(), clang::checkUnsafeBufferUsage(), clang::CodeCompletionResult::createCodeCompletionStringForDecl(), createTemplateSignatureString(), EmitHipStdParUnsupportedBuiltin(), findMetaClassAlloc(), clang::Sema::getDestructorName(), clang::ento::retaincountchecker::RefLeakReportVisitor::getEndPath(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForOverloadedOperator(), clang::extractapi::DeclarationFragmentsBuilder::getFragmentsForSpecialCXXMethod(), getNoteTag(), clang::ASTContext::getObjCEncodingForPropertyDecl(), clang::extractapi::DeclarationFragmentsBuilder::getSubHeading(), IsTemplateDeclCommonStructurallyEquivalent(), clang::randstruct::randomizeStructureLayout(), rewriteToObjCProperty(), clang::ento::SValExplainer::VisitFieldRegion(), clang::JSONNodeDumper::VisitMemberExpr(), clang::JSONNodeDumper::VisitNamedDecl(), clang::ento::SValExplainer::VisitObjCIvarRegion(), and clang::JSONNodeDumper::VisitUsingDecl().

◆ getNameForDiagnostic()

void NamedDecl::getNameForDiagnostic	(	raw_ostream &	OS,
		const PrintingPolicy &	Policy,
		bool	Qualified
	)		const

virtual

Appends a human-readable name for this declaration into the given stream.

This is the method invoked by Sema when displaying a NamedDecl in a diagnostic. It does not necessarily produce the same result as printName(); for example, class template specializations are printed with their template arguments.

Reimplemented in clang::FunctionDecl, clang::ClassTemplateSpecializationDecl, and clang::VarTemplateSpecializationDecl.

Definition at line 1811 of file Decl.cpp.

References printName(), printQualifiedName(), and clang::Qualified.

Referenced by annotateConsumedSummaryMismatch(), clang::FormatASTNodeDiagnosticArgument(), generateDiagnosticsForCallLike(), clang::FunctionDecl::getNameForDiagnostic(), clang::ClassTemplateSpecializationDecl::getNameForDiagnostic(), clang::VarTemplateSpecializationDecl::getNameForDiagnostic(), and clang::Sema::InstantiateClass().

◆ getObjCFStringFormattingFamily()

ObjCStringFormatFamily NamedDecl::getObjCFStringFormattingFamily ( ) const

Definition at line 1163 of file Decl.cpp.

References getName(), clang::SFF_CFString, and clang::SFF_None.

Referenced by clang::SemaObjC::DiagnoseCStringFormatDirectiveInCFAPI().

◆ getQualifiedNameAsString()

std::string NamedDecl::getQualifiedNameAsString ( ) const

Definition at line 1668 of file Decl.cpp.

References clang::Decl::getASTContext(), and printQualifiedName().

Referenced by DiagnosedUnqualifiedCallsToStdFunctions(), DiagnoseTwoPhaseLookup(), clang::ento::NonLoc::dumpToStream(), generateDiagnosticsForCallLike(), clang::diff::SyntaxTree::Impl::getRelativeName(), IsMicrosoftUsingDeclarationAccessBug(), clang::RecordDecl::mayInsertExtraPadding(), print_elem(), clang::ProgramPoint::printJson(), clang::ento::SValExplainer::VisitCXXBaseObjectRegion(), clang::ento::SValExplainer::VisitNonParamVarRegion(), and clang::ento::SValExplainer::VisitParamVarRegion().

◆ getUnderlyingDecl() [1/2]

NamedDecl * clang::NamedDecl::getUnderlyingDecl ( )

inline

Looks through UsingDecls and ObjCCompatibleAliasDecls for the underlying named decl.

Definition at line 462 of file Decl.h.

References clang::Decl::getKind().

Referenced by clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::BuildCXXNestedNameSpecifier(), CheckAnonMemberRedeclaration(), clang::Sema::CheckCoroutineWrapper(), clang::Sema::CheckDependentFunctionTemplateSpecialization(), checkExportedDecl(), clang::Sema::CheckFunctionTemplateSpecialization(), clang::Sema::DiagnoseEmptyLookup(), diagnoseInstanceReference(), clang::CodeGen::CGDebugInfo::EmitUsingShadowDecl(), clang::getConstructorInfo(), GetConversionType(), getDeclShowContexts(), clang::getDeclUsageType(), clang::Sema::getTypeName(), getUnderlyingDecl(), clang::Sema::isAcceptableNestedNameSpecifier(), IsMicrosoftUsingDeclarationAccessBug(), isPreferredLookupResult(), clang::Sema::LookupQualifiedName(), clang::Sema::LookupSpecialMember(), clang::Sema::LookupTemplateName(), and clang::TreeTransform< Derived >::TransformOverloadExprDecls().

◆ getUnderlyingDecl() [2/2]

const NamedDecl * clang::NamedDecl::getUnderlyingDecl ( ) const

inline

Definition at line 472 of file Decl.h.

References getUnderlyingDecl().

◆ getVisibility()

Visibility clang::NamedDecl::getVisibility ( ) const

inline

Determines the visibility of this entity.

Definition at line 419 of file Decl.h.

References getLinkageAndVisibility(), and clang::LinkageInfo::getVisibility().

◆ hasExternalFormalLinkage()

bool clang::NamedDecl::hasExternalFormalLinkage ( ) const

inline

True if this decl has external linkage.

Definition at line 404 of file Decl.h.

References getLinkageInternal(), and clang::isExternalFormalLinkage().

Referenced by clang::Sema::ActOnVariableDeclarator(), clang::Sema::isExternalWithNoLinkageType(), clang::Sema::MergeFunctionDecl(), and clang::Sema::MergeVarDecl().

◆ hasLinkage()

bool NamedDecl::hasLinkage ( ) const

Determine whether this declaration has linkage.

Definition at line 1912 of file Decl.cpp.

References clang::External, getFormalLinkage(), clang::Internal, clang::Invalid, clang::Module, clang::None, clang::UniqueExternal, and clang::VisibleNone.

Referenced by clang::Sema::BuildVariableInstantiation(), clang::Sema::checkCall(), CheckTemplateArgumentAddressOfObjectOrFunction(), clang::Sema::CheckVariableDeclarationType(), isOutOfScopePreviousDeclaration(), and clang::Sema::MergeVarDecl().

◆ hasLinkageBeenComputed()

bool clang::NamedDecl::hasLinkageBeenComputed ( ) const

inline

True if something has required us to compute the linkage of this declaration.

Language features which can retroactively change linkage (like a typedef name for linkage purposes) may need to consider this, but hopefully only in transitory ways during parsing.

Definition at line 454 of file Decl.h.

References clang::Decl::hasCachedLinkage().

Referenced by clang::Sema::setTagNameForLinkagePurposes().