SemaTemplate.cpp revision f3e7ce4bd9837cdab6a096235922865f95467d3d
1//===------- SemaTemplate.cpp - Semantic Analysis for C++ Templates -------===/
2
3//
4//                     The LLVM Compiler Infrastructure
5//
6// This file is distributed under the University of Illinois Open Source
7// License. See LICENSE.TXT for details.
8//===----------------------------------------------------------------------===/
9
10//
11//  This file implements semantic analysis for C++ templates.
12//===----------------------------------------------------------------------===/
13
14#include "Sema.h"
15#include "clang/AST/ASTContext.h"
16#include "clang/AST/Expr.h"
17#include "clang/AST/ExprCXX.h"
18#include "clang/AST/DeclTemplate.h"
19#include "clang/Parse/DeclSpec.h"
20#include "clang/Basic/LangOptions.h"
21
22using namespace clang;
23
24/// isTemplateName - Determines whether the identifier II is a
25/// template name in the current scope, and returns the template
26/// declaration if II names a template. An optional CXXScope can be
27/// passed to indicate the C++ scope in which the identifier will be
28/// found.
29TemplateNameKind Sema::isTemplateName(const IdentifierInfo &II, Scope *S,
30                                      TemplateTy &TemplateResult,
31                                      const CXXScopeSpec *SS) {
32  NamedDecl *IIDecl = LookupParsedName(S, SS, &II, LookupOrdinaryName);
33
34  TemplateNameKind TNK = TNK_Non_template;
35  TemplateDecl *Template = 0;
36
37  if (IIDecl) {
38    if ((Template = dyn_cast<TemplateDecl>(IIDecl))) {
39      if (isa<FunctionTemplateDecl>(IIDecl))
40        TNK = TNK_Function_template;
41      else if (isa<ClassTemplateDecl>(IIDecl) ||
42               isa<TemplateTemplateParmDecl>(IIDecl))
43        TNK = TNK_Type_template;
44      else
45        assert(false && "Unknown template declaration kind");
46    } else if (CXXRecordDecl *Record = dyn_cast<CXXRecordDecl>(IIDecl)) {
47      // C++ [temp.local]p1:
48      //   Like normal (non-template) classes, class templates have an
49      //   injected-class-name (Clause 9). The injected-class-name
50      //   can be used with or without a template-argument-list. When
51      //   it is used without a template-argument-list, it is
52      //   equivalent to the injected-class-name followed by the
53      //   template-parameters of the class template enclosed in
54      //   <>. When it is used with a template-argument-list, it
55      //   refers to the specified class template specialization,
56      //   which could be the current specialization or another
57      //   specialization.
58      if (Record->isInjectedClassName()) {
59        Record = cast<CXXRecordDecl>(Context.getCanonicalDecl(Record));
60        if ((Template = Record->getDescribedClassTemplate()))
61          TNK = TNK_Type_template;
62        else if (ClassTemplateSpecializationDecl *Spec
63                   = dyn_cast<ClassTemplateSpecializationDecl>(Record)) {
64          Template = Spec->getSpecializedTemplate();
65          TNK = TNK_Type_template;
66        }
67      }
68    }
69
70    // FIXME: What follows is a gross hack.
71    if (FunctionDecl *FD = dyn_cast<FunctionDecl>(IIDecl)) {
72      if (FD->getType()->isDependentType()) {
73        TemplateResult = TemplateTy::make(FD);
74        return TNK_Function_template;
75      }
76    } else if (OverloadedFunctionDecl *Ovl
77                 = dyn_cast<OverloadedFunctionDecl>(IIDecl)) {
78      for (OverloadedFunctionDecl::function_iterator F = Ovl->function_begin(),
79                                                  FEnd = Ovl->function_end();
80           F != FEnd; ++F) {
81        if ((*F)->getType()->isDependentType()) {
82          TemplateResult = TemplateTy::make(Ovl);
83          return TNK_Function_template;
84        }
85      }
86    }
87
88    if (TNK != TNK_Non_template) {
89      if (SS && SS->isSet() && !SS->isInvalid()) {
90        NestedNameSpecifier *Qualifier
91          = static_cast<NestedNameSpecifier *>(SS->getScopeRep());
92        TemplateResult
93          = TemplateTy::make(Context.getQualifiedTemplateName(Qualifier,
94                                                              false,
95                                                              Template));
96      } else
97        TemplateResult = TemplateTy::make(TemplateName(Template));
98    }
99  }
100  return TNK;
101}
102
103/// DiagnoseTemplateParameterShadow - Produce a diagnostic complaining
104/// that the template parameter 'PrevDecl' is being shadowed by a new
105/// declaration at location Loc. Returns true to indicate that this is
106/// an error, and false otherwise.
107bool Sema::DiagnoseTemplateParameterShadow(SourceLocation Loc, Decl *PrevDecl) {
108  assert(PrevDecl->isTemplateParameter() && "Not a template parameter");
109
110  // Microsoft Visual C++ permits template parameters to be shadowed.
111  if (getLangOptions().Microsoft)
112    return false;
113
114  // C++ [temp.local]p4:
115  //   A template-parameter shall not be redeclared within its
116  //   scope (including nested scopes).
117  Diag(Loc, diag::err_template_param_shadow)
118    << cast<NamedDecl>(PrevDecl)->getDeclName();
119  Diag(PrevDecl->getLocation(), diag::note_template_param_here);
120  return true;
121}
122
123/// AdjustDeclIfTemplate - If the given decl happens to be a template, reset
124/// the parameter D to reference the templated declaration and return a pointer
125/// to the template declaration. Otherwise, do nothing to D and return null.
126TemplateDecl *Sema::AdjustDeclIfTemplate(DeclPtrTy &D) {
127  if (TemplateDecl *Temp = dyn_cast<TemplateDecl>(D.getAs<Decl>())) {
128    D = DeclPtrTy::make(Temp->getTemplatedDecl());
129    return Temp;
130  }
131  return 0;
132}
133
134/// ActOnTypeParameter - Called when a C++ template type parameter
135/// (e.g., "typename T") has been parsed. Typename specifies whether
136/// the keyword "typename" was used to declare the type parameter
137/// (otherwise, "class" was used), and KeyLoc is the location of the
138/// "class" or "typename" keyword. ParamName is the name of the
139/// parameter (NULL indicates an unnamed template parameter) and
140/// ParamName is the location of the parameter name (if any).
141/// If the type parameter has a default argument, it will be added
142/// later via ActOnTypeParameterDefault.
143Sema::DeclPtrTy Sema::ActOnTypeParameter(Scope *S, bool Typename,
144                                         SourceLocation KeyLoc,
145                                         IdentifierInfo *ParamName,
146                                         SourceLocation ParamNameLoc,
147                                         unsigned Depth, unsigned Position) {
148  assert(S->isTemplateParamScope() &&
149	 "Template type parameter not in template parameter scope!");
150  bool Invalid = false;
151
152  if (ParamName) {
153    NamedDecl *PrevDecl = LookupName(S, ParamName, LookupTagName);
154    if (PrevDecl && PrevDecl->isTemplateParameter())
155      Invalid = Invalid || DiagnoseTemplateParameterShadow(ParamNameLoc,
156							   PrevDecl);
157  }
158
159  SourceLocation Loc = ParamNameLoc;
160  if (!ParamName)
161    Loc = KeyLoc;
162
163  TemplateTypeParmDecl *Param
164    = TemplateTypeParmDecl::Create(Context, CurContext, Loc,
165                                   Depth, Position, ParamName, Typename);
166  if (Invalid)
167    Param->setInvalidDecl();
168
169  if (ParamName) {
170    // Add the template parameter into the current scope.
171    S->AddDecl(DeclPtrTy::make(Param));
172    IdResolver.AddDecl(Param);
173  }
174
175  return DeclPtrTy::make(Param);
176}
177
178/// ActOnTypeParameterDefault - Adds a default argument (the type
179/// Default) to the given template type parameter (TypeParam).
180void Sema::ActOnTypeParameterDefault(DeclPtrTy TypeParam,
181                                     SourceLocation EqualLoc,
182                                     SourceLocation DefaultLoc,
183                                     TypeTy *DefaultT) {
184  TemplateTypeParmDecl *Parm
185    = cast<TemplateTypeParmDecl>(TypeParam.getAs<Decl>());
186  QualType Default = QualType::getFromOpaquePtr(DefaultT);
187
188  // C++ [temp.param]p14:
189  //   A template-parameter shall not be used in its own default argument.
190  // FIXME: Implement this check! Needs a recursive walk over the types.
191
192  // Check the template argument itself.
193  if (CheckTemplateArgument(Parm, Default, DefaultLoc)) {
194    Parm->setInvalidDecl();
195    return;
196  }
197
198  Parm->setDefaultArgument(Default, DefaultLoc, false);
199}
200
201/// \brief Check that the type of a non-type template parameter is
202/// well-formed.
203///
204/// \returns the (possibly-promoted) parameter type if valid;
205/// otherwise, produces a diagnostic and returns a NULL type.
206QualType
207Sema::CheckNonTypeTemplateParameterType(QualType T, SourceLocation Loc) {
208  // C++ [temp.param]p4:
209  //
210  // A non-type template-parameter shall have one of the following
211  // (optionally cv-qualified) types:
212  //
213  //       -- integral or enumeration type,
214  if (T->isIntegralType() || T->isEnumeralType() ||
215      //   -- pointer to object or pointer to function,
216      (T->isPointerType() &&
217       (T->getAsPointerType()->getPointeeType()->isObjectType() ||
218        T->getAsPointerType()->getPointeeType()->isFunctionType())) ||
219      //   -- reference to object or reference to function,
220      T->isReferenceType() ||
221      //   -- pointer to member.
222      T->isMemberPointerType() ||
223      // If T is a dependent type, we can't do the check now, so we
224      // assume that it is well-formed.
225      T->isDependentType())
226    return T;
227  // C++ [temp.param]p8:
228  //
229  //   A non-type template-parameter of type "array of T" or
230  //   "function returning T" is adjusted to be of type "pointer to
231  //   T" or "pointer to function returning T", respectively.
232  else if (T->isArrayType())
233    // FIXME: Keep the type prior to promotion?
234    return Context.getArrayDecayedType(T);
235  else if (T->isFunctionType())
236    // FIXME: Keep the type prior to promotion?
237    return Context.getPointerType(T);
238
239  Diag(Loc, diag::err_template_nontype_parm_bad_type)
240    << T;
241
242  return QualType();
243}
244
245/// ActOnNonTypeTemplateParameter - Called when a C++ non-type
246/// template parameter (e.g., "int Size" in "template<int Size>
247/// class Array") has been parsed. S is the current scope and D is
248/// the parsed declarator.
249Sema::DeclPtrTy Sema::ActOnNonTypeTemplateParameter(Scope *S, Declarator &D,
250                                                    unsigned Depth,
251                                                    unsigned Position) {
252  QualType T = GetTypeForDeclarator(D, S);
253
254  assert(S->isTemplateParamScope() &&
255         "Non-type template parameter not in template parameter scope!");
256  bool Invalid = false;
257
258  IdentifierInfo *ParamName = D.getIdentifier();
259  if (ParamName) {
260    NamedDecl *PrevDecl = LookupName(S, ParamName, LookupTagName);
261    if (PrevDecl && PrevDecl->isTemplateParameter())
262      Invalid = Invalid || DiagnoseTemplateParameterShadow(D.getIdentifierLoc(),
263                                                           PrevDecl);
264  }
265
266  T = CheckNonTypeTemplateParameterType(T, D.getIdentifierLoc());
267  if (T.isNull()) {
268    T = Context.IntTy; // Recover with an 'int' type.
269    Invalid = true;
270  }
271
272  NonTypeTemplateParmDecl *Param
273    = NonTypeTemplateParmDecl::Create(Context, CurContext, D.getIdentifierLoc(),
274                                      Depth, Position, ParamName, T);
275  if (Invalid)
276    Param->setInvalidDecl();
277
278  if (D.getIdentifier()) {
279    // Add the template parameter into the current scope.
280    S->AddDecl(DeclPtrTy::make(Param));
281    IdResolver.AddDecl(Param);
282  }
283  return DeclPtrTy::make(Param);
284}
285
286/// \brief Adds a default argument to the given non-type template
287/// parameter.
288void Sema::ActOnNonTypeTemplateParameterDefault(DeclPtrTy TemplateParamD,
289                                                SourceLocation EqualLoc,
290                                                ExprArg DefaultE) {
291  NonTypeTemplateParmDecl *TemplateParm
292    = cast<NonTypeTemplateParmDecl>(TemplateParamD.getAs<Decl>());
293  Expr *Default = static_cast<Expr *>(DefaultE.get());
294
295  // C++ [temp.param]p14:
296  //   A template-parameter shall not be used in its own default argument.
297  // FIXME: Implement this check! Needs a recursive walk over the types.
298
299  // Check the well-formedness of the default template argument.
300  if (CheckTemplateArgument(TemplateParm, TemplateParm->getType(), Default)) {
301    TemplateParm->setInvalidDecl();
302    return;
303  }
304
305  TemplateParm->setDefaultArgument(DefaultE.takeAs<Expr>());
306}
307
308
309/// ActOnTemplateTemplateParameter - Called when a C++ template template
310/// parameter (e.g. T in template <template <typename> class T> class array)
311/// has been parsed. S is the current scope.
312Sema::DeclPtrTy Sema::ActOnTemplateTemplateParameter(Scope* S,
313                                                     SourceLocation TmpLoc,
314                                                     TemplateParamsTy *Params,
315                                                     IdentifierInfo *Name,
316                                                     SourceLocation NameLoc,
317                                                     unsigned Depth,
318                                                     unsigned Position)
319{
320  assert(S->isTemplateParamScope() &&
321         "Template template parameter not in template parameter scope!");
322
323  // Construct the parameter object.
324  TemplateTemplateParmDecl *Param =
325    TemplateTemplateParmDecl::Create(Context, CurContext, TmpLoc, Depth,
326                                     Position, Name,
327                                     (TemplateParameterList*)Params);
328
329  // Make sure the parameter is valid.
330  // FIXME: Decl object is not currently invalidated anywhere so this doesn't
331  // do anything yet. However, if the template parameter list or (eventual)
332  // default value is ever invalidated, that will propagate here.
333  bool Invalid = false;
334  if (Invalid) {
335    Param->setInvalidDecl();
336  }
337
338  // If the tt-param has a name, then link the identifier into the scope
339  // and lookup mechanisms.
340  if (Name) {
341    S->AddDecl(DeclPtrTy::make(Param));
342    IdResolver.AddDecl(Param);
343  }
344
345  return DeclPtrTy::make(Param);
346}
347
348/// \brief Adds a default argument to the given template template
349/// parameter.
350void Sema::ActOnTemplateTemplateParameterDefault(DeclPtrTy TemplateParamD,
351                                                 SourceLocation EqualLoc,
352                                                 ExprArg DefaultE) {
353  TemplateTemplateParmDecl *TemplateParm
354    = cast<TemplateTemplateParmDecl>(TemplateParamD.getAs<Decl>());
355
356  // Since a template-template parameter's default argument is an
357  // id-expression, it must be a DeclRefExpr.
358  DeclRefExpr *Default
359    = cast<DeclRefExpr>(static_cast<Expr *>(DefaultE.get()));
360
361  // C++ [temp.param]p14:
362  //   A template-parameter shall not be used in its own default argument.
363  // FIXME: Implement this check! Needs a recursive walk over the types.
364
365  // Check the well-formedness of the template argument.
366  if (!isa<TemplateDecl>(Default->getDecl())) {
367    Diag(Default->getSourceRange().getBegin(),
368         diag::err_template_arg_must_be_template)
369      << Default->getSourceRange();
370    TemplateParm->setInvalidDecl();
371    return;
372  }
373  if (CheckTemplateArgument(TemplateParm, Default)) {
374    TemplateParm->setInvalidDecl();
375    return;
376  }
377
378  DefaultE.release();
379  TemplateParm->setDefaultArgument(Default);
380}
381
382/// ActOnTemplateParameterList - Builds a TemplateParameterList that
383/// contains the template parameters in Params/NumParams.
384Sema::TemplateParamsTy *
385Sema::ActOnTemplateParameterList(unsigned Depth,
386                                 SourceLocation ExportLoc,
387                                 SourceLocation TemplateLoc,
388                                 SourceLocation LAngleLoc,
389                                 DeclPtrTy *Params, unsigned NumParams,
390                                 SourceLocation RAngleLoc) {
391  if (ExportLoc.isValid())
392    Diag(ExportLoc, diag::note_template_export_unsupported);
393
394  return TemplateParameterList::Create(Context, TemplateLoc, LAngleLoc,
395                                       (Decl**)Params, NumParams, RAngleLoc);
396}
397
398Sema::DeclResult
399Sema::ActOnClassTemplate(Scope *S, unsigned TagSpec, TagKind TK,
400                         SourceLocation KWLoc, const CXXScopeSpec &SS,
401                         IdentifierInfo *Name, SourceLocation NameLoc,
402                         AttributeList *Attr,
403                         MultiTemplateParamsArg TemplateParameterLists,
404                         AccessSpecifier AS) {
405  assert(TemplateParameterLists.size() > 0 && "No template parameter lists?");
406  assert(TK != TK_Reference && "Can only declare or define class templates");
407  bool Invalid = false;
408
409  // Check that we can declare a template here.
410  if (CheckTemplateDeclScope(S, TemplateParameterLists))
411    return true;
412
413  TagDecl::TagKind Kind;
414  switch (TagSpec) {
415  default: assert(0 && "Unknown tag type!");
416  case DeclSpec::TST_struct: Kind = TagDecl::TK_struct; break;
417  case DeclSpec::TST_union:  Kind = TagDecl::TK_union; break;
418  case DeclSpec::TST_class:  Kind = TagDecl::TK_class; break;
419  }
420
421  // There is no such thing as an unnamed class template.
422  if (!Name) {
423    Diag(KWLoc, diag::err_template_unnamed_class);
424    return true;
425  }
426
427  // Find any previous declaration with this name.
428  LookupResult Previous = LookupParsedName(S, &SS, Name, LookupOrdinaryName,
429                                           true);
430  assert(!Previous.isAmbiguous() && "Ambiguity in class template redecl?");
431  NamedDecl *PrevDecl = 0;
432  if (Previous.begin() != Previous.end())
433    PrevDecl = *Previous.begin();
434
435  DeclContext *SemanticContext = CurContext;
436  if (SS.isNotEmpty() && !SS.isInvalid()) {
437    SemanticContext = computeDeclContext(SS);
438
439    // FIXME: need to match up several levels of template parameter lists here.
440  }
441
442  // FIXME: member templates!
443  TemplateParameterList *TemplateParams
444    = static_cast<TemplateParameterList *>(*TemplateParameterLists.release());
445
446  // If there is a previous declaration with the same name, check
447  // whether this is a valid redeclaration.
448  ClassTemplateDecl *PrevClassTemplate
449    = dyn_cast_or_null<ClassTemplateDecl>(PrevDecl);
450  if (PrevClassTemplate) {
451    // Ensure that the template parameter lists are compatible.
452    if (!TemplateParameterListsAreEqual(TemplateParams,
453                                   PrevClassTemplate->getTemplateParameters(),
454                                        /*Complain=*/true))
455      return true;
456
457    // C++ [temp.class]p4:
458    //   In a redeclaration, partial specialization, explicit
459    //   specialization or explicit instantiation of a class template,
460    //   the class-key shall agree in kind with the original class
461    //   template declaration (7.1.5.3).
462    RecordDecl *PrevRecordDecl = PrevClassTemplate->getTemplatedDecl();
463    if (!isAcceptableTagRedeclaration(PrevRecordDecl, Kind, KWLoc, *Name)) {
464      Diag(KWLoc, diag::err_use_with_wrong_tag)
465        << Name
466        << CodeModificationHint::CreateReplacement(KWLoc,
467                            PrevRecordDecl->getKindName());
468      Diag(PrevRecordDecl->getLocation(), diag::note_previous_use);
469      Kind = PrevRecordDecl->getTagKind();
470    }
471
472    // Check for redefinition of this class template.
473    if (TK == TK_Definition) {
474      if (TagDecl *Def = PrevRecordDecl->getDefinition(Context)) {
475        Diag(NameLoc, diag::err_redefinition) << Name;
476        Diag(Def->getLocation(), diag::note_previous_definition);
477        // FIXME: Would it make sense to try to "forget" the previous
478        // definition, as part of error recovery?
479        return true;
480      }
481    }
482  } else if (PrevDecl && PrevDecl->isTemplateParameter()) {
483    // Maybe we will complain about the shadowed template parameter.
484    DiagnoseTemplateParameterShadow(NameLoc, PrevDecl);
485    // Just pretend that we didn't see the previous declaration.
486    PrevDecl = 0;
487  } else if (PrevDecl) {
488    // C++ [temp]p5:
489    //   A class template shall not have the same name as any other
490    //   template, class, function, object, enumeration, enumerator,
491    //   namespace, or type in the same scope (3.3), except as specified
492    //   in (14.5.4).
493    Diag(NameLoc, diag::err_redefinition_different_kind) << Name;
494    Diag(PrevDecl->getLocation(), diag::note_previous_definition);
495    return true;
496  }
497
498  // Check the template parameter list of this declaration, possibly
499  // merging in the template parameter list from the previous class
500  // template declaration.
501  if (CheckTemplateParameterList(TemplateParams,
502            PrevClassTemplate? PrevClassTemplate->getTemplateParameters() : 0))
503    Invalid = true;
504
505  // FIXME: If we had a scope specifier, we better have a previous template
506  // declaration!
507
508  CXXRecordDecl *NewClass =
509    CXXRecordDecl::Create(Context, Kind, SemanticContext, NameLoc, Name,
510                          PrevClassTemplate?
511                            PrevClassTemplate->getTemplatedDecl() : 0,
512                          /*DelayTypeCreation=*/true);
513
514  ClassTemplateDecl *NewTemplate
515    = ClassTemplateDecl::Create(Context, SemanticContext, NameLoc,
516                                DeclarationName(Name), TemplateParams,
517                                NewClass, PrevClassTemplate);
518  NewClass->setDescribedClassTemplate(NewTemplate);
519
520  // Build the type for the class template declaration now.
521  QualType T =
522    Context.getTypeDeclType(NewClass,
523                            PrevClassTemplate?
524                              PrevClassTemplate->getTemplatedDecl() : 0);
525  assert(T->isDependentType() && "Class template type is not dependent?");
526  (void)T;
527
528  // Set the access specifier.
529  SetMemberAccessSpecifier(NewTemplate, PrevClassTemplate, AS);
530
531  // Set the lexical context of these templates
532  NewClass->setLexicalDeclContext(CurContext);
533  NewTemplate->setLexicalDeclContext(CurContext);
534
535  if (TK == TK_Definition)
536    NewClass->startDefinition();
537
538  if (Attr)
539    ProcessDeclAttributeList(NewClass, Attr);
540
541  PushOnScopeChains(NewTemplate, S);
542
543  if (Invalid) {
544    NewTemplate->setInvalidDecl();
545    NewClass->setInvalidDecl();
546  }
547  return DeclPtrTy::make(NewTemplate);
548}
549
550/// \brief Checks the validity of a template parameter list, possibly
551/// considering the template parameter list from a previous
552/// declaration.
553///
554/// If an "old" template parameter list is provided, it must be
555/// equivalent (per TemplateParameterListsAreEqual) to the "new"
556/// template parameter list.
557///
558/// \param NewParams Template parameter list for a new template
559/// declaration. This template parameter list will be updated with any
560/// default arguments that are carried through from the previous
561/// template parameter list.
562///
563/// \param OldParams If provided, template parameter list from a
564/// previous declaration of the same template. Default template
565/// arguments will be merged from the old template parameter list to
566/// the new template parameter list.
567///
568/// \returns true if an error occurred, false otherwise.
569bool Sema::CheckTemplateParameterList(TemplateParameterList *NewParams,
570                                      TemplateParameterList *OldParams) {
571  bool Invalid = false;
572
573  // C++ [temp.param]p10:
574  //   The set of default template-arguments available for use with a
575  //   template declaration or definition is obtained by merging the
576  //   default arguments from the definition (if in scope) and all
577  //   declarations in scope in the same way default function
578  //   arguments are (8.3.6).
579  bool SawDefaultArgument = false;
580  SourceLocation PreviousDefaultArgLoc;
581
582  // Dummy initialization to avoid warnings.
583  TemplateParameterList::iterator OldParam = NewParams->end();
584  if (OldParams)
585    OldParam = OldParams->begin();
586
587  for (TemplateParameterList::iterator NewParam = NewParams->begin(),
588                                    NewParamEnd = NewParams->end();
589       NewParam != NewParamEnd; ++NewParam) {
590    // Variables used to diagnose redundant default arguments
591    bool RedundantDefaultArg = false;
592    SourceLocation OldDefaultLoc;
593    SourceLocation NewDefaultLoc;
594
595    // Variables used to diagnose missing default arguments
596    bool MissingDefaultArg = false;
597
598    // Merge default arguments for template type parameters.
599    if (TemplateTypeParmDecl *NewTypeParm
600          = dyn_cast<TemplateTypeParmDecl>(*NewParam)) {
601      TemplateTypeParmDecl *OldTypeParm
602          = OldParams? cast<TemplateTypeParmDecl>(*OldParam) : 0;
603
604      if (OldTypeParm && OldTypeParm->hasDefaultArgument() &&
605          NewTypeParm->hasDefaultArgument()) {
606        OldDefaultLoc = OldTypeParm->getDefaultArgumentLoc();
607        NewDefaultLoc = NewTypeParm->getDefaultArgumentLoc();
608        SawDefaultArgument = true;
609        RedundantDefaultArg = true;
610        PreviousDefaultArgLoc = NewDefaultLoc;
611      } else if (OldTypeParm && OldTypeParm->hasDefaultArgument()) {
612        // Merge the default argument from the old declaration to the
613        // new declaration.
614        SawDefaultArgument = true;
615        NewTypeParm->setDefaultArgument(OldTypeParm->getDefaultArgument(),
616                                        OldTypeParm->getDefaultArgumentLoc(),
617                                        true);
618        PreviousDefaultArgLoc = OldTypeParm->getDefaultArgumentLoc();
619      } else if (NewTypeParm->hasDefaultArgument()) {
620        SawDefaultArgument = true;
621        PreviousDefaultArgLoc = NewTypeParm->getDefaultArgumentLoc();
622      } else if (SawDefaultArgument)
623        MissingDefaultArg = true;
624    }
625    // Merge default arguments for non-type template parameters
626    else if (NonTypeTemplateParmDecl *NewNonTypeParm
627               = dyn_cast<NonTypeTemplateParmDecl>(*NewParam)) {
628      NonTypeTemplateParmDecl *OldNonTypeParm
629        = OldParams? cast<NonTypeTemplateParmDecl>(*OldParam) : 0;
630      if (OldNonTypeParm && OldNonTypeParm->hasDefaultArgument() &&
631          NewNonTypeParm->hasDefaultArgument()) {
632        OldDefaultLoc = OldNonTypeParm->getDefaultArgumentLoc();
633        NewDefaultLoc = NewNonTypeParm->getDefaultArgumentLoc();
634        SawDefaultArgument = true;
635        RedundantDefaultArg = true;
636        PreviousDefaultArgLoc = NewDefaultLoc;
637      } else if (OldNonTypeParm && OldNonTypeParm->hasDefaultArgument()) {
638        // Merge the default argument from the old declaration to the
639        // new declaration.
640        SawDefaultArgument = true;
641        // FIXME: We need to create a new kind of "default argument"
642        // expression that points to a previous template template
643        // parameter.
644        NewNonTypeParm->setDefaultArgument(
645                                        OldNonTypeParm->getDefaultArgument());
646        PreviousDefaultArgLoc = OldNonTypeParm->getDefaultArgumentLoc();
647      } else if (NewNonTypeParm->hasDefaultArgument()) {
648        SawDefaultArgument = true;
649        PreviousDefaultArgLoc = NewNonTypeParm->getDefaultArgumentLoc();
650      } else if (SawDefaultArgument)
651        MissingDefaultArg = true;
652    }
653    // Merge default arguments for template template parameters
654    else {
655      TemplateTemplateParmDecl *NewTemplateParm
656        = cast<TemplateTemplateParmDecl>(*NewParam);
657      TemplateTemplateParmDecl *OldTemplateParm
658        = OldParams? cast<TemplateTemplateParmDecl>(*OldParam) : 0;
659      if (OldTemplateParm && OldTemplateParm->hasDefaultArgument() &&
660          NewTemplateParm->hasDefaultArgument()) {
661        OldDefaultLoc = OldTemplateParm->getDefaultArgumentLoc();
662        NewDefaultLoc = NewTemplateParm->getDefaultArgumentLoc();
663        SawDefaultArgument = true;
664        RedundantDefaultArg = true;
665        PreviousDefaultArgLoc = NewDefaultLoc;
666      } else if (OldTemplateParm && OldTemplateParm->hasDefaultArgument()) {
667        // Merge the default argument from the old declaration to the
668        // new declaration.
669        SawDefaultArgument = true;
670        // FIXME: We need to create a new kind of "default argument" expression
671        // that points to a previous template template parameter.
672        NewTemplateParm->setDefaultArgument(
673                                        OldTemplateParm->getDefaultArgument());
674        PreviousDefaultArgLoc = OldTemplateParm->getDefaultArgumentLoc();
675      } else if (NewTemplateParm->hasDefaultArgument()) {
676        SawDefaultArgument = true;
677        PreviousDefaultArgLoc = NewTemplateParm->getDefaultArgumentLoc();
678      } else if (SawDefaultArgument)
679        MissingDefaultArg = true;
680    }
681
682    if (RedundantDefaultArg) {
683      // C++ [temp.param]p12:
684      //   A template-parameter shall not be given default arguments
685      //   by two different declarations in the same scope.
686      Diag(NewDefaultLoc, diag::err_template_param_default_arg_redefinition);
687      Diag(OldDefaultLoc, diag::note_template_param_prev_default_arg);
688      Invalid = true;
689    } else if (MissingDefaultArg) {
690      // C++ [temp.param]p11:
691      //   If a template-parameter has a default template-argument,
692      //   all subsequent template-parameters shall have a default
693      //   template-argument supplied.
694      Diag((*NewParam)->getLocation(),
695           diag::err_template_param_default_arg_missing);
696      Diag(PreviousDefaultArgLoc, diag::note_template_param_prev_default_arg);
697      Invalid = true;
698    }
699
700    // If we have an old template parameter list that we're merging
701    // in, move on to the next parameter.
702    if (OldParams)
703      ++OldParam;
704  }
705
706  return Invalid;
707}
708
709/// \brief Translates template arguments as provided by the parser
710/// into template arguments used by semantic analysis.
711static void
712translateTemplateArguments(ASTTemplateArgsPtr &TemplateArgsIn,
713                           SourceLocation *TemplateArgLocs,
714                     llvm::SmallVector<TemplateArgument, 16> &TemplateArgs) {
715  TemplateArgs.reserve(TemplateArgsIn.size());
716
717  void **Args = TemplateArgsIn.getArgs();
718  bool *ArgIsType = TemplateArgsIn.getArgIsType();
719  for (unsigned Arg = 0, Last = TemplateArgsIn.size(); Arg != Last; ++Arg) {
720    TemplateArgs.push_back(
721      ArgIsType[Arg]? TemplateArgument(TemplateArgLocs[Arg],
722                                       QualType::getFromOpaquePtr(Args[Arg]))
723                    : TemplateArgument(reinterpret_cast<Expr *>(Args[Arg])));
724  }
725}
726
727/// \brief Build a canonical version of a template argument list.
728///
729/// This function builds a canonical version of the given template
730/// argument list, where each of the template arguments has been
731/// converted into its canonical form. This routine is typically used
732/// to canonicalize a template argument list when the template name
733/// itself is dependent. When the template name refers to an actual
734/// template declaration, Sema::CheckTemplateArgumentList should be
735/// used to check and canonicalize the template arguments.
736///
737/// \param TemplateArgs The incoming template arguments.
738///
739/// \param NumTemplateArgs The number of template arguments in \p
740/// TemplateArgs.
741///
742/// \param Canonical A vector to be filled with the canonical versions
743/// of the template arguments.
744///
745/// \param Context The ASTContext in which the template arguments live.
746static void CanonicalizeTemplateArguments(const TemplateArgument *TemplateArgs,
747                                          unsigned NumTemplateArgs,
748                            llvm::SmallVectorImpl<TemplateArgument> &Canonical,
749                                          ASTContext &Context) {
750  Canonical.reserve(NumTemplateArgs);
751  for (unsigned Idx = 0; Idx < NumTemplateArgs; ++Idx) {
752    switch (TemplateArgs[Idx].getKind()) {
753    case TemplateArgument::Expression:
754      // FIXME: Build canonical expression (!)
755      Canonical.push_back(TemplateArgs[Idx]);
756      break;
757
758    case TemplateArgument::Declaration:
759      Canonical.push_back(
760                 TemplateArgument(SourceLocation(),
761                    Context.getCanonicalDecl(TemplateArgs[Idx].getAsDecl())));
762      break;
763
764    case TemplateArgument::Integral:
765      Canonical.push_back(TemplateArgument(SourceLocation(),
766                                           *TemplateArgs[Idx].getAsIntegral(),
767                                        TemplateArgs[Idx].getIntegralType()));
768
769    case TemplateArgument::Type: {
770      QualType CanonType
771        = Context.getCanonicalType(TemplateArgs[Idx].getAsType());
772      Canonical.push_back(TemplateArgument(SourceLocation(), CanonType));
773    }
774    }
775  }
776}
777
778QualType Sema::CheckTemplateIdType(TemplateName Name,
779                                   SourceLocation TemplateLoc,
780                                   SourceLocation LAngleLoc,
781                                   const TemplateArgument *TemplateArgs,
782                                   unsigned NumTemplateArgs,
783                                   SourceLocation RAngleLoc) {
784  TemplateDecl *Template = Name.getAsTemplateDecl();
785  if (!Template) {
786    // The template name does not resolve to a template, so we just
787    // build a dependent template-id type.
788
789    // Canonicalize the template arguments to build the canonical
790    // template-id type.
791    llvm::SmallVector<TemplateArgument, 16> CanonicalTemplateArgs;
792    CanonicalizeTemplateArguments(TemplateArgs, NumTemplateArgs,
793                                  CanonicalTemplateArgs, Context);
794
795    TemplateName CanonName = Context.getCanonicalTemplateName(Name);
796    QualType CanonType
797      = Context.getTemplateSpecializationType(CanonName,
798                                              &CanonicalTemplateArgs[0],
799                                              CanonicalTemplateArgs.size());
800
801    // Build the dependent template-id type.
802    return Context.getTemplateSpecializationType(Name, TemplateArgs,
803                                                 NumTemplateArgs, CanonType);
804  }
805
806  // Check that the template argument list is well-formed for this
807  // template.
808  llvm::SmallVector<TemplateArgument, 16> ConvertedTemplateArgs;
809  if (CheckTemplateArgumentList(Template, TemplateLoc, LAngleLoc,
810                                TemplateArgs, NumTemplateArgs, RAngleLoc,
811                                ConvertedTemplateArgs))
812    return QualType();
813
814  assert((ConvertedTemplateArgs.size() ==
815            Template->getTemplateParameters()->size()) &&
816         "Converted template argument list is too short!");
817
818  QualType CanonType;
819
820  if (TemplateSpecializationType::anyDependentTemplateArguments(
821                                                      TemplateArgs,
822                                                      NumTemplateArgs)) {
823    // This class template specialization is a dependent
824    // type. Therefore, its canonical type is another class template
825    // specialization type that contains all of the converted
826    // arguments in canonical form. This ensures that, e.g., A<T> and
827    // A<T, T> have identical types when A is declared as:
828    //
829    //   template<typename T, typename U = T> struct A;
830    TemplateName CanonName = Context.getCanonicalTemplateName(Name);
831    CanonType = Context.getTemplateSpecializationType(CanonName,
832                                                    &ConvertedTemplateArgs[0],
833                                                ConvertedTemplateArgs.size());
834  } else if (ClassTemplateDecl *ClassTemplate
835               = dyn_cast<ClassTemplateDecl>(Template)) {
836    // Find the class template specialization declaration that
837    // corresponds to these arguments.
838    llvm::FoldingSetNodeID ID;
839    ClassTemplateSpecializationDecl::Profile(ID, &ConvertedTemplateArgs[0],
840                                             ConvertedTemplateArgs.size());
841    void *InsertPos = 0;
842    ClassTemplateSpecializationDecl *Decl
843      = ClassTemplate->getSpecializations().FindNodeOrInsertPos(ID, InsertPos);
844    if (!Decl) {
845      // This is the first time we have referenced this class template
846      // specialization. Create the canonical declaration and add it to
847      // the set of specializations.
848      Decl = ClassTemplateSpecializationDecl::Create(Context,
849                                           ClassTemplate->getDeclContext(),
850                                                     TemplateLoc,
851                                                     ClassTemplate,
852                                                     &ConvertedTemplateArgs[0],
853                                                  ConvertedTemplateArgs.size(),
854                                                     0);
855      ClassTemplate->getSpecializations().InsertNode(Decl, InsertPos);
856      Decl->setLexicalDeclContext(CurContext);
857    }
858
859    CanonType = Context.getTypeDeclType(Decl);
860  }
861
862  // Build the fully-sugared type for this class template
863  // specialization, which refers back to the class template
864  // specialization we created or found.
865  return Context.getTemplateSpecializationType(Name, TemplateArgs,
866                                               NumTemplateArgs, CanonType);
867}
868
869Action::TypeResult
870Sema::ActOnTemplateIdType(TemplateTy TemplateD, SourceLocation TemplateLoc,
871                          SourceLocation LAngleLoc,
872                          ASTTemplateArgsPtr TemplateArgsIn,
873                          SourceLocation *TemplateArgLocs,
874                          SourceLocation RAngleLoc) {
875  TemplateName Template = TemplateD.getAsVal<TemplateName>();
876
877  // Translate the parser's template argument list in our AST format.
878  llvm::SmallVector<TemplateArgument, 16> TemplateArgs;
879  translateTemplateArguments(TemplateArgsIn, TemplateArgLocs, TemplateArgs);
880
881  QualType Result = CheckTemplateIdType(Template, TemplateLoc, LAngleLoc,
882                                        &TemplateArgs[0], TemplateArgs.size(),
883                                        RAngleLoc);
884  TemplateArgsIn.release();
885
886  if (Result.isNull())
887    return true;
888
889  return Result.getAsOpaquePtr();
890}
891
892/// \brief Form a dependent template name.
893///
894/// This action forms a dependent template name given the template
895/// name and its (presumably dependent) scope specifier. For
896/// example, given "MetaFun::template apply", the scope specifier \p
897/// SS will be "MetaFun::", \p TemplateKWLoc contains the location
898/// of the "template" keyword, and "apply" is the \p Name.
899Sema::TemplateTy
900Sema::ActOnDependentTemplateName(SourceLocation TemplateKWLoc,
901                                 const IdentifierInfo &Name,
902                                 SourceLocation NameLoc,
903                                 const CXXScopeSpec &SS) {
904  if (!SS.isSet() || SS.isInvalid())
905    return TemplateTy();
906
907  NestedNameSpecifier *Qualifier
908    = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
909
910  // FIXME: member of the current instantiation
911
912  if (!Qualifier->isDependent()) {
913    // C++0x [temp.names]p5:
914    //   If a name prefixed by the keyword template is not the name of
915    //   a template, the program is ill-formed. [Note: the keyword
916    //   template may not be applied to non-template members of class
917    //   templates. -end note ] [ Note: as is the case with the
918    //   typename prefix, the template prefix is allowed in cases
919    //   where it is not strictly necessary; i.e., when the
920    //   nested-name-specifier or the expression on the left of the ->
921    //   or . is not dependent on a template-parameter, or the use
922    //   does not appear in the scope of a template. -end note]
923    //
924    // Note: C++03 was more strict here, because it banned the use of
925    // the "template" keyword prior to a template-name that was not a
926    // dependent name. C++ DR468 relaxed this requirement (the
927    // "template" keyword is now permitted). We follow the C++0x
928    // rules, even in C++03 mode, retroactively applying the DR.
929    TemplateTy Template;
930    TemplateNameKind TNK = isTemplateName(Name, 0, Template, &SS);
931    if (TNK == TNK_Non_template) {
932      Diag(NameLoc, diag::err_template_kw_refers_to_non_template)
933        << &Name;
934      return TemplateTy();
935    }
936
937    return Template;
938  }
939
940  return TemplateTy::make(Context.getDependentTemplateName(Qualifier, &Name));
941}
942
943/// \brief Check that the given template argument list is well-formed
944/// for specializing the given template.
945bool Sema::CheckTemplateArgumentList(TemplateDecl *Template,
946                                     SourceLocation TemplateLoc,
947                                     SourceLocation LAngleLoc,
948                                     const TemplateArgument *TemplateArgs,
949                                     unsigned NumTemplateArgs,
950                                     SourceLocation RAngleLoc,
951                          llvm::SmallVectorImpl<TemplateArgument> &Converted) {
952  TemplateParameterList *Params = Template->getTemplateParameters();
953  unsigned NumParams = Params->size();
954  unsigned NumArgs = NumTemplateArgs;
955  bool Invalid = false;
956
957  if (NumArgs > NumParams ||
958      NumArgs < Params->getMinRequiredArguments()) {
959    // FIXME: point at either the first arg beyond what we can handle,
960    // or the '>', depending on whether we have too many or too few
961    // arguments.
962    SourceRange Range;
963    if (NumArgs > NumParams)
964      Range = SourceRange(TemplateArgs[NumParams].getLocation(), RAngleLoc);
965    Diag(TemplateLoc, diag::err_template_arg_list_different_arity)
966      << (NumArgs > NumParams)
967      << (isa<ClassTemplateDecl>(Template)? 0 :
968          isa<FunctionTemplateDecl>(Template)? 1 :
969          isa<TemplateTemplateParmDecl>(Template)? 2 : 3)
970      << Template << Range;
971    Diag(Template->getLocation(), diag::note_template_decl_here)
972      << Params->getSourceRange();
973    Invalid = true;
974  }
975
976  // C++ [temp.arg]p1:
977  //   [...] The type and form of each template-argument specified in
978  //   a template-id shall match the type and form specified for the
979  //   corresponding parameter declared by the template in its
980  //   template-parameter-list.
981  unsigned ArgIdx = 0;
982  for (TemplateParameterList::iterator Param = Params->begin(),
983                                       ParamEnd = Params->end();
984       Param != ParamEnd; ++Param, ++ArgIdx) {
985    // Decode the template argument
986    TemplateArgument Arg;
987    if (ArgIdx >= NumArgs) {
988      // Retrieve the default template argument from the template
989      // parameter.
990      if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(*Param)) {
991        if (!TTP->hasDefaultArgument())
992          break;
993
994        QualType ArgType = TTP->getDefaultArgument();
995
996        // If the argument type is dependent, instantiate it now based
997        // on the previously-computed template arguments.
998        if (ArgType->isDependentType()) {
999          InstantiatingTemplate Inst(*this, TemplateLoc,
1000                                     Template, &Converted[0],
1001                                     Converted.size(),
1002                                     SourceRange(TemplateLoc, RAngleLoc));
1003
1004          TemplateArgumentList TemplateArgs(Context, &Converted[0],
1005                                            Converted.size(),
1006                                            /*CopyArgs=*/false);
1007          ArgType = InstantiateType(ArgType, TemplateArgs,
1008                                    TTP->getDefaultArgumentLoc(),
1009                                    TTP->getDeclName());
1010        }
1011
1012        if (ArgType.isNull())
1013          return true;
1014
1015        Arg = TemplateArgument(TTP->getLocation(), ArgType);
1016      } else if (NonTypeTemplateParmDecl *NTTP
1017                   = dyn_cast<NonTypeTemplateParmDecl>(*Param)) {
1018        if (!NTTP->hasDefaultArgument())
1019          break;
1020
1021        // FIXME: Instantiate default argument
1022        Arg = TemplateArgument(NTTP->getDefaultArgument());
1023      } else {
1024        TemplateTemplateParmDecl *TempParm
1025          = cast<TemplateTemplateParmDecl>(*Param);
1026
1027        if (!TempParm->hasDefaultArgument())
1028          break;
1029
1030        // FIXME: Instantiate default argument
1031        Arg = TemplateArgument(TempParm->getDefaultArgument());
1032      }
1033    } else {
1034      // Retrieve the template argument produced by the user.
1035      Arg = TemplateArgs[ArgIdx];
1036    }
1037
1038
1039    if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(*Param)) {
1040      // Check template type parameters.
1041      if (Arg.getKind() == TemplateArgument::Type) {
1042        if (CheckTemplateArgument(TTP, Arg.getAsType(), Arg.getLocation()))
1043          Invalid = true;
1044
1045        // Add the converted template type argument.
1046        Converted.push_back(
1047                 TemplateArgument(Arg.getLocation(),
1048                                  Context.getCanonicalType(Arg.getAsType())));
1049        continue;
1050      }
1051
1052      // C++ [temp.arg.type]p1:
1053      //   A template-argument for a template-parameter which is a
1054      //   type shall be a type-id.
1055
1056      // We have a template type parameter but the template argument
1057      // is not a type.
1058      Diag(Arg.getLocation(), diag::err_template_arg_must_be_type);
1059      Diag((*Param)->getLocation(), diag::note_template_param_here);
1060      Invalid = true;
1061    } else if (NonTypeTemplateParmDecl *NTTP
1062                 = dyn_cast<NonTypeTemplateParmDecl>(*Param)) {
1063      // Check non-type template parameters.
1064
1065      // Instantiate the type of the non-type template parameter with
1066      // the template arguments we've seen thus far.
1067      QualType NTTPType = NTTP->getType();
1068      if (NTTPType->isDependentType()) {
1069        // Instantiate the type of the non-type template parameter.
1070        InstantiatingTemplate Inst(*this, TemplateLoc,
1071                                   Template, &Converted[0],
1072                                   Converted.size(),
1073                                   SourceRange(TemplateLoc, RAngleLoc));
1074
1075        TemplateArgumentList TemplateArgs(Context, &Converted[0],
1076                                          Converted.size(),
1077                                          /*CopyArgs=*/false);
1078        NTTPType = InstantiateType(NTTPType, TemplateArgs,
1079                                   NTTP->getLocation(),
1080                                   NTTP->getDeclName());
1081        // If that worked, check the non-type template parameter type
1082        // for validity.
1083        if (!NTTPType.isNull())
1084          NTTPType = CheckNonTypeTemplateParameterType(NTTPType,
1085                                                       NTTP->getLocation());
1086
1087        if (NTTPType.isNull()) {
1088          Invalid = true;
1089          break;
1090        }
1091      }
1092
1093      switch (Arg.getKind()) {
1094      case TemplateArgument::Expression: {
1095        Expr *E = Arg.getAsExpr();
1096        if (CheckTemplateArgument(NTTP, NTTPType, E, &Converted))
1097          Invalid = true;
1098        break;
1099      }
1100
1101      case TemplateArgument::Declaration:
1102      case TemplateArgument::Integral:
1103        // We've already checked this template argument, so just copy
1104        // it to the list of converted arguments.
1105        Converted.push_back(Arg);
1106        break;
1107
1108      case TemplateArgument::Type:
1109        // We have a non-type template parameter but the template
1110        // argument is a type.
1111
1112        // C++ [temp.arg]p2:
1113        //   In a template-argument, an ambiguity between a type-id and
1114        //   an expression is resolved to a type-id, regardless of the
1115        //   form of the corresponding template-parameter.
1116        //
1117        // We warn specifically about this case, since it can be rather
1118        // confusing for users.
1119        if (Arg.getAsType()->isFunctionType())
1120          Diag(Arg.getLocation(), diag::err_template_arg_nontype_ambig)
1121            << Arg.getAsType();
1122        else
1123          Diag(Arg.getLocation(), diag::err_template_arg_must_be_expr);
1124        Diag((*Param)->getLocation(), diag::note_template_param_here);
1125        Invalid = true;
1126      }
1127    } else {
1128      // Check template template parameters.
1129      TemplateTemplateParmDecl *TempParm
1130        = cast<TemplateTemplateParmDecl>(*Param);
1131
1132      switch (Arg.getKind()) {
1133      case TemplateArgument::Expression: {
1134        Expr *ArgExpr = Arg.getAsExpr();
1135        if (ArgExpr && isa<DeclRefExpr>(ArgExpr) &&
1136            isa<TemplateDecl>(cast<DeclRefExpr>(ArgExpr)->getDecl())) {
1137          if (CheckTemplateArgument(TempParm, cast<DeclRefExpr>(ArgExpr)))
1138            Invalid = true;
1139
1140          // Add the converted template argument.
1141          Decl *D
1142            = Context.getCanonicalDecl(cast<DeclRefExpr>(ArgExpr)->getDecl());
1143          Converted.push_back(TemplateArgument(Arg.getLocation(), D));
1144          continue;
1145        }
1146      }
1147        // fall through
1148
1149      case TemplateArgument::Type: {
1150        // We have a template template parameter but the template
1151        // argument does not refer to a template.
1152        Diag(Arg.getLocation(), diag::err_template_arg_must_be_template);
1153        Invalid = true;
1154        break;
1155      }
1156
1157      case TemplateArgument::Declaration:
1158        // We've already checked this template argument, so just copy
1159        // it to the list of converted arguments.
1160        Converted.push_back(Arg);
1161        break;
1162
1163      case TemplateArgument::Integral:
1164        assert(false && "Integral argument with template template parameter");
1165        break;
1166      }
1167    }
1168  }
1169
1170  return Invalid;
1171}
1172
1173/// \brief Check a template argument against its corresponding
1174/// template type parameter.
1175///
1176/// This routine implements the semantics of C++ [temp.arg.type]. It
1177/// returns true if an error occurred, and false otherwise.
1178bool Sema::CheckTemplateArgument(TemplateTypeParmDecl *Param,
1179                                 QualType Arg, SourceLocation ArgLoc) {
1180  // C++ [temp.arg.type]p2:
1181  //   A local type, a type with no linkage, an unnamed type or a type
1182  //   compounded from any of these types shall not be used as a
1183  //   template-argument for a template type-parameter.
1184  //
1185  // FIXME: Perform the recursive and no-linkage type checks.
1186  const TagType *Tag = 0;
1187  if (const EnumType *EnumT = Arg->getAsEnumType())
1188    Tag = EnumT;
1189  else if (const RecordType *RecordT = Arg->getAsRecordType())
1190    Tag = RecordT;
1191  if (Tag && Tag->getDecl()->getDeclContext()->isFunctionOrMethod())
1192    return Diag(ArgLoc, diag::err_template_arg_local_type)
1193      << QualType(Tag, 0);
1194  else if (Tag && !Tag->getDecl()->getDeclName() &&
1195           !Tag->getDecl()->getTypedefForAnonDecl()) {
1196    Diag(ArgLoc, diag::err_template_arg_unnamed_type);
1197    Diag(Tag->getDecl()->getLocation(), diag::note_template_unnamed_type_here);
1198    return true;
1199  }
1200
1201  return false;
1202}
1203
1204/// \brief Checks whether the given template argument is the address
1205/// of an object or function according to C++ [temp.arg.nontype]p1.
1206bool Sema::CheckTemplateArgumentAddressOfObjectOrFunction(Expr *Arg,
1207                                                          NamedDecl *&Entity) {
1208  bool Invalid = false;
1209
1210  // See through any implicit casts we added to fix the type.
1211  if (ImplicitCastExpr *Cast = dyn_cast<ImplicitCastExpr>(Arg))
1212    Arg = Cast->getSubExpr();
1213
1214  // C++0x allows nullptr, and there's no further checking to be done for that.
1215  if (Arg->getType()->isNullPtrType())
1216    return false;
1217
1218  // C++ [temp.arg.nontype]p1:
1219  //
1220  //   A template-argument for a non-type, non-template
1221  //   template-parameter shall be one of: [...]
1222  //
1223  //     -- the address of an object or function with external
1224  //        linkage, including function templates and function
1225  //        template-ids but excluding non-static class members,
1226  //        expressed as & id-expression where the & is optional if
1227  //        the name refers to a function or array, or if the
1228  //        corresponding template-parameter is a reference; or
1229  DeclRefExpr *DRE = 0;
1230
1231  // Ignore (and complain about) any excess parentheses.
1232  while (ParenExpr *Parens = dyn_cast<ParenExpr>(Arg)) {
1233    if (!Invalid) {
1234      Diag(Arg->getSourceRange().getBegin(),
1235           diag::err_template_arg_extra_parens)
1236        << Arg->getSourceRange();
1237      Invalid = true;
1238    }
1239
1240    Arg = Parens->getSubExpr();
1241  }
1242
1243  if (UnaryOperator *UnOp = dyn_cast<UnaryOperator>(Arg)) {
1244    if (UnOp->getOpcode() == UnaryOperator::AddrOf)
1245      DRE = dyn_cast<DeclRefExpr>(UnOp->getSubExpr());
1246  } else
1247    DRE = dyn_cast<DeclRefExpr>(Arg);
1248
1249  if (!DRE || !isa<ValueDecl>(DRE->getDecl()))
1250    return Diag(Arg->getSourceRange().getBegin(),
1251                diag::err_template_arg_not_object_or_func_form)
1252      << Arg->getSourceRange();
1253
1254  // Cannot refer to non-static data members
1255  if (FieldDecl *Field = dyn_cast<FieldDecl>(DRE->getDecl()))
1256    return Diag(Arg->getSourceRange().getBegin(), diag::err_template_arg_field)
1257      << Field << Arg->getSourceRange();
1258
1259  // Cannot refer to non-static member functions
1260  if (CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(DRE->getDecl()))
1261    if (!Method->isStatic())
1262      return Diag(Arg->getSourceRange().getBegin(),
1263                  diag::err_template_arg_method)
1264        << Method << Arg->getSourceRange();
1265
1266  // Functions must have external linkage.
1267  if (FunctionDecl *Func = dyn_cast<FunctionDecl>(DRE->getDecl())) {
1268    if (Func->getStorageClass() == FunctionDecl::Static) {
1269      Diag(Arg->getSourceRange().getBegin(),
1270           diag::err_template_arg_function_not_extern)
1271        << Func << Arg->getSourceRange();
1272      Diag(Func->getLocation(), diag::note_template_arg_internal_object)
1273        << true;
1274      return true;
1275    }
1276
1277    // Okay: we've named a function with external linkage.
1278    Entity = Func;
1279    return Invalid;
1280  }
1281
1282  if (VarDecl *Var = dyn_cast<VarDecl>(DRE->getDecl())) {
1283    if (!Var->hasGlobalStorage()) {
1284      Diag(Arg->getSourceRange().getBegin(),
1285           diag::err_template_arg_object_not_extern)
1286        << Var << Arg->getSourceRange();
1287      Diag(Var->getLocation(), diag::note_template_arg_internal_object)
1288        << true;
1289      return true;
1290    }
1291
1292    // Okay: we've named an object with external linkage
1293    Entity = Var;
1294    return Invalid;
1295  }
1296
1297  // We found something else, but we don't know specifically what it is.
1298  Diag(Arg->getSourceRange().getBegin(),
1299       diag::err_template_arg_not_object_or_func)
1300      << Arg->getSourceRange();
1301  Diag(DRE->getDecl()->getLocation(),
1302       diag::note_template_arg_refers_here);
1303  return true;
1304}
1305
1306/// \brief Checks whether the given template argument is a pointer to
1307/// member constant according to C++ [temp.arg.nontype]p1.
1308bool
1309Sema::CheckTemplateArgumentPointerToMember(Expr *Arg, NamedDecl *&Member) {
1310  bool Invalid = false;
1311
1312  // See through any implicit casts we added to fix the type.
1313  if (ImplicitCastExpr *Cast = dyn_cast<ImplicitCastExpr>(Arg))
1314    Arg = Cast->getSubExpr();
1315
1316  // C++0x allows nullptr, and there's no further checking to be done for that.
1317  if (Arg->getType()->isNullPtrType())
1318    return false;
1319
1320  // C++ [temp.arg.nontype]p1:
1321  //
1322  //   A template-argument for a non-type, non-template
1323  //   template-parameter shall be one of: [...]
1324  //
1325  //     -- a pointer to member expressed as described in 5.3.1.
1326  QualifiedDeclRefExpr *DRE = 0;
1327
1328  // Ignore (and complain about) any excess parentheses.
1329  while (ParenExpr *Parens = dyn_cast<ParenExpr>(Arg)) {
1330    if (!Invalid) {
1331      Diag(Arg->getSourceRange().getBegin(),
1332           diag::err_template_arg_extra_parens)
1333        << Arg->getSourceRange();
1334      Invalid = true;
1335    }
1336
1337    Arg = Parens->getSubExpr();
1338  }
1339
1340  if (UnaryOperator *UnOp = dyn_cast<UnaryOperator>(Arg))
1341    if (UnOp->getOpcode() == UnaryOperator::AddrOf)
1342      DRE = dyn_cast<QualifiedDeclRefExpr>(UnOp->getSubExpr());
1343
1344  if (!DRE)
1345    return Diag(Arg->getSourceRange().getBegin(),
1346                diag::err_template_arg_not_pointer_to_member_form)
1347      << Arg->getSourceRange();
1348
1349  if (isa<FieldDecl>(DRE->getDecl()) || isa<CXXMethodDecl>(DRE->getDecl())) {
1350    assert((isa<FieldDecl>(DRE->getDecl()) ||
1351            !cast<CXXMethodDecl>(DRE->getDecl())->isStatic()) &&
1352           "Only non-static member pointers can make it here");
1353
1354    // Okay: this is the address of a non-static member, and therefore
1355    // a member pointer constant.
1356    Member = DRE->getDecl();
1357    return Invalid;
1358  }
1359
1360  // We found something else, but we don't know specifically what it is.
1361  Diag(Arg->getSourceRange().getBegin(),
1362       diag::err_template_arg_not_pointer_to_member_form)
1363      << Arg->getSourceRange();
1364  Diag(DRE->getDecl()->getLocation(),
1365       diag::note_template_arg_refers_here);
1366  return true;
1367}
1368
1369/// \brief Check a template argument against its corresponding
1370/// non-type template parameter.
1371///
1372/// This routine implements the semantics of C++ [temp.arg.nontype].
1373/// It returns true if an error occurred, and false otherwise. \p
1374/// InstantiatedParamType is the type of the non-type template
1375/// parameter after it has been instantiated.
1376///
1377/// If Converted is non-NULL and no errors occur, the value
1378/// of this argument will be added to the end of the Converted vector.
1379bool Sema::CheckTemplateArgument(NonTypeTemplateParmDecl *Param,
1380                                 QualType InstantiatedParamType, Expr *&Arg,
1381                         llvm::SmallVectorImpl<TemplateArgument> *Converted) {
1382  SourceLocation StartLoc = Arg->getSourceRange().getBegin();
1383
1384  // If either the parameter has a dependent type or the argument is
1385  // type-dependent, there's nothing we can check now.
1386  // FIXME: Add template argument to Converted!
1387  if (InstantiatedParamType->isDependentType() || Arg->isTypeDependent()) {
1388    // FIXME: Produce a cloned, canonical expression?
1389    Converted->push_back(TemplateArgument(Arg));
1390    return false;
1391  }
1392
1393  // C++ [temp.arg.nontype]p5:
1394  //   The following conversions are performed on each expression used
1395  //   as a non-type template-argument. If a non-type
1396  //   template-argument cannot be converted to the type of the
1397  //   corresponding template-parameter then the program is
1398  //   ill-formed.
1399  //
1400  //     -- for a non-type template-parameter of integral or
1401  //        enumeration type, integral promotions (4.5) and integral
1402  //        conversions (4.7) are applied.
1403  QualType ParamType = InstantiatedParamType;
1404  QualType ArgType = Arg->getType();
1405  if (ParamType->isIntegralType() || ParamType->isEnumeralType()) {
1406    // C++ [temp.arg.nontype]p1:
1407    //   A template-argument for a non-type, non-template
1408    //   template-parameter shall be one of:
1409    //
1410    //     -- an integral constant-expression of integral or enumeration
1411    //        type; or
1412    //     -- the name of a non-type template-parameter; or
1413    SourceLocation NonConstantLoc;
1414    llvm::APSInt Value;
1415    if (!ArgType->isIntegralType() && !ArgType->isEnumeralType()) {
1416      Diag(Arg->getSourceRange().getBegin(),
1417           diag::err_template_arg_not_integral_or_enumeral)
1418        << ArgType << Arg->getSourceRange();
1419      Diag(Param->getLocation(), diag::note_template_param_here);
1420      return true;
1421    } else if (!Arg->isValueDependent() &&
1422               !Arg->isIntegerConstantExpr(Value, Context, &NonConstantLoc)) {
1423      Diag(NonConstantLoc, diag::err_template_arg_not_ice)
1424        << ArgType << Arg->getSourceRange();
1425      return true;
1426    }
1427
1428    // FIXME: We need some way to more easily get the unqualified form
1429    // of the types without going all the way to the
1430    // canonical type.
1431    if (Context.getCanonicalType(ParamType).getCVRQualifiers())
1432      ParamType = Context.getCanonicalType(ParamType).getUnqualifiedType();
1433    if (Context.getCanonicalType(ArgType).getCVRQualifiers())
1434      ArgType = Context.getCanonicalType(ArgType).getUnqualifiedType();
1435
1436    // Try to convert the argument to the parameter's type.
1437    if (ParamType == ArgType) {
1438      // Okay: no conversion necessary
1439    } else if (IsIntegralPromotion(Arg, ArgType, ParamType) ||
1440               !ParamType->isEnumeralType()) {
1441      // This is an integral promotion or conversion.
1442      ImpCastExprToType(Arg, ParamType);
1443    } else {
1444      // We can't perform this conversion.
1445      Diag(Arg->getSourceRange().getBegin(),
1446           diag::err_template_arg_not_convertible)
1447        << Arg->getType() << InstantiatedParamType << Arg->getSourceRange();
1448      Diag(Param->getLocation(), diag::note_template_param_here);
1449      return true;
1450    }
1451
1452    QualType IntegerType = Context.getCanonicalType(ParamType);
1453    if (const EnumType *Enum = IntegerType->getAsEnumType())
1454      IntegerType = Enum->getDecl()->getIntegerType();
1455
1456    if (!Arg->isValueDependent()) {
1457      // Check that an unsigned parameter does not receive a negative
1458      // value.
1459      if (IntegerType->isUnsignedIntegerType()
1460          && (Value.isSigned() && Value.isNegative())) {
1461        Diag(Arg->getSourceRange().getBegin(), diag::err_template_arg_negative)
1462          << Value.toString(10) << Param->getType()
1463          << Arg->getSourceRange();
1464        Diag(Param->getLocation(), diag::note_template_param_here);
1465        return true;
1466      }
1467
1468      // Check that we don't overflow the template parameter type.
1469      unsigned AllowedBits = Context.getTypeSize(IntegerType);
1470      if (Value.getActiveBits() > AllowedBits) {
1471        Diag(Arg->getSourceRange().getBegin(),
1472             diag::err_template_arg_too_large)
1473          << Value.toString(10) << Param->getType()
1474          << Arg->getSourceRange();
1475        Diag(Param->getLocation(), diag::note_template_param_here);
1476        return true;
1477      }
1478
1479      if (Value.getBitWidth() != AllowedBits)
1480        Value.extOrTrunc(AllowedBits);
1481      Value.setIsSigned(IntegerType->isSignedIntegerType());
1482    }
1483
1484    if (Converted) {
1485      // Add the value of this argument to the list of converted
1486      // arguments. We use the bitwidth and signedness of the template
1487      // parameter.
1488      if (Arg->isValueDependent()) {
1489        // The argument is value-dependent. Create a new
1490        // TemplateArgument with the converted expression.
1491        Converted->push_back(TemplateArgument(Arg));
1492        return false;
1493      }
1494
1495      Converted->push_back(TemplateArgument(StartLoc, Value,
1496                                   Context.getCanonicalType(IntegerType)));
1497    }
1498
1499    return false;
1500  }
1501
1502  // Handle pointer-to-function, reference-to-function, and
1503  // pointer-to-member-function all in (roughly) the same way.
1504  if (// -- For a non-type template-parameter of type pointer to
1505      //    function, only the function-to-pointer conversion (4.3) is
1506      //    applied. If the template-argument represents a set of
1507      //    overloaded functions (or a pointer to such), the matching
1508      //    function is selected from the set (13.4).
1509      // In C++0x, any std::nullptr_t value can be converted.
1510      (ParamType->isPointerType() &&
1511       ParamType->getAsPointerType()->getPointeeType()->isFunctionType()) ||
1512      // -- For a non-type template-parameter of type reference to
1513      //    function, no conversions apply. If the template-argument
1514      //    represents a set of overloaded functions, the matching
1515      //    function is selected from the set (13.4).
1516      (ParamType->isReferenceType() &&
1517       ParamType->getAsReferenceType()->getPointeeType()->isFunctionType()) ||
1518      // -- For a non-type template-parameter of type pointer to
1519      //    member function, no conversions apply. If the
1520      //    template-argument represents a set of overloaded member
1521      //    functions, the matching member function is selected from
1522      //    the set (13.4).
1523      // Again, C++0x allows a std::nullptr_t value.
1524      (ParamType->isMemberPointerType() &&
1525       ParamType->getAsMemberPointerType()->getPointeeType()
1526         ->isFunctionType())) {
1527    if (Context.hasSameUnqualifiedType(ArgType,
1528                                       ParamType.getNonReferenceType())) {
1529      // We don't have to do anything: the types already match.
1530    } else if (ArgType->isNullPtrType() && (ParamType->isPointerType() ||
1531                 ParamType->isMemberPointerType())) {
1532      ArgType = ParamType;
1533      ImpCastExprToType(Arg, ParamType);
1534    } else if (ArgType->isFunctionType() && ParamType->isPointerType()) {
1535      ArgType = Context.getPointerType(ArgType);
1536      ImpCastExprToType(Arg, ArgType);
1537    } else if (FunctionDecl *Fn
1538                 = ResolveAddressOfOverloadedFunction(Arg, ParamType, true)) {
1539      if (DiagnoseUseOfDecl(Fn, Arg->getSourceRange().getBegin()))
1540        return true;
1541
1542      FixOverloadedFunctionReference(Arg, Fn);
1543      ArgType = Arg->getType();
1544      if (ArgType->isFunctionType() && ParamType->isPointerType()) {
1545        ArgType = Context.getPointerType(Arg->getType());
1546        ImpCastExprToType(Arg, ArgType);
1547      }
1548    }
1549
1550    if (!Context.hasSameUnqualifiedType(ArgType,
1551                                        ParamType.getNonReferenceType())) {
1552      // We can't perform this conversion.
1553      Diag(Arg->getSourceRange().getBegin(),
1554           diag::err_template_arg_not_convertible)
1555        << Arg->getType() << InstantiatedParamType << Arg->getSourceRange();
1556      Diag(Param->getLocation(), diag::note_template_param_here);
1557      return true;
1558    }
1559
1560    if (ParamType->isMemberPointerType()) {
1561      NamedDecl *Member = 0;
1562      if (CheckTemplateArgumentPointerToMember(Arg, Member))
1563        return true;
1564
1565      if (Converted) {
1566        Member = cast_or_null<NamedDecl>(Context.getCanonicalDecl(Member));
1567        Converted->push_back(TemplateArgument(StartLoc, Member));
1568      }
1569
1570      return false;
1571    }
1572
1573    NamedDecl *Entity = 0;
1574    if (CheckTemplateArgumentAddressOfObjectOrFunction(Arg, Entity))
1575      return true;
1576
1577    if (Converted) {
1578      Entity = cast_or_null<NamedDecl>(Context.getCanonicalDecl(Entity));
1579      Converted->push_back(TemplateArgument(StartLoc, Entity));
1580    }
1581    return false;
1582  }
1583
1584  if (ParamType->isPointerType()) {
1585    //   -- for a non-type template-parameter of type pointer to
1586    //      object, qualification conversions (4.4) and the
1587    //      array-to-pointer conversion (4.2) are applied.
1588    // C++0x also allows a value of std::nullptr_t.
1589    assert(ParamType->getAsPointerType()->getPointeeType()->isObjectType() &&
1590           "Only object pointers allowed here");
1591
1592    if (ArgType->isNullPtrType()) {
1593      ArgType = ParamType;
1594      ImpCastExprToType(Arg, ParamType);
1595    } else if (ArgType->isArrayType()) {
1596      ArgType = Context.getArrayDecayedType(ArgType);
1597      ImpCastExprToType(Arg, ArgType);
1598    }
1599
1600    if (IsQualificationConversion(ArgType, ParamType)) {
1601      ArgType = ParamType;
1602      ImpCastExprToType(Arg, ParamType);
1603    }
1604
1605    if (!Context.hasSameUnqualifiedType(ArgType, ParamType)) {
1606      // We can't perform this conversion.
1607      Diag(Arg->getSourceRange().getBegin(),
1608           diag::err_template_arg_not_convertible)
1609        << Arg->getType() << InstantiatedParamType << Arg->getSourceRange();
1610      Diag(Param->getLocation(), diag::note_template_param_here);
1611      return true;
1612    }
1613
1614    NamedDecl *Entity = 0;
1615    if (CheckTemplateArgumentAddressOfObjectOrFunction(Arg, Entity))
1616      return true;
1617
1618    if (Converted) {
1619      Entity = cast_or_null<NamedDecl>(Context.getCanonicalDecl(Entity));
1620      Converted->push_back(TemplateArgument(StartLoc, Entity));
1621    }
1622
1623    return false;
1624  }
1625
1626  if (const ReferenceType *ParamRefType = ParamType->getAsReferenceType()) {
1627    //   -- For a non-type template-parameter of type reference to
1628    //      object, no conversions apply. The type referred to by the
1629    //      reference may be more cv-qualified than the (otherwise
1630    //      identical) type of the template-argument. The
1631    //      template-parameter is bound directly to the
1632    //      template-argument, which must be an lvalue.
1633    assert(ParamRefType->getPointeeType()->isObjectType() &&
1634           "Only object references allowed here");
1635
1636    if (!Context.hasSameUnqualifiedType(ParamRefType->getPointeeType(), ArgType)) {
1637      Diag(Arg->getSourceRange().getBegin(),
1638           diag::err_template_arg_no_ref_bind)
1639        << InstantiatedParamType << Arg->getType()
1640        << Arg->getSourceRange();
1641      Diag(Param->getLocation(), diag::note_template_param_here);
1642      return true;
1643    }
1644
1645    unsigned ParamQuals
1646      = Context.getCanonicalType(ParamType).getCVRQualifiers();
1647    unsigned ArgQuals = Context.getCanonicalType(ArgType).getCVRQualifiers();
1648
1649    if ((ParamQuals | ArgQuals) != ParamQuals) {
1650      Diag(Arg->getSourceRange().getBegin(),
1651           diag::err_template_arg_ref_bind_ignores_quals)
1652        << InstantiatedParamType << Arg->getType()
1653        << Arg->getSourceRange();
1654      Diag(Param->getLocation(), diag::note_template_param_here);
1655      return true;
1656    }
1657
1658    NamedDecl *Entity = 0;
1659    if (CheckTemplateArgumentAddressOfObjectOrFunction(Arg, Entity))
1660      return true;
1661
1662    if (Converted) {
1663      Entity = cast<NamedDecl>(Context.getCanonicalDecl(Entity));
1664      Converted->push_back(TemplateArgument(StartLoc, Entity));
1665    }
1666
1667    return false;
1668  }
1669
1670  //     -- For a non-type template-parameter of type pointer to data
1671  //        member, qualification conversions (4.4) are applied.
1672  // C++0x allows std::nullptr_t values.
1673  assert(ParamType->isMemberPointerType() && "Only pointers to members remain");
1674
1675  if (Context.hasSameUnqualifiedType(ParamType, ArgType)) {
1676    // Types match exactly: nothing more to do here.
1677  } else if (ArgType->isNullPtrType()) {
1678    ImpCastExprToType(Arg, ParamType);
1679  } else if (IsQualificationConversion(ArgType, ParamType)) {
1680    ImpCastExprToType(Arg, ParamType);
1681  } else {
1682    // We can't perform this conversion.
1683    Diag(Arg->getSourceRange().getBegin(),
1684         diag::err_template_arg_not_convertible)
1685      << Arg->getType() << InstantiatedParamType << Arg->getSourceRange();
1686    Diag(Param->getLocation(), diag::note_template_param_here);
1687    return true;
1688  }
1689
1690  NamedDecl *Member = 0;
1691  if (CheckTemplateArgumentPointerToMember(Arg, Member))
1692    return true;
1693
1694  if (Converted) {
1695    Member = cast_or_null<NamedDecl>(Context.getCanonicalDecl(Member));
1696    Converted->push_back(TemplateArgument(StartLoc, Member));
1697  }
1698
1699  return false;
1700}
1701
1702/// \brief Check a template argument against its corresponding
1703/// template template parameter.
1704///
1705/// This routine implements the semantics of C++ [temp.arg.template].
1706/// It returns true if an error occurred, and false otherwise.
1707bool Sema::CheckTemplateArgument(TemplateTemplateParmDecl *Param,
1708                                 DeclRefExpr *Arg) {
1709  assert(isa<TemplateDecl>(Arg->getDecl()) && "Only template decls allowed");
1710  TemplateDecl *Template = cast<TemplateDecl>(Arg->getDecl());
1711
1712  // C++ [temp.arg.template]p1:
1713  //   A template-argument for a template template-parameter shall be
1714  //   the name of a class template, expressed as id-expression. Only
1715  //   primary class templates are considered when matching the
1716  //   template template argument with the corresponding parameter;
1717  //   partial specializations are not considered even if their
1718  //   parameter lists match that of the template template parameter.
1719  if (!isa<ClassTemplateDecl>(Template)) {
1720    assert(isa<FunctionTemplateDecl>(Template) &&
1721           "Only function templates are possible here");
1722    Diag(Arg->getSourceRange().getBegin(),
1723         diag::note_template_arg_refers_here_func)
1724      << Template;
1725  }
1726
1727  return !TemplateParameterListsAreEqual(Template->getTemplateParameters(),
1728                                         Param->getTemplateParameters(),
1729                                         true, true,
1730                                         Arg->getSourceRange().getBegin());
1731}
1732
1733/// \brief Determine whether the given template parameter lists are
1734/// equivalent.
1735///
1736/// \param New  The new template parameter list, typically written in the
1737/// source code as part of a new template declaration.
1738///
1739/// \param Old  The old template parameter list, typically found via
1740/// name lookup of the template declared with this template parameter
1741/// list.
1742///
1743/// \param Complain  If true, this routine will produce a diagnostic if
1744/// the template parameter lists are not equivalent.
1745///
1746/// \param IsTemplateTemplateParm  If true, this routine is being
1747/// called to compare the template parameter lists of a template
1748/// template parameter.
1749///
1750/// \param TemplateArgLoc If this source location is valid, then we
1751/// are actually checking the template parameter list of a template
1752/// argument (New) against the template parameter list of its
1753/// corresponding template template parameter (Old). We produce
1754/// slightly different diagnostics in this scenario.
1755///
1756/// \returns True if the template parameter lists are equal, false
1757/// otherwise.
1758bool
1759Sema::TemplateParameterListsAreEqual(TemplateParameterList *New,
1760                                     TemplateParameterList *Old,
1761                                     bool Complain,
1762                                     bool IsTemplateTemplateParm,
1763                                     SourceLocation TemplateArgLoc) {
1764  if (Old->size() != New->size()) {
1765    if (Complain) {
1766      unsigned NextDiag = diag::err_template_param_list_different_arity;
1767      if (TemplateArgLoc.isValid()) {
1768        Diag(TemplateArgLoc, diag::err_template_arg_template_params_mismatch);
1769        NextDiag = diag::note_template_param_list_different_arity;
1770      }
1771      Diag(New->getTemplateLoc(), NextDiag)
1772          << (New->size() > Old->size())
1773          << IsTemplateTemplateParm
1774          << SourceRange(New->getTemplateLoc(), New->getRAngleLoc());
1775      Diag(Old->getTemplateLoc(), diag::note_template_prev_declaration)
1776        << IsTemplateTemplateParm
1777        << SourceRange(Old->getTemplateLoc(), Old->getRAngleLoc());
1778    }
1779
1780    return false;
1781  }
1782
1783  for (TemplateParameterList::iterator OldParm = Old->begin(),
1784         OldParmEnd = Old->end(), NewParm = New->begin();
1785       OldParm != OldParmEnd; ++OldParm, ++NewParm) {
1786    if ((*OldParm)->getKind() != (*NewParm)->getKind()) {
1787      unsigned NextDiag = diag::err_template_param_different_kind;
1788      if (TemplateArgLoc.isValid()) {
1789        Diag(TemplateArgLoc, diag::err_template_arg_template_params_mismatch);
1790        NextDiag = diag::note_template_param_different_kind;
1791      }
1792      Diag((*NewParm)->getLocation(), NextDiag)
1793        << IsTemplateTemplateParm;
1794      Diag((*OldParm)->getLocation(), diag::note_template_prev_declaration)
1795        << IsTemplateTemplateParm;
1796      return false;
1797    }
1798
1799    if (isa<TemplateTypeParmDecl>(*OldParm)) {
1800      // Okay; all template type parameters are equivalent (since we
1801      // know we're at the same index).
1802#if 0
1803      // FIXME: Enable this code in debug mode *after* we properly go through
1804      // and "instantiate" the template parameter lists of template template
1805      // parameters. It's only after this instantiation that (1) any dependent
1806      // types within the template parameter list of the template template
1807      // parameter can be checked, and (2) the template type parameter depths
1808      // will match up.
1809      QualType OldParmType
1810        = Context.getTypeDeclType(cast<TemplateTypeParmDecl>(*OldParm));
1811      QualType NewParmType
1812        = Context.getTypeDeclType(cast<TemplateTypeParmDecl>(*NewParm));
1813      assert(Context.getCanonicalType(OldParmType) ==
1814             Context.getCanonicalType(NewParmType) &&
1815             "type parameter mismatch?");
1816#endif
1817    } else if (NonTypeTemplateParmDecl *OldNTTP
1818                 = dyn_cast<NonTypeTemplateParmDecl>(*OldParm)) {
1819      // The types of non-type template parameters must agree.
1820      NonTypeTemplateParmDecl *NewNTTP
1821        = cast<NonTypeTemplateParmDecl>(*NewParm);
1822      if (Context.getCanonicalType(OldNTTP->getType()) !=
1823            Context.getCanonicalType(NewNTTP->getType())) {
1824        if (Complain) {
1825          unsigned NextDiag = diag::err_template_nontype_parm_different_type;
1826          if (TemplateArgLoc.isValid()) {
1827            Diag(TemplateArgLoc,
1828                 diag::err_template_arg_template_params_mismatch);
1829            NextDiag = diag::note_template_nontype_parm_different_type;
1830          }
1831          Diag(NewNTTP->getLocation(), NextDiag)
1832            << NewNTTP->getType()
1833            << IsTemplateTemplateParm;
1834          Diag(OldNTTP->getLocation(),
1835               diag::note_template_nontype_parm_prev_declaration)
1836            << OldNTTP->getType();
1837        }
1838        return false;
1839      }
1840    } else {
1841      // The template parameter lists of template template
1842      // parameters must agree.
1843      // FIXME: Could we perform a faster "type" comparison here?
1844      assert(isa<TemplateTemplateParmDecl>(*OldParm) &&
1845             "Only template template parameters handled here");
1846      TemplateTemplateParmDecl *OldTTP
1847        = cast<TemplateTemplateParmDecl>(*OldParm);
1848      TemplateTemplateParmDecl *NewTTP
1849        = cast<TemplateTemplateParmDecl>(*NewParm);
1850      if (!TemplateParameterListsAreEqual(NewTTP->getTemplateParameters(),
1851                                          OldTTP->getTemplateParameters(),
1852                                          Complain,
1853                                          /*IsTemplateTemplateParm=*/true,
1854                                          TemplateArgLoc))
1855        return false;
1856    }
1857  }
1858
1859  return true;
1860}
1861
1862/// \brief Check whether a template can be declared within this scope.
1863///
1864/// If the template declaration is valid in this scope, returns
1865/// false. Otherwise, issues a diagnostic and returns true.
1866bool
1867Sema::CheckTemplateDeclScope(Scope *S,
1868                             MultiTemplateParamsArg &TemplateParameterLists) {
1869  assert(TemplateParameterLists.size() > 0 && "Not a template");
1870
1871  // Find the nearest enclosing declaration scope.
1872  while ((S->getFlags() & Scope::DeclScope) == 0 ||
1873         (S->getFlags() & Scope::TemplateParamScope) != 0)
1874    S = S->getParent();
1875
1876  TemplateParameterList *TemplateParams =
1877    static_cast<TemplateParameterList*>(*TemplateParameterLists.get());
1878  SourceLocation TemplateLoc = TemplateParams->getTemplateLoc();
1879  SourceRange TemplateRange
1880    = SourceRange(TemplateLoc, TemplateParams->getRAngleLoc());
1881
1882  // C++ [temp]p2:
1883  //   A template-declaration can appear only as a namespace scope or
1884  //   class scope declaration.
1885  DeclContext *Ctx = static_cast<DeclContext *>(S->getEntity());
1886  while (Ctx && isa<LinkageSpecDecl>(Ctx)) {
1887    if (cast<LinkageSpecDecl>(Ctx)->getLanguage() != LinkageSpecDecl::lang_cxx)
1888      return Diag(TemplateLoc, diag::err_template_linkage)
1889        << TemplateRange;
1890
1891    Ctx = Ctx->getParent();
1892  }
1893
1894  if (Ctx && (Ctx->isFileContext() || Ctx->isRecord()))
1895    return false;
1896
1897  return Diag(TemplateLoc, diag::err_template_outside_namespace_or_class_scope)
1898    << TemplateRange;
1899}
1900
1901/// \brief Check whether a class template specialization or explicit
1902/// instantiation in the current context is well-formed.
1903///
1904/// This routine determines whether a class template specialization or
1905/// explicit instantiation can be declared in the current context
1906/// (C++ [temp.expl.spec]p2, C++0x [temp.explicit]p2) and emits
1907/// appropriate diagnostics if there was an error. It returns true if
1908// there was an error that we cannot recover from, and false otherwise.
1909bool
1910Sema::CheckClassTemplateSpecializationScope(ClassTemplateDecl *ClassTemplate,
1911                                   ClassTemplateSpecializationDecl *PrevDecl,
1912                                            SourceLocation TemplateNameLoc,
1913                                            SourceRange ScopeSpecifierRange,
1914                                            bool ExplicitInstantiation) {
1915  // C++ [temp.expl.spec]p2:
1916  //   An explicit specialization shall be declared in the namespace
1917  //   of which the template is a member, or, for member templates, in
1918  //   the namespace of which the enclosing class or enclosing class
1919  //   template is a member. An explicit specialization of a member
1920  //   function, member class or static data member of a class
1921  //   template shall be declared in the namespace of which the class
1922  //   template is a member. Such a declaration may also be a
1923  //   definition. If the declaration is not a definition, the
1924  //   specialization may be defined later in the name- space in which
1925  //   the explicit specialization was declared, or in a namespace
1926  //   that encloses the one in which the explicit specialization was
1927  //   declared.
1928  if (CurContext->getLookupContext()->isFunctionOrMethod()) {
1929    Diag(TemplateNameLoc, diag::err_template_spec_decl_function_scope)
1930      << ExplicitInstantiation << ClassTemplate;
1931    return true;
1932  }
1933
1934  DeclContext *DC = CurContext->getEnclosingNamespaceContext();
1935  DeclContext *TemplateContext
1936    = ClassTemplate->getDeclContext()->getEnclosingNamespaceContext();
1937  if ((!PrevDecl || PrevDecl->getSpecializationKind() == TSK_Undeclared) &&
1938      !ExplicitInstantiation) {
1939    // There is no prior declaration of this entity, so this
1940    // specialization must be in the same context as the template
1941    // itself.
1942    if (DC != TemplateContext) {
1943      if (isa<TranslationUnitDecl>(TemplateContext))
1944        Diag(TemplateNameLoc, diag::err_template_spec_decl_out_of_scope_global)
1945          << ClassTemplate << ScopeSpecifierRange;
1946      else if (isa<NamespaceDecl>(TemplateContext))
1947        Diag(TemplateNameLoc, diag::err_template_spec_decl_out_of_scope)
1948          << ClassTemplate << cast<NamedDecl>(TemplateContext)
1949          << ScopeSpecifierRange;
1950
1951      Diag(ClassTemplate->getLocation(), diag::note_template_decl_here);
1952    }
1953
1954    return false;
1955  }
1956
1957  // We have a previous declaration of this entity. Make sure that
1958  // this redeclaration (or definition) occurs in an enclosing namespace.
1959  if (!CurContext->Encloses(TemplateContext)) {
1960    // FIXME:  In C++98,  we  would like  to  turn these  errors into  warnings,
1961    // dependent on a -Wc++0x flag.
1962    bool SuppressedDiag = false;
1963    if (isa<TranslationUnitDecl>(TemplateContext)) {
1964      if (!ExplicitInstantiation || getLangOptions().CPlusPlus0x)
1965        Diag(TemplateNameLoc, diag::err_template_spec_redecl_global_scope)
1966          << ExplicitInstantiation << ClassTemplate << ScopeSpecifierRange;
1967      else
1968        SuppressedDiag = true;
1969    } else if (isa<NamespaceDecl>(TemplateContext)) {
1970      if (!ExplicitInstantiation || getLangOptions().CPlusPlus0x)
1971        Diag(TemplateNameLoc, diag::err_template_spec_redecl_out_of_scope)
1972          << ExplicitInstantiation << ClassTemplate
1973          << cast<NamedDecl>(TemplateContext) << ScopeSpecifierRange;
1974      else
1975        SuppressedDiag = true;
1976    }
1977
1978    if (!SuppressedDiag)
1979      Diag(ClassTemplate->getLocation(), diag::note_template_decl_here);
1980  }
1981
1982  return false;
1983}
1984
1985Sema::DeclResult
1986Sema::ActOnClassTemplateSpecialization(Scope *S, unsigned TagSpec, TagKind TK,
1987                                       SourceLocation KWLoc,
1988                                       const CXXScopeSpec &SS,
1989                                       TemplateTy TemplateD,
1990                                       SourceLocation TemplateNameLoc,
1991                                       SourceLocation LAngleLoc,
1992                                       ASTTemplateArgsPtr TemplateArgsIn,
1993                                       SourceLocation *TemplateArgLocs,
1994                                       SourceLocation RAngleLoc,
1995                                       AttributeList *Attr,
1996                               MultiTemplateParamsArg TemplateParameterLists) {
1997  // Find the class template we're specializing
1998  TemplateName Name = TemplateD.getAsVal<TemplateName>();
1999  ClassTemplateDecl *ClassTemplate
2000    = cast<ClassTemplateDecl>(Name.getAsTemplateDecl());
2001
2002  // Check the validity of the template headers that introduce this
2003  // template.
2004  // FIXME: Once we have member templates, we'll need to check
2005  // C++ [temp.expl.spec]p17-18, where we could have multiple levels of
2006  // template<> headers.
2007  if (TemplateParameterLists.size() == 0)
2008    Diag(KWLoc, diag::err_template_spec_needs_header)
2009      << CodeModificationHint::CreateInsertion(KWLoc, "template<> ");
2010  else {
2011    TemplateParameterList *TemplateParams
2012      = static_cast<TemplateParameterList*>(*TemplateParameterLists.get());
2013    if (TemplateParameterLists.size() > 1) {
2014      Diag(TemplateParams->getTemplateLoc(),
2015           diag::err_template_spec_extra_headers);
2016      return true;
2017    }
2018
2019    if (TemplateParams->size() > 0) {
2020      // FIXME: No support for class template partial specialization.
2021      Diag(TemplateParams->getTemplateLoc(), diag::unsup_template_partial_spec);
2022      return true;
2023    }
2024  }
2025
2026  // Check that the specialization uses the same tag kind as the
2027  // original template.
2028  TagDecl::TagKind Kind;
2029  switch (TagSpec) {
2030  default: assert(0 && "Unknown tag type!");
2031  case DeclSpec::TST_struct: Kind = TagDecl::TK_struct; break;
2032  case DeclSpec::TST_union:  Kind = TagDecl::TK_union; break;
2033  case DeclSpec::TST_class:  Kind = TagDecl::TK_class; break;
2034  }
2035  if (!isAcceptableTagRedeclaration(ClassTemplate->getTemplatedDecl(),
2036                                    Kind, KWLoc,
2037                                    *ClassTemplate->getIdentifier())) {
2038    Diag(KWLoc, diag::err_use_with_wrong_tag)
2039      << ClassTemplate
2040      << CodeModificationHint::CreateReplacement(KWLoc,
2041                            ClassTemplate->getTemplatedDecl()->getKindName());
2042    Diag(ClassTemplate->getTemplatedDecl()->getLocation(),
2043         diag::note_previous_use);
2044    Kind = ClassTemplate->getTemplatedDecl()->getTagKind();
2045  }
2046
2047  // Translate the parser's template argument list in our AST format.
2048  llvm::SmallVector<TemplateArgument, 16> TemplateArgs;
2049  translateTemplateArguments(TemplateArgsIn, TemplateArgLocs, TemplateArgs);
2050
2051  // Check that the template argument list is well-formed for this
2052  // template.
2053  llvm::SmallVector<TemplateArgument, 16> ConvertedTemplateArgs;
2054  if (CheckTemplateArgumentList(ClassTemplate, TemplateNameLoc, LAngleLoc,
2055                                &TemplateArgs[0], TemplateArgs.size(),
2056                                RAngleLoc, ConvertedTemplateArgs))
2057    return true;
2058
2059  assert((ConvertedTemplateArgs.size() ==
2060            ClassTemplate->getTemplateParameters()->size()) &&
2061         "Converted template argument list is too short!");
2062
2063  // Find the class template specialization declaration that
2064  // corresponds to these arguments.
2065  llvm::FoldingSetNodeID ID;
2066  ClassTemplateSpecializationDecl::Profile(ID, &ConvertedTemplateArgs[0],
2067                                           ConvertedTemplateArgs.size());
2068  void *InsertPos = 0;
2069  ClassTemplateSpecializationDecl *PrevDecl
2070    = ClassTemplate->getSpecializations().FindNodeOrInsertPos(ID, InsertPos);
2071
2072  ClassTemplateSpecializationDecl *Specialization = 0;
2073
2074  // Check whether we can declare a class template specialization in
2075  // the current scope.
2076  if (CheckClassTemplateSpecializationScope(ClassTemplate, PrevDecl,
2077                                            TemplateNameLoc,
2078                                            SS.getRange(),
2079                                            /*ExplicitInstantiation=*/false))
2080    return true;
2081
2082  if (PrevDecl && PrevDecl->getSpecializationKind() == TSK_Undeclared) {
2083    // Since the only prior class template specialization with these
2084    // arguments was referenced but not declared, reuse that
2085    // declaration node as our own, updating its source location to
2086    // reflect our new declaration.
2087    Specialization = PrevDecl;
2088    Specialization->setLocation(TemplateNameLoc);
2089    PrevDecl = 0;
2090  } else {
2091    // Create a new class template specialization declaration node for
2092    // this explicit specialization.
2093    Specialization
2094      = ClassTemplateSpecializationDecl::Create(Context,
2095                                             ClassTemplate->getDeclContext(),
2096                                                TemplateNameLoc,
2097                                                ClassTemplate,
2098                                                &ConvertedTemplateArgs[0],
2099                                                ConvertedTemplateArgs.size(),
2100                                                PrevDecl);
2101
2102    if (PrevDecl) {
2103      ClassTemplate->getSpecializations().RemoveNode(PrevDecl);
2104      ClassTemplate->getSpecializations().GetOrInsertNode(Specialization);
2105    } else {
2106      ClassTemplate->getSpecializations().InsertNode(Specialization,
2107                                                     InsertPos);
2108    }
2109  }
2110
2111  // Note that this is an explicit specialization.
2112  Specialization->setSpecializationKind(TSK_ExplicitSpecialization);
2113
2114  // Check that this isn't a redefinition of this specialization.
2115  if (TK == TK_Definition) {
2116    if (RecordDecl *Def = Specialization->getDefinition(Context)) {
2117      // FIXME: Should also handle explicit specialization after implicit
2118      // instantiation with a special diagnostic.
2119      SourceRange Range(TemplateNameLoc, RAngleLoc);
2120      Diag(TemplateNameLoc, diag::err_redefinition)
2121        << Specialization << Range;
2122      Diag(Def->getLocation(), diag::note_previous_definition);
2123      Specialization->setInvalidDecl();
2124      return true;
2125    }
2126  }
2127
2128  // Build the fully-sugared type for this class template
2129  // specialization as the user wrote in the specialization
2130  // itself. This means that we'll pretty-print the type retrieved
2131  // from the specialization's declaration the way that the user
2132  // actually wrote the specialization, rather than formatting the
2133  // name based on the "canonical" representation used to store the
2134  // template arguments in the specialization.
2135  QualType WrittenTy
2136    = Context.getTemplateSpecializationType(Name,
2137                                            &TemplateArgs[0],
2138                                            TemplateArgs.size(),
2139                                  Context.getTypeDeclType(Specialization));
2140  Specialization->setTypeAsWritten(WrittenTy);
2141  TemplateArgsIn.release();
2142
2143  // C++ [temp.expl.spec]p9:
2144  //   A template explicit specialization is in the scope of the
2145  //   namespace in which the template was defined.
2146  //
2147  // We actually implement this paragraph where we set the semantic
2148  // context (in the creation of the ClassTemplateSpecializationDecl),
2149  // but we also maintain the lexical context where the actual
2150  // definition occurs.
2151  Specialization->setLexicalDeclContext(CurContext);
2152
2153  // We may be starting the definition of this specialization.
2154  if (TK == TK_Definition)
2155    Specialization->startDefinition();
2156
2157  // Add the specialization into its lexical context, so that it can
2158  // be seen when iterating through the list of declarations in that
2159  // context. However, specializations are not found by name lookup.
2160  CurContext->addDecl(Context, Specialization);
2161  return DeclPtrTy::make(Specialization);
2162}
2163
2164// Explicit instantiation of a class template specialization
2165Sema::DeclResult
2166Sema::ActOnExplicitInstantiation(Scope *S, SourceLocation TemplateLoc,
2167                                 unsigned TagSpec,
2168                                 SourceLocation KWLoc,
2169                                 const CXXScopeSpec &SS,
2170                                 TemplateTy TemplateD,
2171                                 SourceLocation TemplateNameLoc,
2172                                 SourceLocation LAngleLoc,
2173                                 ASTTemplateArgsPtr TemplateArgsIn,
2174                                 SourceLocation *TemplateArgLocs,
2175                                 SourceLocation RAngleLoc,
2176                                 AttributeList *Attr) {
2177  // Find the class template we're specializing
2178  TemplateName Name = TemplateD.getAsVal<TemplateName>();
2179  ClassTemplateDecl *ClassTemplate
2180    = cast<ClassTemplateDecl>(Name.getAsTemplateDecl());
2181
2182  // Check that the specialization uses the same tag kind as the
2183  // original template.
2184  TagDecl::TagKind Kind;
2185  switch (TagSpec) {
2186  default: assert(0 && "Unknown tag type!");
2187  case DeclSpec::TST_struct: Kind = TagDecl::TK_struct; break;
2188  case DeclSpec::TST_union:  Kind = TagDecl::TK_union; break;
2189  case DeclSpec::TST_class:  Kind = TagDecl::TK_class; break;
2190  }
2191  if (!isAcceptableTagRedeclaration(ClassTemplate->getTemplatedDecl(),
2192                                    Kind, KWLoc,
2193                                    *ClassTemplate->getIdentifier())) {
2194    Diag(KWLoc, diag::err_use_with_wrong_tag)
2195      << ClassTemplate
2196      << CodeModificationHint::CreateReplacement(KWLoc,
2197                            ClassTemplate->getTemplatedDecl()->getKindName());
2198    Diag(ClassTemplate->getTemplatedDecl()->getLocation(),
2199         diag::note_previous_use);
2200    Kind = ClassTemplate->getTemplatedDecl()->getTagKind();
2201  }
2202
2203  // C++0x [temp.explicit]p2:
2204  //   [...] An explicit instantiation shall appear in an enclosing
2205  //   namespace of its template. [...]
2206  //
2207  // This is C++ DR 275.
2208  if (CheckClassTemplateSpecializationScope(ClassTemplate, 0,
2209                                            TemplateNameLoc,
2210                                            SS.getRange(),
2211                                            /*ExplicitInstantiation=*/true))
2212    return true;
2213
2214  // Translate the parser's template argument list in our AST format.
2215  llvm::SmallVector<TemplateArgument, 16> TemplateArgs;
2216  translateTemplateArguments(TemplateArgsIn, TemplateArgLocs, TemplateArgs);
2217
2218  // Check that the template argument list is well-formed for this
2219  // template.
2220  llvm::SmallVector<TemplateArgument, 16> ConvertedTemplateArgs;
2221  if (CheckTemplateArgumentList(ClassTemplate, TemplateNameLoc, LAngleLoc,
2222                                &TemplateArgs[0], TemplateArgs.size(),
2223                                RAngleLoc, ConvertedTemplateArgs))
2224    return true;
2225
2226  assert((ConvertedTemplateArgs.size() ==
2227            ClassTemplate->getTemplateParameters()->size()) &&
2228         "Converted template argument list is too short!");
2229
2230  // Find the class template specialization declaration that
2231  // corresponds to these arguments.
2232  llvm::FoldingSetNodeID ID;
2233  ClassTemplateSpecializationDecl::Profile(ID, &ConvertedTemplateArgs[0],
2234                                           ConvertedTemplateArgs.size());
2235  void *InsertPos = 0;
2236  ClassTemplateSpecializationDecl *PrevDecl
2237    = ClassTemplate->getSpecializations().FindNodeOrInsertPos(ID, InsertPos);
2238
2239  ClassTemplateSpecializationDecl *Specialization = 0;
2240
2241  bool SpecializationRequiresInstantiation = true;
2242  if (PrevDecl) {
2243    if (PrevDecl->getSpecializationKind() == TSK_ExplicitInstantiation) {
2244      // This particular specialization has already been declared or
2245      // instantiated. We cannot explicitly instantiate it.
2246      Diag(TemplateNameLoc, diag::err_explicit_instantiation_duplicate)
2247        << Context.getTypeDeclType(PrevDecl);
2248      Diag(PrevDecl->getLocation(),
2249           diag::note_previous_explicit_instantiation);
2250      return DeclPtrTy::make(PrevDecl);
2251    }
2252
2253    if (PrevDecl->getSpecializationKind() == TSK_ExplicitSpecialization) {
2254      // C++ DR 259, C++0x [temp.explicit]p4:
2255      //   For a given set of template parameters, if an explicit
2256      //   instantiation of a template appears after a declaration of
2257      //   an explicit specialization for that template, the explicit
2258      //   instantiation has no effect.
2259      if (!getLangOptions().CPlusPlus0x) {
2260        Diag(TemplateNameLoc,
2261             diag::ext_explicit_instantiation_after_specialization)
2262          << Context.getTypeDeclType(PrevDecl);
2263        Diag(PrevDecl->getLocation(),
2264             diag::note_previous_template_specialization);
2265      }
2266
2267      // Create a new class template specialization declaration node
2268      // for this explicit specialization. This node is only used to
2269      // record the existence of this explicit instantiation for
2270      // accurate reproduction of the source code; we don't actually
2271      // use it for anything, since it is semantically irrelevant.
2272      Specialization
2273        = ClassTemplateSpecializationDecl::Create(Context,
2274                                             ClassTemplate->getDeclContext(),
2275                                                  TemplateNameLoc,
2276                                                  ClassTemplate,
2277                                                  &ConvertedTemplateArgs[0],
2278                                                  ConvertedTemplateArgs.size(),
2279                                                  0);
2280      Specialization->setLexicalDeclContext(CurContext);
2281      CurContext->addDecl(Context, Specialization);
2282      return DeclPtrTy::make(Specialization);
2283    }
2284
2285    // If we have already (implicitly) instantiated this
2286    // specialization, there is less work to do.
2287    if (PrevDecl->getSpecializationKind() == TSK_ImplicitInstantiation)
2288      SpecializationRequiresInstantiation = false;
2289
2290    // Since the only prior class template specialization with these
2291    // arguments was referenced but not declared, reuse that
2292    // declaration node as our own, updating its source location to
2293    // reflect our new declaration.
2294    Specialization = PrevDecl;
2295    Specialization->setLocation(TemplateNameLoc);
2296    PrevDecl = 0;
2297  } else {
2298    // Create a new class template specialization declaration node for
2299    // this explicit specialization.
2300    Specialization
2301      = ClassTemplateSpecializationDecl::Create(Context,
2302                                             ClassTemplate->getDeclContext(),
2303                                                TemplateNameLoc,
2304                                                ClassTemplate,
2305                                                &ConvertedTemplateArgs[0],
2306                                                ConvertedTemplateArgs.size(),
2307                                                0);
2308
2309    ClassTemplate->getSpecializations().InsertNode(Specialization,
2310                                                   InsertPos);
2311  }
2312
2313  // Build the fully-sugared type for this explicit instantiation as
2314  // the user wrote in the explicit instantiation itself. This means
2315  // that we'll pretty-print the type retrieved from the
2316  // specialization's declaration the way that the user actually wrote
2317  // the explicit instantiation, rather than formatting the name based
2318  // on the "canonical" representation used to store the template
2319  // arguments in the specialization.
2320  QualType WrittenTy
2321    = Context.getTemplateSpecializationType(Name,
2322                                            &TemplateArgs[0],
2323                                            TemplateArgs.size(),
2324                                  Context.getTypeDeclType(Specialization));
2325  Specialization->setTypeAsWritten(WrittenTy);
2326  TemplateArgsIn.release();
2327
2328  // Add the explicit instantiation into its lexical context. However,
2329  // since explicit instantiations are never found by name lookup, we
2330  // just put it into the declaration context directly.
2331  Specialization->setLexicalDeclContext(CurContext);
2332  CurContext->addDecl(Context, Specialization);
2333
2334  // C++ [temp.explicit]p3:
2335  //   A definition of a class template or class member template
2336  //   shall be in scope at the point of the explicit instantiation of
2337  //   the class template or class member template.
2338  //
2339  // This check comes when we actually try to perform the
2340  // instantiation.
2341  if (SpecializationRequiresInstantiation)
2342    InstantiateClassTemplateSpecialization(Specialization, true);
2343  else // Instantiate the members of this class template specialization.
2344    InstantiateClassTemplateSpecializationMembers(TemplateLoc, Specialization);
2345
2346  return DeclPtrTy::make(Specialization);
2347}
2348
2349// Explicit instantiation of a member class of a class template.
2350Sema::DeclResult
2351Sema::ActOnExplicitInstantiation(Scope *S, SourceLocation TemplateLoc,
2352                                 unsigned TagSpec,
2353                                 SourceLocation KWLoc,
2354                                 const CXXScopeSpec &SS,
2355                                 IdentifierInfo *Name,
2356                                 SourceLocation NameLoc,
2357                                 AttributeList *Attr) {
2358
2359  DeclPtrTy TagD = ActOnTag(S, TagSpec, Action::TK_Reference,
2360                            KWLoc, SS, Name, NameLoc, Attr, AS_none);
2361  if (!TagD)
2362    return true;
2363
2364  TagDecl *Tag = cast<TagDecl>(TagD.getAs<Decl>());
2365  if (Tag->isEnum()) {
2366    Diag(TemplateLoc, diag::err_explicit_instantiation_enum)
2367      << Context.getTypeDeclType(Tag);
2368    return true;
2369  }
2370
2371  CXXRecordDecl *Record = cast<CXXRecordDecl>(Tag);
2372  CXXRecordDecl *Pattern = Record->getInstantiatedFromMemberClass();
2373  if (!Pattern) {
2374    Diag(TemplateLoc, diag::err_explicit_instantiation_nontemplate_type)
2375      << Context.getTypeDeclType(Record);
2376    Diag(Record->getLocation(), diag::note_nontemplate_decl_here);
2377    return true;
2378  }
2379
2380  // C++0x [temp.explicit]p2:
2381  //   [...] An explicit instantiation shall appear in an enclosing
2382  //   namespace of its template. [...]
2383  //
2384  // This is C++ DR 275.
2385  if (getLangOptions().CPlusPlus0x) {
2386    // FIXME: In C++98, we would like to turn these errors into warnings,
2387    // dependent on a -Wc++0x flag.
2388    DeclContext *PatternContext
2389      = Pattern->getDeclContext()->getEnclosingNamespaceContext();
2390    if (!CurContext->Encloses(PatternContext)) {
2391      Diag(TemplateLoc, diag::err_explicit_instantiation_out_of_scope)
2392        << Record << cast<NamedDecl>(PatternContext) << SS.getRange();
2393      Diag(Pattern->getLocation(), diag::note_previous_declaration);
2394    }
2395  }
2396
2397  if (!Record->getDefinition(Context)) {
2398    // If the class has a definition, instantiate it (and all of its
2399    // members, recursively).
2400    Pattern = cast_or_null<CXXRecordDecl>(Pattern->getDefinition(Context));
2401    if (Pattern && InstantiateClass(TemplateLoc, Record, Pattern,
2402                                    getTemplateInstantiationArgs(Record),
2403                                    /*ExplicitInstantiation=*/true))
2404      return true;
2405  } else // Instantiate all of the members of class.
2406    InstantiateClassMembers(TemplateLoc, Record,
2407                            getTemplateInstantiationArgs(Record));
2408
2409  // FIXME: We don't have any representation for explicit instantiations of
2410  // member classes. Such a representation is not needed for compilation, but it
2411  // should be available for clients that want to see all of the declarations in
2412  // the source code.
2413  return TagD;
2414}
2415
2416Sema::TypeResult
2417Sema::ActOnTypenameType(SourceLocation TypenameLoc, const CXXScopeSpec &SS,
2418                        const IdentifierInfo &II, SourceLocation IdLoc) {
2419  NestedNameSpecifier *NNS
2420    = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
2421  if (!NNS)
2422    return true;
2423
2424  QualType T = CheckTypenameType(NNS, II, SourceRange(TypenameLoc, IdLoc));
2425  if (T.isNull())
2426    return true;
2427  return T.getAsOpaquePtr();
2428}
2429
2430Sema::TypeResult
2431Sema::ActOnTypenameType(SourceLocation TypenameLoc, const CXXScopeSpec &SS,
2432                        SourceLocation TemplateLoc, TypeTy *Ty) {
2433  QualType T = QualType::getFromOpaquePtr(Ty);
2434  NestedNameSpecifier *NNS
2435    = static_cast<NestedNameSpecifier *>(SS.getScopeRep());
2436  const TemplateSpecializationType *TemplateId
2437    = T->getAsTemplateSpecializationType();
2438  assert(TemplateId && "Expected a template specialization type");
2439
2440  if (NNS->isDependent())
2441    return Context.getTypenameType(NNS, TemplateId).getAsOpaquePtr();
2442
2443  return Context.getQualifiedNameType(NNS, T).getAsOpaquePtr();
2444}
2445
2446/// \brief Build the type that describes a C++ typename specifier,
2447/// e.g., "typename T::type".
2448QualType
2449Sema::CheckTypenameType(NestedNameSpecifier *NNS, const IdentifierInfo &II,
2450                        SourceRange Range) {
2451  CXXRecordDecl *CurrentInstantiation = 0;
2452  if (NNS->isDependent()) {
2453    CurrentInstantiation = getCurrentInstantiationOf(NNS);
2454
2455    // If the nested-name-specifier does not refer to the current
2456    // instantiation, then build a typename type.
2457    if (!CurrentInstantiation)
2458      return Context.getTypenameType(NNS, &II);
2459  }
2460
2461  DeclContext *Ctx = 0;
2462
2463  if (CurrentInstantiation)
2464    Ctx = CurrentInstantiation;
2465  else {
2466    CXXScopeSpec SS;
2467    SS.setScopeRep(NNS);
2468    SS.setRange(Range);
2469    if (RequireCompleteDeclContext(SS))
2470      return QualType();
2471
2472    Ctx = computeDeclContext(SS);
2473  }
2474  assert(Ctx && "No declaration context?");
2475
2476  DeclarationName Name(&II);
2477  LookupResult Result = LookupQualifiedName(Ctx, Name, LookupOrdinaryName,
2478                                            false);
2479  unsigned DiagID = 0;
2480  Decl *Referenced = 0;
2481  switch (Result.getKind()) {
2482  case LookupResult::NotFound:
2483    if (Ctx->isTranslationUnit())
2484      DiagID = diag::err_typename_nested_not_found_global;
2485    else
2486      DiagID = diag::err_typename_nested_not_found;
2487    break;
2488
2489  case LookupResult::Found:
2490    if (TypeDecl *Type = dyn_cast<TypeDecl>(Result.getAsDecl())) {
2491      // We found a type. Build a QualifiedNameType, since the
2492      // typename-specifier was just sugar. FIXME: Tell
2493      // QualifiedNameType that it has a "typename" prefix.
2494      return Context.getQualifiedNameType(NNS, Context.getTypeDeclType(Type));
2495    }
2496
2497    DiagID = diag::err_typename_nested_not_type;
2498    Referenced = Result.getAsDecl();
2499    break;
2500
2501  case LookupResult::FoundOverloaded:
2502    DiagID = diag::err_typename_nested_not_type;
2503    Referenced = *Result.begin();
2504    break;
2505
2506  case LookupResult::AmbiguousBaseSubobjectTypes:
2507  case LookupResult::AmbiguousBaseSubobjects:
2508  case LookupResult::AmbiguousReference:
2509    DiagnoseAmbiguousLookup(Result, Name, Range.getEnd(), Range);
2510    return QualType();
2511  }
2512
2513  // If we get here, it's because name lookup did not find a
2514  // type. Emit an appropriate diagnostic and return an error.
2515  if (NamedDecl *NamedCtx = dyn_cast<NamedDecl>(Ctx))
2516    Diag(Range.getEnd(), DiagID) << Range << Name << NamedCtx;
2517  else
2518    Diag(Range.getEnd(), DiagID) << Range << Name;
2519  if (Referenced)
2520    Diag(Referenced->getLocation(), diag::note_typename_refers_here)
2521      << Name;
2522  return QualType();
2523}
2524