Represents the results of name lookup. More...

#include "clang/Sema/Lookup.h"

Classes
class	Filter
	A class for iterating through a result set and possibly filtering out results. More...

Public Types
enum	LookupResultKind { NotFound = 0, NotFoundInCurrentInstantiation, Found, FoundOverloaded, FoundUnresolvedValue, Ambiguous }

enum	AmbiguityKind { AmbiguousBaseSubobjectTypes, AmbiguousBaseSubobjects, AmbiguousReference, AmbiguousTagHiding }

enum	TemporaryToken { Temporary }
	A little identifier for flagging temporary lookup results. More...

using	iterator = UnresolvedSetImpl::iterator

Public Member Functions
	LookupResult (Sema &SemaRef, const DeclarationNameInfo &NameInfo, Sema::LookupNameKind LookupKind, Sema::RedeclarationKind Redecl=Sema::NotForRedeclaration)

	LookupResult (Sema &SemaRef, DeclarationName Name, SourceLocation NameLoc, Sema::LookupNameKind LookupKind, Sema::RedeclarationKind Redecl=Sema::NotForRedeclaration)

	LookupResult (TemporaryToken _, const LookupResult &Other)
	Creates a temporary lookup result, initializing its core data using the information from another result. More...

	LookupResult (const LookupResult &)=delete

LookupResult &	operator= (const LookupResult &)=delete

	LookupResult (LookupResult &&Other)

LookupResult &	operator= (LookupResult &&Other)

	~LookupResult ()

const DeclarationNameInfo &	getLookupNameInfo () const
	Gets the name info to look up. More...

void	setLookupNameInfo (const DeclarationNameInfo &NameInfo)
	Sets the name info to look up. More...

DeclarationName	getLookupName () const
	Gets the name to look up. More...

void	setLookupName (DeclarationName Name)
	Sets the name to look up. More...

Sema::LookupNameKind	getLookupKind () const
	Gets the kind of lookup to perform. More...

bool	isForRedeclaration () const
	True if this lookup is just looking for an existing declaration. More...

bool	isForExternalRedeclaration () const
	True if this lookup is just looking for an existing declaration to link against a declaration with external linkage. More...

Sema::RedeclarationKind	redeclarationKind () const

void	setAllowHidden (bool AH)
	Specify whether hidden declarations are visible, e.g., for recovery reasons. More...

bool	isHiddenDeclarationVisible (NamedDecl *ND) const
	Determine whether this lookup is permitted to see hidden declarations, such as those in modules that have not yet been imported. More...

void	setHideTags (bool Hide)
	Sets whether tag declarations should be hidden by non-tag declarations during resolution. More...

void	setTemplateNameLookup (bool TemplateName)
	Sets whether this is a template-name lookup. More...

bool	isTemplateNameLookup () const

bool	isAmbiguous () const

bool	isSingleResult () const
	Determines if this names a single result which is not an unresolved value using decl. More...

bool	isOverloadedResult () const
	Determines if the results are overloaded. More...

bool	isUnresolvableResult () const

LookupResultKind	getResultKind () const

AmbiguityKind	getAmbiguityKind () const

const UnresolvedSetImpl &	asUnresolvedSet () const

iterator	begin () const

iterator	end () const

bool	empty () const
	Return true if no decls were found. More...

CXXBasePaths *	getBasePaths () const
	Return the base paths structure that's associated with these results, or null if none is. More...

NamedDecl *	getAcceptableDecl (NamedDecl *D) const
	Retrieve the accepted (re)declaration of the given declaration, if there is one. More...

unsigned	getIdentifierNamespace () const
	Returns the identifier namespace mask for this lookup. More...

bool	isClassLookup () const
	Returns whether these results arose from performing a lookup into a class. More...

CXXRecordDecl *	getNamingClass () const
	Returns the 'naming class' for this lookup, i.e. More...

void	setNamingClass (CXXRecordDecl *Record)
	Sets the 'naming class' for this lookup. More...

QualType	getBaseObjectType () const
	Returns the base object type associated with this lookup; important for [class.protected]. More...

void	setBaseObjectType (QualType T)
	Sets the base object type for this lookup. More...

void	addDecl (NamedDecl *D)
	Add a declaration to these results with its natural access. More...

void	addDecl (NamedDecl *D, AccessSpecifier AS)
	Add a declaration to these results with the given access. More...

void	addAllDecls (const LookupResult &Other)
	Add all the declarations from another set of lookup results. More...

bool	wasNotFoundInCurrentInstantiation () const
	Determine whether no result was found because we could not search into dependent base classes of the current instantiation. More...

void	setNotFoundInCurrentInstantiation ()
	Note that while no result was found in the current instantiation, there were dependent base classes that could not be searched. More...

bool	isShadowed () const
	Determine whether the lookup result was shadowed by some other declaration that lookup ignored. More...

void	setShadowed ()
	Note that we found and ignored a declaration while performing lookup. More...

void	resolveKind ()
	Resolves the result kind of the lookup, possibly hiding decls. More...

void	resolveKindAfterFilter ()
	Re-resolves the result kind of the lookup after a set of removals has been performed. More...

template<class DeclClass >
DeclClass *	getAsSingle () const

NamedDecl *	getFoundDecl () const
	Fetch the unique decl found by this lookup. More...

NamedDecl *	getRepresentativeDecl () const
	Fetches a representative decl. Useful for lazy diagnostics. More...

bool	isSingleTagDecl () const
	Asks if the result is a single tag decl. More...

void	setAmbiguousBaseSubobjectTypes (CXXBasePaths &P)
	Make these results show that the name was found in base classes of different types. More...

void	setAmbiguousBaseSubobjects (CXXBasePaths &P)
	Make these results show that the name was found in distinct base classes of the same type. More...

void	setAmbiguousQualifiedTagHiding ()
	Make these results show that the name was found in different contexts and a tag decl was hidden by an ordinary decl in a different context. More...

LLVM_ATTRIBUTE_REINITIALIZES void	clear ()
	Clears out any current state. More...

void	clear (Sema::LookupNameKind Kind)
	Clears out any current state and re-initializes for a different kind of lookup. More...

void	setRedeclarationKind (Sema::RedeclarationKind RK)
	Change this lookup's redeclaration kind. More...

void	dump ()

void	print (raw_ostream &)

void	suppressDiagnostics ()
	Suppress the diagnostics that would normally fire because of this lookup. More...

bool	isSuppressingDiagnostics () const
	Determines whether this lookup is suppressing diagnostics. More...

void	setContextRange (SourceRange SR)
	Sets a 'context' source range. More...

SourceRange	getContextRange () const
	Gets the source range of the context of this name; for C++ qualified lookups, this is the source range of the scope specifier. More...

SourceLocation	getNameLoc () const
	Gets the location of the identifier. More...

Sema &	getSema () const
	Get the Sema object that this lookup result is searching with. More...

Filter	makeFilter ()
	Create a filter for this result set. More...

void	setFindLocalExtern (bool FindLocalExtern)

Static Public Member Functions
static bool	isVisible (Sema &SemaRef, NamedDecl *D)
	Determine whether the given declaration is visible to the program. More...

Detailed Description

Represents the results of name lookup.

An instance of the LookupResult class captures the results of a single name lookup, which can return no result (nothing found), a single declaration, a set of overloaded functions, or an ambiguity. Use the getKind() method to determine which of these results occurred for a given lookup.

Definition at line 46 of file Lookup.h.

Member Typedef Documentation

◆ iterator

using clang::LookupResult::iterator = UnresolvedSetImpl::iterator

Definition at line 143 of file Lookup.h.

Member Enumeration Documentation

◆ AmbiguityKind

enum clang::LookupResult::AmbiguityKind

Enumerator
AmbiguousBaseSubobjectTypes	Name lookup results in an ambiguity because multiple entities that meet the lookup criteria were found in subobjects of different types. For example: struct A { void f(int); } struct B { void f(double); } struct C : A, B { }; void test(C c) { c.f(0); // error: A::f and B::f come from subobjects of different // types. overload resolution is not performed. }
AmbiguousBaseSubobjects	Name lookup results in an ambiguity because multiple nonstatic entities that meet the lookup criteria were found in different subobjects of the same type. For example: struct A { int x; }; struct B : A { }; struct C : A { }; struct D : B, C { }; int test(D d) { return d.x; // error: 'x' is found in two A subobjects (of B and C) }
AmbiguousReference	Name lookup results in an ambiguity because multiple definitions of entity that meet the lookup criteria were found in different declaration contexts. namespace A { int i; namespace B { int i; } int test() { using namespace B; return i; // error 'i' is found in namespace A and A::B } }
AmbiguousTagHiding	Name lookup results in an ambiguity because an entity with a tag name was hidden by an entity with an ordinary name from a different context. namespace A { struct Foo {}; } namespace B { void Foo(); } namespace C { using namespace A; using namespace B; } void test() { C::Foo(); // error: tag 'A::Foo' is hidden by an object in a // different namespace }

Definition at line 76 of file Lookup.h.

◆ LookupResultKind

enum clang::LookupResult::LookupResultKind

Enumerator
NotFound	No entity found met the criteria.
NotFoundInCurrentInstantiation	No entity found met the criteria within the current instantiation,, but there were dependent base classes of the current instantiation that could not be searched.
Found	Name lookup found a single declaration that met the criteria. getFoundDecl() will return this declaration.
FoundOverloaded	Name lookup found a set of overloaded functions that met the criteria.
FoundUnresolvedValue	Name lookup found an unresolvable value declaration and cannot yet complete. This only happens in C++ dependent contexts with dependent using declarations.
Ambiguous	Name lookup results in an ambiguity; use getAmbiguityKind to figure out what kind of ambiguity we have.

Definition at line 48 of file Lookup.h.

◆ TemporaryToken

enum clang::LookupResult::TemporaryToken

A little identifier for flagging temporary lookup results.

Enumerator
Temporary

Definition at line 139 of file Lookup.h.

Constructor & Destructor Documentation

◆ LookupResult() [1/5]

clang::LookupResult::LookupResult	(	Sema &	SemaRef,
		const DeclarationNameInfo &	NameInfo,
		Sema::LookupNameKind	LookupKind,
		Sema::RedeclarationKind	Redecl = `Sema::NotForRedeclaration`
	)

inline

Definition at line 145 of file Lookup.h.

Referenced by LookupResult().

◆ LookupResult() [2/5]

clang::LookupResult::LookupResult	(	Sema &	SemaRef,
		DeclarationName	Name,
		SourceLocation	NameLoc,
		Sema::LookupNameKind	LookupKind,
		Sema::RedeclarationKind	Redecl = `Sema::NotForRedeclaration`
	)

inline

Definition at line 158 of file Lookup.h.

◆ LookupResult() [3/5]

clang::LookupResult::LookupResult	(	TemporaryToken	_,
		const LookupResult &	Other
	)

inline

Creates a temporary lookup result, initializing its core data using the information from another result.

Diagnostics are always disabled.

Definition at line 171 of file Lookup.h.

References LookupResult(), and operator=().

◆ LookupResult() [4/5]

clang::LookupResult::LookupResult ( const LookupResult & )

delete

◆ LookupResult() [5/5]

clang::LookupResult::LookupResult ( LookupResult && Other )

inline

Definition at line 183 of file Lookup.h.

◆ ~LookupResult()

clang::LookupResult::~LookupResult ( )

inline

Definition at line 227 of file Lookup.h.

Member Function Documentation

◆ addAllDecls()

void clang::LookupResult::addAllDecls ( const LookupResult & Other )

inline

Add all the declarations from another set of lookup results.

Definition at line 439 of file Lookup.h.

References clang::UnresolvedSetImpl::append(), clang::UnresolvedSetImpl::begin(), clang::UnresolvedSetImpl::end(), and Found.

Referenced by clang::Sema::CheckOverload(), and LookupQualifiedNameInUsingDirectives().

◆ addDecl() [1/2]

void clang::LookupResult::addDecl ( NamedDecl * D )

inline

Add a declaration to these results with its natural access.

Does not test the acceptance criteria.

Definition at line 426 of file Lookup.h.

References clang::Decl::getAccess().

Referenced by clang::Sema::ActOnIdExpression(), clang::Sema::ActOnUsingDirective(), BuildImplicitMemberInitializer(), clang::Sema::CheckImplicitSpecialMemberDeclaration(), LookupBuiltin(), LookupDirect(), clang::Sema::LookupName(), LookupPotentialTypoResult(), clang::TreeTransform< Derived >::TransformOverloadExprDecls(), TryNamespaceTypoCorrection(), and clang::TemplateDeclInstantiator::VisitCXXMethodDecl().

◆ addDecl() [2/2]

void clang::LookupResult::addDecl	(	NamedDecl *	D,
		AccessSpecifier	AS
	)

inline

Add a declaration to these results with the given access.

Does not test the acceptance criteria.

Definition at line 432 of file Lookup.h.

References clang::UnresolvedSetImpl::addDecl(), and Found.

◆ asUnresolvedSet()

const UnresolvedSetImpl& clang::LookupResult::asUnresolvedSet ( ) const

inline

Definition at line 331 of file Lookup.h.

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

◆ begin()

iterator clang::LookupResult::begin ( ) const

inline

Definition at line 335 of file Lookup.h.

References clang::UnresolvedSetImpl::begin().

Referenced by clang::Sema::ActOnExplicitInstantiation(), buildDeclareReductionRef(), buildSingleCopyAssignRecursively(), buildUserDefinedMapperRef(), clang::Sema::CheckFunctionTemplateSpecialization(), clang::Sema::CheckLookupAccess(), clang::Sema::CheckMemberSpecialization(), clang::Sema::CheckOverload(), clang::Sema::CheckQualifiedMemberReference(), clang::Sema::CheckUsingDeclRedeclaration(), clang::Sema::CheckUsingShadowDecl(), ClassifyImplicitMemberAccess(), DiagnoseTwoPhaseLookup(), getFoundDecl(), getRepresentativeDecl(), clang::Sema::hasAnyAcceptableTemplateNames(), HasNoThrowOperator(), isResultTypeOrTemplate(), isValidAfterIdentifierInDeclarator(), resolveAllocationOverload(), resolveDeallocationOverload(), clang::LookupResult::Filter::restart(), and setFindLocalExtern().

◆ clear() [1/2]

LLVM_ATTRIBUTE_REINITIALIZES void clang::LookupResult::clear ( )

inline

Clears out any current state.

Definition at line 554 of file Lookup.h.

References clang::UnresolvedSetImpl::clear(), and NotFound.

Referenced by clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnUsingDirective(), buildDeclareReductionRef(), buildUserDefinedMapperRef(), clear(), clang::Sema::DiagnoseEmptyLookup(), DiagnoseTwoPhaseLookup(), LookupPotentialTypoResult(), LookupQualifiedNameInUsingDirectives(), resolveAllocationOverload(), clang::TreeTransform< Derived >::TransformOverloadExprDecls(), TryNamespaceTypoCorrection(), and clang::TemplateDeclInstantiator::VisitCXXMethodDecl().

◆ clear() [2/2]

void clang::LookupResult::clear ( Sema::LookupNameKind Kind )

inline

Clears out any current state and re-initializes for a different kind of lookup.

Definition at line 565 of file Lookup.h.

References clear().

◆ dump()

LLVM_DUMP_METHOD void LookupResult::dump ( )

Definition at line 666 of file SemaLookup.cpp.

References clang::Decl::dump().

Referenced by clang::Sema::ActOnPragmaDump(), and setRedeclarationKind().

◆ empty()

bool clang::LookupResult::empty ( ) const

inline

Return true if no decls were found.

Definition at line 339 of file Lookup.h.

References clang::UnresolvedSetImpl::empty().

Referenced by clang::Sema::ActOnIdExpression(), clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnOpenMPIdExpression(), clang::Sema::ActOnUsingDirective(), clang::Sema::BuildForRangeBeginEndCall(), clang::Sema::BuildImplicitMemberExpr(), clang::Sema::BuildMemberReferenceExpr(), BuildNonArrayForRange(), clang::Sema::BuildQualifiedDeclarationNameExpr(), clang::Sema::BuildQualifiedTemplateIdExpr(), clang::Sema::CheckDependentFunctionTemplateSpecialization(), clang::Sema::CheckMemberSpecialization(), clang::Sema::CheckUsingShadowDecl(), clang::Sema::CheckVariableDeclaration(), ClassifyImplicitMemberAccess(), clang::Sema::DiagnoseEmptyLookup(), DiagnoseTwoPhaseLookup(), doesUsualArrayDeleteWantSize(), clang::Sema::FindAllocationFunctions(), getTupleLikeElementType(), isTupleLike(), clang::Sema::LookupInObjCMethod(), LookupMemberExprInRecord(), LookupPotentialTypoResult(), LookupQualifiedNameInUsingDirectives(), and clang::TemplateDeclInstantiator::VisitCXXMethodDecl().

◆ end()

iterator clang::LookupResult::end ( ) const

inline

Definition at line 336 of file Lookup.h.

References clang::UnresolvedSetImpl::end().

Referenced by clang::Sema::ActOnExplicitInstantiation(), buildDeclareReductionRef(), buildSingleCopyAssignRecursively(), buildUserDefinedMapperRef(), clang::Sema::CheckFunctionTemplateSpecialization(), clang::Sema::CheckLookupAccess(), clang::Sema::CheckMemberSpecialization(), clang::Sema::CheckOverload(), clang::Sema::CheckQualifiedMemberReference(), clang::Sema::CheckUsingDeclRedeclaration(), clang::Sema::CheckUsingShadowDecl(), DiagnoseTwoPhaseLookup(), clang::Sema::hasAnyAcceptableTemplateNames(), clang::LookupResult::Filter::hasNext(), HasNoThrowOperator(), isResultTypeOrTemplate(), isValidAfterIdentifierInDeclarator(), clang::Sema::maybeAddCUDAHostDeviceAttrs(), clang::LookupResult::Filter::next(), resolveAllocationOverload(), resolveDeallocationOverload(), and setFindLocalExtern().

◆ getAcceptableDecl()

NamedDecl* clang::LookupResult::getAcceptableDecl ( NamedDecl * D ) const

inline

Retrieve the accepted (re)declaration of the given declaration, if there is one.

Definition at line 361 of file Lookup.h.

References getSema(), isHiddenDeclarationVisible(), clang::Decl::isInIdentifierNamespace(), and isVisible().

Referenced by clang::Sema::CheckImplicitSpecialMemberDeclaration(), LookupDirect(), clang::Sema::LookupName(), and LookupVisibleDecls().

◆ getAmbiguityKind()

AmbiguityKind clang::LookupResult::getAmbiguityKind ( ) const

inline

Definition at line 326 of file Lookup.h.

References isAmbiguous().

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

◆ getAsSingle()

template<class DeclClass >

DeclClass* clang::LookupResult::getAsSingle ( ) const

inline

◆ getBaseObjectType()

QualType clang::LookupResult::getBaseObjectType ( ) const

inline

Returns the base object type associated with this lookup; important for [class.protected].

Most lookups do not have an associated base object.

Definition at line 415 of file Lookup.h.

◆ getBasePaths()

CXXBasePaths* clang::LookupResult::getBasePaths ( ) const

inline

Return the base paths structure that's associated with these results, or null if none is.

Definition at line 343 of file Lookup.h.

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

◆ getContextRange()

SourceRange clang::LookupResult::getContextRange ( ) const

inline

Gets the source range of the context of this name; for C++ qualified lookups, this is the source range of the scope specifier.

Definition at line 600 of file Lookup.h.

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

◆ getFoundDecl()

NamedDecl* clang::LookupResult::getFoundDecl ( ) const

inline

Fetch the unique decl found by this lookup.

Asserts that one was found.

This is intended for users who have examined the result kind and are certain that there is only one result.

Definition at line 517 of file Lookup.h.

References begin(), Found, and getResultKind().

Referenced by clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnOpenMPIdExpression(), clang::Sema::ActOnSizeofParameterPackExpr(), clang::Sema::BuildDeclarationNameExpr(), CheckObjCBridgeCFCast(), CheckObjCBridgeNSCast(), clang::Sema::checkObjCBridgeRelatedComponents(), diagReturnOnAllocFailure(), getAsSingle(), clang::Sema::getShadowedDeclaration(), isSingleTagDecl(), clang::Sema::LookupInObjCMethod(), LookupPotentialTypoResult(), clang::Sema::MergeVarDecl(), and ShouldLookupResultBeMultiVersionOverload().

◆ getIdentifierNamespace()

unsigned clang::LookupResult::getIdentifierNamespace ( ) const

inline

Returns the identifier namespace mask for this lookup.

Definition at line 377 of file Lookup.h.

Referenced by findOuterContext().

◆ getLookupKind()

Sema::LookupNameKind clang::LookupResult::getLookupKind ( ) const

inline

Gets the kind of lookup to perform.

Definition at line 253 of file Lookup.h.

Referenced by clang::Sema::ActOnSizeofParameterPackExpr(), attemptRecovery(), clang::Sema::CheckOverload(), clang::Sema::DiagnoseEmptyLookup(), findOuterContext(), LookupBuiltin(), clang::Sema::LookupInSuper(), clang::Sema::LookupName(), and TryNamespaceTypoCorrection().

◆ getLookupName()

DeclarationName clang::LookupResult::getLookupName ( ) const

inline

Gets the name to look up.

Definition at line 243 of file Lookup.h.

References clang::DeclarationNameInfo::getName().

Referenced by clang::Sema::BuildLiteralOperatorCall(), clang::Sema::CheckShadow(), clang::Sema::DiagnoseAmbiguousLookup(), clang::Sema::DiagnoseEmptyLookup(), DiagnoseTwoPhaseLookup(), diagReturnOnAllocFailure(), findOuterContext(), LookupBuiltin(), LookupDirect(), LookupMemberExpr(), clang::Sema::LookupName(), clang::Sema::LookupQualifiedName(), LookupVisibleDecls(), and resolveAllocationOverload().

◆ getLookupNameInfo()

const DeclarationNameInfo& clang::LookupResult::getLookupNameInfo ( ) const

inline

Gets the name info to look up.

Definition at line 233 of file Lookup.h.

Referenced by clang::Sema::ActOnSizeofParameterPackExpr(), attemptRecovery(), clang::Sema::BuildDeclarationNameExpr(), clang::Sema::BuildMemberReferenceExpr(), clang::Sema::BuildTemplateIdExpr(), clang::Sema::CheckQualifiedMemberReference(), clang::Sema::DiagnoseEmptyLookup(), clang::Sema::LookupInSuper(), LookupMemberExpr(), and TryNamespaceTypoCorrection().

◆ getNameLoc()

SourceLocation clang::LookupResult::getNameLoc ( ) const

inline

Gets the location of the identifier.

This isn't always defined: sometimes we're doing lookups on synthesized names.

Definition at line 606 of file Lookup.h.

References clang::DeclarationNameInfo::getLoc().

Referenced by clang::Sema::BuildDeclarationNameExpr(), clang::Sema::BuildImplicitMemberExpr(), clang::Sema::BuildLiteralOperatorCall(), clang::Sema::BuildMemberReferenceExpr(), clang::Sema::BuildTemplateIdExpr(), clang::Sema::CheckShadow(), clang::Sema::DiagnoseAmbiguousLookup(), clang::Sema::DiagnoseEmptyLookup(), DiagnoseTwoPhaseLookup(), findOuterContext(), LookupBuiltin(), LookupDirect(), clang::Sema::LookupInObjCMethod(), LookupMemberExpr(), LookupMemberExprInRecord(), LookupVisibleDecls(), resolveAllocationOverload(), and shouldWarnIfShadowedDecl().

◆ getNamingClass()

CXXRecordDecl* clang::LookupResult::getNamingClass ( ) const

inline

Returns the 'naming class' for this lookup, i.e.

the class which was looked into to find these results.

C++0x [class.access.base]p5: The access to a member is affected by the class in which the member is named. This naming class is the class in which the member name was looked up and found. [Note: this class can be explicit, e.g., when a qualified-id is used, or implicit, e.g., when a class member access operator (5.2.5) is used (including cases where an implicit "this->" is added). If both a class member access operator and a qualified-id are used to name the member (as in p->T::m), the class naming the member is the class named by the nested-name-specifier of the qualified-id (that is, T). – end note ]

This is set by the lookup routines when they find results in a class.

Definition at line 403 of file Lookup.h.

Referenced by clang::Sema::CheckLookupAccess(), and resolveAllocationOverload().

◆ getRepresentativeDecl()

NamedDecl* clang::LookupResult::getRepresentativeDecl ( ) const

inline

Fetches a representative decl. Useful for lazy diagnostics.

Definition at line 524 of file Lookup.h.

References begin(), and clang::UnresolvedSetImpl::empty().

Referenced by clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnStartNamespaceDef(), clang::Sema::ActOnUsingDirective(), clang::Sema::BuildDeclarationNameExpr(), buildDeclareReductionRef(), buildUserDefinedMapperRef(), clang::Sema::CheckQualifiedMemberReference(), diagReturnOnAllocFailure(), getTupleLikeElementType(), clang::Sema::MergeVarDecl(), and clang::TreeTransform< Derived >::RebuildDependentNameType().

◆ getResultKind()

LookupResultKind clang::LookupResult::getResultKind ( ) const

inline

Definition at line 321 of file Lookup.h.

Referenced by clang::Sema::ActOnIdExpression(), clang::Sema::ActOnSizeofParameterPackExpr(), clang::Sema::BuildQualifiedDeclarationNameExpr(), clang::Sema::CheckMicrosoftIfExistsSymbol(), clang::Sema::CheckTemplateTypeArgument(), getAsSingle(), getFoundDecl(), isAmbiguous(), isOverloadedResult(), isSingleResult(), isSingleTagDecl(), isUnresolvableResult(), clang::Sema::LookupLiteralOperator(), clang::TreeTransform< Derived >::RebuildDependentNameType(), and shouldWarnIfShadowedDecl().

◆ getSema()

Sema& clang::LookupResult::getSema ( ) const

inline

Get the Sema object that this lookup result is searching with.

Definition at line 612 of file Lookup.h.

Referenced by getAcceptableDecl(), isResultTypeOrTemplate(), LookupDirect(), LookupVisibleDecls(), and setFindLocalExtern().

◆ isAmbiguous()

bool clang::LookupResult::isAmbiguous ( ) const

inline

Definition at line 301 of file Lookup.h.

References Ambiguous, and getResultKind().

Referenced by clang::Sema::ActOnExplicitInstantiation(), clang::Sema::ActOnIdExpression(), clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnOpenMPDeclareTargetName(), clang::Sema::ActOnOpenMPIdExpression(), clang::Sema::ActOnUsingDirective(), clang::Sema::BuildImplicitMemberExpr(), clang::Sema::BuildMemberReferenceExpr(), clang::Sema::BuildMemInitializer(), BuildNonArrayForRange(), clang::Sema::BuildQualifiedDeclarationNameExpr(), clang::Sema::BuildQualifiedTemplateIdExpr(), clang::Sema::BuildTemplateIdExpr(), clang::Sema::DiagnoseAmbiguousLookup(), doesUsualArrayDeleteWantSize(), clang::Sema::FindAllocationFunctions(), clang::Sema::FindDeallocationFunction(), getAmbiguityKind(), lookupStdTypeTraitMember(), and setFindLocalExtern().

◆ isClassLookup()

bool clang::LookupResult::isClassLookup ( ) const

inline

Returns whether these results arose from performing a lookup into a class.

Definition at line 383 of file Lookup.h.

Referenced by setFindLocalExtern().

◆ isForExternalRedeclaration()

bool clang::LookupResult::isForExternalRedeclaration ( ) const

inline

True if this lookup is just looking for an existing declaration to link against a declaration with external linkage.

Definition at line 264 of file Lookup.h.

Referenced by isHiddenDeclarationVisible().

◆ isForRedeclaration()

bool clang::LookupResult::isForRedeclaration ( ) const

inline

True if this lookup is just looking for an existing declaration.

Definition at line 258 of file Lookup.h.

Referenced by LookupBuiltin(), and LookupDirect().

◆ isHiddenDeclarationVisible()

bool clang::LookupResult::isHiddenDeclarationVisible ( NamedDecl * ND ) const

inline

Determine whether this lookup is permitted to see hidden declarations, such as those in modules that have not yet been imported.

Definition at line 281 of file Lookup.h.

References clang::NamedDecl::isExternallyDeclarable(), and isForExternalRedeclaration().

Referenced by getAcceptableDecl().

◆ isOverloadedResult()

bool clang::LookupResult::isOverloadedResult ( ) const

inline

Determines if the results are overloaded.

Definition at line 313 of file Lookup.h.

References FoundOverloaded, and getResultKind().

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

◆ isShadowed()

bool clang::LookupResult::isShadowed ( ) const

inline

Determine whether the lookup result was shadowed by some other declaration that lookup ignored.

Definition at line 459 of file Lookup.h.

◆ isSingleResult()

bool clang::LookupResult::isSingleResult ( ) const

inline

Determines if this names a single result which is not an unresolved value using decl.

If so, it is safe to call getFoundDecl().

Definition at line 308 of file Lookup.h.

References Found, and getResultKind().

Referenced by clang::Sema::ActOnNamespaceAliasDef(), clang::Sema::ActOnOpenMPDeclareTargetName(), clang::Sema::ActOnOpenMPIdExpression(), clang::Sema::ActOnStartNamespaceDef(), clang::Sema::BuildDeclarationNameExpr(), clang::Sema::LookupInObjCMethod(), LookupPotentialTypoResult(), clang::Sema::MergeVarDecl(), and ShouldLookupResultBeMultiVersionOverload().

◆ isSingleTagDecl()

bool clang::LookupResult::isSingleTagDecl ( ) const

inline

Asks if the result is a single tag decl.

Definition at line 530 of file Lookup.h.

References Found, getFoundDecl(), getResultKind(), P, setAmbiguousBaseSubobjects(), and setAmbiguousBaseSubobjectTypes().

Referenced by LookupQualifiedNameInUsingDirectives(), and clang::TemplateDeclInstantiator::VisitCXXMethodDecl().

◆ isSuppressingDiagnostics()

bool clang::LookupResult::isSuppressingDiagnostics ( ) const

inline

Determines whether this lookup is suppressing diagnostics.

Definition at line 588 of file Lookup.h.

◆ isTemplateNameLookup()

bool clang::LookupResult::isTemplateNameLookup ( ) const

inline

Definition at line 299 of file Lookup.h.

◆ isUnresolvableResult()

bool clang::LookupResult::isUnresolvableResult ( ) const

inline

Definition at line 317 of file Lookup.h.

References FoundUnresolvedValue, and getResultKind().

Referenced by clang::Sema::BuildMemberReferenceExpr(), and ClassifyImplicitMemberAccess().

◆ isVisible()

static bool clang::LookupResult::isVisible	(	Sema &	SemaRef,
		NamedDecl *	D
	)

inlinestatic

Determine whether the given declaration is visible to the program.

Definition at line 349 of file Lookup.h.

References clang::Decl::isHidden().

Referenced by checkCorrectionVisibility(), findAcceptableDecl(), clang::TypoCorrectionConsumer::FoundDecl(), getAcceptableDecl(), and clang::Sema::isModuleVisible().

◆ makeFilter()

Filter clang::LookupResult::makeFilter ( )

inline

Create a filter for this result set.

Definition at line 682 of file Lookup.h.

References clang::tooling::Filter.

Referenced by clang::Sema::ActOnOpenMPDeclareMapperDirectiveStart(), clang::Sema::ActOnOpenMPDeclareReductionDirectiveStart(), buildSingleCopyAssignRecursively(), clang::Sema::CheckDependentFunctionTemplateSpecialization(), clang::Sema::FilterAcceptableTemplateNames(), clang::Sema::LookupLiteralOperator(), and RemoveUsingDecls().

◆ operator=() [1/2]

LookupResult& clang::LookupResult::operator= ( const LookupResult & )

delete

Referenced by LookupResult().

◆ operator=() [2/2]

LookupResult& clang::LookupResult::operator= ( LookupResult && Other )

inline

Definition at line 203 of file Lookup.h.

◆ print()

void LookupResult::print ( raw_ostream & Out )

Definition at line 655 of file SemaLookup.cpp.

Referenced by setRedeclarationKind().

◆ redeclarationKind()

Sema::RedeclarationKind clang::LookupResult::redeclarationKind ( ) const

inline

Definition at line 268 of file Lookup.h.

References clang::Sema::ForExternalRedeclaration, clang::Sema::ForVisibleRedeclaration, and clang::Sema::NotForRedeclaration.

◆ resolveKind()

void LookupResult::resolveKind ( )

Resolves the result kind of the lookup, possibly hiding decls.

Resolves the result kind of this lookup.

This should be called in any environment where lookup might generate multiple lookup results.

Definition at line 472 of file SemaLookup.cpp.

References clang::Decl::getCanonicalDecl(), clang::NamedDecl::getUnderlyingDecl(), and clang::Decl::isInvalidDecl().

Referenced by clang::Sema::ActOnUsingDirective(), clang::Sema::CheckImplicitSpecialMemberDeclaration(), clang::Sema::LookupName(), LookupPotentialTypoResult(), LookupQualifiedNameInUsingDirectives(), resolveKindAfterFilter(), setShadowed(), and clang::TreeTransform< Derived >::TransformOverloadExprDecls().

◆ resolveKindAfterFilter()

void clang::LookupResult::resolveKindAfterFilter ( )

inline

Re-resolves the result kind of the lookup after a set of removals has been performed.

Definition at line 474 of file Lookup.h.

References Ambiguous, clang::UnresolvedSetImpl::empty(), Found, NotFound, NotFoundInCurrentInstantiation, and resolveKind().

Referenced by clang::LookupResult::Filter::done().

◆ setAllowHidden()

void clang::LookupResult::setAllowHidden ( bool AH )

inline

Specify whether hidden declarations are visible, e.g., for recovery reasons.

Definition at line 275 of file Lookup.h.

Referenced by LookupPotentialTypoResult(), and clang::Sema::LookupVisibleDecls().

◆ setAmbiguousBaseSubobjects()

void LookupResult::setAmbiguousBaseSubobjects ( CXXBasePaths & P )

Make these results show that the name was found in distinct base classes of the same type.

The given paths object is copied and invalidated.

Definition at line 639 of file SemaLookup.cpp.

References clang::CXXBasePaths::swap().

Referenced by isSingleTagDecl().

◆ setAmbiguousBaseSubobjectTypes()

void LookupResult::setAmbiguousBaseSubobjectTypes ( CXXBasePaths & P )

Make these results show that the name was found in base classes of different types.

The given paths object is copied and invalidated.

Definition at line 647 of file SemaLookup.cpp.

References clang::CXXBasePaths::swap().

Referenced by isSingleTagDecl().

◆ setAmbiguousQualifiedTagHiding()

void clang::LookupResult::setAmbiguousQualifiedTagHiding ( )

inline

Make these results show that the name was found in different contexts and a tag decl was hidden by an ordinary decl in a different context.

Definition at line 549 of file Lookup.h.

References AmbiguousTagHiding.

Referenced by LookupQualifiedNameInUsingDirectives().

◆ setBaseObjectType()

void clang::LookupResult::setBaseObjectType ( QualType T )

inline

Sets the base object type for this lookup.

Definition at line 420 of file Lookup.h.

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

◆ setContextRange()

void clang::LookupResult::setContextRange ( SourceRange SR )

inline

Sets a 'context' source range.

Definition at line 593 of file Lookup.h.

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

◆ setFindLocalExtern()

void clang::LookupResult::setFindLocalExtern ( bool FindLocalExtern )

inline

Definition at line 686 of file Lookup.h.

References Ambiguous, begin(), clang::Sema::CheckLookupAccess(), clang::Sema::DiagnoseAmbiguousLookup(), end(), getSema(), clang::Decl::IDNS_LocalExtern, isAmbiguous(), isClassLookup(), and NotFound.

Referenced by findOuterContext().

◆ setHideTags()

void clang::LookupResult::setHideTags ( bool Hide )

inline

Sets whether tag declarations should be hidden by non-tag declarations during resolution.

The default is true.

Definition at line 288 of file Lookup.h.

Referenced by clang::Sema::ActOnPragmaDump(), and clang::Sema::CheckUsingDeclQualifier().

◆ setLookupName()

void clang::LookupResult::setLookupName ( DeclarationName Name )

inline

Sets the name to look up.

Definition at line 248 of file Lookup.h.

References clang::DeclarationNameInfo::setName().

Referenced by LookupPotentialTypoResult(), and resolveAllocationOverload().

◆ setLookupNameInfo()

void clang::LookupResult::setLookupNameInfo ( const DeclarationNameInfo & NameInfo )

inline

Sets the name info to look up.

Definition at line 238 of file Lookup.h.

◆ setNamingClass()

void clang::LookupResult::setNamingClass ( CXXRecordDecl * Record )

inline

Sets the 'naming class' for this lookup.

Definition at line 408 of file Lookup.h.

◆ setNotFoundInCurrentInstantiation()

void clang::LookupResult::setNotFoundInCurrentInstantiation ( )

inline

Note that while no result was found in the current instantiation, there were dependent base classes that could not be searched.

Definition at line 452 of file Lookup.h.

References clang::UnresolvedSetImpl::empty(), NotFound, and NotFoundInCurrentInstantiation.

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

◆ setRedeclarationKind()

void clang::LookupResult::setRedeclarationKind ( Sema::RedeclarationKind RK )

inline

Change this lookup's redeclaration kind.

Definition at line 572 of file Lookup.h.

References dump(), clang::Sema::ForExternalRedeclaration, clang::Sema::NotForRedeclaration, and print().

◆ setShadowed()

void clang::LookupResult::setShadowed ( )

inline

Note that we found and ignored a declaration while performing lookup.

Definition at line 463 of file Lookup.h.

References resolveKind().

Referenced by clang::Sema::CheckVariableDeclaration(), and clang::Sema::LookupName().

◆ setTemplateNameLookup()

void clang::LookupResult::setTemplateNameLookup ( bool TemplateName )

inline

Sets whether this is a template-name lookup.

For template-name lookups, injected-class-names are treated as naming a template rather than a template specialization.

Definition at line 295 of file Lookup.h.

◆ suppressDiagnostics()

void clang::LookupResult::suppressDiagnostics ( )

inline

Suppress the diagnostics that would normally fire because of this lookup.

This happens during (e.g.) redeclaration lookups.

Definition at line 583 of file Lookup.h.

Referenced by clang::Sema::ActOnOpenMPDeclareTargetName(), clang::Sema::ActOnOpenMPIdExpression(), clang::Sema::ActOnPragmaDump(), clang::Sema::BuildDeclarationNameExpr(), buildDeclareReductionRef(), clang::Sema::BuildMemberReferenceExpr(), clang::Sema::BuildMemInitializer(), clang::Sema::BuildTemplateIdExpr(), buildUserDefinedMapperRef(), clang::Sema::CheckImplicitSpecialMemberDeclaration(), clang::Sema::CheckMicrosoftIfExistsSymbol(), clang::Sema::CheckUsingDeclQualifier(), clang::Sema::DiagnoseEmptyLookup(), DiagnoseTwoPhaseLookup(), doesUsualArrayDeleteWantSize(), emitReplacement(), clang::Sema::FindAllocationFunctions(), clang::Sema::FindDeallocationFunction(), getTupleLikeElementType(), HasNoThrowOperator(), and LookupPotentialTypoResult().

◆ wasNotFoundInCurrentInstantiation()

bool clang::LookupResult::wasNotFoundInCurrentInstantiation ( ) const

inline

Determine whether no result was found because we could not search into dependent base classes of the current instantiation.

Definition at line 446 of file Lookup.h.

References NotFoundInCurrentInstantiation.

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

include/clang/Sema/Lookup.h
lib/Sema/SemaLookup.cpp

Classes

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ iterator

Member Enumeration Documentation

◆ AmbiguityKind

◆ LookupResultKind

◆ TemporaryToken

Constructor & Destructor Documentation

◆ LookupResult() [1/5]

◆ LookupResult() [2/5]

◆ LookupResult() [3/5]

◆ LookupResult() [4/5]

◆ LookupResult() [5/5]

◆ ~LookupResult()

Member Function Documentation

◆ addAllDecls()

◆ addDecl() [1/2]

◆ addDecl() [2/2]

◆ asUnresolvedSet()

◆ begin()

◆ clear() [1/2]

◆ clear() [2/2]

◆ dump()

◆ empty()

◆ end()

◆ getAcceptableDecl()

◆ getAmbiguityKind()

◆ getAsSingle()

◆ getBaseObjectType()

◆ getBasePaths()

◆ getContextRange()

◆ getFoundDecl()

◆ getIdentifierNamespace()

◆ getLookupKind()

◆ getLookupName()

◆ getLookupNameInfo()

◆ getNameLoc()

◆ getNamingClass()

◆ getRepresentativeDecl()

◆ getResultKind()

◆ getSema()

◆ isAmbiguous()

◆ isClassLookup()

◆ isForExternalRedeclaration()

◆ isForRedeclaration()

◆ isHiddenDeclarationVisible()

◆ isOverloadedResult()

◆ isShadowed()

◆ isSingleResult()

◆ isSingleTagDecl()

◆ isSuppressingDiagnostics()

◆ isTemplateNameLookup()

◆ isUnresolvableResult()

◆ isVisible()

◆ makeFilter()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ print()

◆ redeclarationKind()

◆ resolveKind()

◆ resolveKindAfterFilter()

◆ setAllowHidden()

◆ setAmbiguousBaseSubobjects()

◆ setAmbiguousBaseSubobjectTypes()

◆ setAmbiguousQualifiedTagHiding()

◆ setBaseObjectType()

◆ setContextRange()

◆ setFindLocalExtern()

◆ setHideTags()

◆ setLookupName()

◆ setLookupNameInfo()

◆ setNamingClass()

◆ setNotFoundInCurrentInstantiation()

◆ setRedeclarationKind()

◆ setShadowed()

◆ setTemplateNameLookup()