1 //===--- Decl.cpp - Declaration AST Node Implementation -------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file implements the Decl subclasses.
12 //===----------------------------------------------------------------------===//
14 #include "clang/AST/Decl.h"
15 #include "clang/AST/DeclCXX.h"
16 #include "clang/AST/DeclObjC.h"
17 #include "clang/AST/DeclTemplate.h"
18 #include "clang/AST/ASTContext.h"
19 #include "clang/AST/TypeLoc.h"
20 #include "clang/AST/Stmt.h"
21 #include "clang/AST/Expr.h"
22 #include "clang/AST/ExprCXX.h"
23 #include "clang/AST/PrettyPrinter.h"
24 #include "clang/AST/ASTMutationListener.h"
25 #include "clang/Basic/Builtins.h"
26 #include "clang/Basic/IdentifierTable.h"
27 #include "clang/Basic/Specifiers.h"
28 #include "clang/Basic/TargetInfo.h"
29 #include "llvm/Support/ErrorHandling.h"
31 using namespace clang;
33 //===----------------------------------------------------------------------===//
34 // NamedDecl Implementation
35 //===----------------------------------------------------------------------===//
37 static llvm::Optional<Visibility> getVisibilityOf(const Decl *D) {
38 // If this declaration has an explicit visibility attribute, use it.
39 if (const VisibilityAttr *A = D->getAttr<VisibilityAttr>()) {
40 switch (A->getVisibility()) {
41 case VisibilityAttr::Default:
42 return DefaultVisibility;
43 case VisibilityAttr::Hidden:
44 return HiddenVisibility;
45 case VisibilityAttr::Protected:
46 return ProtectedVisibility;
49 return DefaultVisibility;
52 // If we're on Mac OS X, an 'availability' for Mac OS X attribute
53 // implies visibility(default).
54 if (D->getASTContext().Target.getTriple().isOSDarwin()) {
55 for (specific_attr_iterator<AvailabilityAttr>
56 A = D->specific_attr_begin<AvailabilityAttr>(),
57 AEnd = D->specific_attr_end<AvailabilityAttr>();
59 if ((*A)->getPlatform()->getName().equals("macosx"))
60 return DefaultVisibility;
63 return llvm::Optional<Visibility>();
66 typedef NamedDecl::LinkageInfo LinkageInfo;
67 typedef std::pair<Linkage,Visibility> LVPair;
69 static LVPair merge(LVPair L, LVPair R) {
70 return LVPair(minLinkage(L.first, R.first),
71 minVisibility(L.second, R.second));
74 static LVPair merge(LVPair L, LinkageInfo R) {
75 return LVPair(minLinkage(L.first, R.linkage()),
76 minVisibility(L.second, R.visibility()));
80 /// Flags controlling the computation of linkage and visibility.
82 bool ConsiderGlobalVisibility;
83 bool ConsiderVisibilityAttributes;
84 bool ConsiderTemplateParameterTypes;
86 LVFlags() : ConsiderGlobalVisibility(true),
87 ConsiderVisibilityAttributes(true),
88 ConsiderTemplateParameterTypes(true) {
91 /// \brief Returns a set of flags that is only useful for computing the
92 /// linkage, not the visibility, of a declaration.
93 static LVFlags CreateOnlyDeclLinkage() {
95 F.ConsiderGlobalVisibility = false;
96 F.ConsiderVisibilityAttributes = false;
97 F.ConsiderTemplateParameterTypes = false;
101 /// Returns a set of flags, otherwise based on these, which ignores
102 /// off all sources of visibility except template arguments.
103 LVFlags onlyTemplateVisibility() const {
105 F.ConsiderGlobalVisibility = false;
106 F.ConsiderVisibilityAttributes = false;
107 F.ConsiderTemplateParameterTypes = false;
111 } // end anonymous namespace
113 /// \brief Get the most restrictive linkage for the types in the given
114 /// template parameter list.
116 getLVForTemplateParameterList(const TemplateParameterList *Params) {
117 LVPair LV(ExternalLinkage, DefaultVisibility);
118 for (TemplateParameterList::const_iterator P = Params->begin(),
119 PEnd = Params->end();
121 if (NonTypeTemplateParmDecl *NTTP = dyn_cast<NonTypeTemplateParmDecl>(*P)) {
122 if (NTTP->isExpandedParameterPack()) {
123 for (unsigned I = 0, N = NTTP->getNumExpansionTypes(); I != N; ++I) {
124 QualType T = NTTP->getExpansionType(I);
125 if (!T->isDependentType())
126 LV = merge(LV, T->getLinkageAndVisibility());
131 if (!NTTP->getType()->isDependentType()) {
132 LV = merge(LV, NTTP->getType()->getLinkageAndVisibility());
137 if (TemplateTemplateParmDecl *TTP
138 = dyn_cast<TemplateTemplateParmDecl>(*P)) {
139 LV = merge(LV, getLVForTemplateParameterList(TTP->getTemplateParameters()));
146 /// getLVForDecl - Get the linkage and visibility for the given declaration.
147 static LinkageInfo getLVForDecl(const NamedDecl *D, LVFlags F);
149 /// \brief Get the most restrictive linkage for the types and
150 /// declarations in the given template argument list.
151 static LVPair getLVForTemplateArgumentList(const TemplateArgument *Args,
154 LVPair LV(ExternalLinkage, DefaultVisibility);
156 for (unsigned I = 0; I != NumArgs; ++I) {
157 switch (Args[I].getKind()) {
158 case TemplateArgument::Null:
159 case TemplateArgument::Integral:
160 case TemplateArgument::Expression:
163 case TemplateArgument::Type:
164 LV = merge(LV, Args[I].getAsType()->getLinkageAndVisibility());
167 case TemplateArgument::Declaration:
168 // The decl can validly be null as the representation of nullptr
169 // arguments, valid only in C++0x.
170 if (Decl *D = Args[I].getAsDecl()) {
171 if (NamedDecl *ND = dyn_cast<NamedDecl>(D))
172 LV = merge(LV, getLVForDecl(ND, F));
176 case TemplateArgument::Template:
177 case TemplateArgument::TemplateExpansion:
178 if (TemplateDecl *Template
179 = Args[I].getAsTemplateOrTemplatePattern().getAsTemplateDecl())
180 LV = merge(LV, getLVForDecl(Template, F));
183 case TemplateArgument::Pack:
184 LV = merge(LV, getLVForTemplateArgumentList(Args[I].pack_begin(),
195 getLVForTemplateArgumentList(const TemplateArgumentList &TArgs,
197 return getLVForTemplateArgumentList(TArgs.data(), TArgs.size(), F);
200 static LinkageInfo getLVForNamespaceScopeDecl(const NamedDecl *D, LVFlags F) {
201 assert(D->getDeclContext()->getRedeclContext()->isFileContext() &&
202 "Not a name having namespace scope");
203 ASTContext &Context = D->getASTContext();
205 // C++ [basic.link]p3:
206 // A name having namespace scope (3.3.6) has internal linkage if it
208 // - an object, reference, function or function template that is
209 // explicitly declared static; or,
210 // (This bullet corresponds to C99 6.2.2p3.)
211 if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
212 // Explicitly declared static.
213 if (Var->getStorageClass() == SC_Static)
214 return LinkageInfo::internal();
216 // - an object or reference that is explicitly declared const
217 // and neither explicitly declared extern nor previously
218 // declared to have external linkage; or
219 // (there is no equivalent in C99)
220 if (Context.getLangOptions().CPlusPlus &&
221 Var->getType().isConstant(Context) &&
222 Var->getStorageClass() != SC_Extern &&
223 Var->getStorageClass() != SC_PrivateExtern) {
224 bool FoundExtern = false;
225 for (const VarDecl *PrevVar = Var->getPreviousDeclaration();
226 PrevVar && !FoundExtern;
227 PrevVar = PrevVar->getPreviousDeclaration())
228 if (isExternalLinkage(PrevVar->getLinkage()))
232 return LinkageInfo::internal();
234 } else if (isa<FunctionDecl>(D) || isa<FunctionTemplateDecl>(D)) {
236 // A non-member function template can have internal linkage; any
237 // other template name shall have external linkage.
238 const FunctionDecl *Function = 0;
239 if (const FunctionTemplateDecl *FunTmpl
240 = dyn_cast<FunctionTemplateDecl>(D))
241 Function = FunTmpl->getTemplatedDecl();
243 Function = cast<FunctionDecl>(D);
245 // Explicitly declared static.
246 if (Function->getStorageClass() == SC_Static)
247 return LinkageInfo(InternalLinkage, DefaultVisibility, false);
248 } else if (const FieldDecl *Field = dyn_cast<FieldDecl>(D)) {
249 // - a data member of an anonymous union.
250 if (cast<RecordDecl>(Field->getDeclContext())->isAnonymousStructOrUnion())
251 return LinkageInfo::internal();
254 if (D->isInAnonymousNamespace()) {
255 const VarDecl *Var = dyn_cast<VarDecl>(D);
256 const FunctionDecl *Func = dyn_cast<FunctionDecl>(D);
257 if ((!Var || !Var->isExternC()) && (!Func || !Func->isExternC()))
258 return LinkageInfo::uniqueExternal();
261 // Set up the defaults.
264 // If the declaration of an identifier for an object has file
265 // scope and no storage-class specifier, its linkage is
269 if (F.ConsiderVisibilityAttributes) {
270 if (llvm::Optional<Visibility> Vis = D->getExplicitVisibility()) {
271 LV.setVisibility(*Vis, true);
272 F.ConsiderGlobalVisibility = false;
274 // If we're declared in a namespace with a visibility attribute,
275 // use that namespace's visibility, but don't call it explicit.
276 for (const DeclContext *DC = D->getDeclContext();
277 !isa<TranslationUnitDecl>(DC);
278 DC = DC->getParent()) {
279 if (!isa<NamespaceDecl>(DC)) continue;
280 if (llvm::Optional<Visibility> Vis
281 = cast<NamespaceDecl>(DC)->getExplicitVisibility()) {
282 LV.setVisibility(*Vis, false);
283 F.ConsiderGlobalVisibility = false;
290 // C++ [basic.link]p4:
292 // A name having namespace scope has external linkage if it is the
295 // - an object or reference, unless it has internal linkage; or
296 if (const VarDecl *Var = dyn_cast<VarDecl>(D)) {
297 // GCC applies the following optimization to variables and static
298 // data members, but not to functions:
300 // Modify the variable's LV by the LV of its type unless this is
301 // C or extern "C". This follows from [basic.link]p9:
302 // A type without linkage shall not be used as the type of a
303 // variable or function with external linkage unless
304 // - the entity has C language linkage, or
305 // - the entity is declared within an unnamed namespace, or
306 // - the entity is not used or is defined in the same
308 // and [basic.link]p10:
309 // ...the types specified by all declarations referring to a
310 // given variable or function shall be identical...
311 // C does not have an equivalent rule.
313 // Ignore this if we've got an explicit attribute; the user
314 // probably knows what they're doing.
316 // Note that we don't want to make the variable non-external
317 // because of this, but unique-external linkage suits us.
318 if (Context.getLangOptions().CPlusPlus && !Var->isExternC()) {
319 LVPair TypeLV = Var->getType()->getLinkageAndVisibility();
320 if (TypeLV.first != ExternalLinkage)
321 return LinkageInfo::uniqueExternal();
322 if (!LV.visibilityExplicit())
323 LV.mergeVisibility(TypeLV.second);
326 if (Var->getStorageClass() == SC_PrivateExtern)
327 LV.setVisibility(HiddenVisibility, true);
329 if (!Context.getLangOptions().CPlusPlus &&
330 (Var->getStorageClass() == SC_Extern ||
331 Var->getStorageClass() == SC_PrivateExtern)) {
334 // For an identifier declared with the storage-class specifier
335 // extern in a scope in which a prior declaration of that
336 // identifier is visible, if the prior declaration specifies
337 // internal or external linkage, the linkage of the identifier
338 // at the later declaration is the same as the linkage
339 // specified at the prior declaration. If no prior declaration
340 // is visible, or if the prior declaration specifies no
341 // linkage, then the identifier has external linkage.
342 if (const VarDecl *PrevVar = Var->getPreviousDeclaration()) {
343 LinkageInfo PrevLV = getLVForDecl(PrevVar, F);
344 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
345 LV.mergeVisibility(PrevLV);
349 // - a function, unless it has internal linkage; or
350 } else if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
351 // In theory, we can modify the function's LV by the LV of its
352 // type unless it has C linkage (see comment above about variables
353 // for justification). In practice, GCC doesn't do this, so it's
354 // just too painful to make work.
356 if (Function->getStorageClass() == SC_PrivateExtern)
357 LV.setVisibility(HiddenVisibility, true);
360 // If the declaration of an identifier for a function has no
361 // storage-class specifier, its linkage is determined exactly
362 // as if it were declared with the storage-class specifier
364 if (!Context.getLangOptions().CPlusPlus &&
365 (Function->getStorageClass() == SC_Extern ||
366 Function->getStorageClass() == SC_PrivateExtern ||
367 Function->getStorageClass() == SC_None)) {
369 // For an identifier declared with the storage-class specifier
370 // extern in a scope in which a prior declaration of that
371 // identifier is visible, if the prior declaration specifies
372 // internal or external linkage, the linkage of the identifier
373 // at the later declaration is the same as the linkage
374 // specified at the prior declaration. If no prior declaration
375 // is visible, or if the prior declaration specifies no
376 // linkage, then the identifier has external linkage.
377 if (const FunctionDecl *PrevFunc = Function->getPreviousDeclaration()) {
378 LinkageInfo PrevLV = getLVForDecl(PrevFunc, F);
379 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
380 LV.mergeVisibility(PrevLV);
384 // In C++, then if the type of the function uses a type with
385 // unique-external linkage, it's not legally usable from outside
386 // this translation unit. However, we should use the C linkage
387 // rules instead for extern "C" declarations.
388 if (Context.getLangOptions().CPlusPlus && !Function->isExternC() &&
389 Function->getType()->getLinkage() == UniqueExternalLinkage)
390 return LinkageInfo::uniqueExternal();
392 if (FunctionTemplateSpecializationInfo *SpecInfo
393 = Function->getTemplateSpecializationInfo()) {
394 LV.merge(getLVForDecl(SpecInfo->getTemplate(),
395 F.onlyTemplateVisibility()));
396 const TemplateArgumentList &TemplateArgs = *SpecInfo->TemplateArguments;
397 LV.merge(getLVForTemplateArgumentList(TemplateArgs, F));
400 // - a named class (Clause 9), or an unnamed class defined in a
401 // typedef declaration in which the class has the typedef name
402 // for linkage purposes (7.1.3); or
403 // - a named enumeration (7.2), or an unnamed enumeration
404 // defined in a typedef declaration in which the enumeration
405 // has the typedef name for linkage purposes (7.1.3); or
406 } else if (const TagDecl *Tag = dyn_cast<TagDecl>(D)) {
407 // Unnamed tags have no linkage.
408 if (!Tag->getDeclName() && !Tag->getTypedefNameForAnonDecl())
409 return LinkageInfo::none();
411 // If this is a class template specialization, consider the
412 // linkage of the template and template arguments.
413 if (const ClassTemplateSpecializationDecl *Spec
414 = dyn_cast<ClassTemplateSpecializationDecl>(Tag)) {
415 // From the template.
416 LV.merge(getLVForDecl(Spec->getSpecializedTemplate(),
417 F.onlyTemplateVisibility()));
419 // The arguments at which the template was instantiated.
420 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
421 LV.merge(getLVForTemplateArgumentList(TemplateArgs, F));
424 // Consider -fvisibility unless the type has C linkage.
425 if (F.ConsiderGlobalVisibility)
426 F.ConsiderGlobalVisibility =
427 (Context.getLangOptions().CPlusPlus &&
428 !Tag->getDeclContext()->isExternCContext());
430 // - an enumerator belonging to an enumeration with external linkage;
431 } else if (isa<EnumConstantDecl>(D)) {
432 LinkageInfo EnumLV = getLVForDecl(cast<NamedDecl>(D->getDeclContext()), F);
433 if (!isExternalLinkage(EnumLV.linkage()))
434 return LinkageInfo::none();
437 // - a template, unless it is a function template that has
438 // internal linkage (Clause 14);
439 } else if (const TemplateDecl *temp = dyn_cast<TemplateDecl>(D)) {
440 if (F.ConsiderTemplateParameterTypes)
441 LV.merge(getLVForTemplateParameterList(temp->getTemplateParameters()));
443 // - a namespace (7.3), unless it is declared within an unnamed
445 } else if (isa<NamespaceDecl>(D) && !D->isInAnonymousNamespace()) {
448 // By extension, we assign external linkage to Objective-C
450 } else if (isa<ObjCInterfaceDecl>(D)) {
453 // Everything not covered here has no linkage.
455 return LinkageInfo::none();
458 // If we ended up with non-external linkage, visibility should
459 // always be default.
460 if (LV.linkage() != ExternalLinkage)
461 return LinkageInfo(LV.linkage(), DefaultVisibility, false);
463 // If we didn't end up with hidden visibility, consider attributes
465 if (F.ConsiderGlobalVisibility)
466 LV.mergeVisibility(Context.getLangOptions().getVisibilityMode());
471 static LinkageInfo getLVForClassMember(const NamedDecl *D, LVFlags F) {
472 // Only certain class members have linkage. Note that fields don't
473 // really have linkage, but it's convenient to say they do for the
474 // purposes of calculating linkage of pointer-to-data-member
475 // template arguments.
476 if (!(isa<CXXMethodDecl>(D) ||
480 (D->getDeclName() || cast<TagDecl>(D)->getTypedefNameForAnonDecl()))))
481 return LinkageInfo::none();
485 // The flags we're going to use to compute the class's visibility.
488 // If we have an explicit visibility attribute, merge that in.
489 if (F.ConsiderVisibilityAttributes) {
490 if (llvm::Optional<Visibility> Vis = D->getExplicitVisibility()) {
491 LV.mergeVisibility(*Vis, true);
493 // Ignore global visibility later, but not this attribute.
494 F.ConsiderGlobalVisibility = false;
496 // Ignore both global visibility and attributes when computing our
497 // parent's visibility.
498 ClassF = F.onlyTemplateVisibility();
502 // Class members only have linkage if their class has external
504 LV.merge(getLVForDecl(cast<RecordDecl>(D->getDeclContext()), ClassF));
505 if (!isExternalLinkage(LV.linkage()))
506 return LinkageInfo::none();
508 // If the class already has unique-external linkage, we can't improve.
509 if (LV.linkage() == UniqueExternalLinkage)
510 return LinkageInfo::uniqueExternal();
512 if (const CXXMethodDecl *MD = dyn_cast<CXXMethodDecl>(D)) {
513 // If the type of the function uses a type with unique-external
514 // linkage, it's not legally usable from outside this translation unit.
515 if (MD->getType()->getLinkage() == UniqueExternalLinkage)
516 return LinkageInfo::uniqueExternal();
518 TemplateSpecializationKind TSK = TSK_Undeclared;
520 // If this is a method template specialization, use the linkage for
521 // the template parameters and arguments.
522 if (FunctionTemplateSpecializationInfo *Spec
523 = MD->getTemplateSpecializationInfo()) {
524 LV.merge(getLVForTemplateArgumentList(*Spec->TemplateArguments, F));
525 if (F.ConsiderTemplateParameterTypes)
526 LV.merge(getLVForTemplateParameterList(
527 Spec->getTemplate()->getTemplateParameters()));
529 TSK = Spec->getTemplateSpecializationKind();
530 } else if (MemberSpecializationInfo *MSI =
531 MD->getMemberSpecializationInfo()) {
532 TSK = MSI->getTemplateSpecializationKind();
535 // If we're paying attention to global visibility, apply
536 // -finline-visibility-hidden if this is an inline method.
538 // Note that ConsiderGlobalVisibility doesn't yet have information
539 // about whether containing classes have visibility attributes,
540 // and that's intentional.
541 if (TSK != TSK_ExplicitInstantiationDeclaration &&
542 F.ConsiderGlobalVisibility &&
543 MD->getASTContext().getLangOptions().InlineVisibilityHidden) {
544 // InlineVisibilityHidden only applies to definitions, and
545 // isInlined() only gives meaningful answers on definitions
547 const FunctionDecl *Def = 0;
548 if (MD->hasBody(Def) && Def->isInlined())
549 LV.setVisibility(HiddenVisibility);
552 // Note that in contrast to basically every other situation, we
553 // *do* apply -fvisibility to method declarations.
555 } else if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(D)) {
556 if (const ClassTemplateSpecializationDecl *Spec
557 = dyn_cast<ClassTemplateSpecializationDecl>(RD)) {
558 // Merge template argument/parameter information for member
559 // class template specializations.
560 LV.merge(getLVForTemplateArgumentList(Spec->getTemplateArgs(), F));
561 if (F.ConsiderTemplateParameterTypes)
562 LV.merge(getLVForTemplateParameterList(
563 Spec->getSpecializedTemplate()->getTemplateParameters()));
566 // Static data members.
567 } else if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
568 // Modify the variable's linkage by its type, but ignore the
569 // type's visibility unless it's a definition.
570 LVPair TypeLV = VD->getType()->getLinkageAndVisibility();
571 if (TypeLV.first != ExternalLinkage)
572 LV.mergeLinkage(UniqueExternalLinkage);
573 if (!LV.visibilityExplicit())
574 LV.mergeVisibility(TypeLV.second);
577 F.ConsiderGlobalVisibility &= !LV.visibilityExplicit();
579 // Apply -fvisibility if desired.
580 if (F.ConsiderGlobalVisibility && LV.visibility() != HiddenVisibility) {
581 LV.mergeVisibility(D->getASTContext().getLangOptions().getVisibilityMode());
587 static void clearLinkageForClass(const CXXRecordDecl *record) {
588 for (CXXRecordDecl::decl_iterator
589 i = record->decls_begin(), e = record->decls_end(); i != e; ++i) {
591 if (isa<NamedDecl>(child))
592 cast<NamedDecl>(child)->ClearLinkageCache();
596 void NamedDecl::ClearLinkageCache() {
597 // Note that we can't skip clearing the linkage of children just
598 // because the parent doesn't have cached linkage: we don't cache
599 // when computing linkage for parent contexts.
601 HasCachedLinkage = 0;
603 // If we're changing the linkage of a class, we need to reset the
604 // linkage of child declarations, too.
605 if (const CXXRecordDecl *record = dyn_cast<CXXRecordDecl>(this))
606 clearLinkageForClass(record);
608 if (ClassTemplateDecl *temp =
609 dyn_cast<ClassTemplateDecl>(const_cast<NamedDecl*>(this))) {
610 // Clear linkage for the template pattern.
611 CXXRecordDecl *record = temp->getTemplatedDecl();
612 record->HasCachedLinkage = 0;
613 clearLinkageForClass(record);
615 // We need to clear linkage for specializations, too.
616 for (ClassTemplateDecl::spec_iterator
617 i = temp->spec_begin(), e = temp->spec_end(); i != e; ++i)
618 i->ClearLinkageCache();
621 // Clear cached linkage for function template decls, too.
622 if (FunctionTemplateDecl *temp =
623 dyn_cast<FunctionTemplateDecl>(const_cast<NamedDecl*>(this))) {
624 temp->getTemplatedDecl()->ClearLinkageCache();
625 for (FunctionTemplateDecl::spec_iterator
626 i = temp->spec_begin(), e = temp->spec_end(); i != e; ++i)
627 i->ClearLinkageCache();
632 Linkage NamedDecl::getLinkage() const {
633 if (HasCachedLinkage) {
634 assert(Linkage(CachedLinkage) ==
635 getLVForDecl(this, LVFlags::CreateOnlyDeclLinkage()).linkage());
636 return Linkage(CachedLinkage);
639 CachedLinkage = getLVForDecl(this,
640 LVFlags::CreateOnlyDeclLinkage()).linkage();
641 HasCachedLinkage = 1;
642 return Linkage(CachedLinkage);
645 LinkageInfo NamedDecl::getLinkageAndVisibility() const {
646 LinkageInfo LI = getLVForDecl(this, LVFlags());
647 assert(!HasCachedLinkage || Linkage(CachedLinkage) == LI.linkage());
648 HasCachedLinkage = 1;
649 CachedLinkage = LI.linkage();
653 llvm::Optional<Visibility> NamedDecl::getExplicitVisibility() const {
654 // Use the most recent declaration of a variable.
655 if (const VarDecl *var = dyn_cast<VarDecl>(this))
656 return getVisibilityOf(var->getMostRecentDeclaration());
658 // Use the most recent declaration of a function, and also handle
659 // function template specializations.
660 if (const FunctionDecl *fn = dyn_cast<FunctionDecl>(this)) {
661 if (llvm::Optional<Visibility> V
662 = getVisibilityOf(fn->getMostRecentDeclaration()))
665 // If the function is a specialization of a template with an
666 // explicit visibility attribute, use that.
667 if (FunctionTemplateSpecializationInfo *templateInfo
668 = fn->getTemplateSpecializationInfo())
669 return getVisibilityOf(templateInfo->getTemplate()->getTemplatedDecl());
671 return llvm::Optional<Visibility>();
674 // Otherwise, just check the declaration itself first.
675 if (llvm::Optional<Visibility> V = getVisibilityOf(this))
678 // If there wasn't explicit visibility there, and this is a
679 // specialization of a class template, check for visibility
681 if (const ClassTemplateSpecializationDecl *spec
682 = dyn_cast<ClassTemplateSpecializationDecl>(this))
683 return getVisibilityOf(spec->getSpecializedTemplate()->getTemplatedDecl());
685 return llvm::Optional<Visibility>();
688 static LinkageInfo getLVForDecl(const NamedDecl *D, LVFlags Flags) {
689 // Objective-C: treat all Objective-C declarations as having external
691 switch (D->getKind()) {
694 case Decl::TemplateTemplateParm: // count these as external
695 case Decl::NonTypeTemplateParm:
696 case Decl::ObjCAtDefsField:
697 case Decl::ObjCCategory:
698 case Decl::ObjCCategoryImpl:
699 case Decl::ObjCCompatibleAlias:
700 case Decl::ObjCForwardProtocol:
701 case Decl::ObjCImplementation:
702 case Decl::ObjCMethod:
703 case Decl::ObjCProperty:
704 case Decl::ObjCPropertyImpl:
705 case Decl::ObjCProtocol:
706 return LinkageInfo::external();
709 // Handle linkage for namespace-scope names.
710 if (D->getDeclContext()->getRedeclContext()->isFileContext())
711 return getLVForNamespaceScopeDecl(D, Flags);
713 // C++ [basic.link]p5:
714 // In addition, a member function, static data member, a named
715 // class or enumeration of class scope, or an unnamed class or
716 // enumeration defined in a class-scope typedef declaration such
717 // that the class or enumeration has the typedef name for linkage
718 // purposes (7.1.3), has external linkage if the name of the class
719 // has external linkage.
720 if (D->getDeclContext()->isRecord())
721 return getLVForClassMember(D, Flags);
723 // C++ [basic.link]p6:
724 // The name of a function declared in block scope and the name of
725 // an object declared by a block scope extern declaration have
726 // linkage. If there is a visible declaration of an entity with
727 // linkage having the same name and type, ignoring entities
728 // declared outside the innermost enclosing namespace scope, the
729 // block scope declaration declares that same entity and receives
730 // the linkage of the previous declaration. If there is more than
731 // one such matching entity, the program is ill-formed. Otherwise,
732 // if no matching entity is found, the block scope entity receives
734 if (D->getLexicalDeclContext()->isFunctionOrMethod()) {
735 if (const FunctionDecl *Function = dyn_cast<FunctionDecl>(D)) {
736 if (Function->isInAnonymousNamespace() && !Function->isExternC())
737 return LinkageInfo::uniqueExternal();
740 if (Flags.ConsiderVisibilityAttributes) {
741 if (llvm::Optional<Visibility> Vis = Function->getExplicitVisibility())
742 LV.setVisibility(*Vis);
745 if (const FunctionDecl *Prev = Function->getPreviousDeclaration()) {
746 LinkageInfo PrevLV = getLVForDecl(Prev, Flags);
747 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
748 LV.mergeVisibility(PrevLV);
754 if (const VarDecl *Var = dyn_cast<VarDecl>(D))
755 if (Var->getStorageClass() == SC_Extern ||
756 Var->getStorageClass() == SC_PrivateExtern) {
757 if (Var->isInAnonymousNamespace() && !Var->isExternC())
758 return LinkageInfo::uniqueExternal();
761 if (Var->getStorageClass() == SC_PrivateExtern)
762 LV.setVisibility(HiddenVisibility);
763 else if (Flags.ConsiderVisibilityAttributes) {
764 if (llvm::Optional<Visibility> Vis = Var->getExplicitVisibility())
765 LV.setVisibility(*Vis);
768 if (const VarDecl *Prev = Var->getPreviousDeclaration()) {
769 LinkageInfo PrevLV = getLVForDecl(Prev, Flags);
770 if (PrevLV.linkage()) LV.setLinkage(PrevLV.linkage());
771 LV.mergeVisibility(PrevLV);
778 // C++ [basic.link]p6:
779 // Names not covered by these rules have no linkage.
780 return LinkageInfo::none();
783 std::string NamedDecl::getQualifiedNameAsString() const {
784 return getQualifiedNameAsString(getASTContext().getLangOptions());
787 std::string NamedDecl::getQualifiedNameAsString(const PrintingPolicy &P) const {
788 const DeclContext *Ctx = getDeclContext();
790 if (Ctx->isFunctionOrMethod())
791 return getNameAsString();
793 typedef llvm::SmallVector<const DeclContext *, 8> ContextsTy;
797 while (Ctx && isa<NamedDecl>(Ctx)) {
798 Contexts.push_back(Ctx);
799 Ctx = Ctx->getParent();
802 std::string QualName;
803 llvm::raw_string_ostream OS(QualName);
805 for (ContextsTy::reverse_iterator I = Contexts.rbegin(), E = Contexts.rend();
807 if (const ClassTemplateSpecializationDecl *Spec
808 = dyn_cast<ClassTemplateSpecializationDecl>(*I)) {
809 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
810 std::string TemplateArgsStr
811 = TemplateSpecializationType::PrintTemplateArgumentList(
815 OS << Spec->getName() << TemplateArgsStr;
816 } else if (const NamespaceDecl *ND = dyn_cast<NamespaceDecl>(*I)) {
817 if (ND->isAnonymousNamespace())
818 OS << "<anonymous namespace>";
821 } else if (const RecordDecl *RD = dyn_cast<RecordDecl>(*I)) {
822 if (!RD->getIdentifier())
823 OS << "<anonymous " << RD->getKindName() << '>';
826 } else if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(*I)) {
827 const FunctionProtoType *FT = 0;
828 if (FD->hasWrittenPrototype())
829 FT = dyn_cast<FunctionProtoType>(FD->getType()->getAs<FunctionType>());
833 unsigned NumParams = FD->getNumParams();
834 for (unsigned i = 0; i < NumParams; ++i) {
838 FD->getParamDecl(i)->getType().getAsStringInternal(Param, P);
842 if (FT->isVariadic()) {
850 OS << cast<NamedDecl>(*I);
863 bool NamedDecl::declarationReplaces(NamedDecl *OldD) const {
864 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
866 // UsingDirectiveDecl's are not really NamedDecl's, and all have same name.
867 // We want to keep it, unless it nominates same namespace.
868 if (getKind() == Decl::UsingDirective) {
869 return cast<UsingDirectiveDecl>(this)->getNominatedNamespace()
870 ->getOriginalNamespace() ==
871 cast<UsingDirectiveDecl>(OldD)->getNominatedNamespace()
872 ->getOriginalNamespace();
875 if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(this))
876 // For function declarations, we keep track of redeclarations.
877 return FD->getPreviousDeclaration() == OldD;
879 // For function templates, the underlying function declarations are linked.
880 if (const FunctionTemplateDecl *FunctionTemplate
881 = dyn_cast<FunctionTemplateDecl>(this))
882 if (const FunctionTemplateDecl *OldFunctionTemplate
883 = dyn_cast<FunctionTemplateDecl>(OldD))
884 return FunctionTemplate->getTemplatedDecl()
885 ->declarationReplaces(OldFunctionTemplate->getTemplatedDecl());
887 // For method declarations, we keep track of redeclarations.
888 if (isa<ObjCMethodDecl>(this))
891 if (isa<ObjCInterfaceDecl>(this) && isa<ObjCCompatibleAliasDecl>(OldD))
894 if (isa<UsingShadowDecl>(this) && isa<UsingShadowDecl>(OldD))
895 return cast<UsingShadowDecl>(this)->getTargetDecl() ==
896 cast<UsingShadowDecl>(OldD)->getTargetDecl();
898 if (isa<UsingDecl>(this) && isa<UsingDecl>(OldD)) {
899 ASTContext &Context = getASTContext();
900 return Context.getCanonicalNestedNameSpecifier(
901 cast<UsingDecl>(this)->getQualifier()) ==
902 Context.getCanonicalNestedNameSpecifier(
903 cast<UsingDecl>(OldD)->getQualifier());
906 // For non-function declarations, if the declarations are of the
907 // same kind then this must be a redeclaration, or semantic analysis
908 // would not have given us the new declaration.
909 return this->getKind() == OldD->getKind();
912 bool NamedDecl::hasLinkage() const {
913 return getLinkage() != NoLinkage;
916 NamedDecl *NamedDecl::getUnderlyingDecl() {
917 NamedDecl *ND = this;
919 if (UsingShadowDecl *UD = dyn_cast<UsingShadowDecl>(ND))
920 ND = UD->getTargetDecl();
921 else if (ObjCCompatibleAliasDecl *AD
922 = dyn_cast<ObjCCompatibleAliasDecl>(ND))
923 return AD->getClassInterface();
929 bool NamedDecl::isCXXInstanceMember() const {
930 assert(isCXXClassMember() &&
931 "checking whether non-member is instance member");
933 const NamedDecl *D = this;
934 if (isa<UsingShadowDecl>(D))
935 D = cast<UsingShadowDecl>(D)->getTargetDecl();
937 if (isa<FieldDecl>(D) || isa<IndirectFieldDecl>(D))
939 if (isa<CXXMethodDecl>(D))
940 return cast<CXXMethodDecl>(D)->isInstance();
941 if (isa<FunctionTemplateDecl>(D))
942 return cast<CXXMethodDecl>(cast<FunctionTemplateDecl>(D)
943 ->getTemplatedDecl())->isInstance();
947 //===----------------------------------------------------------------------===//
948 // DeclaratorDecl Implementation
949 //===----------------------------------------------------------------------===//
951 template <typename DeclT>
952 static SourceLocation getTemplateOrInnerLocStart(const DeclT *decl) {
953 if (decl->getNumTemplateParameterLists() > 0)
954 return decl->getTemplateParameterList(0)->getTemplateLoc();
956 return decl->getInnerLocStart();
959 SourceLocation DeclaratorDecl::getTypeSpecStartLoc() const {
960 TypeSourceInfo *TSI = getTypeSourceInfo();
961 if (TSI) return TSI->getTypeLoc().getBeginLoc();
962 return SourceLocation();
965 void DeclaratorDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
967 // Make sure the extended decl info is allocated.
969 // Save (non-extended) type source info pointer.
970 TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
971 // Allocate external info struct.
972 DeclInfo = new (getASTContext()) ExtInfo;
973 // Restore savedTInfo into (extended) decl info.
974 getExtInfo()->TInfo = savedTInfo;
976 // Set qualifier info.
977 getExtInfo()->QualifierLoc = QualifierLoc;
980 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
982 if (getExtInfo()->NumTemplParamLists == 0) {
983 // Save type source info pointer.
984 TypeSourceInfo *savedTInfo = getExtInfo()->TInfo;
985 // Deallocate the extended decl info.
986 getASTContext().Deallocate(getExtInfo());
987 // Restore savedTInfo into (non-extended) decl info.
988 DeclInfo = savedTInfo;
991 getExtInfo()->QualifierLoc = QualifierLoc;
997 DeclaratorDecl::setTemplateParameterListsInfo(ASTContext &Context,
999 TemplateParameterList **TPLists) {
1000 assert(NumTPLists > 0);
1001 // Make sure the extended decl info is allocated.
1002 if (!hasExtInfo()) {
1003 // Save (non-extended) type source info pointer.
1004 TypeSourceInfo *savedTInfo = DeclInfo.get<TypeSourceInfo*>();
1005 // Allocate external info struct.
1006 DeclInfo = new (getASTContext()) ExtInfo;
1007 // Restore savedTInfo into (extended) decl info.
1008 getExtInfo()->TInfo = savedTInfo;
1010 // Set the template parameter lists info.
1011 getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
1014 SourceLocation DeclaratorDecl::getOuterLocStart() const {
1015 return getTemplateOrInnerLocStart(this);
1020 // Helper function: returns true if QT is or contains a type
1021 // having a postfix component.
1022 bool typeIsPostfix(clang::QualType QT) {
1024 const Type* T = QT.getTypePtr();
1025 switch (T->getTypeClass()) {
1029 QT = cast<PointerType>(T)->getPointeeType();
1031 case Type::BlockPointer:
1032 QT = cast<BlockPointerType>(T)->getPointeeType();
1034 case Type::MemberPointer:
1035 QT = cast<MemberPointerType>(T)->getPointeeType();
1037 case Type::LValueReference:
1038 case Type::RValueReference:
1039 QT = cast<ReferenceType>(T)->getPointeeType();
1041 case Type::PackExpansion:
1042 QT = cast<PackExpansionType>(T)->getPattern();
1045 case Type::ConstantArray:
1046 case Type::DependentSizedArray:
1047 case Type::IncompleteArray:
1048 case Type::VariableArray:
1049 case Type::FunctionProto:
1050 case Type::FunctionNoProto:
1058 SourceRange DeclaratorDecl::getSourceRange() const {
1059 SourceLocation RangeEnd = getLocation();
1060 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
1061 if (typeIsPostfix(TInfo->getType()))
1062 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
1064 return SourceRange(getOuterLocStart(), RangeEnd);
1068 QualifierInfo::setTemplateParameterListsInfo(ASTContext &Context,
1069 unsigned NumTPLists,
1070 TemplateParameterList **TPLists) {
1071 assert((NumTPLists == 0 || TPLists != 0) &&
1072 "Empty array of template parameters with positive size!");
1074 // Free previous template parameters (if any).
1075 if (NumTemplParamLists > 0) {
1076 Context.Deallocate(TemplParamLists);
1077 TemplParamLists = 0;
1078 NumTemplParamLists = 0;
1080 // Set info on matched template parameter lists (if any).
1081 if (NumTPLists > 0) {
1082 TemplParamLists = new (Context) TemplateParameterList*[NumTPLists];
1083 NumTemplParamLists = NumTPLists;
1084 for (unsigned i = NumTPLists; i-- > 0; )
1085 TemplParamLists[i] = TPLists[i];
1089 //===----------------------------------------------------------------------===//
1090 // VarDecl Implementation
1091 //===----------------------------------------------------------------------===//
1093 const char *VarDecl::getStorageClassSpecifierString(StorageClass SC) {
1095 case SC_None: break;
1096 case SC_Auto: return "auto"; break;
1097 case SC_Extern: return "extern"; break;
1098 case SC_PrivateExtern: return "__private_extern__"; break;
1099 case SC_Register: return "register"; break;
1100 case SC_Static: return "static"; break;
1103 assert(0 && "Invalid storage class");
1107 VarDecl *VarDecl::Create(ASTContext &C, DeclContext *DC,
1108 SourceLocation StartL, SourceLocation IdL,
1109 IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
1110 StorageClass S, StorageClass SCAsWritten) {
1111 return new (C) VarDecl(Var, DC, StartL, IdL, Id, T, TInfo, S, SCAsWritten);
1114 void VarDecl::setStorageClass(StorageClass SC) {
1115 assert(isLegalForVariable(SC));
1116 if (getStorageClass() != SC)
1117 ClearLinkageCache();
1119 VarDeclBits.SClass = SC;
1122 SourceRange VarDecl::getSourceRange() const {
1124 return SourceRange(getOuterLocStart(), getInit()->getLocEnd());
1125 return DeclaratorDecl::getSourceRange();
1128 bool VarDecl::isExternC() const {
1129 ASTContext &Context = getASTContext();
1130 if (!Context.getLangOptions().CPlusPlus)
1131 return (getDeclContext()->isTranslationUnit() &&
1132 getStorageClass() != SC_Static) ||
1133 (getDeclContext()->isFunctionOrMethod() && hasExternalStorage());
1135 const DeclContext *DC = getDeclContext();
1136 if (DC->isFunctionOrMethod())
1139 for (; !DC->isTranslationUnit(); DC = DC->getParent()) {
1140 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
1141 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
1142 return getStorageClass() != SC_Static;
1152 VarDecl *VarDecl::getCanonicalDecl() {
1153 return getFirstDeclaration();
1156 VarDecl::DefinitionKind VarDecl::isThisDeclarationADefinition() const {
1157 // C++ [basic.def]p2:
1158 // A declaration is a definition unless [...] it contains the 'extern'
1159 // specifier or a linkage-specification and neither an initializer [...],
1160 // it declares a static data member in a class declaration [...].
1161 // C++ [temp.expl.spec]p15:
1162 // An explicit specialization of a static data member of a template is a
1163 // definition if the declaration includes an initializer; otherwise, it is
1165 if (isStaticDataMember()) {
1166 if (isOutOfLine() && (hasInit() ||
1167 getTemplateSpecializationKind() != TSK_ExplicitSpecialization))
1170 return DeclarationOnly;
1173 // A definition of an identifier is a declaration for that identifier that
1174 // [...] causes storage to be reserved for that object.
1175 // Note: that applies for all non-file-scope objects.
1177 // If the declaration of an identifier for an object has file scope and an
1178 // initializer, the declaration is an external definition for the identifier
1181 // AST for 'extern "C" int foo;' is annotated with 'extern'.
1182 if (hasExternalStorage())
1183 return DeclarationOnly;
1185 if (getStorageClassAsWritten() == SC_Extern ||
1186 getStorageClassAsWritten() == SC_PrivateExtern) {
1187 for (const VarDecl *PrevVar = getPreviousDeclaration();
1188 PrevVar; PrevVar = PrevVar->getPreviousDeclaration()) {
1189 if (PrevVar->getLinkage() == InternalLinkage && PrevVar->hasInit())
1190 return DeclarationOnly;
1194 // A declaration of an object that has file scope without an initializer,
1195 // and without a storage class specifier or the scs 'static', constitutes
1196 // a tentative definition.
1197 // No such thing in C++.
1198 if (!getASTContext().getLangOptions().CPlusPlus && isFileVarDecl())
1199 return TentativeDefinition;
1201 // What's left is (in C, block-scope) declarations without initializers or
1202 // external storage. These are definitions.
1206 VarDecl *VarDecl::getActingDefinition() {
1207 DefinitionKind Kind = isThisDeclarationADefinition();
1208 if (Kind != TentativeDefinition)
1211 VarDecl *LastTentative = 0;
1212 VarDecl *First = getFirstDeclaration();
1213 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1215 Kind = (*I)->isThisDeclarationADefinition();
1216 if (Kind == Definition)
1218 else if (Kind == TentativeDefinition)
1221 return LastTentative;
1224 bool VarDecl::isTentativeDefinitionNow() const {
1225 DefinitionKind Kind = isThisDeclarationADefinition();
1226 if (Kind != TentativeDefinition)
1229 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1230 if ((*I)->isThisDeclarationADefinition() == Definition)
1236 VarDecl *VarDecl::getDefinition() {
1237 VarDecl *First = getFirstDeclaration();
1238 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1240 if ((*I)->isThisDeclarationADefinition() == Definition)
1246 VarDecl::DefinitionKind VarDecl::hasDefinition() const {
1247 DefinitionKind Kind = DeclarationOnly;
1249 const VarDecl *First = getFirstDeclaration();
1250 for (redecl_iterator I = First->redecls_begin(), E = First->redecls_end();
1252 Kind = std::max(Kind, (*I)->isThisDeclarationADefinition());
1257 const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
1258 redecl_iterator I = redecls_begin(), E = redecls_end();
1259 while (I != E && !I->getInit())
1264 return I->getInit();
1269 bool VarDecl::isOutOfLine() const {
1270 if (Decl::isOutOfLine())
1273 if (!isStaticDataMember())
1276 // If this static data member was instantiated from a static data member of
1277 // a class template, check whether that static data member was defined
1279 if (VarDecl *VD = getInstantiatedFromStaticDataMember())
1280 return VD->isOutOfLine();
1285 VarDecl *VarDecl::getOutOfLineDefinition() {
1286 if (!isStaticDataMember())
1289 for (VarDecl::redecl_iterator RD = redecls_begin(), RDEnd = redecls_end();
1290 RD != RDEnd; ++RD) {
1291 if (RD->getLexicalDeclContext()->isFileContext())
1298 void VarDecl::setInit(Expr *I) {
1299 if (EvaluatedStmt *Eval = Init.dyn_cast<EvaluatedStmt *>()) {
1300 Eval->~EvaluatedStmt();
1301 getASTContext().Deallocate(Eval);
1307 VarDecl *VarDecl::getInstantiatedFromStaticDataMember() const {
1308 if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
1309 return cast<VarDecl>(MSI->getInstantiatedFrom());
1314 TemplateSpecializationKind VarDecl::getTemplateSpecializationKind() const {
1315 if (MemberSpecializationInfo *MSI = getMemberSpecializationInfo())
1316 return MSI->getTemplateSpecializationKind();
1318 return TSK_Undeclared;
1321 MemberSpecializationInfo *VarDecl::getMemberSpecializationInfo() const {
1322 return getASTContext().getInstantiatedFromStaticDataMember(this);
1325 void VarDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
1326 SourceLocation PointOfInstantiation) {
1327 MemberSpecializationInfo *MSI = getMemberSpecializationInfo();
1328 assert(MSI && "Not an instantiated static data member?");
1329 MSI->setTemplateSpecializationKind(TSK);
1330 if (TSK != TSK_ExplicitSpecialization &&
1331 PointOfInstantiation.isValid() &&
1332 MSI->getPointOfInstantiation().isInvalid())
1333 MSI->setPointOfInstantiation(PointOfInstantiation);
1336 //===----------------------------------------------------------------------===//
1337 // ParmVarDecl Implementation
1338 //===----------------------------------------------------------------------===//
1340 ParmVarDecl *ParmVarDecl::Create(ASTContext &C, DeclContext *DC,
1341 SourceLocation StartLoc,
1342 SourceLocation IdLoc, IdentifierInfo *Id,
1343 QualType T, TypeSourceInfo *TInfo,
1344 StorageClass S, StorageClass SCAsWritten,
1346 return new (C) ParmVarDecl(ParmVar, DC, StartLoc, IdLoc, Id, T, TInfo,
1347 S, SCAsWritten, DefArg);
1350 Expr *ParmVarDecl::getDefaultArg() {
1351 assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
1352 assert(!hasUninstantiatedDefaultArg() &&
1353 "Default argument is not yet instantiated!");
1355 Expr *Arg = getInit();
1356 if (ExprWithCleanups *E = dyn_cast_or_null<ExprWithCleanups>(Arg))
1357 return E->getSubExpr();
1362 unsigned ParmVarDecl::getNumDefaultArgTemporaries() const {
1363 if (const ExprWithCleanups *E = dyn_cast<ExprWithCleanups>(getInit()))
1364 return E->getNumTemporaries();
1369 CXXTemporary *ParmVarDecl::getDefaultArgTemporary(unsigned i) {
1370 assert(getNumDefaultArgTemporaries() &&
1371 "Default arguments does not have any temporaries!");
1373 ExprWithCleanups *E = cast<ExprWithCleanups>(getInit());
1374 return E->getTemporary(i);
1377 SourceRange ParmVarDecl::getDefaultArgRange() const {
1378 if (const Expr *E = getInit())
1379 return E->getSourceRange();
1381 if (hasUninstantiatedDefaultArg())
1382 return getUninstantiatedDefaultArg()->getSourceRange();
1384 return SourceRange();
1387 bool ParmVarDecl::isParameterPack() const {
1388 return isa<PackExpansionType>(getType());
1391 //===----------------------------------------------------------------------===//
1392 // FunctionDecl Implementation
1393 //===----------------------------------------------------------------------===//
1395 void FunctionDecl::getNameForDiagnostic(std::string &S,
1396 const PrintingPolicy &Policy,
1397 bool Qualified) const {
1398 NamedDecl::getNameForDiagnostic(S, Policy, Qualified);
1399 const TemplateArgumentList *TemplateArgs = getTemplateSpecializationArgs();
1401 S += TemplateSpecializationType::PrintTemplateArgumentList(
1402 TemplateArgs->data(),
1403 TemplateArgs->size(),
1408 bool FunctionDecl::isVariadic() const {
1409 if (const FunctionProtoType *FT = getType()->getAs<FunctionProtoType>())
1410 return FT->isVariadic();
1414 bool FunctionDecl::hasBody(const FunctionDecl *&Definition) const {
1415 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1416 if (I->Body || I->IsLateTemplateParsed) {
1425 bool FunctionDecl::hasTrivialBody() const
1427 Stmt *S = getBody();
1429 // Since we don't have a body for this function, we don't know if it's
1434 if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
1439 bool FunctionDecl::isDefined(const FunctionDecl *&Definition) const {
1440 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1441 if (I->IsDeleted || I->IsDefaulted || I->Body || I->IsLateTemplateParsed) {
1442 Definition = I->IsDeleted ? I->getCanonicalDecl() : *I;
1450 Stmt *FunctionDecl::getBody(const FunctionDecl *&Definition) const {
1451 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I) {
1454 return I->Body.get(getASTContext().getExternalSource());
1455 } else if (I->IsLateTemplateParsed) {
1464 void FunctionDecl::setBody(Stmt *B) {
1467 EndRangeLoc = B->getLocEnd();
1470 void FunctionDecl::setPure(bool P) {
1473 if (CXXRecordDecl *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
1474 Parent->markedVirtualFunctionPure();
1477 bool FunctionDecl::isMain() const {
1478 const TranslationUnitDecl *tunit =
1479 dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
1481 !tunit->getASTContext().getLangOptions().Freestanding &&
1483 getIdentifier()->isStr("main");
1486 bool FunctionDecl::isReservedGlobalPlacementOperator() const {
1487 assert(getDeclName().getNameKind() == DeclarationName::CXXOperatorName);
1488 assert(getDeclName().getCXXOverloadedOperator() == OO_New ||
1489 getDeclName().getCXXOverloadedOperator() == OO_Delete ||
1490 getDeclName().getCXXOverloadedOperator() == OO_Array_New ||
1491 getDeclName().getCXXOverloadedOperator() == OO_Array_Delete);
1493 if (isa<CXXRecordDecl>(getDeclContext())) return false;
1494 assert(getDeclContext()->getRedeclContext()->isTranslationUnit());
1496 const FunctionProtoType *proto = getType()->castAs<FunctionProtoType>();
1497 if (proto->getNumArgs() != 2 || proto->isVariadic()) return false;
1499 ASTContext &Context =
1500 cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext())
1503 // The result type and first argument type are constant across all
1504 // these operators. The second argument must be exactly void*.
1505 return (proto->getArgType(1).getCanonicalType() == Context.VoidPtrTy);
1508 bool FunctionDecl::isExternC() const {
1509 ASTContext &Context = getASTContext();
1510 // In C, any non-static, non-overloadable function has external
1512 if (!Context.getLangOptions().CPlusPlus)
1513 return getStorageClass() != SC_Static && !getAttr<OverloadableAttr>();
1515 const DeclContext *DC = getDeclContext();
1519 for (; !DC->isTranslationUnit(); DC = DC->getParent()) {
1520 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC)) {
1521 if (Linkage->getLanguage() == LinkageSpecDecl::lang_c)
1522 return getStorageClass() != SC_Static &&
1523 !getAttr<OverloadableAttr>();
1532 bool FunctionDecl::isGlobal() const {
1533 if (const CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(this))
1534 return Method->isStatic();
1536 if (getStorageClass() == SC_Static)
1539 for (const DeclContext *DC = getDeclContext();
1541 DC = DC->getParent()) {
1542 if (const NamespaceDecl *Namespace = cast<NamespaceDecl>(DC)) {
1543 if (!Namespace->getDeclName())
1553 FunctionDecl::setPreviousDeclaration(FunctionDecl *PrevDecl) {
1554 redeclarable_base::setPreviousDeclaration(PrevDecl);
1556 if (FunctionTemplateDecl *FunTmpl = getDescribedFunctionTemplate()) {
1557 FunctionTemplateDecl *PrevFunTmpl
1558 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : 0;
1559 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
1560 FunTmpl->setPreviousDeclaration(PrevFunTmpl);
1563 if (PrevDecl->IsInline)
1567 const FunctionDecl *FunctionDecl::getCanonicalDecl() const {
1568 return getFirstDeclaration();
1571 FunctionDecl *FunctionDecl::getCanonicalDecl() {
1572 return getFirstDeclaration();
1575 void FunctionDecl::setStorageClass(StorageClass SC) {
1576 assert(isLegalForFunction(SC));
1577 if (getStorageClass() != SC)
1578 ClearLinkageCache();
1583 /// \brief Returns a value indicating whether this function
1584 /// corresponds to a builtin function.
1586 /// The function corresponds to a built-in function if it is
1587 /// declared at translation scope or within an extern "C" block and
1588 /// its name matches with the name of a builtin. The returned value
1589 /// will be 0 for functions that do not correspond to a builtin, a
1590 /// value of type \c Builtin::ID if in the target-independent range
1591 /// \c [1,Builtin::First), or a target-specific builtin value.
1592 unsigned FunctionDecl::getBuiltinID() const {
1593 ASTContext &Context = getASTContext();
1594 if (!getIdentifier() || !getIdentifier()->getBuiltinID())
1597 unsigned BuiltinID = getIdentifier()->getBuiltinID();
1598 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
1601 // This function has the name of a known C library
1602 // function. Determine whether it actually refers to the C library
1603 // function or whether it just has the same name.
1605 // If this is a static function, it's not a builtin.
1606 if (getStorageClass() == SC_Static)
1609 // If this function is at translation-unit scope and we're not in
1610 // C++, it refers to the C library function.
1611 if (!Context.getLangOptions().CPlusPlus &&
1612 getDeclContext()->isTranslationUnit())
1615 // If the function is in an extern "C" linkage specification and is
1616 // not marked "overloadable", it's the real function.
1617 if (isa<LinkageSpecDecl>(getDeclContext()) &&
1618 cast<LinkageSpecDecl>(getDeclContext())->getLanguage()
1619 == LinkageSpecDecl::lang_c &&
1620 !getAttr<OverloadableAttr>())
1628 /// getNumParams - Return the number of parameters this function must have
1629 /// based on its FunctionType. This is the length of the ParamInfo array
1630 /// after it has been created.
1631 unsigned FunctionDecl::getNumParams() const {
1632 const FunctionType *FT = getType()->getAs<FunctionType>();
1633 if (isa<FunctionNoProtoType>(FT))
1635 return cast<FunctionProtoType>(FT)->getNumArgs();
1639 void FunctionDecl::setParams(ASTContext &C,
1640 ParmVarDecl **NewParamInfo, unsigned NumParams) {
1641 assert(ParamInfo == 0 && "Already has param info!");
1642 assert(NumParams == getNumParams() && "Parameter count mismatch!");
1644 // Zero params -> null pointer.
1646 void *Mem = C.Allocate(sizeof(ParmVarDecl*)*NumParams);
1647 ParamInfo = new (Mem) ParmVarDecl*[NumParams];
1648 memcpy(ParamInfo, NewParamInfo, sizeof(ParmVarDecl*)*NumParams);
1650 // Update source range. The check below allows us to set EndRangeLoc before
1651 // setting the parameters.
1652 if (EndRangeLoc.isInvalid() || EndRangeLoc == getLocation())
1653 EndRangeLoc = NewParamInfo[NumParams-1]->getLocEnd();
1657 /// getMinRequiredArguments - Returns the minimum number of arguments
1658 /// needed to call this function. This may be fewer than the number of
1659 /// function parameters, if some of the parameters have default
1660 /// arguments (in C++) or the last parameter is a parameter pack.
1661 unsigned FunctionDecl::getMinRequiredArguments() const {
1662 if (!getASTContext().getLangOptions().CPlusPlus)
1663 return getNumParams();
1665 unsigned NumRequiredArgs = getNumParams();
1667 // If the last parameter is a parameter pack, we don't need an argument for
1669 if (NumRequiredArgs > 0 &&
1670 getParamDecl(NumRequiredArgs - 1)->isParameterPack())
1673 // If this parameter has a default argument, we don't need an argument for
1675 while (NumRequiredArgs > 0 &&
1676 getParamDecl(NumRequiredArgs-1)->hasDefaultArg())
1679 // We might have parameter packs before the end. These can't be deduced,
1680 // but they can still handle multiple arguments.
1681 unsigned ArgIdx = NumRequiredArgs;
1682 while (ArgIdx > 0) {
1683 if (getParamDecl(ArgIdx - 1)->isParameterPack())
1684 NumRequiredArgs = ArgIdx;
1689 return NumRequiredArgs;
1692 bool FunctionDecl::isInlined() const {
1696 if (isa<CXXMethodDecl>(this)) {
1697 if (!isOutOfLine() || getCanonicalDecl()->isInlineSpecified())
1701 switch (getTemplateSpecializationKind()) {
1702 case TSK_Undeclared:
1703 case TSK_ExplicitSpecialization:
1706 case TSK_ImplicitInstantiation:
1707 case TSK_ExplicitInstantiationDeclaration:
1708 case TSK_ExplicitInstantiationDefinition:
1713 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
1714 bool HasPattern = false;
1716 HasPattern = PatternDecl->hasBody(PatternDecl);
1718 if (HasPattern && PatternDecl)
1719 return PatternDecl->isInlined();
1724 /// \brief For an inline function definition in C or C++, determine whether the
1725 /// definition will be externally visible.
1727 /// Inline function definitions are always available for inlining optimizations.
1728 /// However, depending on the language dialect, declaration specifiers, and
1729 /// attributes, the definition of an inline function may or may not be
1730 /// "externally" visible to other translation units in the program.
1732 /// In C99, inline definitions are not externally visible by default. However,
1733 /// if even one of the global-scope declarations is marked "extern inline", the
1734 /// inline definition becomes externally visible (C99 6.7.4p6).
1736 /// In GNU89 mode, or if the gnu_inline attribute is attached to the function
1737 /// definition, we use the GNU semantics for inline, which are nearly the
1738 /// opposite of C99 semantics. In particular, "inline" by itself will create
1739 /// an externally visible symbol, but "extern inline" will not create an
1740 /// externally visible symbol.
1741 bool FunctionDecl::isInlineDefinitionExternallyVisible() const {
1742 assert(doesThisDeclarationHaveABody() && "Must have the function definition");
1743 assert(isInlined() && "Function must be inline");
1744 ASTContext &Context = getASTContext();
1746 if (Context.getLangOptions().GNUInline || hasAttr<GNUInlineAttr>()) {
1747 // If it's not the case that both 'inline' and 'extern' are
1748 // specified on the definition, then this inline definition is
1749 // externally visible.
1750 if (!(isInlineSpecified() && getStorageClassAsWritten() == SC_Extern))
1753 // If any declaration is 'inline' but not 'extern', then this definition
1754 // is externally visible.
1755 for (redecl_iterator Redecl = redecls_begin(), RedeclEnd = redecls_end();
1756 Redecl != RedeclEnd;
1758 if (Redecl->isInlineSpecified() &&
1759 Redecl->getStorageClassAsWritten() != SC_Extern)
1767 // [...] If all of the file scope declarations for a function in a
1768 // translation unit include the inline function specifier without extern,
1769 // then the definition in that translation unit is an inline definition.
1770 for (redecl_iterator Redecl = redecls_begin(), RedeclEnd = redecls_end();
1771 Redecl != RedeclEnd;
1773 // Only consider file-scope declarations in this test.
1774 if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
1777 if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
1778 return true; // Not an inline definition
1782 // An inline definition does not provide an external definition for the
1783 // function, and does not forbid an external definition in another
1784 // translation unit.
1788 /// getOverloadedOperator - Which C++ overloaded operator this
1789 /// function represents, if any.
1790 OverloadedOperatorKind FunctionDecl::getOverloadedOperator() const {
1791 if (getDeclName().getNameKind() == DeclarationName::CXXOperatorName)
1792 return getDeclName().getCXXOverloadedOperator();
1797 /// getLiteralIdentifier - The literal suffix identifier this function
1798 /// represents, if any.
1799 const IdentifierInfo *FunctionDecl::getLiteralIdentifier() const {
1800 if (getDeclName().getNameKind() == DeclarationName::CXXLiteralOperatorName)
1801 return getDeclName().getCXXLiteralIdentifier();
1806 FunctionDecl::TemplatedKind FunctionDecl::getTemplatedKind() const {
1807 if (TemplateOrSpecialization.isNull())
1808 return TK_NonTemplate;
1809 if (TemplateOrSpecialization.is<FunctionTemplateDecl *>())
1810 return TK_FunctionTemplate;
1811 if (TemplateOrSpecialization.is<MemberSpecializationInfo *>())
1812 return TK_MemberSpecialization;
1813 if (TemplateOrSpecialization.is<FunctionTemplateSpecializationInfo *>())
1814 return TK_FunctionTemplateSpecialization;
1815 if (TemplateOrSpecialization.is
1816 <DependentFunctionTemplateSpecializationInfo*>())
1817 return TK_DependentFunctionTemplateSpecialization;
1819 assert(false && "Did we miss a TemplateOrSpecialization type?");
1820 return TK_NonTemplate;
1823 FunctionDecl *FunctionDecl::getInstantiatedFromMemberFunction() const {
1824 if (MemberSpecializationInfo *Info = getMemberSpecializationInfo())
1825 return cast<FunctionDecl>(Info->getInstantiatedFrom());
1830 MemberSpecializationInfo *FunctionDecl::getMemberSpecializationInfo() const {
1831 return TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>();
1835 FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
1837 TemplateSpecializationKind TSK) {
1838 assert(TemplateOrSpecialization.isNull() &&
1839 "Member function is already a specialization");
1840 MemberSpecializationInfo *Info
1841 = new (C) MemberSpecializationInfo(FD, TSK);
1842 TemplateOrSpecialization = Info;
1845 bool FunctionDecl::isImplicitlyInstantiable() const {
1846 // If the function is invalid, it can't be implicitly instantiated.
1847 if (isInvalidDecl())
1850 switch (getTemplateSpecializationKind()) {
1851 case TSK_Undeclared:
1852 case TSK_ExplicitSpecialization:
1853 case TSK_ExplicitInstantiationDefinition:
1856 case TSK_ImplicitInstantiation:
1859 case TSK_ExplicitInstantiationDeclaration:
1864 // Find the actual template from which we will instantiate.
1865 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
1866 bool HasPattern = false;
1868 HasPattern = PatternDecl->hasBody(PatternDecl);
1870 // C++0x [temp.explicit]p9:
1871 // Except for inline functions, other explicit instantiation declarations
1872 // have the effect of suppressing the implicit instantiation of the entity
1873 // to which they refer.
1874 if (!HasPattern || !PatternDecl)
1877 return PatternDecl->isInlined();
1880 FunctionDecl *FunctionDecl::getTemplateInstantiationPattern() const {
1881 if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
1882 while (Primary->getInstantiatedFromMemberTemplate()) {
1883 // If we have hit a point where the user provided a specialization of
1884 // this template, we're done looking.
1885 if (Primary->isMemberSpecialization())
1888 Primary = Primary->getInstantiatedFromMemberTemplate();
1891 return Primary->getTemplatedDecl();
1894 return getInstantiatedFromMemberFunction();
1897 FunctionTemplateDecl *FunctionDecl::getPrimaryTemplate() const {
1898 if (FunctionTemplateSpecializationInfo *Info
1899 = TemplateOrSpecialization
1900 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
1901 return Info->Template.getPointer();
1906 const TemplateArgumentList *
1907 FunctionDecl::getTemplateSpecializationArgs() const {
1908 if (FunctionTemplateSpecializationInfo *Info
1909 = TemplateOrSpecialization
1910 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
1911 return Info->TemplateArguments;
1916 const TemplateArgumentListInfo *
1917 FunctionDecl::getTemplateSpecializationArgsAsWritten() const {
1918 if (FunctionTemplateSpecializationInfo *Info
1919 = TemplateOrSpecialization
1920 .dyn_cast<FunctionTemplateSpecializationInfo*>()) {
1921 return Info->TemplateArgumentsAsWritten;
1927 FunctionDecl::setFunctionTemplateSpecialization(ASTContext &C,
1928 FunctionTemplateDecl *Template,
1929 const TemplateArgumentList *TemplateArgs,
1931 TemplateSpecializationKind TSK,
1932 const TemplateArgumentListInfo *TemplateArgsAsWritten,
1933 SourceLocation PointOfInstantiation) {
1934 assert(TSK != TSK_Undeclared &&
1935 "Must specify the type of function template specialization");
1936 FunctionTemplateSpecializationInfo *Info
1937 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
1939 Info = FunctionTemplateSpecializationInfo::Create(C, this, Template, TSK,
1941 TemplateArgsAsWritten,
1942 PointOfInstantiation);
1943 TemplateOrSpecialization = Info;
1945 // Insert this function template specialization into the set of known
1946 // function template specializations.
1948 Template->addSpecialization(Info, InsertPos);
1950 // Try to insert the new node. If there is an existing node, leave it, the
1951 // set will contain the canonical decls while
1952 // FunctionTemplateDecl::findSpecialization will return
1953 // the most recent redeclarations.
1954 FunctionTemplateSpecializationInfo *Existing
1955 = Template->getSpecializations().GetOrInsertNode(Info);
1957 assert((!Existing || Existing->Function->isCanonicalDecl()) &&
1958 "Set is supposed to only contain canonical decls");
1963 FunctionDecl::setDependentTemplateSpecialization(ASTContext &Context,
1964 const UnresolvedSetImpl &Templates,
1965 const TemplateArgumentListInfo &TemplateArgs) {
1966 assert(TemplateOrSpecialization.isNull());
1967 size_t Size = sizeof(DependentFunctionTemplateSpecializationInfo);
1968 Size += Templates.size() * sizeof(FunctionTemplateDecl*);
1969 Size += TemplateArgs.size() * sizeof(TemplateArgumentLoc);
1970 void *Buffer = Context.Allocate(Size);
1971 DependentFunctionTemplateSpecializationInfo *Info =
1972 new (Buffer) DependentFunctionTemplateSpecializationInfo(Templates,
1974 TemplateOrSpecialization = Info;
1977 DependentFunctionTemplateSpecializationInfo::
1978 DependentFunctionTemplateSpecializationInfo(const UnresolvedSetImpl &Ts,
1979 const TemplateArgumentListInfo &TArgs)
1980 : AngleLocs(TArgs.getLAngleLoc(), TArgs.getRAngleLoc()) {
1982 d.NumTemplates = Ts.size();
1983 d.NumArgs = TArgs.size();
1985 FunctionTemplateDecl **TsArray =
1986 const_cast<FunctionTemplateDecl**>(getTemplates());
1987 for (unsigned I = 0, E = Ts.size(); I != E; ++I)
1988 TsArray[I] = cast<FunctionTemplateDecl>(Ts[I]->getUnderlyingDecl());
1990 TemplateArgumentLoc *ArgsArray =
1991 const_cast<TemplateArgumentLoc*>(getTemplateArgs());
1992 for (unsigned I = 0, E = TArgs.size(); I != E; ++I)
1993 new (&ArgsArray[I]) TemplateArgumentLoc(TArgs[I]);
1996 TemplateSpecializationKind FunctionDecl::getTemplateSpecializationKind() const {
1997 // For a function template specialization, query the specialization
1998 // information object.
1999 FunctionTemplateSpecializationInfo *FTSInfo
2000 = TemplateOrSpecialization.dyn_cast<FunctionTemplateSpecializationInfo*>();
2002 return FTSInfo->getTemplateSpecializationKind();
2004 MemberSpecializationInfo *MSInfo
2005 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>();
2007 return MSInfo->getTemplateSpecializationKind();
2009 return TSK_Undeclared;
2013 FunctionDecl::setTemplateSpecializationKind(TemplateSpecializationKind TSK,
2014 SourceLocation PointOfInstantiation) {
2015 if (FunctionTemplateSpecializationInfo *FTSInfo
2016 = TemplateOrSpecialization.dyn_cast<
2017 FunctionTemplateSpecializationInfo*>()) {
2018 FTSInfo->setTemplateSpecializationKind(TSK);
2019 if (TSK != TSK_ExplicitSpecialization &&
2020 PointOfInstantiation.isValid() &&
2021 FTSInfo->getPointOfInstantiation().isInvalid())
2022 FTSInfo->setPointOfInstantiation(PointOfInstantiation);
2023 } else if (MemberSpecializationInfo *MSInfo
2024 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>()) {
2025 MSInfo->setTemplateSpecializationKind(TSK);
2026 if (TSK != TSK_ExplicitSpecialization &&
2027 PointOfInstantiation.isValid() &&
2028 MSInfo->getPointOfInstantiation().isInvalid())
2029 MSInfo->setPointOfInstantiation(PointOfInstantiation);
2031 assert(false && "Function cannot have a template specialization kind");
2034 SourceLocation FunctionDecl::getPointOfInstantiation() const {
2035 if (FunctionTemplateSpecializationInfo *FTSInfo
2036 = TemplateOrSpecialization.dyn_cast<
2037 FunctionTemplateSpecializationInfo*>())
2038 return FTSInfo->getPointOfInstantiation();
2039 else if (MemberSpecializationInfo *MSInfo
2040 = TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo*>())
2041 return MSInfo->getPointOfInstantiation();
2043 return SourceLocation();
2046 bool FunctionDecl::isOutOfLine() const {
2047 if (Decl::isOutOfLine())
2050 // If this function was instantiated from a member function of a
2051 // class template, check whether that member function was defined out-of-line.
2052 if (FunctionDecl *FD = getInstantiatedFromMemberFunction()) {
2053 const FunctionDecl *Definition;
2054 if (FD->hasBody(Definition))
2055 return Definition->isOutOfLine();
2058 // If this function was instantiated from a function template,
2059 // check whether that function template was defined out-of-line.
2060 if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
2061 const FunctionDecl *Definition;
2062 if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
2063 return Definition->isOutOfLine();
2069 SourceRange FunctionDecl::getSourceRange() const {
2070 return SourceRange(getOuterLocStart(), EndRangeLoc);
2073 //===----------------------------------------------------------------------===//
2074 // FieldDecl Implementation
2075 //===----------------------------------------------------------------------===//
2077 FieldDecl *FieldDecl::Create(const ASTContext &C, DeclContext *DC,
2078 SourceLocation StartLoc, SourceLocation IdLoc,
2079 IdentifierInfo *Id, QualType T,
2080 TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
2082 return new (C) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
2083 BW, Mutable, HasInit);
2086 bool FieldDecl::isAnonymousStructOrUnion() const {
2087 if (!isImplicit() || getDeclName())
2090 if (const RecordType *Record = getType()->getAs<RecordType>())
2091 return Record->getDecl()->isAnonymousStructOrUnion();
2096 unsigned FieldDecl::getFieldIndex() const {
2097 if (CachedFieldIndex) return CachedFieldIndex - 1;
2100 const RecordDecl *RD = getParent();
2101 const FieldDecl *LastFD = 0;
2102 bool IsMsStruct = RD->hasAttr<MsStructAttr>();
2104 RecordDecl::field_iterator i = RD->field_begin(), e = RD->field_end();
2106 assert(i != e && "failed to find field in parent!");
2111 // Zero-length bitfields following non-bitfield members are ignored.
2112 if (getASTContext().ZeroBitfieldFollowsNonBitfield((*i), LastFD)) {
2122 CachedFieldIndex = index + 1;
2126 SourceRange FieldDecl::getSourceRange() const {
2128 return SourceRange(getInnerLocStart(), getBitWidth()->getLocEnd());
2129 return DeclaratorDecl::getSourceRange();
2132 void FieldDecl::setInClassInitializer(Expr *Init) {
2133 assert(!InitializerOrBitWidth.getPointer() &&
2134 "bit width or initializer already set");
2135 InitializerOrBitWidth.setPointer(Init);
2136 InitializerOrBitWidth.setInt(0);
2139 //===----------------------------------------------------------------------===//
2140 // TagDecl Implementation
2141 //===----------------------------------------------------------------------===//
2143 SourceLocation TagDecl::getOuterLocStart() const {
2144 return getTemplateOrInnerLocStart(this);
2147 SourceRange TagDecl::getSourceRange() const {
2148 SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
2149 return SourceRange(getOuterLocStart(), E);
2152 TagDecl* TagDecl::getCanonicalDecl() {
2153 return getFirstDeclaration();
2156 void TagDecl::setTypedefNameForAnonDecl(TypedefNameDecl *TDD) {
2157 TypedefNameDeclOrQualifier = TDD;
2159 const_cast<Type*>(TypeForDecl)->ClearLinkageCache();
2160 ClearLinkageCache();
2163 void TagDecl::startDefinition() {
2164 IsBeingDefined = true;
2166 if (isa<CXXRecordDecl>(this)) {
2167 CXXRecordDecl *D = cast<CXXRecordDecl>(this);
2168 struct CXXRecordDecl::DefinitionData *Data =
2169 new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
2170 for (redecl_iterator I = redecls_begin(), E = redecls_end(); I != E; ++I)
2171 cast<CXXRecordDecl>(*I)->DefinitionData = Data;
2175 void TagDecl::completeDefinition() {
2176 assert((!isa<CXXRecordDecl>(this) ||
2177 cast<CXXRecordDecl>(this)->hasDefinition()) &&
2178 "definition completed but not started");
2180 IsDefinition = true;
2181 IsBeingDefined = false;
2183 if (ASTMutationListener *L = getASTMutationListener())
2184 L->CompletedTagDefinition(this);
2187 TagDecl* TagDecl::getDefinition() const {
2189 return const_cast<TagDecl *>(this);
2190 if (const CXXRecordDecl *CXXRD = dyn_cast<CXXRecordDecl>(this))
2191 return CXXRD->getDefinition();
2193 for (redecl_iterator R = redecls_begin(), REnd = redecls_end();
2195 if (R->isDefinition())
2201 void TagDecl::setQualifierInfo(NestedNameSpecifierLoc QualifierLoc) {
2203 // Make sure the extended qualifier info is allocated.
2205 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
2206 // Set qualifier info.
2207 getExtInfo()->QualifierLoc = QualifierLoc;
2210 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
2212 if (getExtInfo()->NumTemplParamLists == 0) {
2213 getASTContext().Deallocate(getExtInfo());
2214 TypedefNameDeclOrQualifier = (TypedefNameDecl*) 0;
2217 getExtInfo()->QualifierLoc = QualifierLoc;
2222 void TagDecl::setTemplateParameterListsInfo(ASTContext &Context,
2223 unsigned NumTPLists,
2224 TemplateParameterList **TPLists) {
2225 assert(NumTPLists > 0);
2226 // Make sure the extended decl info is allocated.
2228 // Allocate external info struct.
2229 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
2230 // Set the template parameter lists info.
2231 getExtInfo()->setTemplateParameterListsInfo(Context, NumTPLists, TPLists);
2234 //===----------------------------------------------------------------------===//
2235 // EnumDecl Implementation
2236 //===----------------------------------------------------------------------===//
2238 EnumDecl *EnumDecl::Create(ASTContext &C, DeclContext *DC,
2239 SourceLocation StartLoc, SourceLocation IdLoc,
2241 EnumDecl *PrevDecl, bool IsScoped,
2242 bool IsScopedUsingClassTag, bool IsFixed) {
2243 EnumDecl *Enum = new (C) EnumDecl(DC, StartLoc, IdLoc, Id, PrevDecl,
2244 IsScoped, IsScopedUsingClassTag, IsFixed);
2245 C.getTypeDeclType(Enum, PrevDecl);
2249 EnumDecl *EnumDecl::Create(ASTContext &C, EmptyShell Empty) {
2250 return new (C) EnumDecl(0, SourceLocation(), SourceLocation(), 0, 0,
2251 false, false, false);
2254 void EnumDecl::completeDefinition(QualType NewType,
2255 QualType NewPromotionType,
2256 unsigned NumPositiveBits,
2257 unsigned NumNegativeBits) {
2258 assert(!isDefinition() && "Cannot redefine enums!");
2260 IntegerType = NewType.getTypePtr();
2261 PromotionType = NewPromotionType;
2262 setNumPositiveBits(NumPositiveBits);
2263 setNumNegativeBits(NumNegativeBits);
2264 TagDecl::completeDefinition();
2267 //===----------------------------------------------------------------------===//
2268 // RecordDecl Implementation
2269 //===----------------------------------------------------------------------===//
2271 RecordDecl::RecordDecl(Kind DK, TagKind TK, DeclContext *DC,
2272 SourceLocation StartLoc, SourceLocation IdLoc,
2273 IdentifierInfo *Id, RecordDecl *PrevDecl)
2274 : TagDecl(DK, TK, DC, IdLoc, Id, PrevDecl, StartLoc) {
2275 HasFlexibleArrayMember = false;
2276 AnonymousStructOrUnion = false;
2277 HasObjectMember = false;
2278 LoadedFieldsFromExternalStorage = false;
2279 assert(classof(static_cast<Decl*>(this)) && "Invalid Kind!");
2282 RecordDecl *RecordDecl::Create(const ASTContext &C, TagKind TK, DeclContext *DC,
2283 SourceLocation StartLoc, SourceLocation IdLoc,
2284 IdentifierInfo *Id, RecordDecl* PrevDecl) {
2285 RecordDecl* R = new (C) RecordDecl(Record, TK, DC, StartLoc, IdLoc, Id,
2287 C.getTypeDeclType(R, PrevDecl);
2291 RecordDecl *RecordDecl::Create(const ASTContext &C, EmptyShell Empty) {
2292 return new (C) RecordDecl(Record, TTK_Struct, 0, SourceLocation(),
2293 SourceLocation(), 0, 0);
2296 bool RecordDecl::isInjectedClassName() const {
2297 return isImplicit() && getDeclName() && getDeclContext()->isRecord() &&
2298 cast<RecordDecl>(getDeclContext())->getDeclName() == getDeclName();
2301 RecordDecl::field_iterator RecordDecl::field_begin() const {
2302 if (hasExternalLexicalStorage() && !LoadedFieldsFromExternalStorage)
2303 LoadFieldsFromExternalStorage();
2305 return field_iterator(decl_iterator(FirstDecl));
2308 /// completeDefinition - Notes that the definition of this type is now
2310 void RecordDecl::completeDefinition() {
2311 assert(!isDefinition() && "Cannot redefine record!");
2312 TagDecl::completeDefinition();
2315 void RecordDecl::LoadFieldsFromExternalStorage() const {
2316 ExternalASTSource *Source = getASTContext().getExternalSource();
2317 assert(hasExternalLexicalStorage() && Source && "No external storage?");
2319 // Notify that we have a RecordDecl doing some initialization.
2320 ExternalASTSource::Deserializing TheFields(Source);
2322 llvm::SmallVector<Decl*, 64> Decls;
2323 if (Source->FindExternalLexicalDeclsBy<FieldDecl>(this, Decls))
2327 // Check that all decls we got were FieldDecls.
2328 for (unsigned i=0, e=Decls.size(); i != e; ++i)
2329 assert(isa<FieldDecl>(Decls[i]));
2332 LoadedFieldsFromExternalStorage = true;
2337 llvm::tie(FirstDecl, LastDecl) = BuildDeclChain(Decls);
2340 //===----------------------------------------------------------------------===//
2341 // BlockDecl Implementation
2342 //===----------------------------------------------------------------------===//
2344 void BlockDecl::setParams(ParmVarDecl **NewParamInfo,
2346 assert(ParamInfo == 0 && "Already has param info!");
2348 // Zero params -> null pointer.
2351 void *Mem = getASTContext().Allocate(sizeof(ParmVarDecl*)*NumParams);
2352 ParamInfo = new (Mem) ParmVarDecl*[NumParams];
2353 memcpy(ParamInfo, NewParamInfo, sizeof(ParmVarDecl*)*NumParams);
2357 void BlockDecl::setCaptures(ASTContext &Context,
2358 const Capture *begin,
2360 bool capturesCXXThis) {
2361 CapturesCXXThis = capturesCXXThis;
2369 NumCaptures = end - begin;
2371 // Avoid new Capture[] because we don't want to provide a default
2373 size_t allocationSize = NumCaptures * sizeof(Capture);
2374 void *buffer = Context.Allocate(allocationSize, /*alignment*/sizeof(void*));
2375 memcpy(buffer, begin, allocationSize);
2376 Captures = static_cast<Capture*>(buffer);
2379 SourceRange BlockDecl::getSourceRange() const {
2380 return SourceRange(getLocation(), Body? Body->getLocEnd() : getLocation());
2383 //===----------------------------------------------------------------------===//
2384 // Other Decl Allocation/Deallocation Method Implementations
2385 //===----------------------------------------------------------------------===//
2387 TranslationUnitDecl *TranslationUnitDecl::Create(ASTContext &C) {
2388 return new (C) TranslationUnitDecl(C);
2391 LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
2392 SourceLocation IdentL, IdentifierInfo *II) {
2393 return new (C) LabelDecl(DC, IdentL, II, 0, IdentL);
2396 LabelDecl *LabelDecl::Create(ASTContext &C, DeclContext *DC,
2397 SourceLocation IdentL, IdentifierInfo *II,
2398 SourceLocation GnuLabelL) {
2399 assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
2400 return new (C) LabelDecl(DC, IdentL, II, 0, GnuLabelL);
2404 NamespaceDecl *NamespaceDecl::Create(ASTContext &C, DeclContext *DC,
2405 SourceLocation StartLoc,
2406 SourceLocation IdLoc, IdentifierInfo *Id) {
2407 return new (C) NamespaceDecl(DC, StartLoc, IdLoc, Id);
2410 NamespaceDecl *NamespaceDecl::getNextNamespace() {
2411 return dyn_cast_or_null<NamespaceDecl>(
2412 NextNamespace.get(getASTContext().getExternalSource()));
2415 ImplicitParamDecl *ImplicitParamDecl::Create(ASTContext &C, DeclContext *DC,
2416 SourceLocation IdLoc,
2419 return new (C) ImplicitParamDecl(DC, IdLoc, Id, Type);
2422 FunctionDecl *FunctionDecl::Create(ASTContext &C, DeclContext *DC,
2423 SourceLocation StartLoc,
2424 const DeclarationNameInfo &NameInfo,
2425 QualType T, TypeSourceInfo *TInfo,
2426 StorageClass SC, StorageClass SCAsWritten,
2427 bool isInlineSpecified,
2428 bool hasWrittenPrototype) {
2429 FunctionDecl *New = new (C) FunctionDecl(Function, DC, StartLoc, NameInfo,
2430 T, TInfo, SC, SCAsWritten,
2432 New->HasWrittenPrototype = hasWrittenPrototype;
2436 BlockDecl *BlockDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L) {
2437 return new (C) BlockDecl(DC, L);
2440 EnumConstantDecl *EnumConstantDecl::Create(ASTContext &C, EnumDecl *CD,
2442 IdentifierInfo *Id, QualType T,
2443 Expr *E, const llvm::APSInt &V) {
2444 return new (C) EnumConstantDecl(CD, L, Id, T, E, V);
2448 IndirectFieldDecl::Create(ASTContext &C, DeclContext *DC, SourceLocation L,
2449 IdentifierInfo *Id, QualType T, NamedDecl **CH,
2451 return new (C) IndirectFieldDecl(DC, L, Id, T, CH, CHS);
2454 SourceRange EnumConstantDecl::getSourceRange() const {
2455 SourceLocation End = getLocation();
2457 End = Init->getLocEnd();
2458 return SourceRange(getLocation(), End);
2461 TypedefDecl *TypedefDecl::Create(ASTContext &C, DeclContext *DC,
2462 SourceLocation StartLoc, SourceLocation IdLoc,
2463 IdentifierInfo *Id, TypeSourceInfo *TInfo) {
2464 return new (C) TypedefDecl(DC, StartLoc, IdLoc, Id, TInfo);
2467 TypeAliasDecl *TypeAliasDecl::Create(ASTContext &C, DeclContext *DC,
2468 SourceLocation StartLoc,
2469 SourceLocation IdLoc, IdentifierInfo *Id,
2470 TypeSourceInfo *TInfo) {
2471 return new (C) TypeAliasDecl(DC, StartLoc, IdLoc, Id, TInfo);
2474 SourceRange TypedefDecl::getSourceRange() const {
2475 SourceLocation RangeEnd = getLocation();
2476 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
2477 if (typeIsPostfix(TInfo->getType()))
2478 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2480 return SourceRange(getLocStart(), RangeEnd);
2483 SourceRange TypeAliasDecl::getSourceRange() const {
2484 SourceLocation RangeEnd = getLocStart();
2485 if (TypeSourceInfo *TInfo = getTypeSourceInfo())
2486 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2487 return SourceRange(getLocStart(), RangeEnd);
2490 FileScopeAsmDecl *FileScopeAsmDecl::Create(ASTContext &C, DeclContext *DC,
2492 SourceLocation AsmLoc,
2493 SourceLocation RParenLoc) {
2494 return new (C) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);