clang  8.0.0svn
Classes | Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Friends | List of all members
clang::DeclContext Class Reference

DeclContext - This is used only as base class of specific decl types that can act as declaration contexts. More...

#include "clang/AST/DeclBase.h"

Inheritance diagram for clang::DeclContext:
Inheritance graph
[legend]
Collaboration diagram for clang::DeclContext:
Collaboration graph
[legend]

Classes

class  all_lookups_iterator
 all_lookups_iterator - An iterator that provides a view over the results of looking up every possible name. More...
 
class  ddiag_iterator
 An iterator over the dependent diagnostics in a dependent context. More...
 
class  decl_iterator
 decl_iterator - Iterates through the declarations stored within this context. More...
 
class  filtered_decl_iterator
 Iterates over a filtered subrange of declarations stored in a DeclContext. More...
 
class  specific_decl_iterator
 specific_decl_iterator - Iterates over a subrange of declarations stored in a DeclContext, providing only those that are of type SpecificDecl (or a class derived from it). More...
 
struct  udir_iterator
 

Public Types

using decl_range = llvm::iterator_range< decl_iterator >
 
using lookup_result = DeclContextLookupResult
 
using lookup_iterator = lookup_result::iterator
 
using lookups_range = llvm::iterator_range< all_lookups_iterator >
 
using udir_iterator_base = llvm::iterator_adaptor_base< udir_iterator, lookup_iterator, std::random_access_iterator_tag, UsingDirectiveDecl * >
 
using udir_range = llvm::iterator_range< udir_iterator >
 
using ddiag_range = llvm::iterator_range< DeclContext::ddiag_iterator >
 

Public Member Functions

 ~DeclContext ()
 
Decl::Kind getDeclKind () const
 
const char * getDeclKindName () const
 
DeclContextgetParent ()
 getParent - Returns the containing DeclContext. More...
 
const DeclContextgetParent () const
 
DeclContextgetLexicalParent ()
 getLexicalParent - Returns the containing lexical DeclContext. More...
 
const DeclContextgetLexicalParent () const
 
DeclContextgetLookupParent ()
 Find the parent context of this context that will be used for unqualified name lookup. More...
 
const DeclContextgetLookupParent () const
 
ASTContextgetParentASTContext () const
 
bool isClosure () const
 
bool isObjCContainer () const
 
bool isFunctionOrMethod () const
 
bool isLookupContext () const
 Test whether the context supports looking up names. More...
 
bool isFileContext () const
 
bool isTranslationUnit () const
 
bool isRecord () const
 
bool isNamespace () const
 
bool isStdNamespace () const
 
bool isInlineNamespace () const
 
bool isDependentContext () const
 Determines whether this context is dependent on a template parameter. More...
 
bool isTransparentContext () const
 isTransparentContext - Determines whether this context is a "transparent" context, meaning that the members declared in this context are semantically declared in the nearest enclosing non-transparent (opaque) context but are lexically declared in this context. More...
 
bool isExternCContext () const
 Determines whether this context or some of its ancestors is a linkage specification context that specifies C linkage. More...
 
const LinkageSpecDeclgetExternCContext () const
 Retrieve the nearest enclosing C linkage specification context. More...
 
bool isExternCXXContext () const
 Determines whether this context or some of its ancestors is a linkage specification context that specifies C++ linkage. More...
 
bool Equals (const DeclContext *DC) const
 Determine whether this declaration context is equivalent to the declaration context DC. More...
 
bool Encloses (const DeclContext *DC) const
 Determine whether this declaration context encloses the declaration context DC. More...
 
DeclgetNonClosureAncestor ()
 Find the nearest non-closure ancestor of this context, i.e. More...
 
const DeclgetNonClosureAncestor () const
 
DeclContextgetPrimaryContext ()
 getPrimaryContext - There may be many different declarations of the same entity (including forward declarations of classes, multiple definitions of namespaces, etc.), each with a different set of declarations. More...
 
const DeclContextgetPrimaryContext () const
 
DeclContextgetRedeclContext ()
 getRedeclContext - Retrieve the context in which an entity conflicts with other entities of the same name, or where it is a redeclaration if the two entities are compatible. More...
 
const DeclContextgetRedeclContext () const
 
DeclContextgetEnclosingNamespaceContext ()
 Retrieve the nearest enclosing namespace context. More...
 
const DeclContextgetEnclosingNamespaceContext () const
 
RecordDeclgetOuterLexicalRecordContext ()
 Retrieve the outermost lexically enclosing record context. More...
 
const RecordDeclgetOuterLexicalRecordContext () const
 
bool InEnclosingNamespaceSetOf (const DeclContext *NS) const
 Test if this context is part of the enclosing namespace set of the context NS, as defined in C++0x [namespace.def]p9. More...
 
void collectAllContexts (SmallVectorImpl< DeclContext *> &Contexts)
 Collects all of the declaration contexts that are semantically connected to this declaration context. More...
 
decl_range decls () const
 decls_begin/decls_end - Iterate over the declarations stored in this context. More...
 
decl_iterator decls_begin () const
 
decl_iterator decls_end () const
 
bool decls_empty () const
 
decl_range noload_decls () const
 noload_decls_begin/end - Iterate over the declarations stored in this context that are currently loaded; don't attempt to retrieve anything from an external source. More...
 
decl_iterator noload_decls_begin () const
 
decl_iterator noload_decls_end () const
 
void addDecl (Decl *D)
 Add the declaration D into this context. More...
 
void addDeclInternal (Decl *D)
 Add the declaration D into this context, but suppress searches for external declarations with the same name. More...
 
void addHiddenDecl (Decl *D)
 Add the declaration D to this context without modifying any lookup tables. More...
 
void removeDecl (Decl *D)
 Removes a declaration from this context. More...
 
bool containsDecl (Decl *D) const
 Checks whether a declaration is in this context. More...
 
bool containsDeclAndLoad (Decl *D) const
 Checks whether a declaration is in this context. More...
 
lookup_result lookup (DeclarationName Name) const
 lookup - Find the declarations (if any) with the given Name in this context. More...
 
lookup_result noload_lookup (DeclarationName Name)
 Find the declarations with the given name that are visible within this context; don't attempt to retrieve anything from an external source. More...
 
void localUncachedLookup (DeclarationName Name, SmallVectorImpl< NamedDecl *> &Results)
 A simplistic name lookup mechanism that performs name lookup into this declaration context without consulting the external source. More...
 
void makeDeclVisibleInContext (NamedDecl *D)
 Makes a declaration visible within this context. More...
 
lookups_range lookups () const
 
lookups_range noload_lookups (bool PreserveInternalState) const
 
all_lookups_iterator lookups_begin () const
 Iterators over all possible lookups within this context. More...
 
all_lookups_iterator lookups_end () const
 
all_lookups_iterator noload_lookups_begin () const
 Iterators over all possible lookups within this context that are currently loaded; don't attempt to retrieve anything from an external source. More...
 
all_lookups_iterator noload_lookups_end () const
 
udir_range using_directives () const
 Returns iterator range [First, Last) of UsingDirectiveDecls stored within this context. More...
 
ddiag_range ddiags () const
 
void setMustBuildLookupTable ()
 Mark that there are external lexical declarations that we need to include in our lookup table (and that are not available as external visible lookups). More...
 
StoredDeclsMapgetLookupPtr () const
 Retrieve the internal representation of the lookup structure. More...
 
StoredDeclsMapbuildLookup ()
 Ensure the lookup structure is fully-built and return it. More...
 
bool hasExternalLexicalStorage () const
 Whether this DeclContext has external storage containing additional declarations that are lexically in this context. More...
 
void setHasExternalLexicalStorage (bool ES=true) const
 State whether this DeclContext has external storage for declarations lexically in this context. More...
 
bool hasExternalVisibleStorage () const
 Whether this DeclContext has external storage containing additional declarations that are visible in this context. More...
 
void setHasExternalVisibleStorage (bool ES=true) const
 State whether this DeclContext has external storage for declarations visible in this context. More...
 
bool isDeclInLexicalTraversal (const Decl *D) const
 Determine whether the given declaration is stored in the list of declarations lexically within this context. More...
 
bool setUseQualifiedLookup (bool use=true) const
 
bool shouldUseQualifiedLookup () const
 
void dumpDeclContext () const
 
void dumpLookups () const
 
void dumpLookups (llvm::raw_ostream &OS, bool DumpDecls=false, bool Deserialize=false) const
 

Static Public Member Functions

static bool classof (const Decl *D)
 
static bool classof (const DeclContext *D)
 

Protected Member Functions

 DeclContext (Decl::Kind K)
 

Static Protected Member Functions

static std::pair< Decl *, Decl * > BuildDeclChain (ArrayRef< Decl *> Decls, bool FieldsAlreadyLoaded)
 Build up a chain of declarations. More...
 

Protected Attributes

union {
   DeclContextBitfields   DeclContextBits
 
   TagDeclBitfields   TagDeclBits
 
   EnumDeclBitfields   EnumDeclBits
 
   RecordDeclBitfields   RecordDeclBits
 
   OMPDeclareReductionDeclBitfields   OMPDeclareReductionDeclBits
 
   FunctionDeclBitfields   FunctionDeclBits
 
   CXXConstructorDeclBitfields   CXXConstructorDeclBits
 
   ObjCMethodDeclBitfields   ObjCMethodDeclBits
 
   ObjCContainerDeclBitfields   ObjCContainerDeclBits
 
   LinkageSpecDeclBitfields   LinkageSpecDeclBits
 
   BlockDeclBitfields   BlockDeclBits
 
}; 
 This anonymous union stores the bits belonging to DeclContext and classes deriving from it. More...
 
DeclFirstDecl = nullptr
 FirstDecl - The first declaration stored within this declaration context. More...
 
DeclLastDecl = nullptr
 LastDecl - The last declaration stored within this declaration context. More...
 

Friends

class ASTDeclReader
 For makeDeclVisibleInContextImpl. More...
 
class ExternalASTSource
 For reconcileExternalVisibleStorage, CreateStoredDeclsMap, hasNeedToReconcileExternalVisibleStorage. More...
 
class DependentDiagnostic
 For CreateStoredDeclsMap. More...
 
class ASTWriter
 For hasNeedToReconcileExternalVisibleStorage, hasLazyLocalLexicalLookups, hasLazyExternalLexicalLookups. More...
 

Detailed Description

DeclContext - This is used only as base class of specific decl types that can act as declaration contexts.

These decls are (only the top classes that directly derive from DeclContext are mentioned, not their subclasses):

TranslationUnitDecl ExternCContext NamespaceDecl TagDecl OMPDeclareReductionDecl FunctionDecl ObjCMethodDecl ObjCContainerDecl LinkageSpecDecl ExportDecl BlockDecl CapturedDecl

Definition at line 1261 of file DeclBase.h.

Member Typedef Documentation

◆ ddiag_range

Definition at line 2284 of file DeclBase.h.

◆ decl_range

using clang::DeclContext::decl_range = llvm::iterator_range<decl_iterator>

Definition at line 1992 of file DeclBase.h.

◆ lookup_iterator

Definition at line 2201 of file DeclBase.h.

◆ lookup_result

Definition at line 2200 of file DeclBase.h.

◆ lookups_range

Definition at line 2247 of file DeclBase.h.

◆ udir_iterator_base

using clang::DeclContext::udir_iterator_base = llvm::iterator_adaptor_base<udir_iterator, lookup_iterator, std::random_access_iterator_tag, UsingDirectiveDecl *>

Definition at line 2269 of file DeclBase.h.

◆ udir_range

using clang::DeclContext::udir_range = llvm::iterator_range<udir_iterator>

Definition at line 2277 of file DeclBase.h.

Constructor & Destructor Documentation

◆ DeclContext()

DeclContext::DeclContext ( Decl::Kind  K)
protected

Definition at line 1014 of file DeclBase.cpp.

Referenced by clang::ObjCInterfaceDecl::lookupPrivateMethod().

◆ ~DeclContext()

DeclContext::~DeclContext ( )
default

Referenced by classof().

Member Function Documentation

◆ addDecl()

void DeclContext::addDecl ( Decl D)

Add the declaration D into this context.

This routine should be invoked when the declaration D has first been declared, to place D into the context where it was (lexically) defined. Every declaration must be added to one (and only one!) context, where it can be visited via [decls_begin(), decls_end()). Once a declaration has been added to its lexical context, the corresponding DeclContext owns the declaration.

If D is also a NamedDecl, it will be made visible within its semantic context via makeDeclVisibleInContext.

Definition at line 1502 of file DeclBase.cpp.

Referenced by clang::Sema::ActOnPragmaMSComment(), clang::Sema::ActOnStartCategoryImplementation(), clang::Sema::ActOnStartCategoryInterface(), addFieldToRecordDecl(), clang::ObjCImplDecl::addPropertyImplementation(), clang::ASTContext::buildBuiltinTemplateDecl(), clang::Sema::BuildLambdaExpr(), captureThis(), clang::Sema::CheckImplementationIvars(), clang::Sema::createImplicitModuleImportForErrorRecovery(), clang::ASTContext::getBlockDescriptorExtendedType(), clang::ASTContext::getBlockDescriptorType(), clang::ASTContext::getCFConstantStringDecl(), clang::CodeGen::CodeGenModule::getObjCFastEnumerationStateType(), clang::ASTContext::getObjCSuperType(), getPreviousDeclForInstantiation(), clang::TemplateDeclInstantiator::InstantiateEnumDefinition(), clang::TemplateDeclInstantiator::InstantiateTypedefNameDecl(), clang::Sema::ProcessPropertyDecl(), clang::Sema::PushUsingDirective(), clang::TemplateDeclInstantiator::VisitCXXMethodDecl(), and clang::TemplateDeclInstantiator::VisitVarDecl().

◆ addDeclInternal()

void DeclContext::addDeclInternal ( Decl D)

Add the declaration D into this context, but suppress searches for external declarations with the same name.

Although analogous in function to addDecl, this removes an important check. This is only useful if the Decl is being added in response to an external search; in all other cases, addDecl() is the right function to use. See the ASTImporter for use cases.

Definition at line 1510 of file DeclBase.cpp.

Referenced by clang::ASTNodeImporter::VisitAccessSpecDecl(), clang::ASTNodeImporter::VisitClassTemplateSpecializationDecl(), clang::ASTNodeImporter::VisitEmptyDecl(), clang::ASTNodeImporter::VisitFriendDecl(), clang::ASTNodeImporter::VisitLinkageSpecDecl(), clang::ASTNodeImporter::VisitObjCCategoryImplDecl(), clang::ASTNodeImporter::VisitObjCPropertyImplDecl(), clang::ASTNodeImporter::VisitStaticAssertDecl(), and clang::ASTNodeImporter::VisitVarTemplateSpecializationDecl().

◆ addHiddenDecl()

void DeclContext::addHiddenDecl ( Decl D)

Add the declaration D to this context without modifying any lookup tables.

This is useful for some operations in dependent contexts where the semantic context might not be dependent; this basically only happens with friends.

Definition at line 1476 of file DeclBase.cpp.

References clang::ASTContext::addedLocalImportDecl(), clang::Decl::getASTContext(), clang::Decl::getLexicalDeclContext(), clang::Decl::getNextDeclInContext(), and clang::Decl::isFromASTFile().

Referenced by buildCaptureDecl(), clang::Sema::BuildVariableInstantiation(), FinishForRangeVarDecl(), and clang::TemplateDeclInstantiator::VisitVarDecl().

◆ BuildDeclChain()

std::pair< Decl *, Decl * > DeclContext::BuildDeclChain ( ArrayRef< Decl *>  Decls,
bool  FieldsAlreadyLoaded 
)
staticprotected

Build up a chain of declarations.

Returns
the first/last pair of declarations.

Definition at line 1243 of file DeclBase.cpp.

References clang::ExternalASTSource::FindExternalLexicalDecls(), and clang::Decl::NextInContextAndBits.

Referenced by clang::RecordDecl::isMsStruct().

◆ buildLookup()

StoredDeclsMap * DeclContext::buildLookup ( )

Ensure the lookup structure is fully-built and return it.

buildLookup - Build the lookup data structure with all of the declarations in this DeclContext (and any other contexts linked to it or transparent contexts nested within it) and return it.

Note that the produced map may miss out declarations from an external source. If it does, those entries will be marked with the 'hasExternalDecls' flag.

Definition at line 1525 of file DeclBase.cpp.

Referenced by lookups().

◆ classof() [1/2]

bool DeclContext::classof ( const Decl D)
static

Definition at line 1024 of file DeclBase.cpp.

References clang::Decl::getKind(), and ~DeclContext().

◆ classof() [2/2]

static bool clang::DeclContext::classof ( const DeclContext D)
inlinestatic

Definition at line 2353 of file DeclBase.h.

References clang::C.

◆ collectAllContexts()

void DeclContext::collectAllContexts ( SmallVectorImpl< DeclContext *> &  Contexts)

Collects all of the declaration contexts that are semantically connected to this declaration context.

For declaration contexts that have multiple semantically connected but syntactically distinct contexts, such as C++ namespaces, this routine retrieves the complete set of such declaration contexts in source order. For example, given:

namespace N {
int x;
}
namespace N {
int y;
}

The Contexts parameter will contain both definitions of N.

Parameters
ContextsWill be cleared and set to the set of declaration contexts that are semanticaly connected to this declaration context, in source order, including this context (which may be the only result, for non-namespace contexts).

Definition at line 1226 of file DeclBase.cpp.

◆ containsDecl()

bool DeclContext::containsDecl ( Decl D) const

Checks whether a declaration is in this context.

Definition at line 1387 of file DeclBase.cpp.

References clang::Decl::getLexicalDeclContext(), and clang::Decl::NextInContextAndBits.

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

◆ containsDeclAndLoad()

bool DeclContext::containsDeclAndLoad ( Decl D) const

Checks whether a declaration is in this context.

This also loads the Decls from the external source before the check.

Definition at line 1392 of file DeclBase.cpp.

◆ ddiags()

DeclContext::ddiag_range clang::DeclContext::ddiags ( ) const
inline

Definition at line 176 of file DependentDiagnostic.h.

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

◆ decls()

decl_range clang::DeclContext::decls ( ) const
inline

◆ decls_begin()

DeclContext::decl_iterator DeclContext::decls_begin ( ) const

◆ decls_empty()

bool DeclContext::decls_empty ( ) const

Definition at line 1380 of file DeclBase.cpp.

◆ decls_end()

decl_iterator clang::DeclContext::decls_end ( ) const
inline

◆ dumpDeclContext()

LLVM_DUMP_METHOD void DeclContext::dumpDeclContext ( ) const

◆ dumpLookups() [1/2]

LLVM_DUMP_METHOD void DeclContext::dumpLookups ( ) const

◆ dumpLookups() [2/2]

void clang::DeclContext::dumpLookups ( llvm::raw_ostream &  OS,
bool  DumpDecls = false,
bool  Deserialize = false 
) const

◆ Encloses()

bool DeclContext::Encloses ( const DeclContext DC) const

◆ Equals()

bool clang::DeclContext::Equals ( const DeclContext DC) const
inline

◆ getDeclKind()

Decl::Kind clang::DeclContext::getDeclKind ( ) const
inline

◆ getDeclKindName()

const char * DeclContext::getDeclKindName ( ) const

Definition at line 155 of file DeclBase.cpp.

◆ getEnclosingNamespaceContext() [1/2]

DeclContext * DeclContext::getEnclosingNamespaceContext ( )

Retrieve the nearest enclosing namespace context.

Definition at line 1733 of file DeclBase.cpp.

References getParent(), getPrimaryContext(), and isFileContext().

Referenced by CheckExplicitInstantiationScope(), and clang::AnalysisDeclContext::isInStdNamespace().

◆ getEnclosingNamespaceContext() [2/2]

const DeclContext* clang::DeclContext::getEnclosingNamespaceContext ( ) const
inline

Definition at line 1908 of file DeclBase.h.

◆ getExternCContext()

const LinkageSpecDecl * DeclContext::getExternCContext ( ) const

Retrieve the nearest enclosing C linkage specification context.

Definition at line 1136 of file DeclBase.cpp.

References getDeclKind(), getLexicalParent(), and clang::LinkageSpecDecl::lang_c.

Referenced by clang::Sema::CheckLiteralOperatorDeclaration(), and clang::Sema::CheckTemplateDeclScope().

◆ getLexicalParent() [1/2]

DeclContext* clang::DeclContext::getLexicalParent ( )
inline

◆ getLexicalParent() [2/2]

const DeclContext* clang::DeclContext::getLexicalParent ( ) const
inline

Definition at line 1770 of file DeclBase.h.

◆ getLookupParent() [1/2]

DeclContext * DeclContext::getLookupParent ( )

Find the parent context of this context that will be used for unqualified name lookup.

Generally, the parent lookup context is the semantic context. However, for a friend function the parent lookup context is the lexical context, which is the class in which the friend is declared.

Definition at line 1050 of file DeclBase.cpp.

Referenced by AddTopLevelDeclarationToHash(), findRecordWithDependentBasesOfEnclosingMethod(), and LookupVisibleDecls().

◆ getLookupParent() [2/2]

const DeclContext* clang::DeclContext::getLookupParent ( ) const
inline

Definition at line 1776 of file DeclBase.h.

◆ getLookupPtr()

StoredDeclsMap* clang::DeclContext::getLookupPtr ( ) const
inline

Retrieve the internal representation of the lookup structure.

This may omit some names if we are lazily building the structure.

Definition at line 2304 of file DeclBase.h.

Referenced by noload_lookups().

◆ getNonClosureAncestor() [1/2]

Decl * DeclContext::getNonClosureAncestor ( )

Find the nearest non-closure ancestor of this context, i.e.

the innermost semantic parent of this context which is not a closure. A context may be its own non-closure ancestor.

Definition at line 1006 of file DeclBase.cpp.

References getNonClosureContext().

Referenced by LookupMethodInReceiverType().

◆ getNonClosureAncestor() [2/2]

const Decl* clang::DeclContext::getNonClosureAncestor ( ) const
inline

Definition at line 1883 of file DeclBase.h.

◆ getOuterLexicalRecordContext() [1/2]

RecordDecl * DeclContext::getOuterLexicalRecordContext ( )

Retrieve the outermost lexically enclosing record context.

Definition at line 1741 of file DeclBase.cpp.

References getLexicalParent(), and isRecord().

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

◆ getOuterLexicalRecordContext() [2/2]

const RecordDecl* clang::DeclContext::getOuterLexicalRecordContext ( ) const
inline

Definition at line 1914 of file DeclBase.h.

◆ getParent() [1/2]

DeclContext* clang::DeclContext::getParent ( )
inline

getParent - Returns the containing DeclContext.

Definition at line 1751 of file DeclBase.h.

References clang::Decl::getDeclContext().

Referenced by clang::Sema::ActOnFinishFullExpr(), clang::Sema::ActOnSEHTryBlock(), clang::Sema::ActOnUsingDirective(), clang::ODRHash::AddCXXRecordDecl(), clang::ODRHash::AddFunctionDecl(), clang::Sema::adjustContextForLocalExternDecl(), adjustCVQualifiersForCXXThisWithinLambda(), clang::Sema::CheckConstructorAccess(), CheckIfAnyEnclosingLambdasMustCaptureAnyPotentialCaptures(), clang::Sema::CheckQualifiedMemberReference(), clang::Sema::CheckShadow(), clang::Sema::CheckUsingShadowDecl(), ClassifyImplicitMemberAccess(), CollectEnclosingNamespace(), clang::Sema::CreateCapturedStmtRecordDecl(), clang::ento::ExprEngine::CreateCXXTemporaryObject(), clang::Sema::createLambdaClosureType(), clang::ASTContext::DeclMustBeEmitted(), DiagnoseNamespaceInlineMismatch(), DiagnoseTwoPhaseLookup(), dumpDeclContext(), dumpLookups(), dumpPreviousDecl(), Encloses(), clang::Sema::FindInstantiatedDecl(), findOuterContext(), findRecordWithDependentBasesOfEnclosingMethod(), getBestNamespaceSubstr(), clang::CXXMethodDecl::getCorrespondingMethodInClass(), clang::Sema::getCurMethodDecl(), clang::Sema::getCurrentMangleNumberContext(), getEnclosingNamespaceContext(), getExternalLinkageFor(), clang::Sema::getFunctionLevelDeclContext(), clang::getLambdaAwareParentOfDeclContext(), getNullabilityCompletenessCheckFileID(), getOutermostEnclosingLambda(), getOutermostFuncOrBlockContext(), clang::getParameterABISpelling(), clang::CXXMethodDecl::getParent(), getRedeclContext(), clang::AnalysisDeclContext::getSelfDecl(), getStaticBooleanValue(), getTagInjectionContext(), clang::CXXMethodDecl::getThisType(), clang::Decl::getTranslationUnitDecl(), HandleConstructorCall(), clang::CodeGen::CodeGenModule::HasHiddenLTOVisibility(), InEnclosingNamespaceSetOf(), clang::TemplateDeclInstantiator::InstantiateEnumDefinition(), clang::Sema::InstantiateFunctionDeclaration(), clang::ento::CallEvent::isCalled(), clang::CXXRecordDecl::isCurrentInstantiation(), isDeclContextInNamespace(), IsDisallowedCopyOrAssign(), clang::FunctionDecl::isGlobal(), clang::Decl::isInAnonymousNamespace(), clang::Sema::IsInsideALocalClassWithinATemplateFunction(), clang::CXXMethodDecl::isLambdaStaticInvoker(), isReferenceToNonConstCapture(), IsUsingDirectiveInToplevelContext(), clang::MangleContext::mangleBlock(), clang::CodeGen::CGRecordLayout::print(), clang::FieldDecl::setCapturedVLAType(), clang::Sema::tryCaptureVariable(), tryImplicitlyCaptureThisIfImplicitMemberFunctionAccessWithDependentArgs(), clang::FunctionCallFilterCCC::ValidateCandidate(), clang::ento::ExprEngine::VisitCommonDeclRefExpr(), clang::ASTDeclWriter::VisitDecl(), and clang::ASTDeclWriter::VisitNamespaceDecl().

◆ getParent() [2/2]

const DeclContext* clang::DeclContext::getParent ( ) const
inline

Definition at line 1754 of file DeclBase.h.

◆ getParentASTContext()

ASTContext& clang::DeclContext::getParentASTContext ( ) const
inline

◆ getPrimaryContext() [1/2]

DeclContext * DeclContext::getPrimaryContext ( )

getPrimaryContext - There may be many different declarations of the same entity (including forward declarations of classes, multiple definitions of namespaces, etc.), each with a different set of declarations.

This routine returns the "primary" DeclContext structure, which will contain the information needed to perform name lookup into this context.

Definition at line 1161 of file DeclBase.cpp.

References clang::TagDecl::getDefinition(), and clang::TagDecl::isBeingDefined().

Referenced by CollectEnclosingNamespace(), Encloses(), Equals(), findRecordWithDependentBasesOfEnclosingMethod(), getEnclosingNamespaceContext(), clang::Sema::getScopeForContext(), isImportedDeclContext(), lookups(), LookupVisibleDecls(), makeDeclVisibleInContext(), MightInstantiateTo(), noload_lookups(), and clang::ASTDeclWriter::VisitNamespaceDecl().

◆ getPrimaryContext() [2/2]

const DeclContext* clang::DeclContext::getPrimaryContext ( ) const
inline

Definition at line 1894 of file DeclBase.h.

◆ getRedeclContext() [1/2]

DeclContext * DeclContext::getRedeclContext ( )

getRedeclContext - Retrieve the context in which an entity conflicts with other entities of the same name, or where it is a redeclaration if the two entities are compatible.

This skips through transparent contexts.

Definition at line 1725 of file DeclBase.cpp.

References getParent(), and isTransparentContext().

Referenced by adjustDeclContextForDeclaratorDecl(), clang::Sema::CheckCompleteVariableDeclaration(), clang::Sema::CheckDeductionGuideDeclarator(), clang::Sema::CheckDependentFunctionTemplateSpecialization(), CheckExplicitInstantiationScope(), clang::Sema::CheckFunctionTemplateSpecialization(), clang::Sema::CheckObjCDeclScope(), CheckOperatorNewDeleteDeclarationScope(), clang::Sema::CheckShadow(), clang::Sema::CheckTemplateDeclScope(), CheckTemplateSpecializationScope(), clang::Sema::CheckUsingDeclQualifier(), CloneDesignatedInitExpr(), clang::ASTReader::CompleteRedeclChain(), clang::LinkageComputer::computeLVForDecl(), clang::TypeName::createNestedNameSpecifierForScopeOf(), clang::NamedDecl::declarationReplaces(), clang::ASTContext::forEachMultiversionedFunctionVersion(), getContextForScopeMatching(), getDeclForLocalLookup(), clang::getDeclUsageType(), clang::NamedDecl::getExplicitVisibility(), getExternalLinkageFor(), getFunctionStorageClass(), clang::NamedDecl::isCXXClassMember(), clang::VarDecl::isFunctionOrMethodVarDecl(), clang::FunctionDecl::isMain(), clang::FunctionDecl::isMSVCRTEntryPoint(), clang::FunctionDecl::isReplaceableGlobalAllocationFunction(), clang::FunctionDecl::isReservedGlobalPlacementOperator(), isSameEntity(), shouldConsiderLinkage(), shouldIgnoreDueToReservedName(), and clang::ASTDeclWriter::VisitNamespaceDecl().

◆ getRedeclContext() [2/2]

const DeclContext* clang::DeclContext::getRedeclContext ( ) const
inline

Definition at line 1902 of file DeclBase.h.

◆ hasExternalLexicalStorage()

bool clang::DeclContext::hasExternalLexicalStorage ( ) const
inline

Whether this DeclContext has external storage containing additional declarations that are lexically in this context.

Definition at line 2311 of file DeclBase.h.

Referenced by clang::ExternalASTMerger::CanComplete(), clang::ExternalASTMerger::CompleteType(), clang::RecordDecl::field_begin(), clang::ASTContext::getASTRecordLayout(), isDiagnosedResult(), and clang::RecordDecl::isMsStruct().

◆ hasExternalVisibleStorage()

bool clang::DeclContext::hasExternalVisibleStorage ( ) const
inline

Whether this DeclContext has external storage containing additional declarations that are visible in this context.

Definition at line 2323 of file DeclBase.h.

Referenced by clang::ExternalASTMerger::CanComplete(), clang::ASTReader::completeVisibleDeclsMap(), and lookups().

◆ InEnclosingNamespaceSetOf()

bool DeclContext::InEnclosingNamespaceSetOf ( const DeclContext NS) const

Test if this context is part of the enclosing namespace set of the context NS, as defined in C++0x [namespace.def]p9.

If either context isn't a namespace, this is equivalent to Equals().

The enclosing namespace set of a namespace is the namespace and, if it is inline, its enclosing namespace, recursively.

Definition at line 1752 of file DeclBase.cpp.

References Equals(), and getParent().

Referenced by clang::Sema::CheckDependentFunctionTemplateSpecialization(), CheckExplicitInstantiationScope(), and clang::Sema::CheckFunctionTemplateSpecialization().

◆ isClosure()

bool clang::DeclContext::isClosure ( ) const
inline

Definition at line 1784 of file DeclBase.h.

Referenced by clang::FormatASTNodeDiagnosticArgument().

◆ isDeclInLexicalTraversal()

bool clang::DeclContext::isDeclInLexicalTraversal ( const Decl D) const
inline

Determine whether the given declaration is stored in the list of declarations lexically within this context.

Definition at line 2337 of file DeclBase.h.

References clang::Decl::NextInContextAndBits.

Referenced by clang::ASTReader::FindExternalLexicalDecls().

◆ isDependentContext()

bool DeclContext::isDependentContext ( ) const

Determines whether this context is dependent on a template parameter.

Definition at line 1081 of file DeclBase.cpp.

Referenced by clang::Sema::ActOnFinishFunctionBody(), clang::ASTRecordWriter::AddFunctionDefinition(), AddKeywordsToConsumer(), clang::CXXMethodDecl::addOverriddenMethod(), clang::Sema::adjustContextForLocalExternDecl(), clang::Sema::AdjustDestructorExceptionSpec(), buildDeclareReductionRef(), clang::Sema::BuildVariableInstantiation(), CanDeclareSpecialMemberFunction(), clang::Sema::canFullyTypeCheckRedeclaration(), checkForMultipleExportedDefaultConstructors(), CheckIfAnyEnclosingLambdasMustCaptureAnyPotentialCaptures(), checkMoveAssignmentForRepeatedMove(), checkOpenMPLoop(), CheckOperatorDeleteDeclaration(), clang::Sema::CheckPureMethod(), clang::Sema::CheckTemplateArgument(), clang::Sema::CheckTemplatePartialSpecializationArgs(), checkTypeMappable(), clang::Sema::CheckUsingDeclQualifier(), clang::Sema::checkVarDeclRedefinition(), computeDeclRefDependence(), clang::Sema::DeclareImplicitDeductionGuides(), clang::ASTContext::DeclMustBeEmitted(), clang::Sema::DeduceFunctionTypeFromReturnExpr(), DiagnoseBaseOrMemInitializerOrder(), clang::Sema::FinalizeVarWithDestructor(), clang::Sema::FindInstantiatedDecl(), findRecordWithDependentBasesOfEnclosingMethod(), clang::CXXRecordDecl::forallBases(), getCurrentInstantiationOf(), getStackIndexOfNearestEnclosingCaptureReadyLambda(), clang::CXXRecordDecl::hasAnyDependentBases(), clang::TemplateDeclInstantiator::InstantiateEnumDefinition(), clang::TemplateArgument::isDependent(), IsDerivedFromInclusive(), clang::TemplateArgument::isInstantiationDependent(), IsKnownEmitted(), isOdrUseContext(), clang::Expr::isPotentialConstantExpr(), clang::Sema::LookupParsedName(), clang::Sema::LookupQualifiedName(), clang::Sema::MarkBaseAndMemberDestructorsReferenced(), clang::Sema::MarkVTableUsed(), clang::CXXRecordDecl::mayBeAbstract(), clang::Sema::MaybeBindToTemporary(), clang::serialization::needsAnonymousDeclarationNumber(), clang::Sema::RequireCompleteDeclContext(), clang::Sema::SetCtorInitializers(), clang::Sema::shouldLinkDependentDeclWithPrevious(), clang::Sema::ShouldWarnIfUnusedFileScopedDecl(), clang::Sema::startLambdaDefinition(), and tryImplicitlyCaptureThisIfImplicitMemberFunctionAccessWithDependentArgs().

◆ isExternCContext()

bool DeclContext::isExternCContext ( ) const

Determines whether this context or some of its ancestors is a linkage specification context that specifies C linkage.

Definition at line 1132 of file DeclBase.cpp.

References isLinkageSpecContext(), and clang::LinkageSpecDecl::lang_c.

Referenced by clang::Sema::ActOnStartOpenMPDeclareTargetDirective(), clang::Sema::CheckTemplateDeclScope(), clang::VarDecl::isInExternCContext(), clang::FunctionDecl::isInExternCContext(), and clang::CXXRecordDecl::isInterfaceLike().

◆ isExternCXXContext()

bool DeclContext::isExternCXXContext ( ) const

Determines whether this context or some of its ancestors is a linkage specification context that specifies C++ linkage.

Definition at line 1147 of file DeclBase.cpp.

References isLinkageSpecContext(), and clang::LinkageSpecDecl::lang_cxx.

Referenced by clang::Sema::ActOnStartOpenMPDeclareTargetDirective(), clang::VarDecl::isInExternCXXContext(), and clang::FunctionDecl::isInExternCXXContext().

◆ isFileContext()

bool clang::DeclContext::isFileContext ( ) const
inline

◆ isFunctionOrMethod()

bool clang::DeclContext::isFunctionOrMethod ( ) const
inline

◆ isInlineNamespace()

bool DeclContext::isInlineNamespace ( ) const

Definition at line 1060 of file DeclBase.cpp.

Referenced by CollectEnclosingNamespace().

◆ isLookupContext()

bool clang::DeclContext::isLookupContext ( ) const
inline

Test whether the context supports looking up names.

Definition at line 1812 of file DeclBase.h.

References isFunctionOrMethod().

Referenced by isImportedDeclContext().

◆ isNamespace()

bool clang::DeclContext::isNamespace ( ) const
inline

◆ isObjCContainer()

bool clang::DeclContext::isObjCContainer ( ) const
inline

◆ isRecord()

bool clang::DeclContext::isRecord ( ) const
inline

◆ isStdNamespace()

bool DeclContext::isStdNamespace ( ) const

◆ isTranslationUnit()

bool clang::DeclContext::isTranslationUnit ( ) const
inline

◆ isTransparentContext()

bool DeclContext::isTransparentContext ( ) const

isTransparentContext - Determines whether this context is a "transparent" context, meaning that the members declared in this context are semantically declared in the nearest enclosing non-transparent (opaque) context but are lexically declared in this context.

For example, consider the enumerators of an enumeration type:

enum E {
Val1
};

Here, E is a transparent context, so its enumerator (Val1) will appear (semantically) that it is in the same context of E. Examples of transparent contexts include: enumerations (except for C++0x scoped enums), and C++ linkage specifications.

Definition at line 1113 of file DeclBase.cpp.

Referenced by clang::Sema::CheckQualifiedMemberReference(), CollectEnclosingNamespace(), and getRedeclContext().

◆ localUncachedLookup()

void DeclContext::localUncachedLookup ( DeclarationName  Name,
SmallVectorImpl< NamedDecl *> &  Results 
)

A simplistic name lookup mechanism that performs name lookup into this declaration context without consulting the external source.

This function should almost never be used, because it subverts the usual relationship between a DeclContext and the external source. See the ASTImporter for the (few, but important) use cases.

FIXME: This is very inefficient; replace uses of it with uses of noload_lookup.

Definition at line 1687 of file DeclBase.cpp.

◆ lookup()

DeclContext::lookup_result DeclContext::lookup ( DeclarationName  Name) const

◆ lookups()

DeclContext::lookups_range clang::DeclContext::lookups ( ) const
inline

◆ lookups_begin()

all_lookups_iterator clang::DeclContext::lookups_begin ( ) const

Iterators over all possible lookups within this context.

◆ lookups_end()

all_lookups_iterator clang::DeclContext::lookups_end ( ) const

◆ makeDeclVisibleInContext()

void DeclContext::makeDeclVisibleInContext ( NamedDecl D)

Makes a declaration visible within this context.

This routine makes the declaration D visible to name lookup within this context and, if this is a transparent context, within its parent contexts up to the first enclosing non-transparent context. Making a declaration visible within a context does not transfer ownership of a declaration, and a declaration can be visible in many contexts that aren't its lexical context.

If D is a redeclaration of an existing declaration that is visible from this context, as determined by NamedDecl::declarationReplaces, the previous declaration will be replaced with D.

Definition at line 1770 of file DeclBase.cpp.

References clang::StoredDeclsList::AddSubsequentDecl(), clang::C, clang::Decl::getDeclContext(), clang::NamedDecl::getDeclName(), clang::Decl::getLexicalDeclContext(), getPrimaryContext(), clang::StoredDeclsList::HandleRedeclaration(), clang::StoredDeclsList::isNull(), clang::StoredDeclsList::setHasExternalDecls(), clang::StoredDeclsList::setOnlyValue(), and shouldBeHidden().

Referenced by clang::Sema::BuildVariableInstantiation(), clang::Sema::CheckImplementationIvars(), DiagnoseNamespaceInlineMismatch(), clang::TemplateDeclInstantiator::InstantiateEnumDefinition(), clang::TemplateDeclInstantiator::VisitCXXMethodDecl(), and clang::TemplateDeclInstantiator::VisitFunctionDecl().

◆ noload_decls()

decl_range clang::DeclContext::noload_decls ( ) const
inline

noload_decls_begin/end - Iterate over the declarations stored in this context that are currently loaded; don't attempt to retrieve anything from an external source.

Definition at line 2004 of file DeclBase.h.

Referenced by AddLazyVectorDecls().

◆ noload_decls_begin()

decl_iterator clang::DeclContext::noload_decls_begin ( ) const
inline

Definition at line 2007 of file DeclBase.h.

◆ noload_decls_end()

decl_iterator clang::DeclContext::noload_decls_end ( ) const
inline

Definition at line 2008 of file DeclBase.h.

◆ noload_lookup()

DeclContext::lookup_result DeclContext::noload_lookup ( DeclarationName  Name)

Find the declarations with the given name that are visible within this context; don't attempt to retrieve anything from an external source.

Definition at line 1655 of file DeclBase.cpp.

◆ noload_lookups()

DeclContext::lookups_range clang::DeclContext::noload_lookups ( bool  PreserveInternalState) const
inline

◆ noload_lookups_begin()

all_lookups_iterator clang::DeclContext::noload_lookups_begin ( ) const

Iterators over all possible lookups within this context that are currently loaded; don't attempt to retrieve anything from an external source.

◆ noload_lookups_end()

all_lookups_iterator clang::DeclContext::noload_lookups_end ( ) const

◆ removeDecl()

void DeclContext::removeDecl ( Decl D)

Removes a declaration from this context.

Definition at line 1424 of file DeclBase.cpp.

References clang::Decl::getDeclContext(), clang::Decl::getLexicalDeclContext(), clang::Decl::NextInContextAndBits, and shouldBeHidden().

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

◆ setHasExternalLexicalStorage()

void clang::DeclContext::setHasExternalLexicalStorage ( bool  ES = true) const
inline

State whether this DeclContext has external storage for declarations lexically in this context.

Definition at line 2317 of file DeclBase.h.

Referenced by isDiagnosedResult(), and clang::serialization::reader::ASTDeclContextNameLookupTrait::ReadDataInto().

◆ setHasExternalVisibleStorage()

void clang::DeclContext::setHasExternalVisibleStorage ( bool  ES = true) const
inline

State whether this DeclContext has external storage for declarations visible in this context.

Definition at line 2329 of file DeclBase.h.

◆ setMustBuildLookupTable()

void clang::DeclContext::setMustBuildLookupTable ( )
inline

Mark that there are external lexical declarations that we need to include in our lookup table (and that are not available as external visible lookups).

These extra lookup results will be found by walking the lexical declarations of this context. This should be used only if setHasExternalLexicalStorage() has been called on any decl context for which this is the primary context.

Definition at line 2296 of file DeclBase.h.

Referenced by isDiagnosedResult().

◆ setUseQualifiedLookup()

bool clang::DeclContext::setUseQualifiedLookup ( bool  use = true) const
inline

Definition at line 2342 of file DeclBase.h.

◆ shouldUseQualifiedLookup()

bool clang::DeclContext::shouldUseQualifiedLookup ( ) const
inline

Definition at line 2348 of file DeclBase.h.

References clang::classof().

◆ using_directives()

DeclContext::udir_range DeclContext::using_directives ( ) const

Returns iterator range [First, Last) of UsingDirectiveDecls stored within this context.

Definition at line 1879 of file DeclBase.cpp.

References clang::DeclContextLookupResult::begin(), clang::C, clang::StoredDeclsMap::DestroyAll(), clang::DeclContextLookupResult::end(), and clang::Result.

Referenced by LookupQualifiedNameInUsingDirectives().

Friends And Related Function Documentation

◆ ASTDeclReader

friend class ASTDeclReader
friend

For makeDeclVisibleInContextImpl.

Definition at line 1263 of file DeclBase.h.

◆ ASTWriter

friend class ASTWriter
friend

For hasNeedToReconcileExternalVisibleStorage, hasLazyLocalLexicalLookups, hasLazyExternalLexicalLookups.

Definition at line 1271 of file DeclBase.h.

◆ DependentDiagnostic

friend class DependentDiagnostic
friend

For CreateStoredDeclsMap.

Definition at line 1268 of file DeclBase.h.

◆ ExternalASTSource

friend class ExternalASTSource
friend

For reconcileExternalVisibleStorage, CreateStoredDeclsMap, hasNeedToReconcileExternalVisibleStorage.

Definition at line 1266 of file DeclBase.h.

Member Data Documentation

◆ @42

union { ... }

This anonymous union stores the bits belonging to DeclContext and classes deriving from it.

The goal is to use otherwise wasted space in DeclContext to store data belonging to derived classes. The space saved is especially significient when pointers are aligned to 8 bytes. In this case due to alignment requirements we have a little less than 8 bytes free in DeclContext which we can use. We check that none of the classes in this union is larger than 8 bytes with static_asserts in the ctor of DeclContext.

◆ BlockDeclBits

BlockDeclBitfields clang::DeclContext::BlockDeclBits

Definition at line 1697 of file DeclBase.h.

◆ CXXConstructorDeclBits

CXXConstructorDeclBitfields clang::DeclContext::CXXConstructorDeclBits

Definition at line 1693 of file DeclBase.h.

◆ DeclContextBits

DeclContextBitfields clang::DeclContext::DeclContextBits

Definition at line 1687 of file DeclBase.h.

◆ EnumDeclBits

EnumDeclBitfields clang::DeclContext::EnumDeclBits

Definition at line 1689 of file DeclBase.h.

◆ FirstDecl

Decl* clang::DeclContext::FirstDecl = nullptr
mutableprotected

FirstDecl - The first declaration stored within this declaration context.

Definition at line 1725 of file DeclBase.h.

Referenced by clang::RecordDecl::field_begin(), and clang::RecordDecl::isMsStruct().

◆ FunctionDeclBits

FunctionDeclBitfields clang::DeclContext::FunctionDeclBits

Definition at line 1692 of file DeclBase.h.

Referenced by clang::FunctionDecl::setPure().

◆ LastDecl

Decl* clang::DeclContext::LastDecl = nullptr
mutableprotected

LastDecl - The last declaration stored within this declaration context.

FIXME: We could probably cache this value somewhere outside of the DeclContext, to reduce the size of DeclContext by another pointer.

Definition at line 1731 of file DeclBase.h.

Referenced by clang::RecordDecl::isMsStruct().

◆ LinkageSpecDeclBits

LinkageSpecDeclBitfields clang::DeclContext::LinkageSpecDeclBits

Definition at line 1696 of file DeclBase.h.

◆ ObjCContainerDeclBits

ObjCContainerDeclBitfields clang::DeclContext::ObjCContainerDeclBits

Definition at line 1695 of file DeclBase.h.

◆ ObjCMethodDeclBits

ObjCMethodDeclBitfields clang::DeclContext::ObjCMethodDeclBits

◆ OMPDeclareReductionDeclBits

OMPDeclareReductionDeclBitfields clang::DeclContext::OMPDeclareReductionDeclBits

Definition at line 1691 of file DeclBase.h.

◆ RecordDeclBits

RecordDeclBitfields clang::DeclContext::RecordDeclBits

Definition at line 1690 of file DeclBase.h.

◆ TagDeclBits

TagDeclBitfields clang::DeclContext::TagDeclBits

Definition at line 1688 of file DeclBase.h.


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