blob: 89f8aec6e0185d32ea415ea6db09841478299c20 [file] [log] [blame]
Cedric Venet3d658642009-02-14 20:20:19 +00001//===--- SemaCXXScopeSpec.cpp - Semantic Analysis for C++ scope specifiers-===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This file implements C++ semantic analysis for scope specifiers.
11//
12//===----------------------------------------------------------------------===//
13
14#include "Sema.h"
John McCall7d384dd2009-11-18 07:57:50 +000015#include "Lookup.h"
Cedric Venet3d658642009-02-14 20:20:19 +000016#include "clang/AST/ASTContext.h"
Douglas Gregor42af25f2009-05-11 19:58:34 +000017#include "clang/AST/DeclTemplate.h"
Douglas Gregorfe85ced2009-08-06 03:17:00 +000018#include "clang/AST/ExprCXX.h"
Douglas Gregore4e5b052009-03-19 00:18:19 +000019#include "clang/AST/NestedNameSpecifier.h"
Anders Carlssonb7906612009-08-26 23:45:07 +000020#include "clang/Basic/PartialDiagnostic.h"
Cedric Venet3d658642009-02-14 20:20:19 +000021#include "clang/Parse/DeclSpec.h"
22#include "llvm/ADT/STLExtras.h"
Douglas Gregor7551c182009-07-22 00:28:09 +000023#include "llvm/Support/raw_ostream.h"
Cedric Venet3d658642009-02-14 20:20:19 +000024using namespace clang;
25
Douglas Gregor43d88632009-11-04 22:49:18 +000026/// \brief Find the current instantiation that associated with the given type.
27static CXXRecordDecl *
28getCurrentInstantiationOf(ASTContext &Context, DeclContext *CurContext,
29 QualType T) {
30 if (T.isNull())
31 return 0;
32
Douglas Gregor1cfb7da2010-01-15 16:05:33 +000033 T = Context.getCanonicalType(T).getUnqualifiedType();
Douglas Gregor43d88632009-11-04 22:49:18 +000034
Douglas Gregor1cfb7da2010-01-15 16:05:33 +000035 for (DeclContext *Ctx = CurContext; Ctx; Ctx = Ctx->getLookupParent()) {
Douglas Gregor43d88632009-11-04 22:49:18 +000036 // If we've hit a namespace or the global scope, then the
37 // nested-name-specifier can't refer to the current instantiation.
38 if (Ctx->isFileContext())
39 return 0;
40
41 // Skip non-class contexts.
42 CXXRecordDecl *Record = dyn_cast<CXXRecordDecl>(Ctx);
43 if (!Record)
44 continue;
45
46 // If this record type is not dependent,
47 if (!Record->isDependentType())
48 return 0;
49
50 // C++ [temp.dep.type]p1:
51 //
52 // In the definition of a class template, a nested class of a
53 // class template, a member of a class template, or a member of a
54 // nested class of a class template, a name refers to the current
55 // instantiation if it is
56 // -- the injected-class-name (9) of the class template or
57 // nested class,
58 // -- in the definition of a primary class template, the name
59 // of the class template followed by the template argument
60 // list of the primary template (as described below)
61 // enclosed in <>,
62 // -- in the definition of a nested class of a class template,
63 // the name of the nested class referenced as a member of
64 // the current instantiation, or
65 // -- in the definition of a partial specialization, the name
66 // of the class template followed by the template argument
67 // list of the partial specialization enclosed in <>. If
68 // the nth template parameter is a parameter pack, the nth
69 // template argument is a pack expansion (14.6.3) whose
70 // pattern is the name of the parameter pack.
71 // (FIXME: parameter packs)
72 //
73 // All of these options come down to having the
74 // nested-name-specifier type that is equivalent to the
75 // injected-class-name of one of the types that is currently in
76 // our context.
77 if (Context.getCanonicalType(Context.getTypeDeclType(Record)) == T)
78 return Record;
Douglas Gregor43d88632009-11-04 22:49:18 +000079 }
80
81 return 0;
82}
83
Douglas Gregor2dd078a2009-09-02 22:59:36 +000084/// \brief Compute the DeclContext that is associated with the given type.
85///
86/// \param T the type for which we are attempting to find a DeclContext.
87///
Mike Stump1eb44332009-09-09 15:08:12 +000088/// \returns the declaration context represented by the type T,
Douglas Gregor2dd078a2009-09-02 22:59:36 +000089/// or NULL if the declaration context cannot be computed (e.g., because it is
90/// dependent and not the current instantiation).
91DeclContext *Sema::computeDeclContext(QualType T) {
92 if (const TagType *Tag = T->getAs<TagType>())
93 return Tag->getDecl();
Mike Stump1eb44332009-09-09 15:08:12 +000094
Douglas Gregor43d88632009-11-04 22:49:18 +000095 return ::getCurrentInstantiationOf(Context, CurContext, T);
Douglas Gregor2dd078a2009-09-02 22:59:36 +000096}
97
Douglas Gregore4e5b052009-03-19 00:18:19 +000098/// \brief Compute the DeclContext that is associated with the given
99/// scope specifier.
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000100///
101/// \param SS the C++ scope specifier as it appears in the source
102///
103/// \param EnteringContext when true, we will be entering the context of
104/// this scope specifier, so we can retrieve the declaration context of a
105/// class template or class template partial specialization even if it is
106/// not the current instantiation.
107///
108/// \returns the declaration context represented by the scope specifier @p SS,
109/// or NULL if the declaration context cannot be computed (e.g., because it is
110/// dependent and not the current instantiation).
111DeclContext *Sema::computeDeclContext(const CXXScopeSpec &SS,
112 bool EnteringContext) {
Douglas Gregore4e5b052009-03-19 00:18:19 +0000113 if (!SS.isSet() || SS.isInvalid())
Douglas Gregorca5e77f2009-03-18 00:36:05 +0000114 return 0;
Douglas Gregorca5e77f2009-03-18 00:36:05 +0000115
Mike Stump1eb44332009-09-09 15:08:12 +0000116 NestedNameSpecifier *NNS
Douglas Gregor35073692009-03-26 23:56:24 +0000117 = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
Douglas Gregor42af25f2009-05-11 19:58:34 +0000118 if (NNS->isDependent()) {
119 // If this nested-name-specifier refers to the current
120 // instantiation, return its DeclContext.
121 if (CXXRecordDecl *Record = getCurrentInstantiationOf(NNS))
122 return Record;
Mike Stump1eb44332009-09-09 15:08:12 +0000123
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000124 if (EnteringContext) {
John McCall3cb0ebd2010-03-10 03:28:59 +0000125 const Type *NNSType = NNS->getAsType();
126 if (!NNSType) {
127 // do nothing, fall out
128 } else if (const TemplateSpecializationType *SpecType
129 = NNSType->getAs<TemplateSpecializationType>()) {
Douglas Gregor495c35d2009-08-25 22:51:20 +0000130 // We are entering the context of the nested name specifier, so try to
131 // match the nested name specifier to either a primary class template
132 // or a class template partial specialization.
Mike Stump1eb44332009-09-09 15:08:12 +0000133 if (ClassTemplateDecl *ClassTemplate
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000134 = dyn_cast_or_null<ClassTemplateDecl>(
135 SpecType->getTemplateName().getAsTemplateDecl())) {
Douglas Gregorb88e8882009-07-30 17:40:51 +0000136 QualType ContextType
137 = Context.getCanonicalType(QualType(SpecType, 0));
138
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000139 // If the type of the nested name specifier is the same as the
140 // injected class name of the named class template, we're entering
141 // into that class template definition.
John McCall3cb0ebd2010-03-10 03:28:59 +0000142 QualType Injected
143 = ClassTemplate->getInjectedClassNameSpecialization(Context);
Douglas Gregorb88e8882009-07-30 17:40:51 +0000144 if (Context.hasSameType(Injected, ContextType))
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000145 return ClassTemplate->getTemplatedDecl();
Mike Stump1eb44332009-09-09 15:08:12 +0000146
Douglas Gregorb88e8882009-07-30 17:40:51 +0000147 // If the type of the nested name specifier is the same as the
148 // type of one of the class template's class template partial
149 // specializations, we're entering into the definition of that
150 // class template partial specialization.
151 if (ClassTemplatePartialSpecializationDecl *PartialSpec
152 = ClassTemplate->findPartialSpecialization(ContextType))
153 return PartialSpec;
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000154 }
John McCall3cb0ebd2010-03-10 03:28:59 +0000155 } else if (const RecordType *RecordT = NNSType->getAs<RecordType>()) {
Douglas Gregor495c35d2009-08-25 22:51:20 +0000156 // The nested name specifier refers to a member of a class template.
157 return RecordT->getDecl();
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000158 }
159 }
Mike Stump1eb44332009-09-09 15:08:12 +0000160
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000161 return 0;
Douglas Gregor42af25f2009-05-11 19:58:34 +0000162 }
Douglas Gregorab452ba2009-03-26 23:50:42 +0000163
164 switch (NNS->getKind()) {
165 case NestedNameSpecifier::Identifier:
166 assert(false && "Dependent nested-name-specifier has no DeclContext");
167 break;
168
169 case NestedNameSpecifier::Namespace:
170 return NNS->getAsNamespace();
171
172 case NestedNameSpecifier::TypeSpec:
173 case NestedNameSpecifier::TypeSpecWithTemplate: {
Douglas Gregoredc90502010-02-25 04:46:04 +0000174 const TagType *Tag = NNS->getAsType()->getAs<TagType>();
175 assert(Tag && "Non-tag type in nested-name-specifier");
176 return Tag->getDecl();
177 } break;
Douglas Gregorab452ba2009-03-26 23:50:42 +0000178
179 case NestedNameSpecifier::Global:
180 return Context.getTranslationUnitDecl();
181 }
182
Douglas Gregoredc90502010-02-25 04:46:04 +0000183 // Required to silence a GCC warning.
Douglas Gregorab452ba2009-03-26 23:50:42 +0000184 return 0;
Douglas Gregorca5e77f2009-03-18 00:36:05 +0000185}
186
Douglas Gregor5953d8b2009-03-19 17:26:29 +0000187bool Sema::isDependentScopeSpecifier(const CXXScopeSpec &SS) {
188 if (!SS.isSet() || SS.isInvalid())
189 return false;
190
Mike Stump1eb44332009-09-09 15:08:12 +0000191 NestedNameSpecifier *NNS
Douglas Gregor35073692009-03-26 23:56:24 +0000192 = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
Douglas Gregorab452ba2009-03-26 23:50:42 +0000193 return NNS->isDependent();
Douglas Gregor5953d8b2009-03-19 17:26:29 +0000194}
195
Douglas Gregor42af25f2009-05-11 19:58:34 +0000196// \brief Determine whether this C++ scope specifier refers to an
197// unknown specialization, i.e., a dependent type that is not the
198// current instantiation.
199bool Sema::isUnknownSpecialization(const CXXScopeSpec &SS) {
200 if (!isDependentScopeSpecifier(SS))
201 return false;
202
Mike Stump1eb44332009-09-09 15:08:12 +0000203 NestedNameSpecifier *NNS
Douglas Gregor42af25f2009-05-11 19:58:34 +0000204 = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
205 return getCurrentInstantiationOf(NNS) == 0;
206}
207
208/// \brief If the given nested name specifier refers to the current
209/// instantiation, return the declaration that corresponds to that
210/// current instantiation (C++0x [temp.dep.type]p1).
211///
212/// \param NNS a dependent nested name specifier.
213CXXRecordDecl *Sema::getCurrentInstantiationOf(NestedNameSpecifier *NNS) {
214 assert(getLangOptions().CPlusPlus && "Only callable in C++");
215 assert(NNS->isDependent() && "Only dependent nested-name-specifier allowed");
216
Douglas Gregorf59a56e2009-07-21 23:53:31 +0000217 if (!NNS->getAsType())
218 return 0;
Mike Stump1eb44332009-09-09 15:08:12 +0000219
Douglas Gregor1560def2009-07-31 18:32:42 +0000220 QualType T = QualType(NNS->getAsType(), 0);
Douglas Gregor43d88632009-11-04 22:49:18 +0000221 return ::getCurrentInstantiationOf(Context, CurContext, T);
Douglas Gregor42af25f2009-05-11 19:58:34 +0000222}
223
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000224/// \brief Require that the context specified by SS be complete.
225///
226/// If SS refers to a type, this routine checks whether the type is
227/// complete enough (or can be made complete enough) for name lookup
228/// into the DeclContext. A type that is not yet completed can be
229/// considered "complete enough" if it is a class/struct/union/enum
230/// that is currently being defined. Or, if we have a type that names
231/// a class template specialization that is not a complete type, we
232/// will attempt to instantiate that class template.
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000233bool Sema::RequireCompleteDeclContext(CXXScopeSpec &SS) {
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000234 if (!SS.isSet() || SS.isInvalid())
235 return false;
Mike Stump1eb44332009-09-09 15:08:12 +0000236
Douglas Gregor7cdbc582009-07-22 23:48:44 +0000237 DeclContext *DC = computeDeclContext(SS, true);
Douglas Gregor48c89f42010-04-24 16:38:41 +0000238 if (!DC) {
239 // It's dependent.
240 assert(isDependentScopeSpecifier(SS) &&
241 "No context for non-dependent scope specifier?");
242 Diag(SS.getRange().getBegin(), diag::err_dependent_nested_name_spec)
243 << SS.getRange();
244 SS.setScopeRep(0);
245 return true;
246 }
247
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000248 if (TagDecl *Tag = dyn_cast<TagDecl>(DC)) {
Douglas Gregora4e8c2a2010-02-05 04:39:02 +0000249 // If this is a dependent type, then we consider it complete.
250 if (Tag->isDependentContext())
251 return false;
252
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000253 // If we're currently defining this type, then lookup into the
254 // type is okay: don't complain that it isn't complete yet.
Ted Kremenek6217b802009-07-29 21:53:49 +0000255 const TagType *TagT = Context.getTypeDeclType(Tag)->getAs<TagType>();
John McCall3cb0ebd2010-03-10 03:28:59 +0000256 if (TagT && TagT->isBeingDefined())
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000257 return false;
258
259 // The type must be complete.
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000260 if (RequireCompleteType(SS.getRange().getBegin(),
261 Context.getTypeDeclType(Tag),
262 PDiag(diag::err_incomplete_nested_name_spec)
263 << SS.getRange())) {
264 SS.setScopeRep(0); // Mark the ScopeSpec invalid.
265 return true;
266 }
Douglas Gregor4fdf1fa2009-03-11 16:48:53 +0000267 }
268
269 return false;
270}
Cedric Venet3d658642009-02-14 20:20:19 +0000271
272/// ActOnCXXGlobalScopeSpecifier - Return the object that represents the
273/// global scope ('::').
274Sema::CXXScopeTy *Sema::ActOnCXXGlobalScopeSpecifier(Scope *S,
275 SourceLocation CCLoc) {
Douglas Gregorab452ba2009-03-26 23:50:42 +0000276 return NestedNameSpecifier::GlobalSpecifier(Context);
Cedric Venet3d658642009-02-14 20:20:19 +0000277}
278
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000279/// \brief Determines whether the given declaration is an valid acceptable
280/// result for name lookup of a nested-name-specifier.
Douglas Gregoredc90502010-02-25 04:46:04 +0000281bool Sema::isAcceptableNestedNameSpecifier(NamedDecl *SD) {
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000282 if (!SD)
283 return false;
Mike Stump1eb44332009-09-09 15:08:12 +0000284
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000285 // Namespace and namespace aliases are fine.
286 if (isa<NamespaceDecl>(SD) || isa<NamespaceAliasDecl>(SD))
287 return true;
Mike Stump1eb44332009-09-09 15:08:12 +0000288
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000289 if (!isa<TypeDecl>(SD))
290 return false;
Mike Stump1eb44332009-09-09 15:08:12 +0000291
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000292 // Determine whether we have a class (or, in C++0x, an enum) or
293 // a typedef thereof. If so, build the nested-name-specifier.
294 QualType T = Context.getTypeDeclType(cast<TypeDecl>(SD));
295 if (T->isDependentType())
296 return true;
297 else if (TypedefDecl *TD = dyn_cast<TypedefDecl>(SD)) {
298 if (TD->getUnderlyingType()->isRecordType() ||
Mike Stump1eb44332009-09-09 15:08:12 +0000299 (Context.getLangOptions().CPlusPlus0x &&
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000300 TD->getUnderlyingType()->isEnumeralType()))
301 return true;
Mike Stump1eb44332009-09-09 15:08:12 +0000302 } else if (isa<RecordDecl>(SD) ||
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000303 (Context.getLangOptions().CPlusPlus0x && isa<EnumDecl>(SD)))
304 return true;
305
306 return false;
307}
308
Douglas Gregorc68afe22009-09-03 21:38:09 +0000309/// \brief If the given nested-name-specifier begins with a bare identifier
Mike Stump1eb44332009-09-09 15:08:12 +0000310/// (e.g., Base::), perform name lookup for that identifier as a
Douglas Gregorc68afe22009-09-03 21:38:09 +0000311/// nested-name-specifier within the given scope, and return the result of that
312/// name lookup.
313NamedDecl *Sema::FindFirstQualifierInScope(Scope *S, NestedNameSpecifier *NNS) {
314 if (!S || !NNS)
315 return 0;
Mike Stump1eb44332009-09-09 15:08:12 +0000316
Douglas Gregorc68afe22009-09-03 21:38:09 +0000317 while (NNS->getPrefix())
318 NNS = NNS->getPrefix();
Mike Stump1eb44332009-09-09 15:08:12 +0000319
Douglas Gregorc68afe22009-09-03 21:38:09 +0000320 if (NNS->getKind() != NestedNameSpecifier::Identifier)
321 return 0;
Mike Stump1eb44332009-09-09 15:08:12 +0000322
John McCalla24dc2e2009-11-17 02:14:36 +0000323 LookupResult Found(*this, NNS->getAsIdentifier(), SourceLocation(),
324 LookupNestedNameSpecifierName);
325 LookupName(Found, S);
Douglas Gregorc68afe22009-09-03 21:38:09 +0000326 assert(!Found.isAmbiguous() && "Cannot handle ambiguities here yet");
327
John McCall1bcee0a2009-12-02 08:25:40 +0000328 if (!Found.isSingleResult())
329 return 0;
330
331 NamedDecl *Result = Found.getFoundDecl();
Douglas Gregoredc90502010-02-25 04:46:04 +0000332 if (isAcceptableNestedNameSpecifier(Result))
Douglas Gregorc68afe22009-09-03 21:38:09 +0000333 return Result;
Mike Stump1eb44332009-09-09 15:08:12 +0000334
Douglas Gregorc68afe22009-09-03 21:38:09 +0000335 return 0;
336}
337
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000338bool Sema::isNonTypeNestedNameSpecifier(Scope *S, CXXScopeSpec &SS,
Douglas Gregor77549082010-02-24 21:29:12 +0000339 SourceLocation IdLoc,
340 IdentifierInfo &II,
341 TypeTy *ObjectTypePtr) {
342 QualType ObjectType = GetTypeFromParser(ObjectTypePtr);
343 LookupResult Found(*this, &II, IdLoc, LookupNestedNameSpecifierName);
344
345 // Determine where to perform name lookup
346 DeclContext *LookupCtx = 0;
347 bool isDependent = false;
348 if (!ObjectType.isNull()) {
349 // This nested-name-specifier occurs in a member access expression, e.g.,
350 // x->B::f, and we are looking into the type of the object.
351 assert(!SS.isSet() && "ObjectType and scope specifier cannot coexist");
352 LookupCtx = computeDeclContext(ObjectType);
353 isDependent = ObjectType->isDependentType();
354 } else if (SS.isSet()) {
355 // This nested-name-specifier occurs after another nested-name-specifier,
356 // so long into the context associated with the prior nested-name-specifier.
357 LookupCtx = computeDeclContext(SS, false);
358 isDependent = isDependentScopeSpecifier(SS);
359 Found.setContextRange(SS.getRange());
360 }
361
362 if (LookupCtx) {
363 // Perform "qualified" name lookup into the declaration context we
364 // computed, which is either the type of the base of a member access
365 // expression or the declaration context associated with a prior
366 // nested-name-specifier.
367
368 // The declaration context must be complete.
369 if (!LookupCtx->isDependentContext() && RequireCompleteDeclContext(SS))
370 return false;
371
372 LookupQualifiedName(Found, LookupCtx);
373 } else if (isDependent) {
374 return false;
375 } else {
376 LookupName(Found, S);
377 }
378 Found.suppressDiagnostics();
379
380 if (NamedDecl *ND = Found.getAsSingle<NamedDecl>())
381 return isa<NamespaceDecl>(ND) || isa<NamespaceAliasDecl>(ND);
382
383 return false;
384}
385
Douglas Gregorc68afe22009-09-03 21:38:09 +0000386/// \brief Build a new nested-name-specifier for "identifier::", as described
387/// by ActOnCXXNestedNameSpecifier.
388///
389/// This routine differs only slightly from ActOnCXXNestedNameSpecifier, in
390/// that it contains an extra parameter \p ScopeLookupResult, which provides
391/// the result of name lookup within the scope of the nested-name-specifier
Douglas Gregora6e51992009-12-30 16:01:52 +0000392/// that was computed at template definition time.
Chris Lattner46646492009-12-07 01:36:53 +0000393///
394/// If ErrorRecoveryLookup is true, then this call is used to improve error
395/// recovery. This means that it should not emit diagnostics, it should
396/// just return null on failure. It also means it should only return a valid
397/// scope if it *knows* that the result is correct. It should not return in a
398/// dependent context, for example.
Douglas Gregorc68afe22009-09-03 21:38:09 +0000399Sema::CXXScopeTy *Sema::BuildCXXNestedNameSpecifier(Scope *S,
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000400 CXXScopeSpec &SS,
Cedric Venet3d658642009-02-14 20:20:19 +0000401 SourceLocation IdLoc,
402 SourceLocation CCLoc,
Douglas Gregor495c35d2009-08-25 22:51:20 +0000403 IdentifierInfo &II,
Douglas Gregorc68afe22009-09-03 21:38:09 +0000404 QualType ObjectType,
405 NamedDecl *ScopeLookupResult,
Chris Lattner46646492009-12-07 01:36:53 +0000406 bool EnteringContext,
407 bool ErrorRecoveryLookup) {
Mike Stump1eb44332009-09-09 15:08:12 +0000408 NestedNameSpecifier *Prefix
Douglas Gregor35073692009-03-26 23:56:24 +0000409 = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
Mike Stump1eb44332009-09-09 15:08:12 +0000410
John McCalla24dc2e2009-11-17 02:14:36 +0000411 LookupResult Found(*this, &II, IdLoc, LookupNestedNameSpecifierName);
412
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000413 // Determine where to perform name lookup
414 DeclContext *LookupCtx = 0;
415 bool isDependent = false;
Douglas Gregorc68afe22009-09-03 21:38:09 +0000416 if (!ObjectType.isNull()) {
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000417 // This nested-name-specifier occurs in a member access expression, e.g.,
418 // x->B::f, and we are looking into the type of the object.
419 assert(!SS.isSet() && "ObjectType and scope specifier cannot coexist");
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000420 LookupCtx = computeDeclContext(ObjectType);
421 isDependent = ObjectType->isDependentType();
422 } else if (SS.isSet()) {
423 // This nested-name-specifier occurs after another nested-name-specifier,
424 // so long into the context associated with the prior nested-name-specifier.
425 LookupCtx = computeDeclContext(SS, EnteringContext);
426 isDependent = isDependentScopeSpecifier(SS);
John McCalla24dc2e2009-11-17 02:14:36 +0000427 Found.setContextRange(SS.getRange());
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000428 }
Mike Stump1eb44332009-09-09 15:08:12 +0000429
John McCalla24dc2e2009-11-17 02:14:36 +0000430
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000431 bool ObjectTypeSearchedInScope = false;
432 if (LookupCtx) {
Mike Stump1eb44332009-09-09 15:08:12 +0000433 // Perform "qualified" name lookup into the declaration context we
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000434 // computed, which is either the type of the base of a member access
Mike Stump1eb44332009-09-09 15:08:12 +0000435 // expression or the declaration context associated with a prior
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000436 // nested-name-specifier.
Mike Stump1eb44332009-09-09 15:08:12 +0000437
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000438 // The declaration context must be complete.
439 if (!LookupCtx->isDependentContext() && RequireCompleteDeclContext(SS))
440 return 0;
Mike Stump1eb44332009-09-09 15:08:12 +0000441
John McCalla24dc2e2009-11-17 02:14:36 +0000442 LookupQualifiedName(Found, LookupCtx);
Mike Stump1eb44332009-09-09 15:08:12 +0000443
John McCalla24dc2e2009-11-17 02:14:36 +0000444 if (!ObjectType.isNull() && Found.empty()) {
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000445 // C++ [basic.lookup.classref]p4:
446 // If the id-expression in a class member access is a qualified-id of
Mike Stump1eb44332009-09-09 15:08:12 +0000447 // the form
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000448 //
449 // class-name-or-namespace-name::...
450 //
Mike Stump1eb44332009-09-09 15:08:12 +0000451 // the class-name-or-namespace-name following the . or -> operator is
452 // looked up both in the context of the entire postfix-expression and in
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000453 // the scope of the class of the object expression. If the name is found
Mike Stump1eb44332009-09-09 15:08:12 +0000454 // only in the scope of the class of the object expression, the name
455 // shall refer to a class-name. If the name is found only in the
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000456 // context of the entire postfix-expression, the name shall refer to a
457 // class-name or namespace-name. [...]
458 //
459 // Qualified name lookup into a class will not find a namespace-name,
Mike Stump1eb44332009-09-09 15:08:12 +0000460 // so we do not need to diagnoste that case specifically. However,
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000461 // this qualified name lookup may find nothing. In that case, perform
Mike Stump1eb44332009-09-09 15:08:12 +0000462 // unqualified name lookup in the given scope (if available) or
Douglas Gregorc68afe22009-09-03 21:38:09 +0000463 // reconstruct the result from when name lookup was performed at template
464 // definition time.
465 if (S)
John McCalla24dc2e2009-11-17 02:14:36 +0000466 LookupName(Found, S);
John McCallf36e02d2009-10-09 21:13:30 +0000467 else if (ScopeLookupResult)
468 Found.addDecl(ScopeLookupResult);
Mike Stump1eb44332009-09-09 15:08:12 +0000469
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000470 ObjectTypeSearchedInScope = true;
471 }
472 } else if (isDependent) {
Chris Lattner46646492009-12-07 01:36:53 +0000473 // Don't speculate if we're just trying to improve error recovery.
474 if (ErrorRecoveryLookup)
475 return 0;
476
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000477 // We were not able to compute the declaration context for a dependent
Mike Stump1eb44332009-09-09 15:08:12 +0000478 // base object type or prior nested-name-specifier, so this
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000479 // nested-name-specifier refers to an unknown specialization. Just build
480 // a dependent nested-name-specifier.
Douglas Gregor2700dcd2009-09-02 23:58:38 +0000481 if (!Prefix)
482 return NestedNameSpecifier::Create(Context, &II);
Mike Stump1eb44332009-09-09 15:08:12 +0000483
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000484 return NestedNameSpecifier::Create(Context, Prefix, &II);
485 } else {
486 // Perform unqualified name lookup in the current scope.
John McCalla24dc2e2009-11-17 02:14:36 +0000487 LookupName(Found, S);
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000488 }
Mike Stump1eb44332009-09-09 15:08:12 +0000489
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000490 // FIXME: Deal with ambiguities cleanly.
Douglas Gregor175a6562009-12-31 08:26:35 +0000491
492 if (Found.empty() && !ErrorRecoveryLookup) {
493 // We haven't found anything, and we're not recovering from a
494 // different kind of error, so look for typos.
495 DeclarationName Name = Found.getLookupName();
Douglas Gregoraaf87162010-04-14 20:04:41 +0000496 if (CorrectTypo(Found, S, &SS, LookupCtx, EnteringContext,
497 CTC_NoKeywords) &&
Douglas Gregor175a6562009-12-31 08:26:35 +0000498 Found.isSingleResult() &&
Douglas Gregoredc90502010-02-25 04:46:04 +0000499 isAcceptableNestedNameSpecifier(Found.getAsSingle<NamedDecl>())) {
Douglas Gregor175a6562009-12-31 08:26:35 +0000500 if (LookupCtx)
501 Diag(Found.getNameLoc(), diag::err_no_member_suggest)
502 << Name << LookupCtx << Found.getLookupName() << SS.getRange()
Douglas Gregor849b2432010-03-31 17:46:05 +0000503 << FixItHint::CreateReplacement(Found.getNameLoc(),
504 Found.getLookupName().getAsString());
Douglas Gregor175a6562009-12-31 08:26:35 +0000505 else
506 Diag(Found.getNameLoc(), diag::err_undeclared_var_use_suggest)
507 << Name << Found.getLookupName()
Douglas Gregor849b2432010-03-31 17:46:05 +0000508 << FixItHint::CreateReplacement(Found.getNameLoc(),
509 Found.getLookupName().getAsString());
Douglas Gregor67dd1d42010-01-07 00:17:44 +0000510
511 if (NamedDecl *ND = Found.getAsSingle<NamedDecl>())
512 Diag(ND->getLocation(), diag::note_previous_decl)
513 << ND->getDeclName();
Douglas Gregor175a6562009-12-31 08:26:35 +0000514 } else
515 Found.clear();
516 }
517
John McCall1bcee0a2009-12-02 08:25:40 +0000518 NamedDecl *SD = Found.getAsSingle<NamedDecl>();
Douglas Gregoredc90502010-02-25 04:46:04 +0000519 if (isAcceptableNestedNameSpecifier(SD)) {
Douglas Gregorc68afe22009-09-03 21:38:09 +0000520 if (!ObjectType.isNull() && !ObjectTypeSearchedInScope) {
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000521 // C++ [basic.lookup.classref]p4:
Mike Stump1eb44332009-09-09 15:08:12 +0000522 // [...] If the name is found in both contexts, the
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000523 // class-name-or-namespace-name shall refer to the same entity.
524 //
525 // We already found the name in the scope of the object. Now, look
526 // into the current scope (the scope of the postfix-expression) to
Douglas Gregorc68afe22009-09-03 21:38:09 +0000527 // see if we can find the same name there. As above, if there is no
528 // scope, reconstruct the result from the template instantiation itself.
John McCallf36e02d2009-10-09 21:13:30 +0000529 NamedDecl *OuterDecl;
530 if (S) {
Douglas Gregoredc90502010-02-25 04:46:04 +0000531 LookupResult FoundOuter(*this, &II, IdLoc, LookupNestedNameSpecifierName);
John McCalla24dc2e2009-11-17 02:14:36 +0000532 LookupName(FoundOuter, S);
John McCall1bcee0a2009-12-02 08:25:40 +0000533 OuterDecl = FoundOuter.getAsSingle<NamedDecl>();
John McCallf36e02d2009-10-09 21:13:30 +0000534 } else
535 OuterDecl = ScopeLookupResult;
Mike Stump1eb44332009-09-09 15:08:12 +0000536
Douglas Gregoredc90502010-02-25 04:46:04 +0000537 if (isAcceptableNestedNameSpecifier(OuterDecl) &&
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000538 OuterDecl->getCanonicalDecl() != SD->getCanonicalDecl() &&
539 (!isa<TypeDecl>(OuterDecl) || !isa<TypeDecl>(SD) ||
540 !Context.hasSameType(
Douglas Gregorc68afe22009-09-03 21:38:09 +0000541 Context.getTypeDeclType(cast<TypeDecl>(OuterDecl)),
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000542 Context.getTypeDeclType(cast<TypeDecl>(SD))))) {
Chris Lattner46646492009-12-07 01:36:53 +0000543 if (ErrorRecoveryLookup)
544 return 0;
545
Douglas Gregorc68afe22009-09-03 21:38:09 +0000546 Diag(IdLoc, diag::err_nested_name_member_ref_lookup_ambiguous)
547 << &II;
548 Diag(SD->getLocation(), diag::note_ambig_member_ref_object_type)
549 << ObjectType;
550 Diag(OuterDecl->getLocation(), diag::note_ambig_member_ref_scope);
Mike Stump1eb44332009-09-09 15:08:12 +0000551
Chris Lattner46646492009-12-07 01:36:53 +0000552 // Fall through so that we'll pick the name we found in the object
553 // type, since that's probably what the user wanted anyway.
Douglas Gregorc68afe22009-09-03 21:38:09 +0000554 }
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000555 }
Mike Stump1eb44332009-09-09 15:08:12 +0000556
Douglas Gregorab452ba2009-03-26 23:50:42 +0000557 if (NamespaceDecl *Namespace = dyn_cast<NamespaceDecl>(SD))
558 return NestedNameSpecifier::Create(Context, Prefix, Namespace);
Mike Stump1eb44332009-09-09 15:08:12 +0000559
Douglas Gregordacd4342009-08-26 00:04:55 +0000560 // FIXME: It would be nice to maintain the namespace alias name, then
561 // see through that alias when resolving the nested-name-specifier down to
562 // a declaration context.
Anders Carlsson81c85c42009-03-28 23:53:49 +0000563 if (NamespaceAliasDecl *Alias = dyn_cast<NamespaceAliasDecl>(SD))
564 return NestedNameSpecifier::Create(Context, Prefix,
Mike Stump1eb44332009-09-09 15:08:12 +0000565
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000566 Alias->getNamespace());
Mike Stump1eb44332009-09-09 15:08:12 +0000567
Douglas Gregor2dd078a2009-09-02 22:59:36 +0000568 QualType T = Context.getTypeDeclType(cast<TypeDecl>(SD));
569 return NestedNameSpecifier::Create(Context, Prefix, false,
570 T.getTypePtr());
571 }
Mike Stump1eb44332009-09-09 15:08:12 +0000572
Chris Lattner46646492009-12-07 01:36:53 +0000573 // Otherwise, we have an error case. If we don't want diagnostics, just
574 // return an error now.
575 if (ErrorRecoveryLookup)
576 return 0;
577
Cedric Venet3d658642009-02-14 20:20:19 +0000578 // If we didn't find anything during our lookup, try again with
579 // ordinary name lookup, which can help us produce better error
580 // messages.
John McCall1bcee0a2009-12-02 08:25:40 +0000581 if (Found.empty()) {
John McCalla24dc2e2009-11-17 02:14:36 +0000582 Found.clear(LookupOrdinaryName);
583 LookupName(Found, S);
John McCallf36e02d2009-10-09 21:13:30 +0000584 }
Mike Stump1eb44332009-09-09 15:08:12 +0000585
Cedric Venet3d658642009-02-14 20:20:19 +0000586 unsigned DiagID;
John McCall1bcee0a2009-12-02 08:25:40 +0000587 if (!Found.empty())
Cedric Venet3d658642009-02-14 20:20:19 +0000588 DiagID = diag::err_expected_class_or_namespace;
Anders Carlssona31d5f72009-08-30 07:09:50 +0000589 else if (SS.isSet()) {
Douglas Gregor3f093272009-10-13 21:16:44 +0000590 Diag(IdLoc, diag::err_no_member) << &II << LookupCtx << SS.getRange();
Anders Carlssona31d5f72009-08-30 07:09:50 +0000591 return 0;
592 } else
Cedric Venet3d658642009-02-14 20:20:19 +0000593 DiagID = diag::err_undeclared_var_use;
Mike Stump1eb44332009-09-09 15:08:12 +0000594
Cedric Venet3d658642009-02-14 20:20:19 +0000595 if (SS.isSet())
596 Diag(IdLoc, DiagID) << &II << SS.getRange();
597 else
598 Diag(IdLoc, DiagID) << &II;
Mike Stump1eb44332009-09-09 15:08:12 +0000599
Cedric Venet3d658642009-02-14 20:20:19 +0000600 return 0;
601}
602
Douglas Gregorc68afe22009-09-03 21:38:09 +0000603/// ActOnCXXNestedNameSpecifier - Called during parsing of a
604/// nested-name-specifier. e.g. for "foo::bar::" we parsed "foo::" and now
605/// we want to resolve "bar::". 'SS' is empty or the previously parsed
606/// nested-name part ("foo::"), 'IdLoc' is the source location of 'bar',
607/// 'CCLoc' is the location of '::' and 'II' is the identifier for 'bar'.
608/// Returns a CXXScopeTy* object representing the C++ scope.
609Sema::CXXScopeTy *Sema::ActOnCXXNestedNameSpecifier(Scope *S,
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000610 CXXScopeSpec &SS,
Douglas Gregorc68afe22009-09-03 21:38:09 +0000611 SourceLocation IdLoc,
612 SourceLocation CCLoc,
613 IdentifierInfo &II,
614 TypeTy *ObjectTypePtr,
615 bool EnteringContext) {
Mike Stump1eb44332009-09-09 15:08:12 +0000616 return BuildCXXNestedNameSpecifier(S, SS, IdLoc, CCLoc, II,
Douglas Gregorc68afe22009-09-03 21:38:09 +0000617 QualType::getFromOpaquePtr(ObjectTypePtr),
Chris Lattner46646492009-12-07 01:36:53 +0000618 /*ScopeLookupResult=*/0, EnteringContext,
619 false);
620}
621
622/// IsInvalidUnlessNestedName - This method is used for error recovery
623/// purposes to determine whether the specified identifier is only valid as
624/// a nested name specifier, for example a namespace name. It is
625/// conservatively correct to always return false from this method.
626///
627/// The arguments are the same as those passed to ActOnCXXNestedNameSpecifier.
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000628bool Sema::IsInvalidUnlessNestedName(Scope *S, CXXScopeSpec &SS,
Douglas Gregoredc90502010-02-25 04:46:04 +0000629 IdentifierInfo &II, TypeTy *ObjectType,
Chris Lattner46646492009-12-07 01:36:53 +0000630 bool EnteringContext) {
631 return BuildCXXNestedNameSpecifier(S, SS, SourceLocation(), SourceLocation(),
Douglas Gregoredc90502010-02-25 04:46:04 +0000632 II, QualType::getFromOpaquePtr(ObjectType),
Chris Lattner46646492009-12-07 01:36:53 +0000633 /*ScopeLookupResult=*/0, EnteringContext,
634 true);
Douglas Gregorc68afe22009-09-03 21:38:09 +0000635}
636
Douglas Gregor39a8de12009-02-25 19:37:18 +0000637Sema::CXXScopeTy *Sema::ActOnCXXNestedNameSpecifier(Scope *S,
638 const CXXScopeSpec &SS,
639 TypeTy *Ty,
640 SourceRange TypeRange,
Douglas Gregoredc90502010-02-25 04:46:04 +0000641 SourceLocation CCLoc) {
Mike Stump1eb44332009-09-09 15:08:12 +0000642 NestedNameSpecifier *Prefix
Douglas Gregor35073692009-03-26 23:56:24 +0000643 = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
Argyrios Kyrtzidise8661902009-08-19 01:28:28 +0000644 QualType T = GetTypeFromParser(Ty);
Douglas Gregorab452ba2009-03-26 23:50:42 +0000645 return NestedNameSpecifier::Create(Context, Prefix, /*FIXME:*/false,
Douglas Gregor3f5b61c2009-05-14 00:28:11 +0000646 T.getTypePtr());
Douglas Gregor39a8de12009-02-25 19:37:18 +0000647}
648
John McCalle7e278b2009-12-11 20:04:54 +0000649bool Sema::ShouldEnterDeclaratorScope(Scope *S, const CXXScopeSpec &SS) {
650 assert(SS.isSet() && "Parser passed invalid CXXScopeSpec.");
651
652 NestedNameSpecifier *Qualifier =
653 static_cast<NestedNameSpecifier*>(SS.getScopeRep());
654
655 // There are only two places a well-formed program may qualify a
656 // declarator: first, when defining a namespace or class member
657 // out-of-line, and second, when naming an explicitly-qualified
658 // friend function. The latter case is governed by
659 // C++03 [basic.lookup.unqual]p10:
660 // In a friend declaration naming a member function, a name used
661 // in the function declarator and not part of a template-argument
662 // in a template-id is first looked up in the scope of the member
663 // function's class. If it is not found, or if the name is part of
664 // a template-argument in a template-id, the look up is as
665 // described for unqualified names in the definition of the class
666 // granting friendship.
667 // i.e. we don't push a scope unless it's a class member.
668
669 switch (Qualifier->getKind()) {
670 case NestedNameSpecifier::Global:
671 case NestedNameSpecifier::Namespace:
672 // These are always namespace scopes. We never want to enter a
673 // namespace scope from anything but a file context.
674 return CurContext->getLookupContext()->isFileContext();
675
676 case NestedNameSpecifier::Identifier:
677 case NestedNameSpecifier::TypeSpec:
678 case NestedNameSpecifier::TypeSpecWithTemplate:
679 // These are never namespace scopes.
680 return true;
681 }
682
683 // Silence bogus warning.
684 return false;
685}
686
Cedric Venet3d658642009-02-14 20:20:19 +0000687/// ActOnCXXEnterDeclaratorScope - Called when a C++ scope specifier (global
688/// scope or nested-name-specifier) is parsed, part of a declarator-id.
689/// After this method is called, according to [C++ 3.4.3p3], names should be
690/// looked up in the declarator-id's scope, until the declarator is parsed and
691/// ActOnCXXExitDeclaratorScope is called.
692/// The 'SS' should be a non-empty valid CXXScopeSpec.
Jeffrey Yasskin9ab14542010-04-08 16:38:48 +0000693bool Sema::ActOnCXXEnterDeclaratorScope(Scope *S, CXXScopeSpec &SS) {
Cedric Venet3d658642009-02-14 20:20:19 +0000694 assert(SS.isSet() && "Parser passed invalid CXXScopeSpec.");
John McCall7a1dc562009-12-19 10:49:29 +0000695
696 if (SS.isInvalid()) return true;
697
698 DeclContext *DC = computeDeclContext(SS, true);
699 if (!DC) return true;
700
701 // Before we enter a declarator's context, we need to make sure that
702 // it is a complete declaration context.
703 if (!DC->isDependentContext() && RequireCompleteDeclContext(SS))
704 return true;
705
706 EnterDeclaratorContext(S, DC);
Douglas Gregor7dfd0fb2009-09-24 23:39:01 +0000707 return false;
Cedric Venet3d658642009-02-14 20:20:19 +0000708}
709
710/// ActOnCXXExitDeclaratorScope - Called when a declarator that previously
711/// invoked ActOnCXXEnterDeclaratorScope(), is finished. 'SS' is the same
712/// CXXScopeSpec that was passed to ActOnCXXEnterDeclaratorScope as well.
713/// Used to indicate that names should revert to being looked up in the
714/// defining scope.
715void Sema::ActOnCXXExitDeclaratorScope(Scope *S, const CXXScopeSpec &SS) {
716 assert(SS.isSet() && "Parser passed invalid CXXScopeSpec.");
Douglas Gregordacd4342009-08-26 00:04:55 +0000717 if (SS.isInvalid())
718 return;
John McCall7a1dc562009-12-19 10:49:29 +0000719 assert(!SS.isInvalid() && computeDeclContext(SS, true) &&
720 "exiting declarator scope we never really entered");
721 ExitDeclaratorContext(S);
Cedric Venet3d658642009-02-14 20:20:19 +0000722}