xref: /llvm-project-15.0.7/clang/lib/AST/Decl.cpp (revision ec8c9752)
1 //===--- Decl.cpp - Declaration AST Node Implementation -------------------===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements the Decl subclasses.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/AST/Decl.h"
15 #include "clang/AST/ASTContext.h"
16 #include "clang/AST/ASTLambda.h"
17 #include "clang/AST/ASTMutationListener.h"
18 #include "clang/AST/Attr.h"
19 #include "clang/AST/DeclCXX.h"
20 #include "clang/AST/DeclObjC.h"
21 #include "clang/AST/DeclTemplate.h"
22 #include "clang/AST/Expr.h"
23 #include "clang/AST/ExprCXX.h"
24 #include "clang/AST/PrettyPrinter.h"
25 #include "clang/AST/Stmt.h"
26 #include "clang/AST/TypeLoc.h"
27 #include "clang/Basic/Builtins.h"
28 #include "clang/Basic/IdentifierTable.h"
29 #include "clang/Basic/Module.h"
30 #include "clang/Basic/Specifiers.h"
31 #include "clang/Basic/TargetInfo.h"
32 #include "llvm/Support/ErrorHandling.h"
33 #include <algorithm>
34 
35 using namespace clang;
36 
37 Decl *clang::getPrimaryMergedDecl(Decl *D) {
38   return D->getASTContext().getPrimaryMergedDecl(D);
39 }
40 
41 //===----------------------------------------------------------------------===//
42 // NamedDecl Implementation
43 //===----------------------------------------------------------------------===//
44 
45 // Visibility rules aren't rigorously externally specified, but here
46 // are the basic principles behind what we implement:
47 //
48 // 1. An explicit visibility attribute is generally a direct expression
49 // of the user's intent and should be honored.  Only the innermost
50 // visibility attribute applies.  If no visibility attribute applies,
51 // global visibility settings are considered.
52 //
53 // 2. There is one caveat to the above: on or in a template pattern,
54 // an explicit visibility attribute is just a default rule, and
55 // visibility can be decreased by the visibility of template
56 // arguments.  But this, too, has an exception: an attribute on an
57 // explicit specialization or instantiation causes all the visibility
58 // restrictions of the template arguments to be ignored.
59 //
60 // 3. A variable that does not otherwise have explicit visibility can
61 // be restricted by the visibility of its type.
62 //
63 // 4. A visibility restriction is explicit if it comes from an
64 // attribute (or something like it), not a global visibility setting.
65 // When emitting a reference to an external symbol, visibility
66 // restrictions are ignored unless they are explicit.
67 //
68 // 5. When computing the visibility of a non-type, including a
69 // non-type member of a class, only non-type visibility restrictions
70 // are considered: the 'visibility' attribute, global value-visibility
71 // settings, and a few special cases like __private_extern.
72 //
73 // 6. When computing the visibility of a type, including a type member
74 // of a class, only type visibility restrictions are considered:
75 // the 'type_visibility' attribute and global type-visibility settings.
76 // However, a 'visibility' attribute counts as a 'type_visibility'
77 // attribute on any declaration that only has the former.
78 //
79 // The visibility of a "secondary" entity, like a template argument,
80 // is computed using the kind of that entity, not the kind of the
81 // primary entity for which we are computing visibility.  For example,
82 // the visibility of a specialization of either of these templates:
83 //   template <class T, bool (&compare)(T, X)> bool has_match(list<T>, X);
84 //   template <class T, bool (&compare)(T, X)> class matcher;
85 // is restricted according to the type visibility of the argument 'T',
86 // the type visibility of 'bool(&)(T,X)', and the value visibility of
87 // the argument function 'compare'.  That 'has_match' is a value
88 // and 'matcher' is a type only matters when looking for attributes
89 // and settings from the immediate context.
90 
91 const unsigned IgnoreExplicitVisibilityBit = 2;
92 const unsigned IgnoreAllVisibilityBit = 4;
93 
94 /// Kinds of LV computation.  The linkage side of the computation is
95 /// always the same, but different things can change how visibility is
96 /// computed.
97 enum LVComputationKind {
98   /// Do an LV computation for, ultimately, a type.
99   /// Visibility may be restricted by type visibility settings and
100   /// the visibility of template arguments.
101   LVForType = NamedDecl::VisibilityForType,
102 
103   /// Do an LV computation for, ultimately, a non-type declaration.
104   /// Visibility may be restricted by value visibility settings and
105   /// the visibility of template arguments.
106   LVForValue = NamedDecl::VisibilityForValue,
107 
108   /// Do an LV computation for, ultimately, a type that already has
109   /// some sort of explicit visibility.  Visibility may only be
110   /// restricted by the visibility of template arguments.
111   LVForExplicitType = (LVForType | IgnoreExplicitVisibilityBit),
112 
113   /// Do an LV computation for, ultimately, a non-type declaration
114   /// that already has some sort of explicit visibility.  Visibility
115   /// may only be restricted by the visibility of template arguments.
116   LVForExplicitValue = (LVForValue | IgnoreExplicitVisibilityBit),
117 
118   /// Do an LV computation when we only care about the linkage.
119   LVForLinkageOnly =
120       LVForValue | IgnoreExplicitVisibilityBit | IgnoreAllVisibilityBit
121 };
122 
123 /// Does this computation kind permit us to consider additional
124 /// visibility settings from attributes and the like?
125 static bool hasExplicitVisibilityAlready(LVComputationKind computation) {
126   return ((unsigned(computation) & IgnoreExplicitVisibilityBit) != 0);
127 }
128 
129 /// Given an LVComputationKind, return one of the same type/value sort
130 /// that records that it already has explicit visibility.
131 static LVComputationKind
132 withExplicitVisibilityAlready(LVComputationKind oldKind) {
133   LVComputationKind newKind =
134     static_cast<LVComputationKind>(unsigned(oldKind) |
135                                    IgnoreExplicitVisibilityBit);
136   assert(oldKind != LVForType          || newKind == LVForExplicitType);
137   assert(oldKind != LVForValue         || newKind == LVForExplicitValue);
138   assert(oldKind != LVForExplicitType  || newKind == LVForExplicitType);
139   assert(oldKind != LVForExplicitValue || newKind == LVForExplicitValue);
140   return newKind;
141 }
142 
143 static Optional<Visibility> getExplicitVisibility(const NamedDecl *D,
144                                                   LVComputationKind kind) {
145   assert(!hasExplicitVisibilityAlready(kind) &&
146          "asking for explicit visibility when we shouldn't be");
147   return D->getExplicitVisibility((NamedDecl::ExplicitVisibilityKind) kind);
148 }
149 
150 /// Is the given declaration a "type" or a "value" for the purposes of
151 /// visibility computation?
152 static bool usesTypeVisibility(const NamedDecl *D) {
153   return isa<TypeDecl>(D) ||
154          isa<ClassTemplateDecl>(D) ||
155          isa<ObjCInterfaceDecl>(D);
156 }
157 
158 /// Does the given declaration have member specialization information,
159 /// and if so, is it an explicit specialization?
160 template <class T> static typename
161 std::enable_if<!std::is_base_of<RedeclarableTemplateDecl, T>::value, bool>::type
162 isExplicitMemberSpecialization(const T *D) {
163   if (const MemberSpecializationInfo *member =
164         D->getMemberSpecializationInfo()) {
165     return member->isExplicitSpecialization();
166   }
167   return false;
168 }
169 
170 /// For templates, this question is easier: a member template can't be
171 /// explicitly instantiated, so there's a single bit indicating whether
172 /// or not this is an explicit member specialization.
173 static bool isExplicitMemberSpecialization(const RedeclarableTemplateDecl *D) {
174   return D->isMemberSpecialization();
175 }
176 
177 /// Given a visibility attribute, return the explicit visibility
178 /// associated with it.
179 template <class T>
180 static Visibility getVisibilityFromAttr(const T *attr) {
181   switch (attr->getVisibility()) {
182   case T::Default:
183     return DefaultVisibility;
184   case T::Hidden:
185     return HiddenVisibility;
186   case T::Protected:
187     return ProtectedVisibility;
188   }
189   llvm_unreachable("bad visibility kind");
190 }
191 
192 /// Return the explicit visibility of the given declaration.
193 static Optional<Visibility> getVisibilityOf(const NamedDecl *D,
194                                     NamedDecl::ExplicitVisibilityKind kind) {
195   // If we're ultimately computing the visibility of a type, look for
196   // a 'type_visibility' attribute before looking for 'visibility'.
197   if (kind == NamedDecl::VisibilityForType) {
198     if (const TypeVisibilityAttr *A = D->getAttr<TypeVisibilityAttr>()) {
199       return getVisibilityFromAttr(A);
200     }
201   }
202 
203   // If this declaration has an explicit visibility attribute, use it.
204   if (const VisibilityAttr *A = D->getAttr<VisibilityAttr>()) {
205     return getVisibilityFromAttr(A);
206   }
207 
208   // If we're on Mac OS X, an 'availability' for Mac OS X attribute
209   // implies visibility(default).
210   if (D->getASTContext().getTargetInfo().getTriple().isOSDarwin()) {
211     for (const auto *A : D->specific_attrs<AvailabilityAttr>())
212       if (A->getPlatform()->getName().equals("macosx"))
213         return DefaultVisibility;
214   }
215 
216   return None;
217 }
218 
219 static LinkageInfo
220 getLVForType(const Type &T, LVComputationKind computation) {
221   if (computation == LVForLinkageOnly)
222     return LinkageInfo(T.getLinkage(), DefaultVisibility, true);
223   return T.getLinkageAndVisibility();
224 }
225 
226 /// \brief Get the most restrictive linkage for the types in the given
227 /// template parameter list.  For visibility purposes, template
228 /// parameters are part of the signature of a template.
229 static LinkageInfo
230 getLVForTemplateParameterList(const TemplateParameterList *params,
231                               LVComputationKind computation) {
232   LinkageInfo LV;
233   for (TemplateParameterList::const_iterator P = params->begin(),
234                                           PEnd = params->end();
235        P != PEnd; ++P) {
236 
237     // Template type parameters are the most common and never
238     // contribute to visibility, pack or not.
239     if (isa<TemplateTypeParmDecl>(*P))
240       continue;
241 
242     // Non-type template parameters can be restricted by the value type, e.g.
243     //   template <enum X> class A { ... };
244     // We have to be careful here, though, because we can be dealing with
245     // dependent types.
246     if (NonTypeTemplateParmDecl *NTTP = dyn_cast<NonTypeTemplateParmDecl>(*P)) {
247       // Handle the non-pack case first.
248       if (!NTTP->isExpandedParameterPack()) {
249         if (!NTTP->getType()->isDependentType()) {
250           LV.merge(getLVForType(*NTTP->getType(), computation));
251         }
252         continue;
253       }
254 
255       // Look at all the types in an expanded pack.
256       for (unsigned i = 0, n = NTTP->getNumExpansionTypes(); i != n; ++i) {
257         QualType type = NTTP->getExpansionType(i);
258         if (!type->isDependentType())
259           LV.merge(type->getLinkageAndVisibility());
260       }
261       continue;
262     }
263 
264     // Template template parameters can be restricted by their
265     // template parameters, recursively.
266     TemplateTemplateParmDecl *TTP = cast<TemplateTemplateParmDecl>(*P);
267 
268     // Handle the non-pack case first.
269     if (!TTP->isExpandedParameterPack()) {
270       LV.merge(getLVForTemplateParameterList(TTP->getTemplateParameters(),
271                                              computation));
272       continue;
273     }
274 
275     // Look at all expansions in an expanded pack.
276     for (unsigned i = 0, n = TTP->getNumExpansionTemplateParameters();
277            i != n; ++i) {
278       LV.merge(getLVForTemplateParameterList(
279           TTP->getExpansionTemplateParameters(i), computation));
280     }
281   }
282 
283   return LV;
284 }
285 
286 /// getLVForDecl - Get the linkage and visibility for the given declaration.
287 static LinkageInfo getLVForDecl(const NamedDecl *D,
288                                 LVComputationKind computation);
289 
290 static const Decl *getOutermostFuncOrBlockContext(const Decl *D) {
291   const Decl *Ret = NULL;
292   const DeclContext *DC = D->getDeclContext();
293   while (DC->getDeclKind() != Decl::TranslationUnit) {
294     if (isa<FunctionDecl>(DC) || isa<BlockDecl>(DC))
295       Ret = cast<Decl>(DC);
296     DC = DC->getParent();
297   }
298   return Ret;
299 }
300 
301 /// \brief Get the most restrictive linkage for the types and
302 /// declarations in the given template argument list.
303 ///
304 /// Note that we don't take an LVComputationKind because we always
305 /// want to honor the visibility of template arguments in the same way.
306 static LinkageInfo
307 getLVForTemplateArgumentList(ArrayRef<TemplateArgument> args,
308                              LVComputationKind computation) {
309   LinkageInfo LV;
310 
311   for (unsigned i = 0, e = args.size(); i != e; ++i) {
312     const TemplateArgument &arg = args[i];
313     switch (arg.getKind()) {
314     case TemplateArgument::Null:
315     case TemplateArgument::Integral:
316     case TemplateArgument::Expression:
317       continue;
318 
319     case TemplateArgument::Type:
320       LV.merge(getLVForType(*arg.getAsType(), computation));
321       continue;
322 
323     case TemplateArgument::Declaration:
324       if (NamedDecl *ND = dyn_cast<NamedDecl>(arg.getAsDecl())) {
325         assert(!usesTypeVisibility(ND));
326         LV.merge(getLVForDecl(ND, computation));
327       }
328       continue;
329 
330     case TemplateArgument::NullPtr:
331       LV.merge(arg.getNullPtrType()->getLinkageAndVisibility());
332       continue;
333 
334     case TemplateArgument::Template:
335     case TemplateArgument::TemplateExpansion:
336       if (TemplateDecl *Template
337                 = arg.getAsTemplateOrTemplatePattern().getAsTemplateDecl())
338         LV.merge(getLVForDecl(Template, computation));
339       continue;
340 
341     case TemplateArgument::Pack:
342       LV.merge(getLVForTemplateArgumentList(arg.getPackAsArray(), computation));
343       continue;
344     }
345     llvm_unreachable("bad template argument kind");
346   }
347 
348   return LV;
349 }
350 
351 static LinkageInfo
352 getLVForTemplateArgumentList(const TemplateArgumentList &TArgs,
353                              LVComputationKind computation) {
354   return getLVForTemplateArgumentList(TArgs.asArray(), computation);
355 }
356 
357 static bool shouldConsiderTemplateVisibility(const FunctionDecl *fn,
358                         const FunctionTemplateSpecializationInfo *specInfo) {
359   // Include visibility from the template parameters and arguments
360   // only if this is not an explicit instantiation or specialization
361   // with direct explicit visibility.  (Implicit instantiations won't
362   // have a direct attribute.)
363   if (!specInfo->isExplicitInstantiationOrSpecialization())
364     return true;
365 
366   return !fn->hasAttr<VisibilityAttr>();
367 }
368 
369 /// Merge in template-related linkage and visibility for the given
370 /// function template specialization.
371 ///
372 /// We don't need a computation kind here because we can assume
373 /// LVForValue.
374 ///
375 /// \param[out] LV the computation to use for the parent
376 static void
377 mergeTemplateLV(LinkageInfo &LV, const FunctionDecl *fn,
378                 const FunctionTemplateSpecializationInfo *specInfo,
379                 LVComputationKind computation) {
380   bool considerVisibility =
381     shouldConsiderTemplateVisibility(fn, specInfo);
382 
383   // Merge information from the template parameters.
384   FunctionTemplateDecl *temp = specInfo->getTemplate();
385   LinkageInfo tempLV =
386     getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
387   LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
388 
389   // Merge information from the template arguments.
390   const TemplateArgumentList &templateArgs = *specInfo->TemplateArguments;
391   LinkageInfo argsLV = getLVForTemplateArgumentList(templateArgs, computation);
392   LV.mergeMaybeWithVisibility(argsLV, considerVisibility);
393 }
394 
395 /// Does the given declaration have a direct visibility attribute
396 /// that would match the given rules?
397 static bool hasDirectVisibilityAttribute(const NamedDecl *D,
398                                          LVComputationKind computation) {
399   switch (computation) {
400   case LVForType:
401   case LVForExplicitType:
402     if (D->hasAttr<TypeVisibilityAttr>())
403       return true;
404     // fallthrough
405   case LVForValue:
406   case LVForExplicitValue:
407     if (D->hasAttr<VisibilityAttr>())
408       return true;
409     return false;
410   case LVForLinkageOnly:
411     return false;
412   }
413   llvm_unreachable("bad visibility computation kind");
414 }
415 
416 /// Should we consider visibility associated with the template
417 /// arguments and parameters of the given class template specialization?
418 static bool shouldConsiderTemplateVisibility(
419                                  const ClassTemplateSpecializationDecl *spec,
420                                  LVComputationKind computation) {
421   // Include visibility from the template parameters and arguments
422   // only if this is not an explicit instantiation or specialization
423   // with direct explicit visibility (and note that implicit
424   // instantiations won't have a direct attribute).
425   //
426   // Furthermore, we want to ignore template parameters and arguments
427   // for an explicit specialization when computing the visibility of a
428   // member thereof with explicit visibility.
429   //
430   // This is a bit complex; let's unpack it.
431   //
432   // An explicit class specialization is an independent, top-level
433   // declaration.  As such, if it or any of its members has an
434   // explicit visibility attribute, that must directly express the
435   // user's intent, and we should honor it.  The same logic applies to
436   // an explicit instantiation of a member of such a thing.
437 
438   // Fast path: if this is not an explicit instantiation or
439   // specialization, we always want to consider template-related
440   // visibility restrictions.
441   if (!spec->isExplicitInstantiationOrSpecialization())
442     return true;
443 
444   // This is the 'member thereof' check.
445   if (spec->isExplicitSpecialization() &&
446       hasExplicitVisibilityAlready(computation))
447     return false;
448 
449   return !hasDirectVisibilityAttribute(spec, computation);
450 }
451 
452 /// Merge in template-related linkage and visibility for the given
453 /// class template specialization.
454 static void mergeTemplateLV(LinkageInfo &LV,
455                             const ClassTemplateSpecializationDecl *spec,
456                             LVComputationKind computation) {
457   bool considerVisibility = shouldConsiderTemplateVisibility(spec, computation);
458 
459   // Merge information from the template parameters, but ignore
460   // visibility if we're only considering template arguments.
461 
462   ClassTemplateDecl *temp = spec->getSpecializedTemplate();
463   LinkageInfo tempLV =
464     getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
465   LV.mergeMaybeWithVisibility(tempLV,
466            considerVisibility && !hasExplicitVisibilityAlready(computation));
467 
468   // Merge information from the template arguments.  We ignore
469   // template-argument visibility if we've got an explicit
470   // instantiation with a visibility attribute.
471   const TemplateArgumentList &templateArgs = spec->getTemplateArgs();
472   LinkageInfo argsLV = getLVForTemplateArgumentList(templateArgs, computation);
473   if (considerVisibility)
474     LV.mergeVisibility(argsLV);
475   LV.mergeExternalVisibility(argsLV);
476 }
477 
478 static bool useInlineVisibilityHidden(const NamedDecl *D) {
479   // FIXME: we should warn if -fvisibility-inlines-hidden is used with c.
480   const LangOptions &Opts = D->getASTContext().getLangOpts();
481   if (!Opts.CPlusPlus || !Opts.InlineVisibilityHidden)
482     return false;
483 
484   const FunctionDecl *FD = dyn_cast<FunctionDecl>(D);
485   if (!FD)
486     return false;
487 
488   TemplateSpecializationKind TSK = TSK_Undeclared;
489   if (FunctionTemplateSpecializationInfo *spec
490       = FD->getTemplateSpecializationInfo()) {
491     TSK = spec->getTemplateSpecializationKind();
492   } else if (MemberSpecializationInfo *MSI =
493              FD->getMemberSpecializationInfo()) {
494     TSK = MSI->getTemplateSpecializationKind();
495   }
496 
497   const FunctionDecl *Def = 0;
498   // InlineVisibilityHidden only applies to definitions, and
499   // isInlined() only gives meaningful answers on definitions
500   // anyway.
501   return TSK != TSK_ExplicitInstantiationDeclaration &&
502     TSK != TSK_ExplicitInstantiationDefinition &&
503     FD->hasBody(Def) && Def->isInlined() && !Def->hasAttr<GNUInlineAttr>();
504 }
505 
506 template <typename T> static bool isFirstInExternCContext(T *D) {
507   const T *First = D->getFirstDecl();
508   return First->isInExternCContext();
509 }
510 
511 static bool isSingleLineLanguageLinkage(const Decl &D) {
512   if (const LinkageSpecDecl *SD = dyn_cast<LinkageSpecDecl>(D.getDeclContext()))
513     if (!SD->hasBraces())
514       return true;
515   return false;
516 }
517 
518 static LinkageInfo getLVForNamespaceScopeDecl(const NamedDecl *D,
519                                               LVComputationKind computation) {
520   assert(D->getDeclContext()->getRedeclContext()->isFileContext() &&
521          "Not a name having namespace scope");
522   ASTContext &Context = D->getASTContext();
523 
524   // C++ [basic.link]p3:
525   //   A name having namespace scope (3.3.6) has internal linkage if it
526   //   is the name of
527   //     - an object, reference, function or function template that is
528   //       explicitly declared static; or,
529   // (This bullet corresponds to C99 6.2.2p3.)
530   if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
531     // Explicitly declared static.
532     if (Var->getStorageClass() == SC_Static)
533       return LinkageInfo::internal();
534 
535     // - a non-volatile object or reference that is explicitly declared const
536     //   or constexpr and neither explicitly declared extern nor previously
537     //   declared to have external linkage; or (there is no equivalent in C99)
538     if (Context.getLangOpts().CPlusPlus &&
539         Var->getType().isConstQualified() &&
540         !Var->getType().isVolatileQualified()) {
541       const VarDecl *PrevVar = Var->getPreviousDecl();
542       if (PrevVar)
543         return getLVForDecl(PrevVar, computation);
544 
545       if (Var->getStorageClass() != SC_Extern &&
546           Var->getStorageClass() != SC_PrivateExtern &&
547           !isSingleLineLanguageLinkage(*Var))
548         return LinkageInfo::internal();
549     }
550 
551     for (const VarDecl *PrevVar = Var->getPreviousDecl(); PrevVar;
552          PrevVar = PrevVar->getPreviousDecl()) {
553       if (PrevVar->getStorageClass() == SC_PrivateExtern &&
554           Var->getStorageClass() == SC_None)
555         return PrevVar->getLinkageAndVisibility();
556       // Explicitly declared static.
557       if (PrevVar->getStorageClass() == SC_Static)
558         return LinkageInfo::internal();
559     }
560   } else if (const FunctionDecl *Function = D->getAsFunction()) {
561     // C++ [temp]p4:
562     //   A non-member function template can have internal linkage; any
563     //   other template name shall have external linkage.
564 
565     // Explicitly declared static.
566     if (Function->getCanonicalDecl()->getStorageClass() == SC_Static)
567       return LinkageInfo(InternalLinkage, DefaultVisibility, false);
568   }
569   //   - a data member of an anonymous union.
570   assert(!isa<IndirectFieldDecl>(D) && "Didn't expect an IndirectFieldDecl!");
571   assert(!isa<FieldDecl>(D) && "Didn't expect a FieldDecl!");
572 
573   if (D->isInAnonymousNamespace()) {
574     const VarDecl *Var = dyn_cast<VarDecl>(D);
575     const FunctionDecl *Func = dyn_cast<FunctionDecl>(D);
576     if ((!Var || !isFirstInExternCContext(Var)) &&
577         (!Func || !isFirstInExternCContext(Func)))
578       return LinkageInfo::uniqueExternal();
579   }
580 
581   // Set up the defaults.
582 
583   // C99 6.2.2p5:
584   //   If the declaration of an identifier for an object has file
585   //   scope and no storage-class specifier, its linkage is
586   //   external.
587   LinkageInfo LV;
588 
589   if (!hasExplicitVisibilityAlready(computation)) {
590     if (Optional<Visibility> Vis = getExplicitVisibility(D, computation)) {
591       LV.mergeVisibility(*Vis, true);
592     } else {
593       // If we're declared in a namespace with a visibility attribute,
594       // use that namespace's visibility, and it still counts as explicit.
595       for (const DeclContext *DC = D->getDeclContext();
596            !isa<TranslationUnitDecl>(DC);
597            DC = DC->getParent()) {
598         const NamespaceDecl *ND = dyn_cast<NamespaceDecl>(DC);
599         if (!ND) continue;
600         if (Optional<Visibility> Vis = getExplicitVisibility(ND, computation)) {
601           LV.mergeVisibility(*Vis, true);
602           break;
603         }
604       }
605     }
606 
607     // Add in global settings if the above didn't give us direct visibility.
608     if (!LV.isVisibilityExplicit()) {
609       // Use global type/value visibility as appropriate.
610       Visibility globalVisibility;
611       if (computation == LVForValue) {
612         globalVisibility = Context.getLangOpts().getValueVisibilityMode();
613       } else {
614         assert(computation == LVForType);
615         globalVisibility = Context.getLangOpts().getTypeVisibilityMode();
616       }
617       LV.mergeVisibility(globalVisibility, /*explicit*/ false);
618 
619       // If we're paying attention to global visibility, apply
620       // -finline-visibility-hidden if this is an inline method.
621       if (useInlineVisibilityHidden(D))
622         LV.mergeVisibility(HiddenVisibility, true);
623     }
624   }
625 
626   // C++ [basic.link]p4:
627 
628   //   A name having namespace scope has external linkage if it is the
629   //   name of
630   //
631   //     - an object or reference, unless it has internal linkage; or
632   if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
633     // GCC applies the following optimization to variables and static
634     // data members, but not to functions:
635     //
636     // Modify the variable's LV by the LV of its type unless this is
637     // C or extern "C".  This follows from [basic.link]p9:
638     //   A type without linkage shall not be used as the type of a
639     //   variable or function with external linkage unless
640     //    - the entity has C language linkage, or
641     //    - the entity is declared within an unnamed namespace, or
642     //    - the entity is not used or is defined in the same
643     //      translation unit.
644     // and [basic.link]p10:
645     //   ...the types specified by all declarations referring to a
646     //   given variable or function shall be identical...
647     // C does not have an equivalent rule.
648     //
649     // Ignore this if we've got an explicit attribute;  the user
650     // probably knows what they're doing.
651     //
652     // Note that we don't want to make the variable non-external
653     // because of this, but unique-external linkage suits us.
654     if (Context.getLangOpts().CPlusPlus && !isFirstInExternCContext(Var)) {
655       LinkageInfo TypeLV = getLVForType(*Var->getType(), computation);
656       if (TypeLV.getLinkage() != ExternalLinkage)
657         return LinkageInfo::uniqueExternal();
658       if (!LV.isVisibilityExplicit())
659         LV.mergeVisibility(TypeLV);
660     }
661 
662     if (Var->getStorageClass() == SC_PrivateExtern)
663       LV.mergeVisibility(HiddenVisibility, true);
664 
665     // Note that Sema::MergeVarDecl already takes care of implementing
666     // C99 6.2.2p4 and propagating the visibility attribute, so we don't have
667     // to do it here.
668 
669   //     - a function, unless it has internal linkage; or
670   } else if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
671     // In theory, we can modify the function's LV by the LV of its
672     // type unless it has C linkage (see comment above about variables
673     // for justification).  In practice, GCC doesn't do this, so it's
674     // just too painful to make work.
675 
676     if (Function->getStorageClass() == SC_PrivateExtern)
677       LV.mergeVisibility(HiddenVisibility, true);
678 
679     // Note that Sema::MergeCompatibleFunctionDecls already takes care of
680     // merging storage classes and visibility attributes, so we don't have to
681     // look at previous decls in here.
682 
683     // In C++, then if the type of the function uses a type with
684     // unique-external linkage, it's not legally usable from outside
685     // this translation unit.  However, we should use the C linkage
686     // rules instead for extern "C" declarations.
687     if (Context.getLangOpts().CPlusPlus &&
688         !Function->isInExternCContext()) {
689       // Only look at the type-as-written. If this function has an auto-deduced
690       // return type, we can't compute the linkage of that type because it could
691       // require looking at the linkage of this function, and we don't need this
692       // for correctness because the type is not part of the function's
693       // signature.
694       // FIXME: This is a hack. We should be able to solve this circularity and
695       // the one in getLVForClassMember for Functions some other way.
696       QualType TypeAsWritten = Function->getType();
697       if (TypeSourceInfo *TSI = Function->getTypeSourceInfo())
698         TypeAsWritten = TSI->getType();
699       if (TypeAsWritten->getLinkage() == UniqueExternalLinkage)
700         return LinkageInfo::uniqueExternal();
701     }
702 
703     // Consider LV from the template and the template arguments.
704     // We're at file scope, so we do not need to worry about nested
705     // specializations.
706     if (FunctionTemplateSpecializationInfo *specInfo
707                                = Function->getTemplateSpecializationInfo()) {
708       mergeTemplateLV(LV, Function, specInfo, computation);
709     }
710 
711   //     - a named class (Clause 9), or an unnamed class defined in a
712   //       typedef declaration in which the class has the typedef name
713   //       for linkage purposes (7.1.3); or
714   //     - a named enumeration (7.2), or an unnamed enumeration
715   //       defined in a typedef declaration in which the enumeration
716   //       has the typedef name for linkage purposes (7.1.3); or
717   } else if (const TagDecl *Tag = dyn_cast<TagDecl>(D)) {
718     // Unnamed tags have no linkage.
719     if (!Tag->hasNameForLinkage())
720       return LinkageInfo::none();
721 
722     // If this is a class template specialization, consider the
723     // linkage of the template and template arguments.  We're at file
724     // scope, so we do not need to worry about nested specializations.
725     if (const ClassTemplateSpecializationDecl *spec
726           = dyn_cast<ClassTemplateSpecializationDecl>(Tag)) {
727       mergeTemplateLV(LV, spec, computation);
728     }
729 
730   //     - an enumerator belonging to an enumeration with external linkage;
731   } else if (isa<EnumConstantDecl>(D)) {
732     LinkageInfo EnumLV = getLVForDecl(cast<NamedDecl>(D->getDeclContext()),
733                                       computation);
734     if (!isExternalFormalLinkage(EnumLV.getLinkage()))
735       return LinkageInfo::none();
736     LV.merge(EnumLV);
737 
738   //     - a template, unless it is a function template that has
739   //       internal linkage (Clause 14);
740   } else if (const TemplateDecl *temp = dyn_cast<TemplateDecl>(D)) {
741     bool considerVisibility = !hasExplicitVisibilityAlready(computation);
742     LinkageInfo tempLV =
743       getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
744     LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
745 
746   //     - a namespace (7.3), unless it is declared within an unnamed
747   //       namespace.
748   } else if (isa<NamespaceDecl>(D) && !D->isInAnonymousNamespace()) {
749     return LV;
750 
751   // By extension, we assign external linkage to Objective-C
752   // interfaces.
753   } else if (isa<ObjCInterfaceDecl>(D)) {
754     // fallout
755 
756   // Everything not covered here has no linkage.
757   } else {
758     return LinkageInfo::none();
759   }
760 
761   // If we ended up with non-external linkage, visibility should
762   // always be default.
763   if (LV.getLinkage() != ExternalLinkage)
764     return LinkageInfo(LV.getLinkage(), DefaultVisibility, false);
765 
766   return LV;
767 }
768 
769 static LinkageInfo getLVForClassMember(const NamedDecl *D,
770                                        LVComputationKind computation) {
771   // Only certain class members have linkage.  Note that fields don't
772   // really have linkage, but it's convenient to say they do for the
773   // purposes of calculating linkage of pointer-to-data-member
774   // template arguments.
775   //
776   // Templates also don't officially have linkage, but since we ignore
777   // the C++ standard and look at template arguments when determining
778   // linkage and visibility of a template specialization, we might hit
779   // a template template argument that way. If we do, we need to
780   // consider its linkage.
781   if (!(isa<CXXMethodDecl>(D) ||
782         isa<VarDecl>(D) ||
783         isa<FieldDecl>(D) ||
784         isa<IndirectFieldDecl>(D) ||
785         isa<TagDecl>(D) ||
786         isa<TemplateDecl>(D)))
787     return LinkageInfo::none();
788 
789   LinkageInfo LV;
790 
791   // If we have an explicit visibility attribute, merge that in.
792   if (!hasExplicitVisibilityAlready(computation)) {
793     if (Optional<Visibility> Vis = getExplicitVisibility(D, computation))
794       LV.mergeVisibility(*Vis, true);
795     // If we're paying attention to global visibility, apply
796     // -finline-visibility-hidden if this is an inline method.
797     //
798     // Note that we do this before merging information about
799     // the class visibility.
800     if (!LV.isVisibilityExplicit() && useInlineVisibilityHidden(D))
801       LV.mergeVisibility(HiddenVisibility, true);
802   }
803 
804   // If this class member has an explicit visibility attribute, the only
805   // thing that can change its visibility is the template arguments, so
806   // only look for them when processing the class.
807   LVComputationKind classComputation = computation;
808   if (LV.isVisibilityExplicit())
809     classComputation = withExplicitVisibilityAlready(computation);
810 
811   LinkageInfo classLV =
812     getLVForDecl(cast<RecordDecl>(D->getDeclContext()), classComputation);
813   // If the class already has unique-external linkage, we can't improve.
814   if (classLV.getLinkage() == UniqueExternalLinkage)
815     return LinkageInfo::uniqueExternal();
816 
817   if (!isExternallyVisible(classLV.getLinkage()))
818     return LinkageInfo::none();
819 
820 
821   // Otherwise, don't merge in classLV yet, because in certain cases
822   // we need to completely ignore the visibility from it.
823 
824   // Specifically, if this decl exists and has an explicit attribute.
825   const NamedDecl *explicitSpecSuppressor = 0;
826 
827   if (const CXXMethodDecl *MD = dyn_cast<CXXMethodDecl>(D)) {
828     // If the type of the function uses a type with unique-external
829     // linkage, it's not legally usable from outside this translation unit.
830     // But only look at the type-as-written. If this function has an auto-deduced
831     // return type, we can't compute the linkage of that type because it could
832     // require looking at the linkage of this function, and we don't need this
833     // for correctness because the type is not part of the function's
834     // signature.
835     // FIXME: This is a hack. We should be able to solve this circularity and the
836     // one in getLVForNamespaceScopeDecl for Functions some other way.
837     {
838       QualType TypeAsWritten = MD->getType();
839       if (TypeSourceInfo *TSI = MD->getTypeSourceInfo())
840         TypeAsWritten = TSI->getType();
841       if (TypeAsWritten->getLinkage() == UniqueExternalLinkage)
842         return LinkageInfo::uniqueExternal();
843     }
844     // If this is a method template specialization, use the linkage for
845     // the template parameters and arguments.
846     if (FunctionTemplateSpecializationInfo *spec
847            = MD->getTemplateSpecializationInfo()) {
848       mergeTemplateLV(LV, MD, spec, computation);
849       if (spec->isExplicitSpecialization()) {
850         explicitSpecSuppressor = MD;
851       } else if (isExplicitMemberSpecialization(spec->getTemplate())) {
852         explicitSpecSuppressor = spec->getTemplate()->getTemplatedDecl();
853       }
854     } else if (isExplicitMemberSpecialization(MD)) {
855       explicitSpecSuppressor = MD;
856     }
857 
858   } else if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(D)) {
859     if (const ClassTemplateSpecializationDecl *spec
860         = dyn_cast<ClassTemplateSpecializationDecl>(RD)) {
861       mergeTemplateLV(LV, spec, computation);
862       if (spec->isExplicitSpecialization()) {
863         explicitSpecSuppressor = spec;
864       } else {
865         const ClassTemplateDecl *temp = spec->getSpecializedTemplate();
866         if (isExplicitMemberSpecialization(temp)) {
867           explicitSpecSuppressor = temp->getTemplatedDecl();
868         }
869       }
870     } else if (isExplicitMemberSpecialization(RD)) {
871       explicitSpecSuppressor = RD;
872     }
873 
874   // Static data members.
875   } else if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
876     // Modify the variable's linkage by its type, but ignore the
877     // type's visibility unless it's a definition.
878     LinkageInfo typeLV = getLVForType(*VD->getType(), computation);
879     if (!LV.isVisibilityExplicit() && !classLV.isVisibilityExplicit())
880       LV.mergeVisibility(typeLV);
881     LV.mergeExternalVisibility(typeLV);
882 
883     if (isExplicitMemberSpecialization(VD)) {
884       explicitSpecSuppressor = VD;
885     }
886 
887   // Template members.
888   } else if (const TemplateDecl *temp = dyn_cast<TemplateDecl>(D)) {
889     bool considerVisibility =
890       (!LV.isVisibilityExplicit() &&
891        !classLV.isVisibilityExplicit() &&
892        !hasExplicitVisibilityAlready(computation));
893     LinkageInfo tempLV =
894       getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
895     LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
896 
897     if (const RedeclarableTemplateDecl *redeclTemp =
898           dyn_cast<RedeclarableTemplateDecl>(temp)) {
899       if (isExplicitMemberSpecialization(redeclTemp)) {
900         explicitSpecSuppressor = temp->getTemplatedDecl();
901       }
902     }
903   }
904 
905   // We should never be looking for an attribute directly on a template.
906   assert(!explicitSpecSuppressor || !isa<TemplateDecl>(explicitSpecSuppressor));
907 
908   // If this member is an explicit member specialization, and it has
909   // an explicit attribute, ignore visibility from the parent.
910   bool considerClassVisibility = true;
911   if (explicitSpecSuppressor &&
912       // optimization: hasDVA() is true only with explicit visibility.
913       LV.isVisibilityExplicit() &&
914       classLV.getVisibility() != DefaultVisibility &&
915       hasDirectVisibilityAttribute(explicitSpecSuppressor, computation)) {
916     considerClassVisibility = false;
917   }
918 
919   // Finally, merge in information from the class.
920   LV.mergeMaybeWithVisibility(classLV, considerClassVisibility);
921   return LV;
922 }
923 
924 void NamedDecl::anchor() { }
925 
926 static LinkageInfo computeLVForDecl(const NamedDecl *D,
927                                     LVComputationKind computation);
928 
929 bool NamedDecl::isLinkageValid() const {
930   if (!hasCachedLinkage())
931     return true;
932 
933   return computeLVForDecl(this, LVForLinkageOnly).getLinkage() ==
934          getCachedLinkage();
935 }
936 
937 Linkage NamedDecl::getLinkageInternal() const {
938   // We don't care about visibility here, so ask for the cheapest
939   // possible visibility analysis.
940   return getLVForDecl(this, LVForLinkageOnly).getLinkage();
941 }
942 
943 LinkageInfo NamedDecl::getLinkageAndVisibility() const {
944   LVComputationKind computation =
945     (usesTypeVisibility(this) ? LVForType : LVForValue);
946   return getLVForDecl(this, computation);
947 }
948 
949 static Optional<Visibility>
950 getExplicitVisibilityAux(const NamedDecl *ND,
951                          NamedDecl::ExplicitVisibilityKind kind,
952                          bool IsMostRecent) {
953   assert(!IsMostRecent || ND == ND->getMostRecentDecl());
954 
955   // Check the declaration itself first.
956   if (Optional<Visibility> V = getVisibilityOf(ND, kind))
957     return V;
958 
959   // If this is a member class of a specialization of a class template
960   // and the corresponding decl has explicit visibility, use that.
961   if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(ND)) {
962     CXXRecordDecl *InstantiatedFrom = RD->getInstantiatedFromMemberClass();
963     if (InstantiatedFrom)
964       return getVisibilityOf(InstantiatedFrom, kind);
965   }
966 
967   // If there wasn't explicit visibility there, and this is a
968   // specialization of a class template, check for visibility
969   // on the pattern.
970   if (const ClassTemplateSpecializationDecl *spec
971         = dyn_cast<ClassTemplateSpecializationDecl>(ND))
972     return getVisibilityOf(spec->getSpecializedTemplate()->getTemplatedDecl(),
973                            kind);
974 
975   // Use the most recent declaration.
976   if (!IsMostRecent && !isa<NamespaceDecl>(ND)) {
977     const NamedDecl *MostRecent = ND->getMostRecentDecl();
978     if (MostRecent != ND)
979       return getExplicitVisibilityAux(MostRecent, kind, true);
980   }
981 
982   if (const VarDecl *Var = dyn_cast<VarDecl>(ND)) {
983     if (Var->isStaticDataMember()) {
984       VarDecl *InstantiatedFrom = Var->getInstantiatedFromStaticDataMember();
985       if (InstantiatedFrom)
986         return getVisibilityOf(InstantiatedFrom, kind);
987     }
988 
989     return None;
990   }
991   // Also handle function template specializations.
992   if (const FunctionDecl *fn = dyn_cast<FunctionDecl>(ND)) {
993     // If the function is a specialization of a template with an
994     // explicit visibility attribute, use that.
995     if (FunctionTemplateSpecializationInfo *templateInfo
996           = fn->getTemplateSpecializationInfo())
997       return getVisibilityOf(templateInfo->getTemplate()->getTemplatedDecl(),
998                              kind);
999 
1000     // If the function is a member of a specialization of a class template
1001     // and the corresponding decl has explicit visibility, use that.
1002     FunctionDecl *InstantiatedFrom = fn->getInstantiatedFromMemberFunction();
1003     if (InstantiatedFrom)
1004       return getVisibilityOf(InstantiatedFrom, kind);
1005 
1006     return None;
1007   }
1008 
1009   // The visibility of a template is stored in the templated decl.
1010   if (const TemplateDecl *TD = dyn_cast<TemplateDecl>(ND))
1011     return getVisibilityOf(TD->getTemplatedDecl(), kind);
1012 
1013   return None;
1014 }
1015 
1016 Optional<Visibility>
1017 NamedDecl::getExplicitVisibility(ExplicitVisibilityKind kind) const {
1018   return getExplicitVisibilityAux(this, kind, false);
1019 }
1020 
1021 static LinkageInfo getLVForClosure(const DeclContext *DC, Decl *ContextDecl,
1022                                    LVComputationKind computation) {
1023   // This lambda has its linkage/visibility determined by its owner.
1024   if (ContextDecl) {
1025     if (isa<ParmVarDecl>(ContextDecl))
1026       DC = ContextDecl->getDeclContext()->getRedeclContext();
1027     else
1028       return getLVForDecl(cast<NamedDecl>(ContextDecl), computation);
1029   }
1030 
1031   if (const NamedDecl *ND = dyn_cast<NamedDecl>(DC))
1032     return getLVForDecl(ND, computation);
1033 
1034   return LinkageInfo::external();
1035 }
1036 
1037 static LinkageInfo getLVForLocalDecl(const NamedDecl *D,
1038                                      LVComputationKind computation) {
1039   if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
1040     if (Function->isInAnonymousNamespace() &&
1041         !Function->isInExternCContext())
1042       return LinkageInfo::uniqueExternal();
1043 
1044     // This is a "void f();" which got merged with a file static.
1045     if (Function->getCanonicalDecl()->getStorageClass() == SC_Static)
1046       return LinkageInfo::internal();
1047 
1048     LinkageInfo LV;
1049     if (!hasExplicitVisibilityAlready(computation)) {
1050       if (Optional<Visibility> Vis =
1051               getExplicitVisibility(Function, computation))
1052         LV.mergeVisibility(*Vis, true);
1053     }
1054 
1055     // Note that Sema::MergeCompatibleFunctionDecls already takes care of
1056     // merging storage classes and visibility attributes, so we don't have to
1057     // look at previous decls in here.
1058 
1059     return LV;
1060   }
1061 
1062   if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
1063     if (Var->hasExternalStorage()) {
1064       if (Var->isInAnonymousNamespace() && !Var->isInExternCContext())
1065         return LinkageInfo::uniqueExternal();
1066 
1067       LinkageInfo LV;
1068       if (Var->getStorageClass() == SC_PrivateExtern)
1069         LV.mergeVisibility(HiddenVisibility, true);
1070       else if (!hasExplicitVisibilityAlready(computation)) {
1071         if (Optional<Visibility> Vis = getExplicitVisibility(Var, computation))
1072           LV.mergeVisibility(*Vis, true);
1073       }
1074 
1075       if (const VarDecl *Prev = Var->getPreviousDecl()) {
1076         LinkageInfo PrevLV = getLVForDecl(Prev, computation);
1077         if (PrevLV.getLinkage())
1078           LV.setLinkage(PrevLV.getLinkage());
1079         LV.mergeVisibility(PrevLV);
1080       }
1081 
1082       return LV;
1083     }
1084 
1085     if (!Var->isStaticLocal())
1086       return LinkageInfo::none();
1087   }
1088 
1089   ASTContext &Context = D->getASTContext();
1090   if (!Context.getLangOpts().CPlusPlus)
1091     return LinkageInfo::none();
1092 
1093   const Decl *OuterD = getOutermostFuncOrBlockContext(D);
1094   if (!OuterD)
1095     return LinkageInfo::none();
1096 
1097   LinkageInfo LV;
1098   if (const BlockDecl *BD = dyn_cast<BlockDecl>(OuterD)) {
1099     if (!BD->getBlockManglingNumber())
1100       return LinkageInfo::none();
1101 
1102     LV = getLVForClosure(BD->getDeclContext()->getRedeclContext(),
1103                          BD->getBlockManglingContextDecl(), computation);
1104   } else {
1105     const FunctionDecl *FD = cast<FunctionDecl>(OuterD);
1106     if (!FD->isInlined() &&
1107         FD->getTemplateSpecializationKind() == TSK_Undeclared)
1108       return LinkageInfo::none();
1109 
1110     LV = getLVForDecl(FD, computation);
1111   }
1112   if (!isExternallyVisible(LV.getLinkage()))
1113     return LinkageInfo::none();
1114   return LinkageInfo(VisibleNoLinkage, LV.getVisibility(),
1115                      LV.isVisibilityExplicit());
1116 }
1117 
1118 static inline const CXXRecordDecl*
1119 getOutermostEnclosingLambda(const CXXRecordDecl *Record) {
1120   const CXXRecordDecl *Ret = Record;
1121   while (Record && Record->isLambda()) {
1122     Ret = Record;
1123     if (!Record->getParent()) break;
1124     // Get the Containing Class of this Lambda Class
1125     Record = dyn_cast_or_null<CXXRecordDecl>(
1126       Record->getParent()->getParent());
1127   }
1128   return Ret;
1129 }
1130 
1131 static LinkageInfo computeLVForDecl(const NamedDecl *D,
1132                                     LVComputationKind computation) {
1133   // Objective-C: treat all Objective-C declarations as having external
1134   // linkage.
1135   switch (D->getKind()) {
1136     default:
1137       break;
1138     case Decl::ParmVar:
1139       return LinkageInfo::none();
1140     case Decl::TemplateTemplateParm: // count these as external
1141     case Decl::NonTypeTemplateParm:
1142     case Decl::ObjCAtDefsField:
1143     case Decl::ObjCCategory:
1144     case Decl::ObjCCategoryImpl:
1145     case Decl::ObjCCompatibleAlias:
1146     case Decl::ObjCImplementation:
1147     case Decl::ObjCMethod:
1148     case Decl::ObjCProperty:
1149     case Decl::ObjCPropertyImpl:
1150     case Decl::ObjCProtocol:
1151       return LinkageInfo::external();
1152 
1153     case Decl::CXXRecord: {
1154       const CXXRecordDecl *Record = cast<CXXRecordDecl>(D);
1155       if (Record->isLambda()) {
1156         if (!Record->getLambdaManglingNumber()) {
1157           // This lambda has no mangling number, so it's internal.
1158           return LinkageInfo::internal();
1159         }
1160 
1161         // This lambda has its linkage/visibility determined:
1162         //  - either by the outermost lambda if that lambda has no mangling
1163         //    number.
1164         //  - or by the parent of the outer most lambda
1165         // This prevents infinite recursion in settings such as nested lambdas
1166         // used in NSDMI's, for e.g.
1167         //  struct L {
1168         //    int t{};
1169         //    int t2 = ([](int a) { return [](int b) { return b; };})(t)(t);
1170         //  };
1171         const CXXRecordDecl *OuterMostLambda =
1172             getOutermostEnclosingLambda(Record);
1173         if (!OuterMostLambda->getLambdaManglingNumber())
1174           return LinkageInfo::internal();
1175 
1176         return getLVForClosure(
1177                   OuterMostLambda->getDeclContext()->getRedeclContext(),
1178                   OuterMostLambda->getLambdaContextDecl(), computation);
1179       }
1180 
1181       break;
1182     }
1183   }
1184 
1185   // Handle linkage for namespace-scope names.
1186   if (D->getDeclContext()->getRedeclContext()->isFileContext())
1187     return getLVForNamespaceScopeDecl(D, computation);
1188 
1189   // C++ [basic.link]p5:
1190   //   In addition, a member function, static data member, a named
1191   //   class or enumeration of class scope, or an unnamed class or
1192   //   enumeration defined in a class-scope typedef declaration such
1193   //   that the class or enumeration has the typedef name for linkage
1194   //   purposes (7.1.3), has external linkage if the name of the class
1195   //   has external linkage.
1196   if (D->getDeclContext()->isRecord())
1197     return getLVForClassMember(D, computation);
1198 
1199   // C++ [basic.link]p6:
1200   //   The name of a function declared in block scope and the name of
1201   //   an object declared by a block scope extern declaration have
1202   //   linkage. If there is a visible declaration of an entity with
1203   //   linkage having the same name and type, ignoring entities
1204   //   declared outside the innermost enclosing namespace scope, the
1205   //   block scope declaration declares that same entity and receives
1206   //   the linkage of the previous declaration. If there is more than
1207   //   one such matching entity, the program is ill-formed. Otherwise,
1208   //   if no matching entity is found, the block scope entity receives
1209   //   external linkage.
1210   if (D->getDeclContext()->isFunctionOrMethod())
1211     return getLVForLocalDecl(D, computation);
1212 
1213   // C++ [basic.link]p6:
1214   //   Names not covered by these rules have no linkage.
1215   return LinkageInfo::none();
1216 }
1217 
1218 namespace clang {
1219 class LinkageComputer {
1220 public:
1221   static LinkageInfo getLVForDecl(const NamedDecl *D,
1222                                   LVComputationKind computation) {
1223     if (computation == LVForLinkageOnly && D->hasCachedLinkage())
1224       return LinkageInfo(D->getCachedLinkage(), DefaultVisibility, false);
1225 
1226     LinkageInfo LV = computeLVForDecl(D, computation);
1227     if (D->hasCachedLinkage())
1228       assert(D->getCachedLinkage() == LV.getLinkage());
1229 
1230     D->setCachedLinkage(LV.getLinkage());
1231 
1232 #ifndef NDEBUG
1233     // In C (because of gnu inline) and in c++ with microsoft extensions an
1234     // static can follow an extern, so we can have two decls with different
1235     // linkages.
1236     const LangOptions &Opts = D->getASTContext().getLangOpts();
1237     if (!Opts.CPlusPlus || Opts.MicrosoftExt)
1238       return LV;
1239 
1240     // We have just computed the linkage for this decl. By induction we know
1241     // that all other computed linkages match, check that the one we just
1242     // computed also does.
1243     NamedDecl *Old = NULL;
1244     for (auto I : D->redecls()) {
1245       NamedDecl *T = cast<NamedDecl>(I);
1246       if (T == D)
1247         continue;
1248       if (!T->isInvalidDecl() && T->hasCachedLinkage()) {
1249         Old = T;
1250         break;
1251       }
1252     }
1253     assert(!Old || Old->getCachedLinkage() == D->getCachedLinkage());
1254 #endif
1255 
1256     return LV;
1257   }
1258 };
1259 }
1260 
1261 static LinkageInfo getLVForDecl(const NamedDecl *D,
1262                                 LVComputationKind computation) {
1263   return clang::LinkageComputer::getLVForDecl(D, computation);
1264 }
1265 
1266 std::string NamedDecl::getQualifiedNameAsString() const {
1267   std::string QualName;
1268   llvm::raw_string_ostream OS(QualName);
1269   printQualifiedName(OS, getASTContext().getPrintingPolicy());
1270   return OS.str();
1271 }
1272 
1273 void NamedDecl::printQualifiedName(raw_ostream &OS) const {
1274   printQualifiedName(OS, getASTContext().getPrintingPolicy());
1275 }
1276 
1277 void NamedDecl::printQualifiedName(raw_ostream &OS,
1278                                    const PrintingPolicy &P) const {
1279   const DeclContext *Ctx = getDeclContext();
1280 
1281   if (Ctx->isFunctionOrMethod()) {
1282     printName(OS);
1283     return;
1284   }
1285 
1286   typedef SmallVector<const DeclContext *, 8> ContextsTy;
1287   ContextsTy Contexts;
1288 
1289   // Collect contexts.
1290   while (Ctx && isa<NamedDecl>(Ctx)) {
1291     Contexts.push_back(Ctx);
1292     Ctx = Ctx->getParent();
1293   }
1294 
1295   for (ContextsTy::reverse_iterator I = Contexts.rbegin(), E = Contexts.rend();
1296        I != E; ++I) {
1297     if (const ClassTemplateSpecializationDecl *Spec
1298           = dyn_cast<ClassTemplateSpecializationDecl>(*I)) {
1299       OS << Spec->getName();
1300       const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
1301       TemplateSpecializationType::PrintTemplateArgumentList(OS,
1302                                                             TemplateArgs.data(),
1303                                                             TemplateArgs.size(),
1304                                                             P);
1305     } else if (const NamespaceDecl *ND = dyn_cast<NamespaceDecl>(*I)) {
1306       if (ND->isAnonymousNamespace())
1307         OS << "(anonymous namespace)";
1308       else
1309         OS << *ND;
1310     } else if (const RecordDecl *RD = dyn_cast<RecordDecl>(*I)) {
1311       if (!RD->getIdentifier())
1312         OS << "(anonymous " << RD->getKindName() << ')';
1313       else
1314         OS << *RD;
1315     } else if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
1316       const FunctionProtoType *FT = 0;
1317       if (FD->hasWrittenPrototype())
1318         FT = dyn_cast<FunctionProtoType>(FD->getType()->castAs<FunctionType>());
1319 
1320       OS << *FD << '(';
1321       if (FT) {
1322         unsigned NumParams = FD->getNumParams();
1323         for (unsigned i = 0; i < NumParams; ++i) {
1324           if (i)
1325             OS << ", ";
1326           OS << FD->getParamDecl(i)->getType().stream(P);
1327         }
1328 
1329         if (FT->isVariadic()) {
1330           if (NumParams > 0)
1331             OS << ", ";
1332           OS << "...";
1333         }
1334       }
1335       OS << ')';
1336     } else {
1337       OS << *cast<NamedDecl>(*I);
1338     }
1339     OS << "::";
1340   }
1341 
1342   if (getDeclName())
1343     OS << *this;
1344   else
1345     OS << "(anonymous)";
1346 }
1347 
1348 void NamedDecl::getNameForDiagnostic(raw_ostream &OS,
1349                                      const PrintingPolicy &Policy,
1350                                      bool Qualified) const {
1351   if (Qualified)
1352     printQualifiedName(OS, Policy);
1353   else
1354     printName(OS);
1355 }
1356 
1357 bool NamedDecl::declarationReplaces(NamedDecl *OldD) const {
1358   assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
1359 
1360   // UsingDirectiveDecl's are not really NamedDecl's, and all have same name.
1361   // We want to keep it, unless it nominates same namespace.
1362   if (getKind() == Decl::UsingDirective) {
1363     return cast<UsingDirectiveDecl>(this)->getNominatedNamespace()
1364              ->getOriginalNamespace() ==
1365            cast<UsingDirectiveDecl>(OldD)->getNominatedNamespace()
1366              ->getOriginalNamespace();
1367   }
1368 
1369   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(this))
1370     // For function declarations, we keep track of redeclarations.
1371     return FD->getPreviousDecl() == OldD;
1372 
1373   // For function templates, the underlying function declarations are linked.
1374   if (const FunctionTemplateDecl *FunctionTemplate
1375         = dyn_cast<FunctionTemplateDecl>(this))
1376     if (const FunctionTemplateDecl *OldFunctionTemplate
1377           = dyn_cast<FunctionTemplateDecl>(OldD))
1378       return FunctionTemplate->getTemplatedDecl()
1379                ->declarationReplaces(OldFunctionTemplate->getTemplatedDecl());
1380 
1381   // For method declarations, we keep track of redeclarations.
1382   if (isa<ObjCMethodDecl>(this))
1383     return false;
1384 
1385   // FIXME: Is this correct if one of the decls comes from an inline namespace?
1386   if (isa<ObjCInterfaceDecl>(this) && isa<ObjCCompatibleAliasDecl>(OldD))
1387     return true;
1388 
1389   if (isa<UsingShadowDecl>(this) && isa<UsingShadowDecl>(OldD))
1390     return cast<UsingShadowDecl>(this)->getTargetDecl() ==
1391            cast<UsingShadowDecl>(OldD)->getTargetDecl();
1392 
1393   if (isa<UsingDecl>(this) && isa<UsingDecl>(OldD)) {
1394     ASTContext &Context = getASTContext();
1395     return Context.getCanonicalNestedNameSpecifier(
1396                                      cast<UsingDecl>(this)->getQualifier()) ==
1397            Context.getCanonicalNestedNameSpecifier(
1398                                         cast<UsingDecl>(OldD)->getQualifier());
1399   }
1400 
1401   if (isa<UnresolvedUsingValueDecl>(this) &&
1402       isa<UnresolvedUsingValueDecl>(OldD)) {
1403     ASTContext &Context = getASTContext();
1404     return Context.getCanonicalNestedNameSpecifier(
1405                       cast<UnresolvedUsingValueDecl>(this)->getQualifier()) ==
1406            Context.getCanonicalNestedNameSpecifier(
1407                         cast<UnresolvedUsingValueDecl>(OldD)->getQualifier());
1408   }
1409 
1410   // A typedef of an Objective-C class type can replace an Objective-C class
1411   // declaration or definition, and vice versa.
1412   // FIXME: Is this correct if one of the decls comes from an inline namespace?
1413   if ((isa<TypedefNameDecl>(this) && isa<ObjCInterfaceDecl>(OldD)) ||
1414       (isa<ObjCInterfaceDecl>(this) && isa<TypedefNameDecl>(OldD)))
1415     return true;
1416 
1417   // For non-function declarations, if the declarations are of the
1418   // same kind and have the same parent then this must be a redeclaration,
1419   // or semantic analysis would not have given us the new declaration.
1420   // Note that inline namespaces can give us two declarations with the same
1421   // name and kind in the same scope but different contexts.
1422   return this->getKind() == OldD->getKind() &&
1423          this->getDeclContext()->getRedeclContext()->Equals(
1424              OldD->getDeclContext()->getRedeclContext());
1425 }
1426 
1427 bool NamedDecl::hasLinkage() const {
1428   return getFormalLinkage() != NoLinkage;
1429 }
1430 
1431 NamedDecl *NamedDecl::getUnderlyingDeclImpl() {
1432   NamedDecl *ND = this;
1433   while (UsingShadowDecl *UD = dyn_cast<UsingShadowDecl>(ND))
1434     ND = UD->getTargetDecl();
1435 
1436   if (ObjCCompatibleAliasDecl *AD = dyn_cast<ObjCCompatibleAliasDecl>(ND))
1437     return AD->getClassInterface();
1438 
1439   return ND;
1440 }
1441 
1442 bool NamedDecl::isCXXInstanceMember() const {
1443   if (!isCXXClassMember())
1444     return false;
1445 
1446   const NamedDecl *D = this;
1447   if (isa<UsingShadowDecl>(D))
1448     D = cast<UsingShadowDecl>(D)->getTargetDecl();
1449 
1450   if (isa<FieldDecl>(D) || isa<IndirectFieldDecl>(D) || isa<MSPropertyDecl>(D))
1451     return true;
1452   if (const CXXMethodDecl *MD =
1453           dyn_cast_or_null<CXXMethodDecl>(D->getAsFunction()))
1454     return MD->isInstance();
1455   return false;
1456 }
1457 
1458 //===----------------------------------------------------------------------===//
1459 // DeclaratorDecl Implementation
1460 //===----------------------------------------------------------------------===//
1461 
1462 template <typename DeclT>
1463 static SourceLocation getTemplateOrInnerLocStart(const DeclT *decl) {
1464   if (decl->getNumTemplateParameterLists() > 0)
1465     return decl->getTemplateParameterList(0)->getTemplateLoc();
1466   else
1467     return decl->getInnerLocStart();
1468 }
1469 
1470 SourceLocation DeclaratorDecl::getTypeSpecStartLoc() const {
1471   TypeSourceInfo *TSI = getTypeSourceInfo();
1472   if (TSI) return TSI->getTypeLoc().getBeginLoc();
1473   return SourceLocation();
1474 }
1475 
1476 void DeclaratorDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
1477   if (QualifierLoc) {
1478     // Make sure the extended decl info is allocated.
1479     if (!hasExtInfo()) {
1480       // Save (non-extended) type source info pointer.
1481       TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
1482       // Allocate external info struct.
1483       DeclInfo = new (getASTContext()) ExtInfo;
1484       // Restore savedTInfo into (extended) decl info.
1485       getExtInfo()->TInfo = savedTInfo;
1486     }
1487     // Set qualifier info.
1488     getExtInfo()->QualifierLoc = QualifierLoc;
1489   } else {
1490     // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
1491     if (hasExtInfo()) {
1492       if (getExtInfo()->NumTemplParamLists == 0) {
1493         // Save type source info pointer.
1494         TypeSourceInfo *savedTInfo = getExtInfo()->TInfo;
1495         // Deallocate the extended decl info.
1496         getASTContext().Deallocate(getExtInfo());
1497         // Restore savedTInfo into (non-extended) decl info.
1498         DeclInfo = savedTInfo;
1499       }
1500       else
1501         getExtInfo()->QualifierLoc = QualifierLoc;
1502     }
1503   }
1504 }
1505 
1506 void
1507 DeclaratorDecl::setTemplateParameterListsInfo(ASTContext &Context,
1508                                               unsigned NumTPLists,
1509                                               TemplateParameterList **TPLists) {
1510   assert(NumTPLists > 0);
1511   // Make sure the extended decl info is allocated.
1512   if (!hasExtInfo()) {
1513     // Save (non-extended) type source info pointer.
1514     TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
1515     // Allocate external info struct.
1516     DeclInfo = new (getASTContext()) ExtInfo;
1517     // Restore savedTInfo into (extended) decl info.
1518     getExtInfo()->TInfo = savedTInfo;
1519   }
1520   // Set the template parameter lists info.
1521   getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
1522 }
1523 
1524 SourceLocation DeclaratorDecl::getOuterLocStart() const {
1525   return getTemplateOrInnerLocStart(this);
1526 }
1527 
1528 namespace {
1529 
1530 // Helper function: returns true if QT is or contains a type
1531 // having a postfix component.
1532 bool typeIsPostfix(clang::QualType QT) {
1533   while (true) {
1534     const Type* T = QT.getTypePtr();
1535     switch (T->getTypeClass()) {
1536     default:
1537       return false;
1538     case Type::Pointer:
1539       QT = cast<PointerType>(T)->getPointeeType();
1540       break;
1541     case Type::BlockPointer:
1542       QT = cast<BlockPointerType>(T)->getPointeeType();
1543       break;
1544     case Type::MemberPointer:
1545       QT = cast<MemberPointerType>(T)->getPointeeType();
1546       break;
1547     case Type::LValueReference:
1548     case Type::RValueReference:
1549       QT = cast<ReferenceType>(T)->getPointeeType();
1550       break;
1551     case Type::PackExpansion:
1552       QT = cast<PackExpansionType>(T)->getPattern();
1553       break;
1554     case Type::Paren:
1555     case Type::ConstantArray:
1556     case Type::DependentSizedArray:
1557     case Type::IncompleteArray:
1558     case Type::VariableArray:
1559     case Type::FunctionProto:
1560     case Type::FunctionNoProto:
1561       return true;
1562     }
1563   }
1564 }
1565 
1566 } // namespace
1567 
1568 SourceRange DeclaratorDecl::getSourceRange() const {
1569   SourceLocation RangeEnd = getLocation();
1570   if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
1571     // If the declaration has no name or the type extends past the name take the
1572     // end location of the type.
1573     if (!getDeclName() || typeIsPostfix(TInfo->getType()))
1574       RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
1575   }
1576   return SourceRange(getOuterLocStart(), RangeEnd);
1577 }
1578 
1579 void
1580 QualifierInfo::setTemplateParameterListsInfo(ASTContext &Context,
1581                                              unsigned NumTPLists,
1582                                              TemplateParameterList **TPLists) {
1583   assert((NumTPLists == 0 || TPLists != 0) &&
1584          "Empty array of template parameters with positive size!");
1585 
1586   // Free previous template parameters (if any).
1587   if (NumTemplParamLists > 0) {
1588     Context.Deallocate(TemplParamLists);
1589     TemplParamLists = 0;
1590     NumTemplParamLists = 0;
1591   }
1592   // Set info on matched template parameter lists (if any).
1593   if (NumTPLists > 0) {
1594     TemplParamLists = new (Context) TemplateParameterList*[NumTPLists];
1595     NumTemplParamLists = NumTPLists;
1596     for (unsigned i = NumTPLists; i-- > 0; )
1597       TemplParamLists[i] = TPLists[i];
1598   }
1599 }
1600 
1601 //===----------------------------------------------------------------------===//
1602 // VarDecl Implementation
1603 //===----------------------------------------------------------------------===//
1604 
1605 const char *VarDecl::getStorageClassSpecifierString(StorageClass SC) {
1606   switch (SC) {
1607   case SC_None:                 break;
1608   case SC_Auto:                 return "auto";
1609   case SC_Extern:               return "extern";
1610   case SC_OpenCLWorkGroupLocal: return "<<work-group-local>>";
1611   case SC_PrivateExtern:        return "__private_extern__";
1612   case SC_Register:             return "register";
1613   case SC_Static:               return "static";
1614   }
1615 
1616   llvm_unreachable("Invalid storage class");
1617 }
1618 
1619 VarDecl::VarDecl(Kind DK, DeclContext *DC, SourceLocation StartLoc,
1620                  SourceLocation IdLoc, IdentifierInfo *Id, QualType T,
1621                  TypeSourceInfo *TInfo, StorageClass SC)
1622     : DeclaratorDecl(DK, DC, IdLoc, Id, T, TInfo, StartLoc), Init() {
1623   static_assert(sizeof(VarDeclBitfields) <= sizeof(unsigned),
1624                 "VarDeclBitfields too large!");
1625   static_assert(sizeof(ParmVarDeclBitfields) <= sizeof(unsigned),
1626                 "ParmVarDeclBitfields too large!");
1627   AllBits = 0;
1628   VarDeclBits.SClass = SC;
1629   // Everything else is implicitly initialized to false.
1630 }
1631 
1632 VarDecl *VarDecl::Create(ASTContext &C, DeclContext *DC,
1633                          SourceLocation StartL, SourceLocation IdL,
1634                          IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
1635                          StorageClass S) {
1636   return new (C, DC) VarDecl(Var, DC, StartL, IdL, Id, T, TInfo, S);
1637 }
1638 
1639 VarDecl *VarDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
1640   return new (C, ID) VarDecl(Var, 0, SourceLocation(), SourceLocation(), 0,
1641                              QualType(), 0, SC_None);
1642 }
1643 
1644 void VarDecl::setStorageClass(StorageClass SC) {
1645   assert(isLegalForVariable(SC));
1646   VarDeclBits.SClass = SC;
1647 }
1648 
1649 SourceRange VarDecl::getSourceRange() const {
1650   if (const Expr *Init = getInit()) {
1651     SourceLocation InitEnd = Init->getLocEnd();
1652     // If Init is implicit, ignore its source range and fallback on
1653     // DeclaratorDecl::getSourceRange() to handle postfix elements.
1654     if (InitEnd.isValid() && InitEnd != getLocation())
1655       return SourceRange(getOuterLocStart(), InitEnd);
1656   }
1657   return DeclaratorDecl::getSourceRange();
1658 }
1659 
1660 template<typename T>
1661 static LanguageLinkage getLanguageLinkageTemplate(const T &D) {
1662   // C++ [dcl.link]p1: All function types, function names with external linkage,
1663   // and variable names with external linkage have a language linkage.
1664   if (!D.hasExternalFormalLinkage())
1665     return NoLanguageLinkage;
1666 
1667   // Language linkage is a C++ concept, but saying that everything else in C has
1668   // C language linkage fits the implementation nicely.
1669   ASTContext &Context = D.getASTContext();
1670   if (!Context.getLangOpts().CPlusPlus)
1671     return CLanguageLinkage;
1672 
1673   // C++ [dcl.link]p4: A C language linkage is ignored in determining the
1674   // language linkage of the names of class members and the function type of
1675   // class member functions.
1676   const DeclContext *DC = D.getDeclContext();
1677   if (DC->isRecord())
1678     return CXXLanguageLinkage;
1679 
1680   // If the first decl is in an extern "C" context, any other redeclaration
1681   // will have C language linkage. If the first one is not in an extern "C"
1682   // context, we would have reported an error for any other decl being in one.
1683   if (isFirstInExternCContext(&D))
1684     return CLanguageLinkage;
1685   return CXXLanguageLinkage;
1686 }
1687 
1688 template<typename T>
1689 static bool isExternCTemplate(const T &D) {
1690   // Since the context is ignored for class members, they can only have C++
1691   // language linkage or no language linkage.
1692   const DeclContext *DC = D.getDeclContext();
1693   if (DC->isRecord()) {
1694     assert(D.getASTContext().getLangOpts().CPlusPlus);
1695     return false;
1696   }
1697 
1698   return D.getLanguageLinkage() == CLanguageLinkage;
1699 }
1700 
1701 LanguageLinkage VarDecl::getLanguageLinkage() const {
1702   return getLanguageLinkageTemplate(*this);
1703 }
1704 
1705 bool VarDecl::isExternC() const {
1706   return isExternCTemplate(*this);
1707 }
1708 
1709 bool VarDecl::isInExternCContext() const {
1710   return getLexicalDeclContext()->isExternCContext();
1711 }
1712 
1713 bool VarDecl::isInExternCXXContext() const {
1714   return getLexicalDeclContext()->isExternCXXContext();
1715 }
1716 
1717 VarDecl *VarDecl::getCanonicalDecl() { return getFirstDecl(); }
1718 
1719 VarDecl::DefinitionKind VarDecl::isThisDeclarationADefinition(
1720   ASTContext &C) const
1721 {
1722   // C++ [basic.def]p2:
1723   //   A declaration is a definition unless [...] it contains the 'extern'
1724   //   specifier or a linkage-specification and neither an initializer [...],
1725   //   it declares a static data member in a class declaration [...].
1726   // C++1y [temp.expl.spec]p15:
1727   //   An explicit specialization of a static data member or an explicit
1728   //   specialization of a static data member template is a definition if the
1729   //   declaration includes an initializer; otherwise, it is a declaration.
1730   //
1731   // FIXME: How do you declare (but not define) a partial specialization of
1732   // a static data member template outside the containing class?
1733   if (isStaticDataMember()) {
1734     if (isOutOfLine() &&
1735         (hasInit() ||
1736          // If the first declaration is out-of-line, this may be an
1737          // instantiation of an out-of-line partial specialization of a variable
1738          // template for which we have not yet instantiated the initializer.
1739          (getFirstDecl()->isOutOfLine()
1740               ? getTemplateSpecializationKind() == TSK_Undeclared
1741               : getTemplateSpecializationKind() !=
1742                     TSK_ExplicitSpecialization) ||
1743          isa<VarTemplatePartialSpecializationDecl>(this)))
1744       return Definition;
1745     else
1746       return DeclarationOnly;
1747   }
1748   // C99 6.7p5:
1749   //   A definition of an identifier is a declaration for that identifier that
1750   //   [...] causes storage to be reserved for that object.
1751   // Note: that applies for all non-file-scope objects.
1752   // C99 6.9.2p1:
1753   //   If the declaration of an identifier for an object has file scope and an
1754   //   initializer, the declaration is an external definition for the identifier
1755   if (hasInit())
1756     return Definition;
1757 
1758   if (hasAttr<AliasAttr>())
1759     return Definition;
1760 
1761   // A variable template specialization (other than a static data member
1762   // template or an explicit specialization) is a declaration until we
1763   // instantiate its initializer.
1764   if (isa<VarTemplateSpecializationDecl>(this) &&
1765       getTemplateSpecializationKind() != TSK_ExplicitSpecialization)
1766     return DeclarationOnly;
1767 
1768   if (hasExternalStorage())
1769     return DeclarationOnly;
1770 
1771   // [dcl.link] p7:
1772   //   A declaration directly contained in a linkage-specification is treated
1773   //   as if it contains the extern specifier for the purpose of determining
1774   //   the linkage of the declared name and whether it is a definition.
1775   if (isSingleLineLanguageLinkage(*this))
1776     return DeclarationOnly;
1777 
1778   // C99 6.9.2p2:
1779   //   A declaration of an object that has file scope without an initializer,
1780   //   and without a storage class specifier or the scs 'static', constitutes
1781   //   a tentative definition.
1782   // No such thing in C++.
1783   if (!C.getLangOpts().CPlusPlus && isFileVarDecl())
1784     return TentativeDefinition;
1785 
1786   // What's left is (in C, block-scope) declarations without initializers or
1787   // external storage. These are definitions.
1788   return Definition;
1789 }
1790 
1791 VarDecl *VarDecl::getActingDefinition() {
1792   DefinitionKind Kind = isThisDeclarationADefinition();
1793   if (Kind != TentativeDefinition)
1794     return 0;
1795 
1796   VarDecl *LastTentative = 0;
1797   VarDecl *First = getFirstDecl();
1798   for (auto I : First->redecls()) {
1799     Kind = I->isThisDeclarationADefinition();
1800     if (Kind == Definition)
1801       return 0;
1802     else if (Kind == TentativeDefinition)
1803       LastTentative = I;
1804   }
1805   return LastTentative;
1806 }
1807 
1808 VarDecl *VarDecl::getDefinition(ASTContext &C) {
1809   VarDecl *First = getFirstDecl();
1810   for (auto I : First->redecls()) {
1811     if (I->isThisDeclarationADefinition(C) == Definition)
1812       return I;
1813   }
1814   return 0;
1815 }
1816 
1817 VarDecl::DefinitionKind VarDecl::hasDefinition(ASTContext &C) const {
1818   DefinitionKind Kind = DeclarationOnly;
1819 
1820   const VarDecl *First = getFirstDecl();
1821   for (auto I : First->redecls()) {
1822     Kind = std::max(Kind, I->isThisDeclarationADefinition(C));
1823     if (Kind == Definition)
1824       break;
1825   }
1826 
1827   return Kind;
1828 }
1829 
1830 const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
1831   for (auto I : redecls()) {
1832     if (auto Expr = I->getInit()) {
1833       D = I;
1834       return Expr;
1835     }
1836   }
1837   return 0;
1838 }
1839 
1840 bool VarDecl::isOutOfLine() const {
1841   if (Decl::isOutOfLine())
1842     return true;
1843 
1844   if (!isStaticDataMember())
1845     return false;
1846 
1847   // If this static data member was instantiated from a static data member of
1848   // a class template, check whether that static data member was defined
1849   // out-of-line.
1850   if (VarDecl *VD = getInstantiatedFromStaticDataMember())
1851     return VD->isOutOfLine();
1852 
1853   return false;
1854 }
1855 
1856 VarDecl *VarDecl::getOutOfLineDefinition() {
1857   if (!isStaticDataMember())
1858     return 0;
1859 
1860   for (auto RD : redecls()) {
1861     if (RD->getLexicalDeclContext()->isFileContext())
1862       return RD;
1863   }
1864 
1865   return 0;
1866 }
1867 
1868 void VarDecl::setInit(Expr *I) {
1869   if (EvaluatedStmt *Eval = Init.dyn_cast<EvaluatedStmt *>()) {
1870     Eval->~EvaluatedStmt();
1871     getASTContext().Deallocate(Eval);
1872   }
1873 
1874   Init = I;
1875 }
1876 
1877 bool VarDecl::isUsableInConstantExpressions(ASTContext &C) const {
1878   const LangOptions &Lang = C.getLangOpts();
1879 
1880   if (!Lang.CPlusPlus)
1881     return false;
1882 
1883   // In C++11, any variable of reference type can be used in a constant
1884   // expression if it is initialized by a constant expression.
1885   if (Lang.CPlusPlus11 && getType()->isReferenceType())
1886     return true;
1887 
1888   // Only const objects can be used in constant expressions in C++. C++98 does
1889   // not require the variable to be non-volatile, but we consider this to be a
1890   // defect.
1891   if (!getType().isConstQualified() || getType().isVolatileQualified())
1892     return false;
1893 
1894   // In C++, const, non-volatile variables of integral or enumeration types
1895   // can be used in constant expressions.
1896   if (getType()->isIntegralOrEnumerationType())
1897     return true;
1898 
1899   // Additionally, in C++11, non-volatile constexpr variables can be used in
1900   // constant expressions.
1901   return Lang.CPlusPlus11 && isConstexpr();
1902 }
1903 
1904 /// Convert the initializer for this declaration to the elaborated EvaluatedStmt
1905 /// form, which contains extra information on the evaluated value of the
1906 /// initializer.
1907 EvaluatedStmt *VarDecl::ensureEvaluatedStmt() const {
1908   EvaluatedStmt *Eval = Init.dyn_cast<EvaluatedStmt *>();
1909   if (!Eval) {
1910     Stmt *S = Init.get<Stmt *>();
1911     // Note: EvaluatedStmt contains an APValue, which usually holds
1912     // resources not allocated from the ASTContext.  We need to do some
1913     // work to avoid leaking those, but we do so in VarDecl::evaluateValue
1914     // where we can detect whether there's anything to clean up or not.
1915     Eval = new (getASTContext()) EvaluatedStmt;
1916     Eval->Value = S;
1917     Init = Eval;
1918   }
1919   return Eval;
1920 }
1921 
1922 APValue *VarDecl::evaluateValue() const {
1923   SmallVector<PartialDiagnosticAt, 8> Notes;
1924   return evaluateValue(Notes);
1925 }
1926 
1927 namespace {
1928 // Destroy an APValue that was allocated in an ASTContext.
1929 void DestroyAPValue(void* UntypedValue) {
1930   static_cast<APValue*>(UntypedValue)->~APValue();
1931 }
1932 } // namespace
1933 
1934 APValue *VarDecl::evaluateValue(
1935     SmallVectorImpl<PartialDiagnosticAt> &Notes) const {
1936   EvaluatedStmt *Eval = ensureEvaluatedStmt();
1937 
1938   // We only produce notes indicating why an initializer is non-constant the
1939   // first time it is evaluated. FIXME: The notes won't always be emitted the
1940   // first time we try evaluation, so might not be produced at all.
1941   if (Eval->WasEvaluated)
1942     return Eval->Evaluated.isUninit() ? 0 : &Eval->Evaluated;
1943 
1944   const Expr *Init = cast<Expr>(Eval->Value);
1945   assert(!Init->isValueDependent());
1946 
1947   if (Eval->IsEvaluating) {
1948     // FIXME: Produce a diagnostic for self-initialization.
1949     Eval->CheckedICE = true;
1950     Eval->IsICE = false;
1951     return 0;
1952   }
1953 
1954   Eval->IsEvaluating = true;
1955 
1956   bool Result = Init->EvaluateAsInitializer(Eval->Evaluated, getASTContext(),
1957                                             this, Notes);
1958 
1959   // Ensure the computed APValue is cleaned up later if evaluation succeeded,
1960   // or that it's empty (so that there's nothing to clean up) if evaluation
1961   // failed.
1962   if (!Result)
1963     Eval->Evaluated = APValue();
1964   else if (Eval->Evaluated.needsCleanup())
1965     getASTContext().AddDeallocation(DestroyAPValue, &Eval->Evaluated);
1966 
1967   Eval->IsEvaluating = false;
1968   Eval->WasEvaluated = true;
1969 
1970   // In C++11, we have determined whether the initializer was a constant
1971   // expression as a side-effect.
1972   if (getASTContext().getLangOpts().CPlusPlus11 && !Eval->CheckedICE) {
1973     Eval->CheckedICE = true;
1974     Eval->IsICE = Result && Notes.empty();
1975   }
1976 
1977   return Result ? &Eval->Evaluated : 0;
1978 }
1979 
1980 bool VarDecl::checkInitIsICE() const {
1981   // Initializers of weak variables are never ICEs.
1982   if (isWeak())
1983     return false;
1984 
1985   EvaluatedStmt *Eval = ensureEvaluatedStmt();
1986   if (Eval->CheckedICE)
1987     // We have already checked whether this subexpression is an
1988     // integral constant expression.
1989     return Eval->IsICE;
1990 
1991   const Expr *Init = cast<Expr>(Eval->Value);
1992   assert(!Init->isValueDependent());
1993 
1994   // In C++11, evaluate the initializer to check whether it's a constant
1995   // expression.
1996   if (getASTContext().getLangOpts().CPlusPlus11) {
1997     SmallVector<PartialDiagnosticAt, 8> Notes;
1998     evaluateValue(Notes);
1999     return Eval->IsICE;
2000   }
2001 
2002   // It's an ICE whether or not the definition we found is
2003   // out-of-line.  See DR 721 and the discussion in Clang PR
2004   // 6206 for details.
2005 
2006   if (Eval->CheckingICE)
2007     return false;
2008   Eval->CheckingICE = true;
2009 
2010   Eval->IsICE = Init->isIntegerConstantExpr(getASTContext());
2011   Eval->CheckingICE = false;
2012   Eval->CheckedICE = true;
2013   return Eval->IsICE;
2014 }
2015 
2016 VarDecl *VarDecl::getInstantiatedFromStaticDataMember() const {
2017   if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
2018     return cast<VarDecl>(MSI->getInstantiatedFrom());
2019 
2020   return 0;
2021 }
2022 
2023 TemplateSpecializationKind VarDecl::getTemplateSpecializationKind() const {
2024   if (const VarTemplateSpecializationDecl *Spec =
2025           dyn_cast<VarTemplateSpecializationDecl>(this))
2026     return Spec->getSpecializationKind();
2027 
2028   if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
2029     return MSI->getTemplateSpecializationKind();
2030 
2031   return TSK_Undeclared;
2032 }
2033 
2034 SourceLocation VarDecl::getPointOfInstantiation() const {
2035   if (const VarTemplateSpecializationDecl *Spec =
2036           dyn_cast<VarTemplateSpecializationDecl>(this))
2037     return Spec->getPointOfInstantiation();
2038 
2039   if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
2040     return MSI->getPointOfInstantiation();
2041 
2042   return SourceLocation();
2043 }
2044 
2045 VarTemplateDecl *VarDecl::getDescribedVarTemplate() const {
2046   return getASTContext().getTemplateOrSpecializationInfo(this)
2047       .dyn_cast<VarTemplateDecl *>();
2048 }
2049 
2050 void VarDecl::setDescribedVarTemplate(VarTemplateDecl *Template) {
2051   getASTContext().setTemplateOrSpecializationInfo(this, Template);
2052 }
2053 
2054 MemberSpecializationInfo *VarDecl::getMemberSpecializationInfo() const {
2055   if (isStaticDataMember())
2056     // FIXME: Remove ?
2057     // return getASTContext().getInstantiatedFromStaticDataMember(this);
2058     return getASTContext().getTemplateOrSpecializationInfo(this)
2059         .dyn_cast<MemberSpecializationInfo *>();
2060   return 0;
2061 }
2062 
2063 void VarDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
2064                                          SourceLocation PointOfInstantiation) {
2065   assert((isa<VarTemplateSpecializationDecl>(this) ||
2066           getMemberSpecializationInfo()) &&
2067          "not a variable or static data member template specialization");
2068 
2069   if (VarTemplateSpecializationDecl *Spec =
2070           dyn_cast<VarTemplateSpecializationDecl>(this)) {
2071     Spec->setSpecializationKind(TSK);
2072     if (TSK != TSK_ExplicitSpecialization && PointOfInstantiation.isValid() &&
2073         Spec->getPointOfInstantiation().isInvalid())
2074       Spec->setPointOfInstantiation(PointOfInstantiation);
2075   }
2076 
2077   if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo()) {
2078     MSI->setTemplateSpecializationKind(TSK);
2079     if (TSK != TSK_ExplicitSpecialization && PointOfInstantiation.isValid() &&
2080         MSI->getPointOfInstantiation().isInvalid())
2081       MSI->setPointOfInstantiation(PointOfInstantiation);
2082   }
2083 }
2084 
2085 void
2086 VarDecl::setInstantiationOfStaticDataMember(VarDecl *VD,
2087                                             TemplateSpecializationKind TSK) {
2088   assert(getASTContext().getTemplateOrSpecializationInfo(this).isNull() &&
2089          "Previous template or instantiation?");
2090   getASTContext().setInstantiatedFromStaticDataMember(this, VD, TSK);
2091 }
2092 
2093 //===----------------------------------------------------------------------===//
2094 // ParmVarDecl Implementation
2095 //===----------------------------------------------------------------------===//
2096 
2097 ParmVarDecl *ParmVarDecl::Create(ASTContext &C, DeclContext *DC,
2098                                  SourceLocation StartLoc,
2099                                  SourceLocation IdLoc, IdentifierInfo *Id,
2100                                  QualType T, TypeSourceInfo *TInfo,
2101                                  StorageClass S, Expr *DefArg) {
2102   return new (C, DC) ParmVarDecl(ParmVar, DC, StartLoc, IdLoc, Id, T, TInfo,
2103                                  S, DefArg);
2104 }
2105 
2106 QualType ParmVarDecl::getOriginalType() const {
2107   TypeSourceInfo *TSI = getTypeSourceInfo();
2108   QualType T = TSI ? TSI->getType() : getType();
2109   if (const DecayedType *DT = dyn_cast<DecayedType>(T))
2110     return DT->getOriginalType();
2111   return T;
2112 }
2113 
2114 ParmVarDecl *ParmVarDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
2115   return new (C, ID) ParmVarDecl(ParmVar, 0, SourceLocation(), SourceLocation(),
2116                                  0, QualType(), 0, SC_None, 0);
2117 }
2118 
2119 SourceRange ParmVarDecl::getSourceRange() const {
2120   if (!hasInheritedDefaultArg()) {
2121     SourceRange ArgRange = getDefaultArgRange();
2122     if (ArgRange.isValid())
2123       return SourceRange(getOuterLocStart(), ArgRange.getEnd());
2124   }
2125 
2126   // DeclaratorDecl considers the range of postfix types as overlapping with the
2127   // declaration name, but this is not the case with parameters in ObjC methods.
2128   if (isa<ObjCMethodDecl>(getDeclContext()))
2129     return SourceRange(DeclaratorDecl::getLocStart(), getLocation());
2130 
2131   return DeclaratorDecl::getSourceRange();
2132 }
2133 
2134 Expr *ParmVarDecl::getDefaultArg() {
2135   assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
2136   assert(!hasUninstantiatedDefaultArg() &&
2137          "Default argument is not yet instantiated!");
2138 
2139   Expr *Arg = getInit();
2140   if (ExprWithCleanups *E = dyn_cast_or_null<ExprWithCleanups>(Arg))
2141     return E->getSubExpr();
2142 
2143   return Arg;
2144 }
2145 
2146 SourceRange ParmVarDecl::getDefaultArgRange() const {
2147   if (const Expr *E = getInit())
2148     return E->getSourceRange();
2149 
2150   if (hasUninstantiatedDefaultArg())
2151     return getUninstantiatedDefaultArg()->getSourceRange();
2152 
2153   return SourceRange();
2154 }
2155 
2156 bool ParmVarDecl::isParameterPack() const {
2157   return isa<PackExpansionType>(getType());
2158 }
2159 
2160 void ParmVarDecl::setParameterIndexLarge(unsigned parameterIndex) {
2161   getASTContext().setParameterIndex(this, parameterIndex);
2162   ParmVarDeclBits.ParameterIndex = ParameterIndexSentinel;
2163 }
2164 
2165 unsigned ParmVarDecl::getParameterIndexLarge() const {
2166   return getASTContext().getParameterIndex(this);
2167 }
2168 
2169 //===----------------------------------------------------------------------===//
2170 // FunctionDecl Implementation
2171 //===----------------------------------------------------------------------===//
2172 
2173 void FunctionDecl::getNameForDiagnostic(
2174     raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const {
2175   NamedDecl::getNameForDiagnostic(OS, Policy, Qualified);
2176   const TemplateArgumentList *TemplateArgs = getTemplateSpecializationArgs();
2177   if (TemplateArgs)
2178     TemplateSpecializationType::PrintTemplateArgumentList(
2179         OS, TemplateArgs->data(), TemplateArgs->size(), Policy);
2180 }
2181 
2182 bool FunctionDecl::isVariadic() const {
2183   if (const FunctionProtoType *FT = getType()->getAs<FunctionProtoType>())
2184     return FT->isVariadic();
2185   return false;
2186 }
2187 
2188 bool FunctionDecl::hasBody(const FunctionDecl *&Definition) const {
2189   for (auto I : redecls()) {
2190     if (I->Body || I->IsLateTemplateParsed) {
2191       Definition = I;
2192       return true;
2193     }
2194   }
2195 
2196   return false;
2197 }
2198 
2199 bool FunctionDecl::hasTrivialBody() const
2200 {
2201   Stmt *S = getBody();
2202   if (!S) {
2203     // Since we don't have a body for this function, we don't know if it's
2204     // trivial or not.
2205     return false;
2206   }
2207 
2208   if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
2209     return true;
2210   return false;
2211 }
2212 
2213 bool FunctionDecl::isDefined(const FunctionDecl *&Definition) const {
2214   for (auto I : redecls()) {
2215     if (I->IsDeleted || I->IsDefaulted || I->Body || I->IsLateTemplateParsed ||
2216         I->hasAttr<AliasAttr>()) {
2217       Definition = I->IsDeleted ? I->getCanonicalDecl() : I;
2218       return true;
2219     }
2220   }
2221 
2222   return false;
2223 }
2224 
2225 Stmt *FunctionDecl::getBody(const FunctionDecl *&Definition) const {
2226   if (!hasBody(Definition))
2227     return 0;
2228 
2229   if (Definition->Body)
2230     return Definition->Body.get(getASTContext().getExternalSource());
2231 
2232   return 0;
2233 }
2234 
2235 void FunctionDecl::setBody(Stmt *B) {
2236   Body = B;
2237   if (B)
2238     EndRangeLoc = B->getLocEnd();
2239 }
2240 
2241 void FunctionDecl::setPure(bool P) {
2242   IsPure = P;
2243   if (P)
2244     if (CXXRecordDecl *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
2245       Parent->markedVirtualFunctionPure();
2246 }
2247 
2248 template<std::size_t Len>
2249 static bool isNamed(const NamedDecl *ND, const char (&Str)[Len]) {
2250   IdentifierInfo *II = ND->getIdentifier();
2251   return II && II->isStr(Str);
2252 }
2253 
2254 bool FunctionDecl::isMain() const {
2255   const TranslationUnitDecl *tunit =
2256     dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
2257   return tunit &&
2258          !tunit->getASTContext().getLangOpts().Freestanding &&
2259          isNamed(this, "main");
2260 }
2261 
2262 bool FunctionDecl::isMSVCRTEntryPoint() const {
2263   const TranslationUnitDecl *TUnit =
2264       dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
2265   if (!TUnit)
2266     return false;
2267 
2268   // Even though we aren't really targeting MSVCRT if we are freestanding,
2269   // semantic analysis for these functions remains the same.
2270 
2271   // MSVCRT entry points only exist on MSVCRT targets.
2272   if (!TUnit->getASTContext().getTargetInfo().getTriple().isOSMSVCRT())
2273     return false;
2274 
2275   // Nameless functions like constructors cannot be entry points.
2276   if (!getIdentifier())
2277     return false;
2278 
2279   return llvm::StringSwitch<bool>(getName())
2280       .Cases("main",     // an ANSI console app
2281              "wmain",    // a Unicode console App
2282              "WinMain",  // an ANSI GUI app
2283              "wWinMain", // a Unicode GUI app
2284              "DllMain",  // a DLL
2285              true)
2286       .Default(false);
2287 }
2288 
2289 bool FunctionDecl::isReservedGlobalPlacementOperator() const {
2290   assert(getDeclName().getNameKind() == DeclarationName::CXXOperatorName);
2291   assert(getDeclName().getCXXOverloadedOperator() == OO_New ||
2292          getDeclName().getCXXOverloadedOperator() == OO_Delete ||
2293          getDeclName().getCXXOverloadedOperator() == OO_Array_New ||
2294          getDeclName().getCXXOverloadedOperator() == OO_Array_Delete);
2295 
2296   if (!getDeclContext()->getRedeclContext()->isTranslationUnit())
2297     return false;
2298 
2299   const FunctionProtoType *proto = getType()->castAs<FunctionProtoType>();
2300   if (proto->getNumParams() != 2 || proto->isVariadic())
2301     return false;
2302 
2303   ASTContext &Context =
2304     cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext())
2305       ->getASTContext();
2306 
2307   // The result type and first argument type are constant across all
2308   // these operators.  The second argument must be exactly void*.
2309   return (proto->getParamType(1).getCanonicalType() == Context.VoidPtrTy);
2310 }
2311 
2312 static bool isNamespaceStd(const DeclContext *DC) {
2313   const NamespaceDecl *ND = dyn_cast<NamespaceDecl>(DC->getRedeclContext());
2314   return ND && isNamed(ND, "std") &&
2315          ND->getParent()->getRedeclContext()->isTranslationUnit();
2316 }
2317 
2318 bool FunctionDecl::isReplaceableGlobalAllocationFunction() const {
2319   if (getDeclName().getNameKind() != DeclarationName::CXXOperatorName)
2320     return false;
2321   if (getDeclName().getCXXOverloadedOperator() != OO_New &&
2322       getDeclName().getCXXOverloadedOperator() != OO_Delete &&
2323       getDeclName().getCXXOverloadedOperator() != OO_Array_New &&
2324       getDeclName().getCXXOverloadedOperator() != OO_Array_Delete)
2325     return false;
2326 
2327   if (isa<CXXRecordDecl>(getDeclContext()))
2328     return false;
2329 
2330   // This can only fail for an invalid 'operator new' declaration.
2331   if (!getDeclContext()->getRedeclContext()->isTranslationUnit())
2332     return false;
2333 
2334   const FunctionProtoType *FPT = getType()->castAs<FunctionProtoType>();
2335   if (FPT->getNumParams() > 2 || FPT->isVariadic())
2336     return false;
2337 
2338   // If this is a single-parameter function, it must be a replaceable global
2339   // allocation or deallocation function.
2340   if (FPT->getNumParams() == 1)
2341     return true;
2342 
2343   // Otherwise, we're looking for a second parameter whose type is
2344   // 'const std::nothrow_t &', or, in C++1y, 'std::size_t'.
2345   QualType Ty = FPT->getParamType(1);
2346   ASTContext &Ctx = getASTContext();
2347   if (Ctx.getLangOpts().SizedDeallocation &&
2348       Ctx.hasSameType(Ty, Ctx.getSizeType()))
2349     return true;
2350   if (!Ty->isReferenceType())
2351     return false;
2352   Ty = Ty->getPointeeType();
2353   if (Ty.getCVRQualifiers() != Qualifiers::Const)
2354     return false;
2355   // FIXME: Recognise nothrow_t in an inline namespace inside std?
2356   const CXXRecordDecl *RD = Ty->getAsCXXRecordDecl();
2357   return RD && isNamed(RD, "nothrow_t") && isNamespaceStd(RD->getDeclContext());
2358 }
2359 
2360 FunctionDecl *
2361 FunctionDecl::getCorrespondingUnsizedGlobalDeallocationFunction() const {
2362   ASTContext &Ctx = getASTContext();
2363   if (!Ctx.getLangOpts().SizedDeallocation)
2364     return 0;
2365 
2366   if (getDeclName().getNameKind() != DeclarationName::CXXOperatorName)
2367     return 0;
2368   if (getDeclName().getCXXOverloadedOperator() != OO_Delete &&
2369       getDeclName().getCXXOverloadedOperator() != OO_Array_Delete)
2370     return 0;
2371   if (isa<CXXRecordDecl>(getDeclContext()))
2372     return 0;
2373 
2374   if (!getDeclContext()->getRedeclContext()->isTranslationUnit())
2375     return 0;
2376 
2377   if (getNumParams() != 2 || isVariadic() ||
2378       !Ctx.hasSameType(getType()->castAs<FunctionProtoType>()->getParamType(1),
2379                        Ctx.getSizeType()))
2380     return 0;
2381 
2382   // This is a sized deallocation function. Find the corresponding unsized
2383   // deallocation function.
2384   lookup_const_result R = getDeclContext()->lookup(getDeclName());
2385   for (lookup_const_result::iterator RI = R.begin(), RE = R.end(); RI != RE;
2386        ++RI)
2387     if (FunctionDecl *FD = dyn_cast<FunctionDecl>(*RI))
2388       if (FD->getNumParams() == 1 && !FD->isVariadic())
2389         return FD;
2390   return 0;
2391 }
2392 
2393 LanguageLinkage FunctionDecl::getLanguageLinkage() const {
2394   return getLanguageLinkageTemplate(*this);
2395 }
2396 
2397 bool FunctionDecl::isExternC() const {
2398   return isExternCTemplate(*this);
2399 }
2400 
2401 bool FunctionDecl::isInExternCContext() const {
2402   return getLexicalDeclContext()->isExternCContext();
2403 }
2404 
2405 bool FunctionDecl::isInExternCXXContext() const {
2406   return getLexicalDeclContext()->isExternCXXContext();
2407 }
2408 
2409 bool FunctionDecl::isGlobal() const {
2410   if (const CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(this))
2411     return Method->isStatic();
2412 
2413   if (getCanonicalDecl()->getStorageClass() == SC_Static)
2414     return false;
2415 
2416   for (const DeclContext *DC = getDeclContext();
2417        DC->isNamespace();
2418        DC = DC->getParent()) {
2419     if (const NamespaceDecl *Namespace = cast<NamespaceDecl>(DC)) {
2420       if (!Namespace->getDeclName())
2421         return false;
2422       break;
2423     }
2424   }
2425 
2426   return true;
2427 }
2428 
2429 bool FunctionDecl::isNoReturn() const {
2430   return hasAttr<NoReturnAttr>() || hasAttr<CXX11NoReturnAttr>() ||
2431          hasAttr<C11NoReturnAttr>() ||
2432          getType()->getAs<FunctionType>()->getNoReturnAttr();
2433 }
2434 
2435 void
2436 FunctionDecl::setPreviousDeclaration(FunctionDecl *PrevDecl) {
2437   redeclarable_base::setPreviousDecl(PrevDecl);
2438 
2439   if (FunctionTemplateDecl *FunTmpl = getDescribedFunctionTemplate()) {
2440     FunctionTemplateDecl *PrevFunTmpl
2441       = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : 0;
2442     assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
2443     FunTmpl->setPreviousDecl(PrevFunTmpl);
2444   }
2445 
2446   if (PrevDecl && PrevDecl->IsInline)
2447     IsInline = true;
2448 }
2449 
2450 const FunctionDecl *FunctionDecl::getCanonicalDecl() const {
2451   return getFirstDecl();
2452 }
2453 
2454 FunctionDecl *FunctionDecl::getCanonicalDecl() { return getFirstDecl(); }
2455 
2456 /// \brief Returns a value indicating whether this function
2457 /// corresponds to a builtin function.
2458 ///
2459 /// The function corresponds to a built-in function if it is
2460 /// declared at translation scope or within an extern "C" block and
2461 /// its name matches with the name of a builtin. The returned value
2462 /// will be 0 for functions that do not correspond to a builtin, a
2463 /// value of type \c Builtin::ID if in the target-independent range
2464 /// \c [1,Builtin::First), or a target-specific builtin value.
2465 unsigned FunctionDecl::getBuiltinID() const {
2466   if (!getIdentifier())
2467     return 0;
2468 
2469   unsigned BuiltinID = getIdentifier()->getBuiltinID();
2470   if (!BuiltinID)
2471     return 0;
2472 
2473   ASTContext &Context = getASTContext();
2474   if (Context.getLangOpts().CPlusPlus) {
2475     const LinkageSpecDecl *LinkageDecl = dyn_cast<LinkageSpecDecl>(
2476         getFirstDecl()->getDeclContext());
2477     // In C++, the first declaration of a builtin is always inside an implicit
2478     // extern "C".
2479     // FIXME: A recognised library function may not be directly in an extern "C"
2480     // declaration, for instance "extern "C" { namespace std { decl } }".
2481     if (!LinkageDecl || LinkageDecl->getLanguage() != LinkageSpecDecl::lang_c)
2482       return 0;
2483   }
2484 
2485   // If the function is marked "overloadable", it has a different mangled name
2486   // and is not the C library function.
2487   if (hasAttr<OverloadableAttr>())
2488     return 0;
2489 
2490   if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
2491     return BuiltinID;
2492 
2493   // This function has the name of a known C library
2494   // function. Determine whether it actually refers to the C library
2495   // function or whether it just has the same name.
2496 
2497   // If this is a static function, it's not a builtin.
2498   if (getStorageClass() == SC_Static)
2499     return 0;
2500 
2501   return BuiltinID;
2502 }
2503 
2504 
2505 /// getNumParams - Return the number of parameters this function must have
2506 /// based on its FunctionType.  This is the length of the ParamInfo array
2507 /// after it has been created.
2508 unsigned FunctionDecl::getNumParams() const {
2509   const FunctionProtoType *FPT = getType()->getAs<FunctionProtoType>();
2510   return FPT ? FPT->getNumParams() : 0;
2511 }
2512 
2513 void FunctionDecl::setParams(ASTContext &C,
2514                              ArrayRef<ParmVarDecl *> NewParamInfo) {
2515   assert(ParamInfo == 0 && "Already has param info!");
2516   assert(NewParamInfo.size() == getNumParams() && "Parameter count mismatch!");
2517 
2518   // Zero params -> null pointer.
2519   if (!NewParamInfo.empty()) {
2520     ParamInfo = new (C) ParmVarDecl*[NewParamInfo.size()];
2521     std::copy(NewParamInfo.begin(), NewParamInfo.end(), ParamInfo);
2522   }
2523 }
2524 
2525 void FunctionDecl::setDeclsInPrototypeScope(ArrayRef<NamedDecl *> NewDecls) {
2526   assert(DeclsInPrototypeScope.empty() && "Already has prototype decls!");
2527 
2528   if (!NewDecls.empty()) {
2529     NamedDecl **A = new (getASTContext()) NamedDecl*[NewDecls.size()];
2530     std::copy(NewDecls.begin(), NewDecls.end(), A);
2531     DeclsInPrototypeScope = ArrayRef<NamedDecl *>(A, NewDecls.size());
2532   }
2533 }
2534 
2535 /// getMinRequiredArguments - Returns the minimum number of arguments
2536 /// needed to call this function. This may be fewer than the number of
2537 /// function parameters, if some of the parameters have default
2538 /// arguments (in C++) or are parameter packs (C++11).
2539 unsigned FunctionDecl::getMinRequiredArguments() const {
2540   if (!getASTContext().getLangOpts().CPlusPlus)
2541     return getNumParams();
2542 
2543   unsigned NumRequiredArgs = 0;
2544   for (auto *Param : params())
2545     if (!Param->isParameterPack() && !Param->hasDefaultArg())
2546       ++NumRequiredArgs;
2547   return NumRequiredArgs;
2548 }
2549 
2550 /// \brief The combination of the extern and inline keywords under MSVC forces
2551 /// the function to be required.
2552 ///
2553 /// Note: This function assumes that we will only get called when isInlined()
2554 /// would return true for this FunctionDecl.
2555 bool FunctionDecl::isMSExternInline() const {
2556   assert(isInlined() && "expected to get called on an inlined function!");
2557 
2558   const ASTContext &Context = getASTContext();
2559   if (!Context.getLangOpts().MSVCCompat)
2560     return false;
2561 
2562   for (const FunctionDecl *FD = this; FD; FD = FD->getPreviousDecl())
2563     if (FD->getStorageClass() == SC_Extern)
2564       return true;
2565 
2566   return false;
2567 }
2568 
2569 static bool redeclForcesDefMSVC(const FunctionDecl *Redecl) {
2570   if (Redecl->getStorageClass() != SC_Extern)
2571     return false;
2572 
2573   for (const FunctionDecl *FD = Redecl->getPreviousDecl(); FD;
2574        FD = FD->getPreviousDecl())
2575     if (FD->getStorageClass() == SC_Extern)
2576       return false;
2577 
2578   return true;
2579 }
2580 
2581 static bool RedeclForcesDefC99(const FunctionDecl *Redecl) {
2582   // Only consider file-scope declarations in this test.
2583   if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
2584     return false;
2585 
2586   // Only consider explicit declarations; the presence of a builtin for a
2587   // libcall shouldn't affect whether a definition is externally visible.
2588   if (Redecl->isImplicit())
2589     return false;
2590 
2591   if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
2592     return true; // Not an inline definition
2593 
2594   return false;
2595 }
2596 
2597 /// \brief For a function declaration in C or C++, determine whether this
2598 /// declaration causes the definition to be externally visible.
2599 ///
2600 /// For instance, this determines if adding the current declaration to the set
2601 /// of redeclarations of the given functions causes
2602 /// isInlineDefinitionExternallyVisible to change from false to true.
2603 bool FunctionDecl::doesDeclarationForceExternallyVisibleDefinition() const {
2604   assert(!doesThisDeclarationHaveABody() &&
2605          "Must have a declaration without a body.");
2606 
2607   ASTContext &Context = getASTContext();
2608 
2609   if (Context.getLangOpts().MSVCCompat) {
2610     const FunctionDecl *Definition;
2611     if (hasBody(Definition) && Definition->isInlined() &&
2612         redeclForcesDefMSVC(this))
2613       return true;
2614   }
2615 
2616   if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
2617     // With GNU inlining, a declaration with 'inline' but not 'extern', forces
2618     // an externally visible definition.
2619     //
2620     // FIXME: What happens if gnu_inline gets added on after the first
2621     // declaration?
2622     if (!isInlineSpecified() || getStorageClass() == SC_Extern)
2623       return false;
2624 
2625     const FunctionDecl *Prev = this;
2626     bool FoundBody = false;
2627     while ((Prev = Prev->getPreviousDecl())) {
2628       FoundBody |= Prev->Body.isValid();
2629 
2630       if (Prev->Body) {
2631         // If it's not the case that both 'inline' and 'extern' are
2632         // specified on the definition, then it is always externally visible.
2633         if (!Prev->isInlineSpecified() ||
2634             Prev->getStorageClass() != SC_Extern)
2635           return false;
2636       } else if (Prev->isInlineSpecified() &&
2637                  Prev->getStorageClass() != SC_Extern) {
2638         return false;
2639       }
2640     }
2641     return FoundBody;
2642   }
2643 
2644   if (Context.getLangOpts().CPlusPlus)
2645     return false;
2646 
2647   // C99 6.7.4p6:
2648   //   [...] If all of the file scope declarations for a function in a
2649   //   translation unit include the inline function specifier without extern,
2650   //   then the definition in that translation unit is an inline definition.
2651   if (isInlineSpecified() && getStorageClass() != SC_Extern)
2652     return false;
2653   const FunctionDecl *Prev = this;
2654   bool FoundBody = false;
2655   while ((Prev = Prev->getPreviousDecl())) {
2656     FoundBody |= Prev->Body.isValid();
2657     if (RedeclForcesDefC99(Prev))
2658       return false;
2659   }
2660   return FoundBody;
2661 }
2662 
2663 /// \brief For an inline function definition in C, or for a gnu_inline function
2664 /// in C++, determine whether the definition will be externally visible.
2665 ///
2666 /// Inline function definitions are always available for inlining optimizations.
2667 /// However, depending on the language dialect, declaration specifiers, and
2668 /// attributes, the definition of an inline function may or may not be
2669 /// "externally" visible to other translation units in the program.
2670 ///
2671 /// In C99, inline definitions are not externally visible by default. However,
2672 /// if even one of the global-scope declarations is marked "extern inline", the
2673 /// inline definition becomes externally visible (C99 6.7.4p6).
2674 ///
2675 /// In GNU89 mode, or if the gnu_inline attribute is attached to the function
2676 /// definition, we use the GNU semantics for inline, which are nearly the
2677 /// opposite of C99 semantics. In particular, "inline" by itself will create
2678 /// an externally visible symbol, but "extern inline" will not create an
2679 /// externally visible symbol.
2680 bool FunctionDecl::isInlineDefinitionExternallyVisible() const {
2681   assert(doesThisDeclarationHaveABody() && "Must have the function definition");
2682   assert(isInlined() && "Function must be inline");
2683   ASTContext &Context = getASTContext();
2684 
2685   if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
2686     // Note: If you change the logic here, please change
2687     // doesDeclarationForceExternallyVisibleDefinition as well.
2688     //
2689     // If it's not the case that both 'inline' and 'extern' are
2690     // specified on the definition, then this inline definition is
2691     // externally visible.
2692     if (!(isInlineSpecified() && getStorageClass() == SC_Extern))
2693       return true;
2694 
2695     // If any declaration is 'inline' but not 'extern', then this definition
2696     // is externally visible.
2697     for (auto Redecl : redecls()) {
2698       if (Redecl->isInlineSpecified() &&
2699           Redecl->getStorageClass() != SC_Extern)
2700         return true;
2701     }
2702 
2703     return false;
2704   }
2705 
2706   // The rest of this function is C-only.
2707   assert(!Context.getLangOpts().CPlusPlus &&
2708          "should not use C inline rules in C++");
2709 
2710   // C99 6.7.4p6:
2711   //   [...] If all of the file scope declarations for a function in a
2712   //   translation unit include the inline function specifier without extern,
2713   //   then the definition in that translation unit is an inline definition.
2714   for (auto Redecl : redecls()) {
2715     if (RedeclForcesDefC99(Redecl))
2716       return true;
2717   }
2718 
2719   // C99 6.7.4p6:
2720   //   An inline definition does not provide an external definition for the
2721   //   function, and does not forbid an external definition in another
2722   //   translation unit.
2723   return false;
2724 }
2725 
2726 /// getOverloadedOperator - Which C++ overloaded operator this
2727 /// function represents, if any.
2728 OverloadedOperatorKind FunctionDecl::getOverloadedOperator() const {
2729   if (getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
2730     return getDeclName().getCXXOverloadedOperator();
2731   else
2732     return OO_None;
2733 }
2734 
2735 /// getLiteralIdentifier - The literal suffix identifier this function
2736 /// represents, if any.
2737 const IdentifierInfo *FunctionDecl::getLiteralIdentifier() const {
2738   if (getDeclName().getNameKind() == DeclarationName::CXXLiteralOperatorName)
2739     return getDeclName().getCXXLiteralIdentifier();
2740   else
2741     return 0;
2742 }
2743 
2744 FunctionDecl::TemplatedKind FunctionDecl::getTemplatedKind() const {
2745   if (TemplateOrSpecialization.isNull())
2746     return TK_NonTemplate;
2747   if (TemplateOrSpecialization.is<FunctionTemplateDecl *>())
2748     return TK_FunctionTemplate;
2749   if (TemplateOrSpecialization.is<MemberSpecializationInfo *>())
2750     return TK_MemberSpecialization;
2751   if (TemplateOrSpecialization.is<FunctionTemplateSpecializationInfo *>())
2752     return TK_FunctionTemplateSpecialization;
2753   if (TemplateOrSpecialization.is
2754                                <DependentFunctionTemplateSpecializationInfo*>())
2755     return TK_DependentFunctionTemplateSpecialization;
2756 
2757   llvm_unreachable("Did we miss a TemplateOrSpecialization type?");
2758 }
2759 
2760 FunctionDecl *FunctionDecl::getInstantiatedFromMemberFunction() const {
2761   if (MemberSpecializationInfo *Info = getMemberSpecializationInfo())
2762     return cast<FunctionDecl>(Info->getInstantiatedFrom());
2763 
2764   return 0;
2765 }
2766 
2767 void
2768 FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
2769                                                FunctionDecl *FD,
2770                                                TemplateSpecializationKind TSK) {
2771   assert(TemplateOrSpecialization.isNull() &&
2772          "Member function is already a specialization");
2773   MemberSpecializationInfo *Info
2774     = new (C) MemberSpecializationInfo(FD, TSK);
2775   TemplateOrSpecialization = Info;
2776 }
2777 
2778 bool FunctionDecl::isImplicitlyInstantiable() const {
2779   // If the function is invalid, it can't be implicitly instantiated.
2780   if (isInvalidDecl())
2781     return false;
2782 
2783   switch (getTemplateSpecializationKind()) {
2784   case TSK_Undeclared:
2785   case TSK_ExplicitInstantiationDefinition:
2786     return false;
2787 
2788   case TSK_ImplicitInstantiation:
2789     return true;
2790 
2791   // It is possible to instantiate TSK_ExplicitSpecialization kind
2792   // if the FunctionDecl has a class scope specialization pattern.
2793   case TSK_ExplicitSpecialization:
2794     return getClassScopeSpecializationPattern() != 0;
2795 
2796   case TSK_ExplicitInstantiationDeclaration:
2797     // Handled below.
2798     break;
2799   }
2800 
2801   // Find the actual template from which we will instantiate.
2802   const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
2803   bool HasPattern = false;
2804   if (PatternDecl)
2805     HasPattern = PatternDecl->hasBody(PatternDecl);
2806 
2807   // C++0x [temp.explicit]p9:
2808   //   Except for inline functions, other explicit instantiation declarations
2809   //   have the effect of suppressing the implicit instantiation of the entity
2810   //   to which they refer.
2811   if (!HasPattern || !PatternDecl)
2812     return true;
2813 
2814   return PatternDecl->isInlined();
2815 }
2816 
2817 bool FunctionDecl::isTemplateInstantiation() const {
2818   switch (getTemplateSpecializationKind()) {
2819     case TSK_Undeclared:
2820     case TSK_ExplicitSpecialization:
2821       return false;
2822     case TSK_ImplicitInstantiation:
2823     case TSK_ExplicitInstantiationDeclaration:
2824     case TSK_ExplicitInstantiationDefinition:
2825       return true;
2826   }
2827   llvm_unreachable("All TSK values handled.");
2828 }
2829 
2830 FunctionDecl *FunctionDecl::getTemplateInstantiationPattern() const {
2831   // Handle class scope explicit specialization special case.
2832   if (getTemplateSpecializationKind() == TSK_ExplicitSpecialization)
2833     return getClassScopeSpecializationPattern();
2834 
2835   // If this is a generic lambda call operator specialization, its
2836   // instantiation pattern is always its primary template's pattern
2837   // even if its primary template was instantiated from another
2838   // member template (which happens with nested generic lambdas).
2839   // Since a lambda's call operator's body is transformed eagerly,
2840   // we don't have to go hunting for a prototype definition template
2841   // (i.e. instantiated-from-member-template) to use as an instantiation
2842   // pattern.
2843 
2844   if (isGenericLambdaCallOperatorSpecialization(
2845           dyn_cast<CXXMethodDecl>(this))) {
2846     assert(getPrimaryTemplate() && "A generic lambda specialization must be "
2847                                    "generated from a primary call operator "
2848                                    "template");
2849     assert(getPrimaryTemplate()->getTemplatedDecl()->getBody() &&
2850            "A generic lambda call operator template must always have a body - "
2851            "even if instantiated from a prototype (i.e. as written) member "
2852            "template");
2853     return getPrimaryTemplate()->getTemplatedDecl();
2854   }
2855 
2856   if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
2857     while (Primary->getInstantiatedFromMemberTemplate()) {
2858       // If we have hit a point where the user provided a specialization of
2859       // this template, we're done looking.
2860       if (Primary->isMemberSpecialization())
2861         break;
2862       Primary = Primary->getInstantiatedFromMemberTemplate();
2863     }
2864 
2865     return Primary->getTemplatedDecl();
2866   }
2867 
2868   return getInstantiatedFromMemberFunction();
2869 }
2870 
2871 FunctionTemplateDecl *FunctionDecl::getPrimaryTemplate() const {
2872   if (FunctionTemplateSpecializationInfo *Info
2873         = TemplateOrSpecialization
2874             .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
2875     return Info->Template.getPointer();
2876   }
2877   return 0;
2878 }
2879 
2880 FunctionDecl *FunctionDecl::getClassScopeSpecializationPattern() const {
2881     return getASTContext().getClassScopeSpecializationPattern(this);
2882 }
2883 
2884 const TemplateArgumentList *
2885 FunctionDecl::getTemplateSpecializationArgs() const {
2886   if (FunctionTemplateSpecializationInfo *Info
2887         = TemplateOrSpecialization
2888             .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
2889     return Info->TemplateArguments;
2890   }
2891   return 0;
2892 }
2893 
2894 const ASTTemplateArgumentListInfo *
2895 FunctionDecl::getTemplateSpecializationArgsAsWritten() const {
2896   if (FunctionTemplateSpecializationInfo *Info
2897         = TemplateOrSpecialization
2898             .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
2899     return Info->TemplateArgumentsAsWritten;
2900   }
2901   return 0;
2902 }
2903 
2904 void
2905 FunctionDecl::setFunctionTemplateSpecialization(ASTContext &C,
2906                                                 FunctionTemplateDecl *Template,
2907                                      const TemplateArgumentList *TemplateArgs,
2908                                                 void *InsertPos,
2909                                                 TemplateSpecializationKind TSK,
2910                         const TemplateArgumentListInfo *TemplateArgsAsWritten,
2911                                           SourceLocation PointOfInstantiation) {
2912   assert(TSK != TSK_Undeclared &&
2913          "Must specify the type of function template specialization");
2914   FunctionTemplateSpecializationInfo *Info
2915     = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
2916   if (!Info)
2917     Info = FunctionTemplateSpecializationInfo::Create(C, this, Template, TSK,
2918                                                       TemplateArgs,
2919                                                       TemplateArgsAsWritten,
2920                                                       PointOfInstantiation);
2921   TemplateOrSpecialization = Info;
2922   Template->addSpecialization(Info, InsertPos);
2923 }
2924 
2925 void
2926 FunctionDecl::setDependentTemplateSpecialization(ASTContext &Context,
2927                                     const UnresolvedSetImpl &Templates,
2928                              const TemplateArgumentListInfo &TemplateArgs) {
2929   assert(TemplateOrSpecialization.isNull());
2930   size_t Size = sizeof(DependentFunctionTemplateSpecializationInfo);
2931   Size += Templates.size() * sizeof(FunctionTemplateDecl*);
2932   Size += TemplateArgs.size() * sizeof(TemplateArgumentLoc);
2933   void *Buffer = Context.Allocate(Size);
2934   DependentFunctionTemplateSpecializationInfo *Info =
2935     new (Buffer) DependentFunctionTemplateSpecializationInfo(Templates,
2936                                                              TemplateArgs);
2937   TemplateOrSpecialization = Info;
2938 }
2939 
2940 DependentFunctionTemplateSpecializationInfo::
2941 DependentFunctionTemplateSpecializationInfo(const UnresolvedSetImpl &Ts,
2942                                       const TemplateArgumentListInfo &TArgs)
2943   : AngleLocs(TArgs.getLAngleLoc(), TArgs.getRAngleLoc()) {
2944 
2945   d.NumTemplates = Ts.size();
2946   d.NumArgs = TArgs.size();
2947 
2948   FunctionTemplateDecl **TsArray =
2949     const_cast<FunctionTemplateDecl**>(getTemplates());
2950   for (unsigned I = 0, E = Ts.size(); I != E; ++I)
2951     TsArray[I] = cast<FunctionTemplateDecl>(Ts[I]->getUnderlyingDecl());
2952 
2953   TemplateArgumentLoc *ArgsArray =
2954     const_cast<TemplateArgumentLoc*>(getTemplateArgs());
2955   for (unsigned I = 0, E = TArgs.size(); I != E; ++I)
2956     new (&ArgsArray[I]) TemplateArgumentLoc(TArgs[I]);
2957 }
2958 
2959 TemplateSpecializationKind FunctionDecl::getTemplateSpecializationKind() const {
2960   // For a function template specialization, query the specialization
2961   // information object.
2962   FunctionTemplateSpecializationInfo *FTSInfo
2963     = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
2964   if (FTSInfo)
2965     return FTSInfo->getTemplateSpecializationKind();
2966 
2967   MemberSpecializationInfo *MSInfo
2968     = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>();
2969   if (MSInfo)
2970     return MSInfo->getTemplateSpecializationKind();
2971 
2972   return TSK_Undeclared;
2973 }
2974 
2975 void
2976 FunctionDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
2977                                           SourceLocation PointOfInstantiation) {
2978   if (FunctionTemplateSpecializationInfo *FTSInfo
2979         = TemplateOrSpecialization.dyn_cast<
2980                                     FunctionTemplateSpecializationInfo*>()) {
2981     FTSInfo->setTemplateSpecializationKind(TSK);
2982     if (TSK != TSK_ExplicitSpecialization &&
2983         PointOfInstantiation.isValid() &&
2984         FTSInfo->getPointOfInstantiation().isInvalid())
2985       FTSInfo->setPointOfInstantiation(PointOfInstantiation);
2986   } else if (MemberSpecializationInfo *MSInfo
2987              = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>()) {
2988     MSInfo->setTemplateSpecializationKind(TSK);
2989     if (TSK != TSK_ExplicitSpecialization &&
2990         PointOfInstantiation.isValid() &&
2991         MSInfo->getPointOfInstantiation().isInvalid())
2992       MSInfo->setPointOfInstantiation(PointOfInstantiation);
2993   } else
2994     llvm_unreachable("Function cannot have a template specialization kind");
2995 }
2996 
2997 SourceLocation FunctionDecl::getPointOfInstantiation() const {
2998   if (FunctionTemplateSpecializationInfo *FTSInfo
2999         = TemplateOrSpecialization.dyn_cast<
3000                                         FunctionTemplateSpecializationInfo*>())
3001     return FTSInfo->getPointOfInstantiation();
3002   else if (MemberSpecializationInfo *MSInfo
3003              = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>())
3004     return MSInfo->getPointOfInstantiation();
3005 
3006   return SourceLocation();
3007 }
3008 
3009 bool FunctionDecl::isOutOfLine() const {
3010   if (Decl::isOutOfLine())
3011     return true;
3012 
3013   // If this function was instantiated from a member function of a
3014   // class template, check whether that member function was defined out-of-line.
3015   if (FunctionDecl *FD = getInstantiatedFromMemberFunction()) {
3016     const FunctionDecl *Definition;
3017     if (FD->hasBody(Definition))
3018       return Definition->isOutOfLine();
3019   }
3020 
3021   // If this function was instantiated from a function template,
3022   // check whether that function template was defined out-of-line.
3023   if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
3024     const FunctionDecl *Definition;
3025     if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
3026       return Definition->isOutOfLine();
3027   }
3028 
3029   return false;
3030 }
3031 
3032 SourceRange FunctionDecl::getSourceRange() const {
3033   return SourceRange(getOuterLocStart(), EndRangeLoc);
3034 }
3035 
3036 unsigned FunctionDecl::getMemoryFunctionKind() const {
3037   IdentifierInfo *FnInfo = getIdentifier();
3038 
3039   if (!FnInfo)
3040     return 0;
3041 
3042   // Builtin handling.
3043   switch (getBuiltinID()) {
3044   case Builtin::BI__builtin_memset:
3045   case Builtin::BI__builtin___memset_chk:
3046   case Builtin::BImemset:
3047     return Builtin::BImemset;
3048 
3049   case Builtin::BI__builtin_memcpy:
3050   case Builtin::BI__builtin___memcpy_chk:
3051   case Builtin::BImemcpy:
3052     return Builtin::BImemcpy;
3053 
3054   case Builtin::BI__builtin_memmove:
3055   case Builtin::BI__builtin___memmove_chk:
3056   case Builtin::BImemmove:
3057     return Builtin::BImemmove;
3058 
3059   case Builtin::BIstrlcpy:
3060     return Builtin::BIstrlcpy;
3061   case Builtin::BIstrlcat:
3062     return Builtin::BIstrlcat;
3063 
3064   case Builtin::BI__builtin_memcmp:
3065   case Builtin::BImemcmp:
3066     return Builtin::BImemcmp;
3067 
3068   case Builtin::BI__builtin_strncpy:
3069   case Builtin::BI__builtin___strncpy_chk:
3070   case Builtin::BIstrncpy:
3071     return Builtin::BIstrncpy;
3072 
3073   case Builtin::BI__builtin_strncmp:
3074   case Builtin::BIstrncmp:
3075     return Builtin::BIstrncmp;
3076 
3077   case Builtin::BI__builtin_strncasecmp:
3078   case Builtin::BIstrncasecmp:
3079     return Builtin::BIstrncasecmp;
3080 
3081   case Builtin::BI__builtin_strncat:
3082   case Builtin::BI__builtin___strncat_chk:
3083   case Builtin::BIstrncat:
3084     return Builtin::BIstrncat;
3085 
3086   case Builtin::BI__builtin_strndup:
3087   case Builtin::BIstrndup:
3088     return Builtin::BIstrndup;
3089 
3090   case Builtin::BI__builtin_strlen:
3091   case Builtin::BIstrlen:
3092     return Builtin::BIstrlen;
3093 
3094   default:
3095     if (isExternC()) {
3096       if (FnInfo->isStr("memset"))
3097         return Builtin::BImemset;
3098       else if (FnInfo->isStr("memcpy"))
3099         return Builtin::BImemcpy;
3100       else if (FnInfo->isStr("memmove"))
3101         return Builtin::BImemmove;
3102       else if (FnInfo->isStr("memcmp"))
3103         return Builtin::BImemcmp;
3104       else if (FnInfo->isStr("strncpy"))
3105         return Builtin::BIstrncpy;
3106       else if (FnInfo->isStr("strncmp"))
3107         return Builtin::BIstrncmp;
3108       else if (FnInfo->isStr("strncasecmp"))
3109         return Builtin::BIstrncasecmp;
3110       else if (FnInfo->isStr("strncat"))
3111         return Builtin::BIstrncat;
3112       else if (FnInfo->isStr("strndup"))
3113         return Builtin::BIstrndup;
3114       else if (FnInfo->isStr("strlen"))
3115         return Builtin::BIstrlen;
3116     }
3117     break;
3118   }
3119   return 0;
3120 }
3121 
3122 //===----------------------------------------------------------------------===//
3123 // FieldDecl Implementation
3124 //===----------------------------------------------------------------------===//
3125 
3126 FieldDecl *FieldDecl::Create(const ASTContext &C, DeclContext *DC,
3127                              SourceLocation StartLoc, SourceLocation IdLoc,
3128                              IdentifierInfo *Id, QualType T,
3129                              TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
3130                              InClassInitStyle InitStyle) {
3131   return new (C, DC) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
3132                                BW, Mutable, InitStyle);
3133 }
3134 
3135 FieldDecl *FieldDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3136   return new (C, ID) FieldDecl(Field, 0, SourceLocation(), SourceLocation(),
3137                                0, QualType(), 0, 0, false, ICIS_NoInit);
3138 }
3139 
3140 bool FieldDecl::isAnonymousStructOrUnion() const {
3141   if (!isImplicit() || getDeclName())
3142     return false;
3143 
3144   if (const RecordType *Record = getType()->getAs<RecordType>())
3145     return Record->getDecl()->isAnonymousStructOrUnion();
3146 
3147   return false;
3148 }
3149 
3150 unsigned FieldDecl::getBitWidthValue(const ASTContext &Ctx) const {
3151   assert(isBitField() && "not a bitfield");
3152   Expr *BitWidth = InitializerOrBitWidth.getPointer();
3153   return BitWidth->EvaluateKnownConstInt(Ctx).getZExtValue();
3154 }
3155 
3156 unsigned FieldDecl::getFieldIndex() const {
3157   const FieldDecl *Canonical = getCanonicalDecl();
3158   if (Canonical != this)
3159     return Canonical->getFieldIndex();
3160 
3161   if (CachedFieldIndex) return CachedFieldIndex - 1;
3162 
3163   unsigned Index = 0;
3164   const RecordDecl *RD = getParent();
3165 
3166   for (RecordDecl::field_iterator I = RD->field_begin(), E = RD->field_end();
3167        I != E; ++I, ++Index)
3168     I->getCanonicalDecl()->CachedFieldIndex = Index + 1;
3169 
3170   assert(CachedFieldIndex && "failed to find field in parent");
3171   return CachedFieldIndex - 1;
3172 }
3173 
3174 SourceRange FieldDecl::getSourceRange() const {
3175   if (const Expr *E = InitializerOrBitWidth.getPointer())
3176     return SourceRange(getInnerLocStart(), E->getLocEnd());
3177   return DeclaratorDecl::getSourceRange();
3178 }
3179 
3180 void FieldDecl::setBitWidth(Expr *Width) {
3181   assert(!InitializerOrBitWidth.getPointer() && !hasInClassInitializer() &&
3182          "bit width or initializer already set");
3183   InitializerOrBitWidth.setPointer(Width);
3184 }
3185 
3186 void FieldDecl::setInClassInitializer(Expr *Init) {
3187   assert(!InitializerOrBitWidth.getPointer() && hasInClassInitializer() &&
3188          "bit width or initializer already set");
3189   InitializerOrBitWidth.setPointer(Init);
3190 }
3191 
3192 //===----------------------------------------------------------------------===//
3193 // TagDecl Implementation
3194 //===----------------------------------------------------------------------===//
3195 
3196 SourceLocation TagDecl::getOuterLocStart() const {
3197   return getTemplateOrInnerLocStart(this);
3198 }
3199 
3200 SourceRange TagDecl::getSourceRange() const {
3201   SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
3202   return SourceRange(getOuterLocStart(), E);
3203 }
3204 
3205 TagDecl *TagDecl::getCanonicalDecl() { return getFirstDecl(); }
3206 
3207 void TagDecl::setTypedefNameForAnonDecl(TypedefNameDecl *TDD) {
3208   NamedDeclOrQualifier = TDD;
3209   if (TypeForDecl)
3210     assert(TypeForDecl->isLinkageValid());
3211   assert(isLinkageValid());
3212 }
3213 
3214 void TagDecl::startDefinition() {
3215   IsBeingDefined = true;
3216 
3217   if (CXXRecordDecl *D = dyn_cast<CXXRecordDecl>(this)) {
3218     struct CXXRecordDecl::DefinitionData *Data =
3219       new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
3220     for (auto I : redecls())
3221       cast<CXXRecordDecl>(I)->DefinitionData = Data;
3222   }
3223 }
3224 
3225 void TagDecl::completeDefinition() {
3226   assert((!isa<CXXRecordDecl>(this) ||
3227           cast<CXXRecordDecl>(this)->hasDefinition()) &&
3228          "definition completed but not started");
3229 
3230   IsCompleteDefinition = true;
3231   IsBeingDefined = false;
3232 
3233   if (ASTMutationListener *L = getASTMutationListener())
3234     L->CompletedTagDefinition(this);
3235 }
3236 
3237 TagDecl *TagDecl::getDefinition() const {
3238   if (isCompleteDefinition())
3239     return const_cast<TagDecl *>(this);
3240 
3241   // If it's possible for us to have an out-of-date definition, check now.
3242   if (MayHaveOutOfDateDef) {
3243     if (IdentifierInfo *II = getIdentifier()) {
3244       if (II->isOutOfDate()) {
3245         updateOutOfDate(*II);
3246       }
3247     }
3248   }
3249 
3250   if (const CXXRecordDecl *CXXRD = dyn_cast<CXXRecordDecl>(this))
3251     return CXXRD->getDefinition();
3252 
3253   for (auto R : redecls())
3254     if (R->isCompleteDefinition())
3255       return R;
3256 
3257   return 0;
3258 }
3259 
3260 void TagDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
3261   if (QualifierLoc) {
3262     // Make sure the extended qualifier info is allocated.
3263     if (!hasExtInfo())
3264       NamedDeclOrQualifier = new (getASTContext()) ExtInfo;
3265     // Set qualifier info.
3266     getExtInfo()->QualifierLoc = QualifierLoc;
3267   } else {
3268     // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
3269     if (hasExtInfo()) {
3270       if (getExtInfo()->NumTemplParamLists == 0) {
3271         getASTContext().Deallocate(getExtInfo());
3272         NamedDeclOrQualifier = (TypedefNameDecl*) 0;
3273       }
3274       else
3275         getExtInfo()->QualifierLoc = QualifierLoc;
3276     }
3277   }
3278 }
3279 
3280 void TagDecl::setTemplateParameterListsInfo(ASTContext &Context,
3281                                             unsigned NumTPLists,
3282                                             TemplateParameterList **TPLists) {
3283   assert(NumTPLists > 0);
3284   // Make sure the extended decl info is allocated.
3285   if (!hasExtInfo())
3286     // Allocate external info struct.
3287     NamedDeclOrQualifier = new (getASTContext()) ExtInfo;
3288   // Set the template parameter lists info.
3289   getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
3290 }
3291 
3292 //===----------------------------------------------------------------------===//
3293 // EnumDecl Implementation
3294 //===----------------------------------------------------------------------===//
3295 
3296 void EnumDecl::anchor() { }
3297 
3298 EnumDecl *EnumDecl::Create(ASTContext &C, DeclContext *DC,
3299                            SourceLocation StartLoc, SourceLocation IdLoc,
3300                            IdentifierInfo *Id,
3301                            EnumDecl *PrevDecl, bool IsScoped,
3302                            bool IsScopedUsingClassTag, bool IsFixed) {
3303   EnumDecl *Enum = new (C, DC) EnumDecl(DC, StartLoc, IdLoc, Id, PrevDecl,
3304                                         IsScoped, IsScopedUsingClassTag,
3305                                         IsFixed);
3306   Enum->MayHaveOutOfDateDef = C.getLangOpts().Modules;
3307   C.getTypeDeclType(Enum, PrevDecl);
3308   return Enum;
3309 }
3310 
3311 EnumDecl *EnumDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3312   EnumDecl *Enum = new (C, ID) EnumDecl(0, SourceLocation(), SourceLocation(),
3313                                         0, 0, false, false, false);
3314   Enum->MayHaveOutOfDateDef = C.getLangOpts().Modules;
3315   return Enum;
3316 }
3317 
3318 SourceRange EnumDecl::getIntegerTypeRange() const {
3319   if (const TypeSourceInfo *TI = getIntegerTypeSourceInfo())
3320     return TI->getTypeLoc().getSourceRange();
3321   return SourceRange();
3322 }
3323 
3324 void EnumDecl::completeDefinition(QualType NewType,
3325                                   QualType NewPromotionType,
3326                                   unsigned NumPositiveBits,
3327                                   unsigned NumNegativeBits) {
3328   assert(!isCompleteDefinition() && "Cannot redefine enums!");
3329   if (!IntegerType)
3330     IntegerType = NewType.getTypePtr();
3331   PromotionType = NewPromotionType;
3332   setNumPositiveBits(NumPositiveBits);
3333   setNumNegativeBits(NumNegativeBits);
3334   TagDecl::completeDefinition();
3335 }
3336 
3337 TemplateSpecializationKind EnumDecl::getTemplateSpecializationKind() const {
3338   if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
3339     return MSI->getTemplateSpecializationKind();
3340 
3341   return TSK_Undeclared;
3342 }
3343 
3344 void EnumDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
3345                                          SourceLocation PointOfInstantiation) {
3346   MemberSpecializationInfo *MSI = getMemberSpecializationInfo();
3347   assert(MSI && "Not an instantiated member enumeration?");
3348   MSI->setTemplateSpecializationKind(TSK);
3349   if (TSK != TSK_ExplicitSpecialization &&
3350       PointOfInstantiation.isValid() &&
3351       MSI->getPointOfInstantiation().isInvalid())
3352     MSI->setPointOfInstantiation(PointOfInstantiation);
3353 }
3354 
3355 EnumDecl *EnumDecl::getInstantiatedFromMemberEnum() const {
3356   if (SpecializationInfo)
3357     return cast<EnumDecl>(SpecializationInfo->getInstantiatedFrom());
3358 
3359   return 0;
3360 }
3361 
3362 void EnumDecl::setInstantiationOfMemberEnum(ASTContext &C, EnumDecl *ED,
3363                                             TemplateSpecializationKind TSK) {
3364   assert(!SpecializationInfo && "Member enum is already a specialization");
3365   SpecializationInfo = new (C) MemberSpecializationInfo(ED, TSK);
3366 }
3367 
3368 //===----------------------------------------------------------------------===//
3369 // RecordDecl Implementation
3370 //===----------------------------------------------------------------------===//
3371 
3372 RecordDecl::RecordDecl(Kind DK, TagKind TK, DeclContext *DC,
3373                        SourceLocation StartLoc, SourceLocation IdLoc,
3374                        IdentifierInfo *Id, RecordDecl *PrevDecl)
3375   : TagDecl(DK, TK, DC, IdLoc, Id, PrevDecl, StartLoc) {
3376   HasFlexibleArrayMember = false;
3377   AnonymousStructOrUnion = false;
3378   HasObjectMember = false;
3379   HasVolatileMember = false;
3380   LoadedFieldsFromExternalStorage = false;
3381   assert(classof(static_cast<Decl*>(this)) && "Invalid Kind!");
3382 }
3383 
3384 RecordDecl *RecordDecl::Create(const ASTContext &C, TagKind TK, DeclContext *DC,
3385                                SourceLocation StartLoc, SourceLocation IdLoc,
3386                                IdentifierInfo *Id, RecordDecl* PrevDecl) {
3387   RecordDecl* R = new (C, DC) RecordDecl(Record, TK, DC, StartLoc, IdLoc, Id,
3388                                          PrevDecl);
3389   R->MayHaveOutOfDateDef = C.getLangOpts().Modules;
3390 
3391   C.getTypeDeclType(R, PrevDecl);
3392   return R;
3393 }
3394 
3395 RecordDecl *RecordDecl::CreateDeserialized(const ASTContext &C, unsigned ID) {
3396   RecordDecl *R = new (C, ID) RecordDecl(Record, TTK_Struct, 0, SourceLocation(),
3397                                          SourceLocation(), 0, 0);
3398   R->MayHaveOutOfDateDef = C.getLangOpts().Modules;
3399   return R;
3400 }
3401 
3402 bool RecordDecl::isInjectedClassName() const {
3403   return isImplicit() && getDeclName() && getDeclContext()->isRecord() &&
3404     cast<RecordDecl>(getDeclContext())->getDeclName() == getDeclName();
3405 }
3406 
3407 RecordDecl::field_iterator RecordDecl::field_begin() const {
3408   if (hasExternalLexicalStorage() && !LoadedFieldsFromExternalStorage)
3409     LoadFieldsFromExternalStorage();
3410 
3411   return field_iterator(decl_iterator(FirstDecl));
3412 }
3413 
3414 /// completeDefinition - Notes that the definition of this type is now
3415 /// complete.
3416 void RecordDecl::completeDefinition() {
3417   assert(!isCompleteDefinition() && "Cannot redefine record!");
3418   TagDecl::completeDefinition();
3419 }
3420 
3421 /// isMsStruct - Get whether or not this record uses ms_struct layout.
3422 /// This which can be turned on with an attribute, pragma, or the
3423 /// -mms-bitfields command-line option.
3424 bool RecordDecl::isMsStruct(const ASTContext &C) const {
3425   return hasAttr<MsStructAttr>() || C.getLangOpts().MSBitfields == 1;
3426 }
3427 
3428 static bool isFieldOrIndirectField(Decl::Kind K) {
3429   return FieldDecl::classofKind(K) || IndirectFieldDecl::classofKind(K);
3430 }
3431 
3432 void RecordDecl::LoadFieldsFromExternalStorage() const {
3433   ExternalASTSource *Source = getASTContext().getExternalSource();
3434   assert(hasExternalLexicalStorage() && Source && "No external storage?");
3435 
3436   // Notify that we have a RecordDecl doing some initialization.
3437   ExternalASTSource::Deserializing TheFields(Source);
3438 
3439   SmallVector<Decl*, 64> Decls;
3440   LoadedFieldsFromExternalStorage = true;
3441   switch (Source->FindExternalLexicalDecls(this, isFieldOrIndirectField,
3442                                            Decls)) {
3443   case ELR_Success:
3444     break;
3445 
3446   case ELR_AlreadyLoaded:
3447   case ELR_Failure:
3448     return;
3449   }
3450 
3451 #ifndef NDEBUG
3452   // Check that all decls we got were FieldDecls.
3453   for (unsigned i=0, e=Decls.size(); i != e; ++i)
3454     assert(isa<FieldDecl>(Decls[i]) || isa<IndirectFieldDecl>(Decls[i]));
3455 #endif
3456 
3457   if (Decls.empty())
3458     return;
3459 
3460   std::tie(FirstDecl, LastDecl) = BuildDeclChain(Decls,
3461                                                  /*FieldsAlreadyLoaded=*/false);
3462 }
3463 
3464 //===----------------------------------------------------------------------===//
3465 // BlockDecl Implementation
3466 //===----------------------------------------------------------------------===//
3467 
3468 void BlockDecl::setParams(ArrayRef<ParmVarDecl *> NewParamInfo) {
3469   assert(ParamInfo == 0 && "Already has param info!");
3470 
3471   // Zero params -> null pointer.
3472   if (!NewParamInfo.empty()) {
3473     NumParams = NewParamInfo.size();
3474     ParamInfo = new (getASTContext()) ParmVarDecl*[NewParamInfo.size()];
3475     std::copy(NewParamInfo.begin(), NewParamInfo.end(), ParamInfo);
3476   }
3477 }
3478 
3479 void BlockDecl::setCaptures(ASTContext &Context,
3480                             const Capture *begin,
3481                             const Capture *end,
3482                             bool capturesCXXThis) {
3483   CapturesCXXThis = capturesCXXThis;
3484 
3485   if (begin == end) {
3486     NumCaptures = 0;
3487     Captures = 0;
3488     return;
3489   }
3490 
3491   NumCaptures = end - begin;
3492 
3493   // Avoid new Capture[] because we don't want to provide a default
3494   // constructor.
3495   size_t allocationSize = NumCaptures * sizeof(Capture);
3496   void *buffer = Context.Allocate(allocationSize, /*alignment*/sizeof(void*));
3497   memcpy(buffer, begin, allocationSize);
3498   Captures = static_cast<Capture*>(buffer);
3499 }
3500 
3501 bool BlockDecl::capturesVariable(const VarDecl *variable) const {
3502   for (const auto &I : captures())
3503     // Only auto vars can be captured, so no redeclaration worries.
3504     if (I.getVariable() == variable)
3505       return true;
3506 
3507   return false;
3508 }
3509 
3510 SourceRange BlockDecl::getSourceRange() const {
3511   return SourceRange(getLocation(), Body? Body->getLocEnd() : getLocation());
3512 }
3513 
3514 //===----------------------------------------------------------------------===//
3515 // Other Decl Allocation/Deallocation Method Implementations
3516 //===----------------------------------------------------------------------===//
3517 
3518 void TranslationUnitDecl::anchor() { }
3519 
3520 TranslationUnitDecl *TranslationUnitDecl::Create(ASTContext &C) {
3521   return new (C, (DeclContext*)0) TranslationUnitDecl(C);
3522 }
3523 
3524 void LabelDecl::anchor() { }
3525 
3526 LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
3527                              SourceLocation IdentL, IdentifierInfo *II) {
3528   return new (C, DC) LabelDecl(DC, IdentL, II, 0, IdentL);
3529 }
3530 
3531 LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
3532                              SourceLocation IdentL, IdentifierInfo *II,
3533                              SourceLocation GnuLabelL) {
3534   assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
3535   return new (C, DC) LabelDecl(DC, IdentL, II, 0, GnuLabelL);
3536 }
3537 
3538 LabelDecl *LabelDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3539   return new (C, ID) LabelDecl(0, SourceLocation(), 0, 0, SourceLocation());
3540 }
3541 
3542 void ValueDecl::anchor() { }
3543 
3544 bool ValueDecl::isWeak() const {
3545   for (const auto *I : attrs())
3546     if (isa<WeakAttr>(I) || isa<WeakRefAttr>(I))
3547       return true;
3548 
3549   return isWeakImported();
3550 }
3551 
3552 void ImplicitParamDecl::anchor() { }
3553 
3554 ImplicitParamDecl *ImplicitParamDecl::Create(ASTContext &C, DeclContext *DC,
3555                                              SourceLocation IdLoc,
3556                                              IdentifierInfo *Id,
3557                                              QualType Type) {
3558   return new (C, DC) ImplicitParamDecl(DC, IdLoc, Id, Type);
3559 }
3560 
3561 ImplicitParamDecl *ImplicitParamDecl::CreateDeserialized(ASTContext &C,
3562                                                          unsigned ID) {
3563   return new (C, ID) ImplicitParamDecl(0, SourceLocation(), 0, QualType());
3564 }
3565 
3566 FunctionDecl *FunctionDecl::Create(ASTContext &C, DeclContext *DC,
3567                                    SourceLocation StartLoc,
3568                                    const DeclarationNameInfo &NameInfo,
3569                                    QualType T, TypeSourceInfo *TInfo,
3570                                    StorageClass SC,
3571                                    bool isInlineSpecified,
3572                                    bool hasWrittenPrototype,
3573                                    bool isConstexprSpecified) {
3574   FunctionDecl *New =
3575       new (C, DC) FunctionDecl(Function, DC, StartLoc, NameInfo, T, TInfo, SC,
3576                                isInlineSpecified, isConstexprSpecified);
3577   New->HasWrittenPrototype = hasWrittenPrototype;
3578   return New;
3579 }
3580 
3581 FunctionDecl *FunctionDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3582   return new (C, ID) FunctionDecl(Function, 0, SourceLocation(),
3583                                   DeclarationNameInfo(), QualType(), 0,
3584                                   SC_None, false, false);
3585 }
3586 
3587 BlockDecl *BlockDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L) {
3588   return new (C, DC) BlockDecl(DC, L);
3589 }
3590 
3591 BlockDecl *BlockDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3592   return new (C, ID) BlockDecl(0, SourceLocation());
3593 }
3594 
3595 CapturedDecl *CapturedDecl::Create(ASTContext &C, DeclContext *DC,
3596                                    unsigned NumParams) {
3597   return new (C, DC, NumParams * sizeof(ImplicitParamDecl *))
3598       CapturedDecl(DC, NumParams);
3599 }
3600 
3601 CapturedDecl *CapturedDecl::CreateDeserialized(ASTContext &C, unsigned ID,
3602                                                unsigned NumParams) {
3603   return new (C, ID, NumParams * sizeof(ImplicitParamDecl *))
3604       CapturedDecl(0, NumParams);
3605 }
3606 
3607 EnumConstantDecl *EnumConstantDecl::Create(ASTContext &C, EnumDecl *CD,
3608                                            SourceLocation L,
3609                                            IdentifierInfo *Id, QualType T,
3610                                            Expr *E, const llvm::APSInt &V) {
3611   return new (C, CD) EnumConstantDecl(CD, L, Id, T, E, V);
3612 }
3613 
3614 EnumConstantDecl *
3615 EnumConstantDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3616   return new (C, ID) EnumConstantDecl(0, SourceLocation(), 0, QualType(), 0,
3617                                       llvm::APSInt());
3618 }
3619 
3620 void IndirectFieldDecl::anchor() { }
3621 
3622 IndirectFieldDecl *
3623 IndirectFieldDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
3624                           IdentifierInfo *Id, QualType T, NamedDecl **CH,
3625                           unsigned CHS) {
3626   return new (C, DC) IndirectFieldDecl(DC, L, Id, T, CH, CHS);
3627 }
3628 
3629 IndirectFieldDecl *IndirectFieldDecl::CreateDeserialized(ASTContext &C,
3630                                                          unsigned ID) {
3631   return new (C, ID) IndirectFieldDecl(0, SourceLocation(), DeclarationName(),
3632                                        QualType(), 0, 0);
3633 }
3634 
3635 SourceRange EnumConstantDecl::getSourceRange() const {
3636   SourceLocation End = getLocation();
3637   if (Init)
3638     End = Init->getLocEnd();
3639   return SourceRange(getLocation(), End);
3640 }
3641 
3642 void TypeDecl::anchor() { }
3643 
3644 TypedefDecl *TypedefDecl::Create(ASTContext &C, DeclContext *DC,
3645                                  SourceLocation StartLoc, SourceLocation IdLoc,
3646                                  IdentifierInfo *Id, TypeSourceInfo *TInfo) {
3647   return new (C, DC) TypedefDecl(DC, StartLoc, IdLoc, Id, TInfo);
3648 }
3649 
3650 void TypedefNameDecl::anchor() { }
3651 
3652 TypedefDecl *TypedefDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3653   return new (C, ID) TypedefDecl(0, SourceLocation(), SourceLocation(), 0, 0);
3654 }
3655 
3656 TypeAliasDecl *TypeAliasDecl::Create(ASTContext &C, DeclContext *DC,
3657                                      SourceLocation StartLoc,
3658                                      SourceLocation IdLoc, IdentifierInfo *Id,
3659                                      TypeSourceInfo *TInfo) {
3660   return new (C, DC) TypeAliasDecl(DC, StartLoc, IdLoc, Id, TInfo);
3661 }
3662 
3663 TypeAliasDecl *TypeAliasDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3664   return new (C, ID) TypeAliasDecl(0, SourceLocation(), SourceLocation(), 0, 0);
3665 }
3666 
3667 SourceRange TypedefDecl::getSourceRange() const {
3668   SourceLocation RangeEnd = getLocation();
3669   if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
3670     if (typeIsPostfix(TInfo->getType()))
3671       RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
3672   }
3673   return SourceRange(getLocStart(), RangeEnd);
3674 }
3675 
3676 SourceRange TypeAliasDecl::getSourceRange() const {
3677   SourceLocation RangeEnd = getLocStart();
3678   if (TypeSourceInfo *TInfo = getTypeSourceInfo())
3679     RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
3680   return SourceRange(getLocStart(), RangeEnd);
3681 }
3682 
3683 void FileScopeAsmDecl::anchor() { }
3684 
3685 FileScopeAsmDecl *FileScopeAsmDecl::Create(ASTContext &C, DeclContext *DC,
3686                                            StringLiteral *Str,
3687                                            SourceLocation AsmLoc,
3688                                            SourceLocation RParenLoc) {
3689   return new (C, DC) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);
3690 }
3691 
3692 FileScopeAsmDecl *FileScopeAsmDecl::CreateDeserialized(ASTContext &C,
3693                                                        unsigned ID) {
3694   return new (C, ID) FileScopeAsmDecl(0, 0, SourceLocation(), SourceLocation());
3695 }
3696 
3697 void EmptyDecl::anchor() {}
3698 
3699 EmptyDecl *EmptyDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L) {
3700   return new (C, DC) EmptyDecl(DC, L);
3701 }
3702 
3703 EmptyDecl *EmptyDecl::CreateDeserialized(ASTContext &C, unsigned ID) {
3704   return new (C, ID) EmptyDecl(0, SourceLocation());
3705 }
3706 
3707 //===----------------------------------------------------------------------===//
3708 // ImportDecl Implementation
3709 //===----------------------------------------------------------------------===//
3710 
3711 /// \brief Retrieve the number of module identifiers needed to name the given
3712 /// module.
3713 static unsigned getNumModuleIdentifiers(Module *Mod) {
3714   unsigned Result = 1;
3715   while (Mod->Parent) {
3716     Mod = Mod->Parent;
3717     ++Result;
3718   }
3719   return Result;
3720 }
3721 
3722 ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
3723                        Module *Imported,
3724                        ArrayRef<SourceLocation> IdentifierLocs)
3725   : Decl(Import, DC, StartLoc), ImportedAndComplete(Imported, true),
3726     NextLocalImport()
3727 {
3728   assert(getNumModuleIdentifiers(Imported) == IdentifierLocs.size());
3729   SourceLocation *StoredLocs = reinterpret_cast<SourceLocation *>(this + 1);
3730   memcpy(StoredLocs, IdentifierLocs.data(),
3731          IdentifierLocs.size() * sizeof(SourceLocation));
3732 }
3733 
3734 ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
3735                        Module *Imported, SourceLocation EndLoc)
3736   : Decl(Import, DC, StartLoc), ImportedAndComplete(Imported, false),
3737     NextLocalImport()
3738 {
3739   *reinterpret_cast<SourceLocation *>(this + 1) = EndLoc;
3740 }
3741 
3742 ImportDecl *ImportDecl::Create(ASTContext &C, DeclContext *DC,
3743                                SourceLocation StartLoc, Module *Imported,
3744                                ArrayRef<SourceLocation> IdentifierLocs) {
3745   return new (C, DC, IdentifierLocs.size() * sizeof(SourceLocation))
3746       ImportDecl(DC, StartLoc, Imported, IdentifierLocs);
3747 }
3748 
3749 ImportDecl *ImportDecl::CreateImplicit(ASTContext &C, DeclContext *DC,
3750                                        SourceLocation StartLoc,
3751                                        Module *Imported,
3752                                        SourceLocation EndLoc) {
3753   ImportDecl *Import =
3754       new (C, DC, sizeof(SourceLocation)) ImportDecl(DC, StartLoc,
3755                                                      Imported, EndLoc);
3756   Import->setImplicit();
3757   return Import;
3758 }
3759 
3760 ImportDecl *ImportDecl::CreateDeserialized(ASTContext &C, unsigned ID,
3761                                            unsigned NumLocations) {
3762   return new (C, ID, NumLocations * sizeof(SourceLocation))
3763       ImportDecl(EmptyShell());
3764 }
3765 
3766 ArrayRef<SourceLocation> ImportDecl::getIdentifierLocs() const {
3767   if (!ImportedAndComplete.getInt())
3768     return None;
3769 
3770   const SourceLocation *StoredLocs
3771     = reinterpret_cast<const SourceLocation *>(this + 1);
3772   return ArrayRef<SourceLocation>(StoredLocs,
3773                                   getNumModuleIdentifiers(getImportedModule()));
3774 }
3775 
3776 SourceRange ImportDecl::getSourceRange() const {
3777   if (!ImportedAndComplete.getInt())
3778     return SourceRange(getLocation(),
3779                        *reinterpret_cast<const SourceLocation *>(this + 1));
3780 
3781   return SourceRange(getLocation(), getIdentifierLocs().back());
3782 }
3783