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