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