clang 23.0.0git
Decl.cpp
Go to the documentation of this file.
1//===- Decl.cpp - Declaration AST Node Implementation ---------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file implements the Decl subclasses.
10//
11//===----------------------------------------------------------------------===//
12
13#include "clang/AST/Decl.h"
14#include "Linkage.h"
17#include "clang/AST/ASTLambda.h"
19#include "clang/AST/Attr.h"
21#include "clang/AST/DeclBase.h"
22#include "clang/AST/DeclCXX.h"
23#include "clang/AST/DeclObjC.h"
26#include "clang/AST/Expr.h"
27#include "clang/AST/ExprCXX.h"
29#include "clang/AST/ODRHash.h"
35#include "clang/AST/Stmt.h"
37#include "clang/AST/Type.h"
38#include "clang/AST/TypeLoc.h"
41#include "clang/Basic/LLVM.h"
43#include "clang/Basic/Linkage.h"
44#include "clang/Basic/Module.h"
54#include "llvm/ADT/APSInt.h"
55#include "llvm/ADT/ArrayRef.h"
56#include "llvm/ADT/STLExtras.h"
57#include "llvm/ADT/SmallVector.h"
58#include "llvm/ADT/StringRef.h"
59#include "llvm/ADT/StringSwitch.h"
60#include "llvm/ADT/iterator_range.h"
61#include "llvm/Support/Casting.h"
62#include "llvm/Support/ErrorHandling.h"
63#include "llvm/Support/raw_ostream.h"
64#include "llvm/TargetParser/Triple.h"
65#include <algorithm>
66#include <cassert>
67#include <cstddef>
68#include <cstring>
69#include <optional>
70#include <string>
71#include <tuple>
72#include <type_traits>
73
74using namespace clang;
75
79
80void PrettyDeclStackTraceEntry::print(raw_ostream &OS) const {
81 SourceLocation Loc = this->Loc;
82 if (!Loc.isValid() && TheDecl) Loc = TheDecl->getLocation();
83 if (Loc.isValid()) {
84 Loc.print(OS, Context.getSourceManager());
85 OS << ": ";
86 }
87 OS << Message;
88
89 if (auto *ND = dyn_cast_if_present<NamedDecl>(TheDecl)) {
90 OS << " '";
91 ND->getNameForDiagnostic(OS, Context.getPrintingPolicy(), true);
92 OS << "'";
93 }
94
95 OS << '\n';
96}
97
98// Defined here so that it can be inlined into its direct callers.
99bool Decl::isOutOfLine() const {
101}
102
103TranslationUnitDecl::TranslationUnitDecl(ASTContext &ctx)
104 : Decl(TranslationUnit, nullptr, SourceLocation()),
105 DeclContext(TranslationUnit), redeclarable_base(ctx), Ctx(ctx) {}
106
107//===----------------------------------------------------------------------===//
108// NamedDecl Implementation
109//===----------------------------------------------------------------------===//
110
111// Visibility rules aren't rigorously externally specified, but here
112// are the basic principles behind what we implement:
113//
114// 1. An explicit visibility attribute is generally a direct expression
115// of the user's intent and should be honored. Only the innermost
116// visibility attribute applies. If no visibility attribute applies,
117// global visibility settings are considered.
118//
119// 2. There is one caveat to the above: on or in a template pattern,
120// an explicit visibility attribute is just a default rule, and
121// visibility can be decreased by the visibility of template
122// arguments. But this, too, has an exception: an attribute on an
123// explicit specialization or instantiation causes all the visibility
124// restrictions of the template arguments to be ignored.
125//
126// 3. A variable that does not otherwise have explicit visibility can
127// be restricted by the visibility of its type.
128//
129// 4. A visibility restriction is explicit if it comes from an
130// attribute (or something like it), not a global visibility setting.
131// When emitting a reference to an external symbol, visibility
132// restrictions are ignored unless they are explicit.
133//
134// 5. When computing the visibility of a non-type, including a
135// non-type member of a class, only non-type visibility restrictions
136// are considered: the 'visibility' attribute, global value-visibility
137// settings, and a few special cases like __private_extern.
138//
139// 6. When computing the visibility of a type, including a type member
140// of a class, only type visibility restrictions are considered:
141// the 'type_visibility' attribute and global type-visibility settings.
142// However, a 'visibility' attribute counts as a 'type_visibility'
143// attribute on any declaration that only has the former.
144//
145// The visibility of a "secondary" entity, like a template argument,
146// is computed using the kind of that entity, not the kind of the
147// primary entity for which we are computing visibility. For example,
148// the visibility of a specialization of either of these templates:
149// template <class T, bool (&compare)(T, X)> bool has_match(list<T>, X);
150// template <class T, bool (&compare)(T, X)> class matcher;
151// is restricted according to the type visibility of the argument 'T',
152// the type visibility of 'bool(&)(T,X)', and the value visibility of
153// the argument function 'compare'. That 'has_match' is a value
154// and 'matcher' is a type only matters when looking for attributes
155// and settings from the immediate context.
156
157/// Does this computation kind permit us to consider additional
158/// visibility settings from attributes and the like?
160 return computation.IgnoreExplicitVisibility;
161}
162
163/// Given an LVComputationKind, return one of the same type/value sort
164/// that records that it already has explicit visibility.
167 Kind.IgnoreExplicitVisibility = true;
168 return Kind;
169}
170
171static std::optional<Visibility> getExplicitVisibility(const NamedDecl *D,
173 assert(!kind.IgnoreExplicitVisibility &&
174 "asking for explicit visibility when we shouldn't be");
175 return D->getExplicitVisibility(kind.getExplicitVisibilityKind());
176}
177
178/// Is the given declaration a "type" or a "value" for the purposes of
179/// visibility computation?
180static bool usesTypeVisibility(const NamedDecl *D) {
181 return isa<TypeDecl>(D) ||
184}
185
186/// Does the given declaration have member specialization information,
187/// and if so, is it an explicit specialization?
188template <class T>
189static std::enable_if_t<!std::is_base_of_v<RedeclarableTemplateDecl, T>, bool>
191 if (const MemberSpecializationInfo *member =
192 D->getMemberSpecializationInfo()) {
193 return member->isExplicitSpecialization();
194 }
195 return false;
196}
197
198/// For templates, this question is easier: a member template can't be
199/// explicitly instantiated, so there's a single bit indicating whether
200/// or not this is an explicit member specialization.
204
205/// Given a visibility attribute, return the explicit visibility
206/// associated with it.
207template <class T>
209 switch (attr->getVisibility()) {
210 case T::Default:
211 return DefaultVisibility;
212 case T::Hidden:
213 return HiddenVisibility;
214 case T::Protected:
215 return ProtectedVisibility;
216 }
217 llvm_unreachable("bad visibility kind");
218}
219
220/// Return the explicit visibility of the given declaration.
221static std::optional<Visibility>
223 // If we're ultimately computing the visibility of a type, look for
224 // a 'type_visibility' attribute before looking for 'visibility'.
226 if (const auto *A = D->getAttr<TypeVisibilityAttr>()) {
227 return getVisibilityFromAttr(A);
228 }
229 }
230
231 // If this declaration has an explicit visibility attribute, use it.
232 if (const auto *A = D->getAttr<VisibilityAttr>()) {
233 return getVisibilityFromAttr(A);
234 }
235
236 return std::nullopt;
237}
238
239LinkageInfo LinkageComputer::getLVForType(const Type &T,
240 LVComputationKind computation) {
241 if (computation.IgnoreAllVisibility)
242 return LinkageInfo(T.getLinkage(), DefaultVisibility, true);
244}
245
246/// Get the most restrictive linkage for the types in the given
247/// template parameter list. For visibility purposes, template
248/// parameters are part of the signature of a template.
249LinkageInfo LinkageComputer::getLVForTemplateParameterList(
250 const TemplateParameterList *Params, LVComputationKind computation) {
251 LinkageInfo LV;
252 for (const NamedDecl *P : *Params) {
253 // Template type parameters are the most common and never
254 // contribute to visibility, pack or not.
256 continue;
257
258 // Non-type template parameters can be restricted by the value type, e.g.
259 // template <enum X> class A { ... };
260 // We have to be careful here, though, because we can be dealing with
261 // dependent types.
262 if (const auto *NTTP = dyn_cast<NonTypeTemplateParmDecl>(P)) {
263 // Handle the non-pack case first.
264 if (!NTTP->isExpandedParameterPack()) {
265 if (!NTTP->getType()->isDependentType()) {
266 LV.merge(getLVForType(*NTTP->getType(), computation));
267 }
268 continue;
269 }
270
271 // Look at all the types in an expanded pack.
272 for (unsigned i = 0, n = NTTP->getNumExpansionTypes(); i != n; ++i) {
273 QualType type = NTTP->getExpansionType(i);
274 if (!type->isDependentType())
276 }
277 continue;
278 }
279
280 // Template template parameters can be restricted by their
281 // template parameters, recursively.
282 const auto *TTP = cast<TemplateTemplateParmDecl>(P);
283
284 // Handle the non-pack case first.
285 if (!TTP->isExpandedParameterPack()) {
286 LV.merge(getLVForTemplateParameterList(TTP->getTemplateParameters(),
287 computation));
288 continue;
289 }
290
291 // Look at all expansions in an expanded pack.
292 for (unsigned i = 0, n = TTP->getNumExpansionTemplateParameters();
293 i != n; ++i) {
294 LV.merge(getLVForTemplateParameterList(
295 TTP->getExpansionTemplateParameters(i), computation));
296 }
297 }
298
299 return LV;
300}
301
302static const Decl *getOutermostFuncOrBlockContext(const Decl *D) {
303 const Decl *Ret = nullptr;
304 const DeclContext *DC = D->getDeclContext();
305 while (DC->getDeclKind() != Decl::TranslationUnit) {
306 if (isa<FunctionDecl>(DC) || isa<BlockDecl>(DC))
307 Ret = cast<Decl>(DC);
308 DC = DC->getParent();
309 }
310 return Ret;
311}
312
313/// Get the most restrictive linkage for the types and
314/// declarations in the given template argument list.
315///
316/// Note that we don't take an LVComputationKind because we always
317/// want to honor the visibility of template arguments in the same way.
319LinkageComputer::getLVForTemplateArgumentList(ArrayRef<TemplateArgument> Args,
320 LVComputationKind computation) {
321 LinkageInfo LV;
322
323 for (const TemplateArgument &Arg : Args) {
324 switch (Arg.getKind()) {
328 continue;
329
331 LV.merge(getLVForType(*Arg.getAsType(), computation));
332 continue;
333
335 const NamedDecl *ND = Arg.getAsDecl();
336 assert(!usesTypeVisibility(ND));
337 LV.merge(getLVForDecl(ND, computation));
338 continue;
339 }
340
342 LV.merge(getTypeLinkageAndVisibility(Arg.getNullPtrType()));
343 continue;
344
346 LV.merge(getLVForValue(Arg.getAsStructuralValue(), computation));
347 continue;
348
351 if (TemplateDecl *Template =
352 Arg.getAsTemplateOrTemplatePattern().getAsTemplateDecl(
353 /*IgnoreDeduced=*/true))
354 LV.merge(getLVForDecl(Template, computation));
355 continue;
356
358 LV.merge(getLVForTemplateArgumentList(Arg.getPackAsArray(), computation));
359 continue;
360 }
361 llvm_unreachable("bad template argument kind");
362 }
363
364 return LV;
365}
366
368LinkageComputer::getLVForTemplateArgumentList(const TemplateArgumentList &TArgs,
369 LVComputationKind computation) {
370 return getLVForTemplateArgumentList(TArgs.asArray(), computation);
371}
372
374 const FunctionTemplateSpecializationInfo *specInfo) {
375 // Include visibility from the template parameters and arguments
376 // only if this is not an explicit instantiation or specialization
377 // with direct explicit visibility. (Implicit instantiations won't
378 // have a direct attribute.)
380 return true;
381
382 return !fn->hasAttr<VisibilityAttr>();
383}
384
385/// Merge in template-related linkage and visibility for the given
386/// function template specialization.
387///
388/// We don't need a computation kind here because we can assume
389/// LVForValue.
390///
391/// \param[out] LV the computation to use for the parent
392void LinkageComputer::mergeTemplateLV(
393 LinkageInfo &LV, const FunctionDecl *fn,
395 LVComputationKind computation) {
396 bool considerVisibility =
398
399 FunctionTemplateDecl *temp = specInfo->getTemplate();
400 // Merge information from the template declaration.
401 LinkageInfo tempLV = getLVForDecl(temp, computation);
402 // The linkage and visibility of the specialization should be
403 // consistent with the template declaration.
404 LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
405
406 // Merge information from the template parameters.
407 LinkageInfo paramsLV =
408 getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
409 LV.mergeMaybeWithVisibility(paramsLV, considerVisibility);
410
411 // Merge information from the template arguments.
412 const TemplateArgumentList &templateArgs = *specInfo->TemplateArguments;
413 LinkageInfo argsLV = getLVForTemplateArgumentList(templateArgs, computation);
414 LV.mergeMaybeWithVisibility(argsLV, considerVisibility);
415}
416
417/// Does the given declaration have a direct visibility attribute
418/// that would match the given rules?
420 LVComputationKind computation) {
421 if (computation.IgnoreAllVisibility)
422 return false;
423
424 return (computation.isTypeVisibility() && D->hasAttr<TypeVisibilityAttr>()) ||
425 D->hasAttr<VisibilityAttr>();
426}
427
428/// Should we consider visibility associated with the template
429/// arguments and parameters of the given class template specialization?
432 LVComputationKind computation) {
433 // Include visibility from the template parameters and arguments
434 // only if this is not an explicit instantiation or specialization
435 // with direct explicit visibility (and note that implicit
436 // instantiations won't have a direct attribute).
437 //
438 // Furthermore, we want to ignore template parameters and arguments
439 // for an explicit specialization when computing the visibility of a
440 // member thereof with explicit visibility.
441 //
442 // This is a bit complex; let's unpack it.
443 //
444 // An explicit class specialization is an independent, top-level
445 // declaration. As such, if it or any of its members has an
446 // explicit visibility attribute, that must directly express the
447 // user's intent, and we should honor it. The same logic applies to
448 // an explicit instantiation of a member of such a thing.
449
450 // Fast path: if this is not an explicit instantiation or
451 // specialization, we always want to consider template-related
452 // visibility restrictions.
454 return true;
455
456 // This is the 'member thereof' check.
457 if (spec->isExplicitSpecialization() &&
458 hasExplicitVisibilityAlready(computation))
459 return false;
460
461 return !hasDirectVisibilityAttribute(spec, computation);
462}
463
464/// Merge in template-related linkage and visibility for the given
465/// class template specialization.
466void LinkageComputer::mergeTemplateLV(
468 LVComputationKind computation) {
469 bool considerVisibility = shouldConsiderTemplateVisibility(spec, computation);
470
471 // Merge information from the template parameters, but ignore
472 // visibility if we're only considering template arguments.
473 ClassTemplateDecl *temp = spec->getSpecializedTemplate();
474 // Merge information from the template declaration.
475 LinkageInfo tempLV = getLVForDecl(temp, computation);
476 // The linkage of the specialization should be consistent with the
477 // template declaration.
478 LV.setLinkage(tempLV.getLinkage());
479
480 LinkageInfo paramsLV =
481 getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
482 LV.mergeMaybeWithVisibility(paramsLV,
483 considerVisibility && !hasExplicitVisibilityAlready(computation));
484
485 // Merge information from the template arguments. We ignore
486 // template-argument visibility if we've got an explicit
487 // instantiation with a visibility attribute.
488 const TemplateArgumentList &templateArgs = spec->getTemplateArgs();
489 LinkageInfo argsLV = getLVForTemplateArgumentList(templateArgs, computation);
490 if (considerVisibility)
491 LV.mergeVisibility(argsLV);
492 LV.mergeExternalVisibility(argsLV);
493}
494
495/// Should we consider visibility associated with the template
496/// arguments and parameters of the given variable template
497/// specialization? As usual, follow class template specialization
498/// logic up to initialization.
501 LVComputationKind computation) {
502 // Include visibility from the template parameters and arguments
503 // only if this is not an explicit instantiation or specialization
504 // with direct explicit visibility (and note that implicit
505 // instantiations won't have a direct attribute).
507 return true;
508
509 // An explicit variable specialization is an independent, top-level
510 // declaration. As such, if it has an explicit visibility attribute,
511 // that must directly express the user's intent, and we should honor
512 // it.
513 if (spec->isExplicitSpecialization() &&
514 hasExplicitVisibilityAlready(computation))
515 return false;
516
517 return !hasDirectVisibilityAttribute(spec, computation);
518}
519
520/// Merge in template-related linkage and visibility for the given
521/// variable template specialization. As usual, follow class template
522/// specialization logic up to initialization.
523void LinkageComputer::mergeTemplateLV(LinkageInfo &LV,
525 LVComputationKind computation) {
526 bool considerVisibility = shouldConsiderTemplateVisibility(spec, computation);
527
528 // Merge information from the template parameters, but ignore
529 // visibility if we're only considering template arguments.
530 VarTemplateDecl *temp = spec->getSpecializedTemplate();
531 LinkageInfo tempLV =
532 getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
533 LV.mergeMaybeWithVisibility(tempLV,
534 considerVisibility && !hasExplicitVisibilityAlready(computation));
535
536 // Merge information from the template arguments. We ignore
537 // template-argument visibility if we've got an explicit
538 // instantiation with a visibility attribute.
539 const TemplateArgumentList &templateArgs = spec->getTemplateArgs();
540 LinkageInfo argsLV = getLVForTemplateArgumentList(templateArgs, computation);
541 if (considerVisibility)
542 LV.mergeVisibility(argsLV);
543 LV.mergeExternalVisibility(argsLV);
544}
545
547 // FIXME: we should warn if -fvisibility-inlines-hidden is used with c.
548 const LangOptions &Opts = D->getASTContext().getLangOpts();
549 if (!Opts.CPlusPlus || !Opts.InlineVisibilityHidden)
550 return false;
551
552 const auto *FD = dyn_cast<FunctionDecl>(D);
553 if (!FD)
554 return false;
555
558 = FD->getTemplateSpecializationInfo()) {
559 TSK = spec->getTemplateSpecializationKind();
560 } else if (MemberSpecializationInfo *MSI =
561 FD->getMemberSpecializationInfo()) {
562 TSK = MSI->getTemplateSpecializationKind();
563 }
564
565 const FunctionDecl *Def = nullptr;
566 // InlineVisibilityHidden only applies to definitions, and
567 // isInlined() only gives meaningful answers on definitions
568 // anyway.
571 FD->hasBody(Def) && Def->isInlined() && !Def->hasAttr<GNUInlineAttr>();
572}
573
574template <typename T> static bool isFirstInExternCContext(T *D) {
575 const T *First = D->getFirstDecl();
576 return First->isInExternCContext();
577}
578
579static bool isSingleLineLanguageLinkage(const Decl &D) {
580 if (const auto *SD = dyn_cast<LinkageSpecDecl>(D.getDeclContext()))
581 if (!SD->hasBraces())
582 return true;
583 return false;
584}
585
589
591 if (auto *TD = dyn_cast<TemplateDecl>(D))
592 D = TD->getTemplatedDecl();
593 if (D) {
594 if (auto *VD = dyn_cast<VarDecl>(D))
595 return VD->getStorageClass();
596 if (auto *FD = dyn_cast<FunctionDecl>(D))
597 return FD->getStorageClass();
598 }
599 return SC_None;
600}
601
603LinkageComputer::getLVForNamespaceScopeDecl(const NamedDecl *D,
604 LVComputationKind computation,
605 bool IgnoreVarTypeLinkage) {
607 "Not a name having namespace scope");
608 ASTContext &Context = D->getASTContext();
609 const auto *Var = dyn_cast<VarDecl>(D);
610
611 // C++ [basic.link]p3:
612 // A name having namespace scope (3.3.6) has internal linkage if it
613 // is the name of
614
616 (Context.getLangOpts().C23 && Var && Var->isConstexpr())) {
617 // - a variable, variable template, function, or function template
618 // that is explicitly declared static; or
619 // (This bullet corresponds to C99 6.2.2p3.)
620
621 // C23 6.2.2p3
622 // If the declaration of a file scope identifier for
623 // an object contains any of the storage-class specifiers static or
624 // constexpr then the identifier has internal linkage.
625 return LinkageInfo::internal();
626 }
627
628 if (Var) {
629 // - a non-template variable of non-volatile const-qualified type, unless
630 // - it is explicitly declared extern, or
631 // - it is declared in the purview of a module interface unit
632 // (outside the private-module-fragment, if any) or module partition, or
633 // - it is inline, or
634 // - it was previously declared and the prior declaration did not have
635 // internal linkage
636 // (There is no equivalent in C99.)
637 if (Context.getLangOpts().CPlusPlus && Var->getType().isConstQualified() &&
638 !Var->getType().isVolatileQualified() && !Var->isInline() &&
639 ![Var]() {
640 // Check if it is module purview except private module fragment
641 // and implementation unit.
642 if (auto *M = Var->getOwningModule())
643 return M->isInterfaceOrPartition() || M->isImplicitGlobalModule();
644 return false;
645 }() &&
647 !Var->getDescribedVarTemplate()) {
648 const VarDecl *PrevVar = Var->getPreviousDecl();
649 if (PrevVar)
650 return getLVForDecl(PrevVar, computation);
651
652 if (Var->getStorageClass() != SC_Extern &&
653 Var->getStorageClass() != SC_PrivateExtern &&
655 return LinkageInfo::internal();
656 }
657
658 for (const VarDecl *PrevVar = Var->getPreviousDecl(); PrevVar;
659 PrevVar = PrevVar->getPreviousDecl()) {
660 if (PrevVar->getStorageClass() == SC_PrivateExtern &&
661 Var->getStorageClass() == SC_None)
662 return getDeclLinkageAndVisibility(PrevVar);
663 // Explicitly declared static.
664 if (PrevVar->getStorageClass() == SC_Static)
665 return LinkageInfo::internal();
666 }
667 } else if (const auto *IFD = dyn_cast<IndirectFieldDecl>(D)) {
668 // - a data member of an anonymous union.
669 const VarDecl *VD = IFD->getVarDecl();
670 assert(VD && "Expected a VarDecl in this IndirectFieldDecl!");
671 return getLVForNamespaceScopeDecl(VD, computation, IgnoreVarTypeLinkage);
672 }
673 assert(!isa<FieldDecl>(D) && "Didn't expect a FieldDecl!");
674
675 // FIXME: This gives internal linkage to names that should have no linkage
676 // (those not covered by [basic.link]p6).
677 if (D->isInAnonymousNamespace()) {
678 const auto *Var = dyn_cast<VarDecl>(D);
679 const auto *Func = dyn_cast<FunctionDecl>(D);
680 // FIXME: The check for extern "C" here is not justified by the standard
681 // wording, but we retain it from the pre-DR1113 model to avoid breaking
682 // code.
683 //
684 // C++11 [basic.link]p4:
685 // An unnamed namespace or a namespace declared directly or indirectly
686 // within an unnamed namespace has internal linkage.
687 if ((!Var || !isFirstInExternCContext(Var)) &&
689 return LinkageInfo::internal();
690 }
691
692 // Set up the defaults.
693
694 // C99 6.2.2p5:
695 // If the declaration of an identifier for an object has file
696 // scope and no storage-class specifier, its linkage is
697 // external.
698 LinkageInfo LV = getExternalLinkageFor(D);
699
700 if (!hasExplicitVisibilityAlready(computation)) {
701 if (std::optional<Visibility> Vis = getExplicitVisibility(D, computation)) {
702 LV.mergeVisibility(*Vis, true);
703 } else {
704 // If we're declared in a namespace with a visibility attribute,
705 // use that namespace's visibility, and it still counts as explicit.
706 for (const DeclContext *DC = D->getDeclContext();
708 DC = DC->getParent()) {
709 const auto *ND = dyn_cast<NamespaceDecl>(DC);
710 if (!ND) continue;
711 if (std::optional<Visibility> Vis =
712 getExplicitVisibility(ND, computation)) {
713 LV.mergeVisibility(*Vis, true);
714 break;
715 }
716 }
717 }
718
719 // Add in global settings if the above didn't give us direct visibility.
720 if (!LV.isVisibilityExplicit()) {
721 // Use global type/value visibility as appropriate.
722 Visibility globalVisibility =
723 computation.isValueVisibility()
724 ? Context.getLangOpts().getValueVisibilityMode()
725 : Context.getLangOpts().getTypeVisibilityMode();
726 LV.mergeVisibility(globalVisibility, /*explicit*/ false);
727
728 // If we're paying attention to global visibility, apply
729 // -finline-visibility-hidden if this is an inline method.
731 LV.mergeVisibility(HiddenVisibility, /*visibilityExplicit=*/false);
732 }
733 }
734
735 // C++ [basic.link]p4:
736
737 // A name having namespace scope that has not been given internal linkage
738 // above and that is the name of
739 // [...bullets...]
740 // has its linkage determined as follows:
741 // - if the enclosing namespace has internal linkage, the name has
742 // internal linkage; [handled above]
743 // - otherwise, if the declaration of the name is attached to a named
744 // module and is not exported, the name has module linkage;
745 // - otherwise, the name has external linkage.
746 // LV is currently set up to handle the last two bullets.
747 //
748 // The bullets are:
749
750 // - a variable; or
751 if (const auto *Var = dyn_cast<VarDecl>(D)) {
752 // GCC applies the following optimization to variables and static
753 // data members, but not to functions:
754 //
755 // Modify the variable's LV by the LV of its type unless this is
756 // C or extern "C". This follows from [basic.link]p9:
757 // A type without linkage shall not be used as the type of a
758 // variable or function with external linkage unless
759 // - the entity has C language linkage, or
760 // - the entity is declared within an unnamed namespace, or
761 // - the entity is not used or is defined in the same
762 // translation unit.
763 // and [basic.link]p10:
764 // ...the types specified by all declarations referring to a
765 // given variable or function shall be identical...
766 // C does not have an equivalent rule.
767 //
768 // Ignore this if we've got an explicit attribute; the user
769 // probably knows what they're doing.
770 //
771 // Note that we don't want to make the variable non-external
772 // because of this, but unique-external linkage suits us.
773
774 if (Context.getLangOpts().CPlusPlus && !isFirstInExternCContext(Var) &&
775 !IgnoreVarTypeLinkage) {
776 LinkageInfo TypeLV = getLVForType(*Var->getType(), computation);
777 if (!isExternallyVisible(TypeLV.getLinkage()))
779 if (!LV.isVisibilityExplicit())
780 LV.mergeVisibility(TypeLV);
781 }
782
783 if (Var->getStorageClass() == SC_PrivateExtern)
785
786 // Note that Sema::MergeVarDecl already takes care of implementing
787 // C99 6.2.2p4 and propagating the visibility attribute, so we don't have
788 // to do it here.
789
790 // As per function and class template specializations (below),
791 // consider LV for the template and template arguments. We're at file
792 // scope, so we do not need to worry about nested specializations.
793 if (const auto *spec = dyn_cast<VarTemplateSpecializationDecl>(Var)) {
794 mergeTemplateLV(LV, spec, computation);
795 }
796
797 // - a function; or
798 } else if (const auto *Function = dyn_cast<FunctionDecl>(D)) {
799 // In theory, we can modify the function's LV by the LV of its
800 // type unless it has C linkage (see comment above about variables
801 // for justification). In practice, GCC doesn't do this, so it's
802 // just too painful to make work.
803
804 if (Function->getStorageClass() == SC_PrivateExtern)
806
807 // OpenMP target declare device functions are not callable from the host so
808 // they should not be exported from the device image. This applies to all
809 // functions as the host-callable kernel functions are emitted at codegen.
810 if (Context.getLangOpts().OpenMP &&
811 Context.getLangOpts().OpenMPIsTargetDevice &&
812 (Context.getTargetInfo().getTriple().isGPU() ||
813 OMPDeclareTargetDeclAttr::isDeclareTargetDeclaration(Function)))
814 LV.mergeVisibility(HiddenVisibility, /*newExplicit=*/false);
815
816 // Note that Sema::MergeCompatibleFunctionDecls already takes care of
817 // merging storage classes and visibility attributes, so we don't have to
818 // look at previous decls in here.
819
820 // In C++, then if the type of the function uses a type with
821 // unique-external linkage, it's not legally usable from outside
822 // this translation unit. However, we should use the C linkage
823 // rules instead for extern "C" declarations.
824 if (Context.getLangOpts().CPlusPlus && !isFirstInExternCContext(Function)) {
825 // Only look at the type-as-written. Otherwise, deducing the return type
826 // of a function could change its linkage.
827 QualType TypeAsWritten = Function->getType();
828 if (TypeSourceInfo *TSI = Function->getTypeSourceInfo())
829 TypeAsWritten = TSI->getType();
830 if (!isExternallyVisible(TypeAsWritten->getLinkage()))
832 }
833
834 // Consider LV from the template and the template arguments.
835 // We're at file scope, so we do not need to worry about nested
836 // specializations.
837 if (FunctionTemplateSpecializationInfo *specInfo
838 = Function->getTemplateSpecializationInfo()) {
839 mergeTemplateLV(LV, Function, specInfo, computation);
840 }
841
842 // - a named class (Clause 9), or an unnamed class defined in a
843 // typedef declaration in which the class has the typedef name
844 // for linkage purposes (7.1.3); or
845 // - a named enumeration (7.2), or an unnamed enumeration
846 // defined in a typedef declaration in which the enumeration
847 // has the typedef name for linkage purposes (7.1.3); or
848 } else if (const auto *Tag = dyn_cast<TagDecl>(D)) {
849 // Unnamed tags have no linkage.
850 if (!Tag->hasNameForLinkage())
851 return LinkageInfo::none();
852
853 // If this is a class template specialization, consider the
854 // linkage of the template and template arguments. We're at file
855 // scope, so we do not need to worry about nested specializations.
856 if (const auto *spec = dyn_cast<ClassTemplateSpecializationDecl>(Tag)) {
857 mergeTemplateLV(LV, spec, computation);
858 }
859
860 // FIXME: This is not part of the C++ standard any more.
861 // - an enumerator belonging to an enumeration with external linkage; or
862 } else if (isa<EnumConstantDecl>(D)) {
863 LinkageInfo EnumLV = getLVForDecl(cast<NamedDecl>(D->getDeclContext()),
864 computation);
865 if (!isExternalFormalLinkage(EnumLV.getLinkage()))
866 return LinkageInfo::none();
867 LV.merge(EnumLV);
868
869 // - a template
870 } else if (const auto *temp = dyn_cast<TemplateDecl>(D)) {
871 bool considerVisibility = !hasExplicitVisibilityAlready(computation);
872 LinkageInfo tempLV =
873 getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
874 LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
875
876 // An unnamed namespace or a namespace declared directly or indirectly
877 // within an unnamed namespace has internal linkage. All other namespaces
878 // have external linkage.
879 //
880 // We handled names in anonymous namespaces above.
881 } else if (isa<NamespaceDecl>(D)) {
882 return LV;
883
884 // By extension, we assign external linkage to Objective-C
885 // interfaces.
886 } else if (isa<ObjCInterfaceDecl>(D)) {
887 // fallout
888
889 } else if (auto *TD = dyn_cast<TypedefNameDecl>(D)) {
890 // A typedef declaration has linkage if it gives a type a name for
891 // linkage purposes.
892 if (!TD->getAnonDeclWithTypedefName(/*AnyRedecl*/true))
893 return LinkageInfo::none();
894
895 } else if (isa<MSGuidDecl>(D)) {
896 // A GUID behaves like an inline variable with external linkage. Fall
897 // through.
898
899 // Everything not covered here has no linkage.
900 } else {
901 return LinkageInfo::none();
902 }
903
904 // If we ended up with non-externally-visible linkage, visibility should
905 // always be default.
907 return LinkageInfo(LV.getLinkage(), DefaultVisibility, false);
908
909 return LV;
910}
911
913LinkageComputer::getLVForClassMember(const NamedDecl *D,
914 LVComputationKind computation,
915 bool IgnoreVarTypeLinkage) {
916 // Only certain class members have linkage. Note that fields don't
917 // really have linkage, but it's convenient to say they do for the
918 // purposes of calculating linkage of pointer-to-data-member
919 // template arguments.
920 //
921 // Templates also don't officially have linkage, but since we ignore
922 // the C++ standard and look at template arguments when determining
923 // linkage and visibility of a template specialization, we might hit
924 // a template template argument that way. If we do, we need to
925 // consider its linkage.
926 if (!(isa<CXXMethodDecl>(D) ||
927 isa<VarDecl>(D) ||
928 isa<FieldDecl>(D) ||
930 isa<TagDecl>(D) ||
932 return LinkageInfo::none();
933
934 LinkageInfo LV;
935
936 // If we have an explicit visibility attribute, merge that in.
937 if (!hasExplicitVisibilityAlready(computation)) {
938 if (std::optional<Visibility> Vis = getExplicitVisibility(D, computation))
939 LV.mergeVisibility(*Vis, true);
940 // If we're paying attention to global visibility, apply
941 // -finline-visibility-hidden if this is an inline method.
942 //
943 // Note that we do this before merging information about
944 // the class visibility.
946 LV.mergeVisibility(HiddenVisibility, /*visibilityExplicit=*/false);
947 }
948
949 // If this class member has an explicit visibility attribute, the only
950 // thing that can change its visibility is the template arguments, so
951 // only look for them when processing the class.
952 LVComputationKind classComputation = computation;
953 if (LV.isVisibilityExplicit())
954 classComputation = withExplicitVisibilityAlready(computation);
955
956 LinkageInfo classLV =
957 getLVForDecl(cast<RecordDecl>(D->getDeclContext()), classComputation);
958 // The member has the same linkage as the class. If that's not externally
959 // visible, we don't need to compute anything about the linkage.
960 // FIXME: If we're only computing linkage, can we bail out here?
961 if (!isExternallyVisible(classLV.getLinkage()))
962 return classLV;
963
964
965 // Otherwise, don't merge in classLV yet, because in certain cases
966 // we need to completely ignore the visibility from it.
967
968 // Specifically, if this decl exists and has an explicit attribute.
969 const NamedDecl *explicitSpecSuppressor = nullptr;
970
971 if (const auto *MD = dyn_cast<CXXMethodDecl>(D)) {
972 // Only look at the type-as-written. Otherwise, deducing the return type
973 // of a function could change its linkage.
974 QualType TypeAsWritten = MD->getType();
975 if (TypeSourceInfo *TSI = MD->getTypeSourceInfo())
976 TypeAsWritten = TSI->getType();
977 if (!isExternallyVisible(TypeAsWritten->getLinkage()))
979
980 // If this is a method template specialization, use the linkage for
981 // the template parameters and arguments.
982 if (FunctionTemplateSpecializationInfo *spec
983 = MD->getTemplateSpecializationInfo()) {
984 mergeTemplateLV(LV, MD, spec, computation);
985 if (spec->isExplicitSpecialization()) {
986 explicitSpecSuppressor = MD;
987 } else if (isExplicitMemberSpecialization(spec->getTemplate())) {
988 explicitSpecSuppressor = spec->getTemplate()->getTemplatedDecl();
989 }
990 } else if (isExplicitMemberSpecialization(MD)) {
991 explicitSpecSuppressor = MD;
992 }
993
994 // OpenMP target declare device functions are not callable from the host so
995 // they should not be exported from the device image. This applies to all
996 // functions as the host-callable kernel functions are emitted at codegen.
997 ASTContext &Context = D->getASTContext();
998 if (Context.getLangOpts().OpenMP &&
999 Context.getLangOpts().OpenMPIsTargetDevice &&
1000 ((Context.getTargetInfo().getTriple().isAMDGPU() ||
1001 Context.getTargetInfo().getTriple().isNVPTX()) ||
1002 OMPDeclareTargetDeclAttr::isDeclareTargetDeclaration(MD)))
1003 LV.mergeVisibility(HiddenVisibility, /*newExplicit=*/false);
1004
1005 } else if (const auto *RD = dyn_cast<CXXRecordDecl>(D)) {
1006 if (const auto *spec = dyn_cast<ClassTemplateSpecializationDecl>(RD)) {
1007 mergeTemplateLV(LV, spec, computation);
1008 if (spec->isExplicitSpecialization()) {
1009 explicitSpecSuppressor = spec;
1010 } else {
1011 const ClassTemplateDecl *temp = spec->getSpecializedTemplate();
1013 explicitSpecSuppressor = temp->getTemplatedDecl();
1014 }
1015 }
1016 } else if (isExplicitMemberSpecialization(RD)) {
1017 explicitSpecSuppressor = RD;
1018 }
1019
1020 // Static data members.
1021 } else if (const auto *VD = dyn_cast<VarDecl>(D)) {
1022 if (const auto *spec = dyn_cast<VarTemplateSpecializationDecl>(VD))
1023 mergeTemplateLV(LV, spec, computation);
1024
1025 // Modify the variable's linkage by its type, but ignore the
1026 // type's visibility unless it's a definition.
1027 if (!IgnoreVarTypeLinkage) {
1028 LinkageInfo typeLV = getLVForType(*VD->getType(), computation);
1029 // FIXME: If the type's linkage is not externally visible, we can
1030 // give this static data member UniqueExternalLinkage.
1031 if (!LV.isVisibilityExplicit() && !classLV.isVisibilityExplicit())
1032 LV.mergeVisibility(typeLV);
1033 LV.mergeExternalVisibility(typeLV);
1034 }
1035
1037 explicitSpecSuppressor = VD;
1038 }
1039
1040 // Template members.
1041 } else if (const auto *temp = dyn_cast<TemplateDecl>(D)) {
1042 bool considerVisibility =
1043 (!LV.isVisibilityExplicit() &&
1044 !classLV.isVisibilityExplicit() &&
1045 !hasExplicitVisibilityAlready(computation));
1046 LinkageInfo tempLV =
1047 getLVForTemplateParameterList(temp->getTemplateParameters(), computation);
1048 LV.mergeMaybeWithVisibility(tempLV, considerVisibility);
1049
1050 if (const auto *redeclTemp = dyn_cast<RedeclarableTemplateDecl>(temp)) {
1051 if (isExplicitMemberSpecialization(redeclTemp)) {
1052 explicitSpecSuppressor = temp->getTemplatedDecl();
1053 } else if (const RedeclarableTemplateDecl *from =
1054 redeclTemp->getInstantiatedFromMemberTemplate()) {
1055 // If no explicit visibility is specified yet, and this is an
1056 // instantiated member of a template, look up visibility there
1057 // as well.
1058 LinkageInfo fromLV = from->getLinkageAndVisibility();
1059 LV.mergeMaybeWithVisibility(fromLV, considerVisibility);
1060 }
1061 }
1062 }
1063
1064 // We should never be looking for an attribute directly on a template.
1065 assert(!explicitSpecSuppressor || !isa<TemplateDecl>(explicitSpecSuppressor));
1066
1067 // If this member is an explicit member specialization, and it has
1068 // an explicit attribute, ignore visibility from the parent.
1069 bool considerClassVisibility = true;
1070 if (explicitSpecSuppressor &&
1071 // optimization: hasDVA() is true only with explicit visibility.
1072 LV.isVisibilityExplicit() &&
1073 classLV.getVisibility() != DefaultVisibility &&
1074 hasDirectVisibilityAttribute(explicitSpecSuppressor, computation)) {
1075 considerClassVisibility = false;
1076 }
1077
1078 // Finally, merge in information from the class.
1079 LV.mergeMaybeWithVisibility(classLV, considerClassVisibility);
1080 return LV;
1081}
1082
1083void NamedDecl::anchor() {}
1084
1086 if (!hasCachedLinkage())
1087 return true;
1088
1090 .computeLVForDecl(this, LVComputationKind::forLinkageOnly())
1091 .getLinkage();
1092 return L == getCachedLinkage();
1093}
1094
1095bool NamedDecl::isPlaceholderVar(const LangOptions &LangOpts) const {
1096 // [C++2c] [basic.scope.scope]/p5
1097 // A declaration is name-independent if its name is _ and it declares
1098 // - a variable with automatic storage duration,
1099 // - a structured binding not inhabiting a namespace scope,
1100 // - the variable introduced by an init-capture
1101 // - or a non-static data member.
1102
1103 if (!LangOpts.CPlusPlus || !getIdentifier() ||
1104 !getIdentifier()->isPlaceholder())
1105 return false;
1106 if (isa<FieldDecl>(this))
1107 return true;
1108 if (const auto *IFD = dyn_cast<IndirectFieldDecl>(this)) {
1109 if (!getDeclContext()->isFunctionOrMethod() &&
1110 !getDeclContext()->isRecord())
1111 return false;
1112 const VarDecl *VD = IFD->getVarDecl();
1113 return !VD || VD->getStorageDuration() == SD_Automatic;
1114 }
1115 // and it declares a variable with automatic storage duration
1116 if (const auto *VD = dyn_cast<VarDecl>(this)) {
1117 if (isa<ParmVarDecl>(VD))
1118 return false;
1119 if (VD->isInitCapture())
1120 return true;
1122 }
1123 if (const auto *BD = dyn_cast<BindingDecl>(this);
1125 const VarDecl *VD = BD->getHoldingVar();
1127 }
1128 return false;
1129}
1130
1132NamedDecl::isReserved(const LangOptions &LangOpts) const {
1133 const IdentifierInfo *II = getIdentifier();
1134
1135 // This triggers at least for CXXLiteralIdentifiers, which we already checked
1136 // at lexing time.
1137 if (!II)
1139
1140 ReservedIdentifierStatus Status = II->isReserved(LangOpts);
1141 if (isReservedAtGlobalScope(Status) && !isReservedInAllContexts(Status)) {
1142 // This name is only reserved at global scope. Check if this declaration
1143 // conflicts with a global scope declaration.
1146
1147 // C++ [dcl.link]/7:
1148 // Two declarations [conflict] if [...] one declares a function or
1149 // variable with C language linkage, and the other declares [...] a
1150 // variable that belongs to the global scope.
1151 //
1152 // Therefore names that are reserved at global scope are also reserved as
1153 // names of variables and functions with C language linkage.
1155 if (DC->isTranslationUnit())
1156 return Status;
1157 if (auto *VD = dyn_cast<VarDecl>(this))
1158 if (VD->isExternC())
1160 if (auto *FD = dyn_cast<FunctionDecl>(this))
1161 if (FD->isExternC())
1164 }
1165
1166 return Status;
1167}
1168
1170 StringRef name = getName();
1171 if (name.empty()) return SFF_None;
1172
1173 if (name.front() == 'C')
1174 if (name == "CFStringCreateWithFormat" ||
1175 name == "CFStringCreateWithFormatAndArguments" ||
1176 name == "CFStringAppendFormat" ||
1177 name == "CFStringAppendFormatAndArguments")
1178 return SFF_CFString;
1179 return SFF_None;
1180}
1181
1183 // We don't care about visibility here, so ask for the cheapest
1184 // possible visibility analysis.
1185 return LinkageComputer{}
1186 .getLVForDecl(this, LVComputationKind::forLinkageOnly())
1187 .getLinkage();
1188}
1189
1191 // FIXME: Handle isModulePrivate.
1192 switch (D->getModuleOwnershipKind()) {
1197 return false;
1200 return D->isInNamedModule();
1201 }
1202 llvm_unreachable("unexpected module ownership kind");
1203}
1204
1205/// Get the linkage from a semantic point of view. Entities in
1206/// anonymous namespaces are external (in c++98).
1208 Linkage InternalLinkage = getLinkageInternal();
1209
1210 // C++ [basic.link]p4.8:
1211 // - if the declaration of the name is attached to a named module and is not
1212 // exported
1213 // the name has module linkage;
1214 //
1215 // [basic.namespace.general]/p2
1216 // A namespace is never attached to a named module and never has a name with
1217 // module linkage.
1218 if (isInNamedModule() && InternalLinkage == Linkage::External &&
1221 !isa<NamespaceDecl>(this))
1222 InternalLinkage = Linkage::Module;
1223
1224 return clang::getFormalLinkage(InternalLinkage);
1225}
1226
1228 return LinkageComputer{}.getDeclLinkageAndVisibility(this);
1229}
1230
1231static std::optional<Visibility>
1234 bool IsMostRecent) {
1235 assert(!IsMostRecent || ND == ND->getMostRecentDecl());
1236
1237 if (isa<ConceptDecl>(ND))
1238 return {};
1239
1240 // Check the declaration itself first.
1241 if (std::optional<Visibility> V = getVisibilityOf(ND, kind))
1242 return V;
1243
1244 // If this is a member class of a specialization of a class template
1245 // and the corresponding decl has explicit visibility, use that.
1246 if (const auto *RD = dyn_cast<CXXRecordDecl>(ND)) {
1247 CXXRecordDecl *InstantiatedFrom = RD->getInstantiatedFromMemberClass();
1248 if (InstantiatedFrom)
1249 return getVisibilityOf(InstantiatedFrom, kind);
1250 }
1251
1252 // If there wasn't explicit visibility there, and this is a
1253 // specialization of a class template, check for visibility
1254 // on the pattern.
1255 if (const auto *spec = dyn_cast<ClassTemplateSpecializationDecl>(ND)) {
1256 // Walk all the template decl till this point to see if there are
1257 // explicit visibility attributes.
1258 const auto *TD = spec->getSpecializedTemplate()->getTemplatedDecl();
1259 while (TD != nullptr) {
1260 auto Vis = getVisibilityOf(TD, kind);
1261 if (Vis != std::nullopt)
1262 return Vis;
1263 TD = TD->getPreviousDecl();
1264 }
1265 return std::nullopt;
1266 }
1267
1268 // Use the most recent declaration.
1269 if (!IsMostRecent && !isa<NamespaceDecl>(ND)) {
1270 const NamedDecl *MostRecent = ND->getMostRecentDecl();
1271 if (MostRecent != ND)
1272 return getExplicitVisibilityAux(MostRecent, kind, true);
1273 }
1274
1275 if (const auto *Var = dyn_cast<VarDecl>(ND)) {
1276 if (Var->isStaticDataMember()) {
1277 VarDecl *InstantiatedFrom = Var->getInstantiatedFromStaticDataMember();
1278 if (InstantiatedFrom)
1279 return getVisibilityOf(InstantiatedFrom, kind);
1280 }
1281
1282 if (const auto *VTSD = dyn_cast<VarTemplateSpecializationDecl>(Var))
1283 return getVisibilityOf(VTSD->getSpecializedTemplate()->getTemplatedDecl(),
1284 kind);
1285
1286 return std::nullopt;
1287 }
1288 // Also handle function template specializations.
1289 if (const auto *fn = dyn_cast<FunctionDecl>(ND)) {
1290 // If the function is a specialization of a template with an
1291 // explicit visibility attribute, use that.
1292 if (FunctionTemplateSpecializationInfo *templateInfo
1294 return getVisibilityOf(templateInfo->getTemplate()->getTemplatedDecl(),
1295 kind);
1296
1297 // If the function is a member of a specialization of a class template
1298 // and the corresponding decl has explicit visibility, use that.
1299 FunctionDecl *InstantiatedFrom = fn->getInstantiatedFromMemberFunction();
1300 if (InstantiatedFrom)
1301 return getVisibilityOf(InstantiatedFrom, kind);
1302
1303 return std::nullopt;
1304 }
1305
1306 // The visibility of a template is stored in the templated decl.
1307 if (const auto *TD = dyn_cast<TemplateDecl>(ND))
1308 return getVisibilityOf(TD->getTemplatedDecl(), kind);
1309
1310 return std::nullopt;
1311}
1312
1313std::optional<Visibility>
1317
1318LinkageInfo LinkageComputer::getLVForClosure(const DeclContext *DC,
1319 Decl *ContextDecl,
1320 LVComputationKind computation) {
1321 // This lambda has its linkage/visibility determined by its owner.
1322 const NamedDecl *Owner;
1323 if (!ContextDecl)
1324 Owner = dyn_cast<NamedDecl>(DC);
1325 else if (isa<ParmVarDecl>(ContextDecl))
1326 Owner =
1327 dyn_cast<NamedDecl>(ContextDecl->getDeclContext()->getRedeclContext());
1328 else if (isa<ImplicitConceptSpecializationDecl>(ContextDecl)) {
1329 // Replace with the concept's owning decl, which is either a namespace or a
1330 // TU, so this needs a dyn_cast.
1331 Owner = dyn_cast<NamedDecl>(ContextDecl->getDeclContext());
1332 } else {
1333 Owner = cast<NamedDecl>(ContextDecl);
1334 }
1335
1336 if (!Owner)
1337 return LinkageInfo::none();
1338
1339 // If the owner has a deduced type, we need to skip querying the linkage and
1340 // visibility of that type, because it might involve this closure type. The
1341 // only effect of this is that we might give a lambda VisibleNoLinkage rather
1342 // than NoLinkage when we don't strictly need to, which is benign.
1343 auto *VD = dyn_cast<VarDecl>(Owner);
1344 LinkageInfo OwnerLV =
1345 VD && VD->getType()->getContainedDeducedType()
1346 ? computeLVForDecl(Owner, computation, /*IgnoreVarTypeLinkage*/true)
1347 : getLVForDecl(Owner, computation);
1348
1349 // A lambda never formally has linkage. But if the owner is externally
1350 // visible, then the lambda is too. We apply the same rules to blocks.
1351 if (!isExternallyVisible(OwnerLV.getLinkage()))
1352 return LinkageInfo::none();
1353 return LinkageInfo(Linkage::VisibleNone, OwnerLV.getVisibility(),
1354 OwnerLV.isVisibilityExplicit());
1355}
1356
1357LinkageInfo LinkageComputer::getLVForLocalDecl(const NamedDecl *D,
1358 LVComputationKind computation) {
1359 if (const auto *Function = dyn_cast<FunctionDecl>(D)) {
1360 if (Function->isInAnonymousNamespace() &&
1362 return LinkageInfo::internal();
1363
1364 // This is a "void f();" which got merged with a file static.
1365 if (Function->getCanonicalDecl()->getStorageClass() == SC_Static)
1366 return LinkageInfo::internal();
1367
1368 LinkageInfo LV;
1369 if (!hasExplicitVisibilityAlready(computation)) {
1370 if (std::optional<Visibility> Vis =
1371 getExplicitVisibility(Function, computation))
1372 LV.mergeVisibility(*Vis, true);
1373 }
1374
1375 // Note that Sema::MergeCompatibleFunctionDecls already takes care of
1376 // merging storage classes and visibility attributes, so we don't have to
1377 // look at previous decls in here.
1378
1379 return LV;
1380 }
1381
1382 if (const auto *Var = dyn_cast<VarDecl>(D)) {
1383 if (Var->hasExternalStorage()) {
1384 if (Var->isInAnonymousNamespace() && !isFirstInExternCContext(Var))
1385 return LinkageInfo::internal();
1386
1387 LinkageInfo LV;
1388 if (Var->getStorageClass() == SC_PrivateExtern)
1390 else if (!hasExplicitVisibilityAlready(computation)) {
1391 if (std::optional<Visibility> Vis =
1392 getExplicitVisibility(Var, computation))
1393 LV.mergeVisibility(*Vis, true);
1394 }
1395
1396 if (const VarDecl *Prev = Var->getPreviousDecl()) {
1397 LinkageInfo PrevLV = getLVForDecl(Prev, computation);
1398 if (PrevLV.getLinkage() != Linkage::Invalid)
1399 LV.setLinkage(PrevLV.getLinkage());
1400 LV.mergeVisibility(PrevLV);
1401 }
1402
1403 return LV;
1404 }
1405
1406 if (!Var->isStaticLocal())
1407 return LinkageInfo::none();
1408 }
1409
1410 ASTContext &Context = D->getASTContext();
1411 if (!Context.getLangOpts().CPlusPlus)
1412 return LinkageInfo::none();
1413
1414 const Decl *OuterD = getOutermostFuncOrBlockContext(D);
1415 if (!OuterD || OuterD->isInvalidDecl())
1416 return LinkageInfo::none();
1417
1418 LinkageInfo LV;
1419 if (const auto *BD = dyn_cast<BlockDecl>(OuterD)) {
1420 if (!BD->getBlockManglingNumber())
1421 return LinkageInfo::none();
1422
1423 LV = getLVForClosure(BD->getDeclContext()->getRedeclContext(),
1424 BD->getBlockManglingContextDecl(), computation);
1425 } else {
1426 const auto *FD = cast<FunctionDecl>(OuterD);
1427 if (!FD->isInlined() &&
1428 !isTemplateInstantiation(FD->getTemplateSpecializationKind()))
1429 return LinkageInfo::none();
1430
1431 // If a function is hidden by -fvisibility-inlines-hidden option and
1432 // is not explicitly attributed as a hidden function,
1433 // we should not make static local variables in the function hidden.
1434 LV = getLVForDecl(FD, computation);
1436 !LV.isVisibilityExplicit() &&
1437 !Context.getLangOpts().VisibilityInlinesHiddenStaticLocalVar) {
1438 assert(cast<VarDecl>(D)->isStaticLocal());
1439 // If this was an implicitly hidden inline method, check again for
1440 // explicit visibility on the parent class, and use that for static locals
1441 // if present.
1442 if (const auto *MD = dyn_cast<CXXMethodDecl>(FD))
1443 LV = getLVForDecl(MD->getParent(), computation);
1444 if (!LV.isVisibilityExplicit()) {
1445 Visibility globalVisibility =
1446 computation.isValueVisibility()
1447 ? Context.getLangOpts().getValueVisibilityMode()
1448 : Context.getLangOpts().getTypeVisibilityMode();
1449 return LinkageInfo(Linkage::VisibleNone, globalVisibility,
1450 /*visibilityExplicit=*/false);
1451 }
1452 }
1453 }
1455 return LinkageInfo::none();
1456 return LinkageInfo(Linkage::VisibleNone, LV.getVisibility(),
1458}
1459
1461 LVComputationKind computation,
1462 bool IgnoreVarTypeLinkage) {
1463 // Internal_linkage attribute overrides other considerations.
1464 if (D->hasAttr<InternalLinkageAttr>())
1465 return LinkageInfo::internal();
1466
1467 // Objective-C: treat all Objective-C declarations as having external
1468 // linkage.
1469 switch (D->getKind()) {
1470 default:
1471 break;
1472
1473 // Per C++ [basic.link]p2, only the names of objects, references,
1474 // functions, types, templates, namespaces, and values ever have linkage.
1475 //
1476 // Note that the name of a typedef, namespace alias, using declaration,
1477 // and so on are not the name of the corresponding type, namespace, or
1478 // declaration, so they do *not* have linkage.
1479 case Decl::ImplicitParam:
1480 case Decl::Label:
1481 case Decl::NamespaceAlias:
1482 case Decl::ParmVar:
1483 case Decl::Using:
1484 case Decl::UsingEnum:
1485 case Decl::UsingShadow:
1486 case Decl::UsingDirective:
1487 return LinkageInfo::none();
1488
1489 case Decl::EnumConstant:
1490 // C++ [basic.link]p4: an enumerator has the linkage of its enumeration.
1491 if (D->getASTContext().getLangOpts().CPlusPlus)
1492 return getLVForDecl(cast<EnumDecl>(D->getDeclContext()), computation);
1494
1495 case Decl::Typedef:
1496 case Decl::TypeAlias:
1497 // A typedef declaration has linkage if it gives a type a name for
1498 // linkage purposes.
1499 if (!cast<TypedefNameDecl>(D)
1500 ->getAnonDeclWithTypedefName(/*AnyRedecl*/true))
1501 return LinkageInfo::none();
1502 break;
1503
1504 case Decl::TemplateTemplateParm: // count these as external
1505 case Decl::NonTypeTemplateParm:
1506 case Decl::ObjCAtDefsField:
1507 case Decl::ObjCCategory:
1508 case Decl::ObjCCategoryImpl:
1509 case Decl::ObjCCompatibleAlias:
1510 case Decl::ObjCImplementation:
1511 case Decl::ObjCMethod:
1512 case Decl::ObjCProperty:
1513 case Decl::ObjCPropertyImpl:
1514 case Decl::ObjCProtocol:
1515 return getExternalLinkageFor(D);
1516
1517 case Decl::CXXRecord: {
1518 const auto *Record = cast<CXXRecordDecl>(D);
1519 if (Record->isLambda()) {
1520 if (Record->hasKnownLambdaInternalLinkage() ||
1521 !Record->getLambdaManglingNumber()) {
1522 // This lambda has no mangling number, so it's internal.
1523 return LinkageInfo::internal();
1524 }
1525
1526 return getLVForClosure(
1527 Record->getDeclContext()->getRedeclContext(),
1528 Record->getLambdaContextDecl(), computation);
1529 }
1530
1531 break;
1532 }
1533
1534 case Decl::TemplateParamObject: {
1535 // The template parameter object can be referenced from anywhere its type
1536 // and value can be referenced.
1537 auto *TPO = cast<TemplateParamObjectDecl>(D);
1538 LinkageInfo LV = getLVForType(*TPO->getType(), computation);
1539 LV.merge(getLVForValue(TPO->getValue(), computation));
1540 return LV;
1541 }
1542 }
1543
1544 // Handle linkage for namespace-scope names.
1546 return getLVForNamespaceScopeDecl(D, computation, IgnoreVarTypeLinkage);
1547
1548 // C++ [basic.link]p5:
1549 // In addition, a member function, static data member, a named
1550 // class or enumeration of class scope, or an unnamed class or
1551 // enumeration defined in a class-scope typedef declaration such
1552 // that the class or enumeration has the typedef name for linkage
1553 // purposes (7.1.3), has external linkage if the name of the class
1554 // has external linkage.
1555 if (D->getDeclContext()->isRecord())
1556 return getLVForClassMember(D, computation, IgnoreVarTypeLinkage);
1557
1558 // C++ [basic.link]p6:
1559 // The name of a function declared in block scope and the name of
1560 // an object declared by a block scope extern declaration have
1561 // linkage. If there is a visible declaration of an entity with
1562 // linkage having the same name and type, ignoring entities
1563 // declared outside the innermost enclosing namespace scope, the
1564 // block scope declaration declares that same entity and receives
1565 // the linkage of the previous declaration. If there is more than
1566 // one such matching entity, the program is ill-formed. Otherwise,
1567 // if no matching entity is found, the block scope entity receives
1568 // external linkage.
1570 return getLVForLocalDecl(D, computation);
1571
1572 // C++ [basic.link]p6:
1573 // Names not covered by these rules have no linkage.
1574 return LinkageInfo::none();
1575}
1576
1577/// getLVForDecl - Get the linkage and visibility for the given declaration.
1579 LVComputationKind computation) {
1580 // Internal_linkage attribute overrides other considerations.
1581 if (D->hasAttr<InternalLinkageAttr>())
1582 return LinkageInfo::internal();
1583
1584 if (computation.IgnoreAllVisibility && D->hasCachedLinkage())
1585 return LinkageInfo(D->getCachedLinkage(), DefaultVisibility, false);
1586
1587 if (std::optional<LinkageInfo> LI = lookup(D, computation))
1588 return *LI;
1589
1590 LinkageInfo LV = computeLVForDecl(D, computation);
1591 if (D->hasCachedLinkage())
1592 assert(D->getCachedLinkage() == LV.getLinkage());
1593
1595 cache(D, computation, LV);
1596
1597#ifndef NDEBUG
1598 // In C (because of gnu inline) and in c++ with microsoft extensions an
1599 // static can follow an extern, so we can have two decls with different
1600 // linkages.
1601 const LangOptions &Opts = D->getASTContext().getLangOpts();
1602 if (!Opts.CPlusPlus || Opts.MicrosoftExt)
1603 return LV;
1604
1605 // We have just computed the linkage for this decl. By induction we know
1606 // that all other computed linkages match, check that the one we just
1607 // computed also does.
1608 // We can't assume the redecl chain is well formed at this point,
1609 // so keep track of already visited declarations.
1610 for (llvm::SmallPtrSet<const Decl *, 4> AlreadyVisited{D}; /**/; /**/) {
1611 D = cast<NamedDecl>(const_cast<NamedDecl *>(D)->getNextRedeclarationImpl());
1612 if (!AlreadyVisited.insert(D).second)
1613 break;
1614 if (D->isInvalidDecl())
1615 continue;
1616 if (auto OldLinkage = D->getCachedLinkage();
1617 OldLinkage != Linkage::Invalid) {
1618 assert(LV.getLinkage() == OldLinkage);
1619 break;
1620 }
1621 }
1622#endif
1623
1624 return LV;
1625}
1626
1636
1638 if (isa<NamespaceDecl>(this))
1639 // Namespaces never have module linkage. It is the entities within them
1640 // that [may] do.
1641 return nullptr;
1642
1643 Module *M = getOwningModule();
1644 if (!M)
1645 return nullptr;
1646
1647 switch (M->Kind) {
1649 // Module map modules have no special linkage semantics.
1650 return nullptr;
1651
1656 return M;
1657
1661 // The global module shouldn't change the linkage.
1662 return nullptr;
1663
1665 // The private module fragment is part of its containing module for linkage
1666 // purposes.
1667 return M->Parent;
1668 }
1669
1670 llvm_unreachable("unknown module kind");
1671}
1672
1673void NamedDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
1674 Name.print(OS, Policy);
1675}
1676
1677void NamedDecl::printName(raw_ostream &OS) const {
1678 printName(OS, getASTContext().getPrintingPolicy());
1679}
1680
1682 std::string QualName;
1683 llvm::raw_string_ostream OS(QualName);
1684 printQualifiedName(OS, getASTContext().getPrintingPolicy());
1685 return QualName;
1686}
1687
1688void NamedDecl::printQualifiedName(raw_ostream &OS) const {
1689 printQualifiedName(OS, getASTContext().getPrintingPolicy());
1690}
1691
1693 const PrintingPolicy &P) const {
1694 if (getDeclContext()->isFunctionOrMethod()) {
1695 // We do not print '(anonymous)' for function parameters without name.
1696 printName(OS, P);
1697 return;
1698 }
1700 if (getDeclName()) {
1701 printName(OS, P);
1702 } else {
1703 // Give the printName override a chance to pick a different name before we
1704 // fall back to "(anonymous)".
1705 SmallString<64> NameBuffer;
1706 llvm::raw_svector_ostream NameOS(NameBuffer);
1707 printName(NameOS, P);
1708 if (NameBuffer.empty())
1709 OS << "(anonymous)";
1710 else
1711 OS << NameBuffer;
1712 }
1713}
1714
1715void NamedDecl::printNestedNameSpecifier(raw_ostream &OS) const {
1716 printNestedNameSpecifier(OS, getASTContext().getPrintingPolicy());
1717}
1718
1720 const PrintingPolicy &P) const {
1721 const DeclContext *Ctx = getDeclContext();
1722
1723 // For ObjC methods and properties, look through categories and use the
1724 // interface as context.
1725 if (auto *MD = dyn_cast<ObjCMethodDecl>(this)) {
1726 if (auto *ID = MD->getClassInterface())
1727 Ctx = ID;
1728 } else if (auto *PD = dyn_cast<ObjCPropertyDecl>(this)) {
1729 if (auto *MD = PD->getGetterMethodDecl())
1730 if (auto *ID = MD->getClassInterface())
1731 Ctx = ID;
1732 } else if (auto *ID = dyn_cast<ObjCIvarDecl>(this)) {
1733 if (auto *CI = ID->getContainingInterface())
1734 Ctx = CI;
1735 }
1736
1737 if (Ctx->isFunctionOrMethod())
1738 return;
1739
1740 using ContextsTy = SmallVector<const DeclContext *, 8>;
1741 ContextsTy Contexts;
1742
1743 // Collect named contexts.
1744 DeclarationName NameInScope = getDeclName();
1745 for (; Ctx; Ctx = Ctx->getParent()) {
1746 if (P.Callbacks && P.Callbacks->isScopeVisible(Ctx))
1747 continue;
1748
1749 // Suppress anonymous namespace if requested.
1751 cast<NamespaceDecl>(Ctx)->isAnonymousNamespace())
1752 continue;
1753
1754 // Suppress inline namespace if it doesn't make the result ambiguous.
1755 if (Ctx->isInlineNamespace() && NameInScope) {
1757 llvm::to_underlying(
1760 llvm::to_underlying(
1762 cast<NamespaceDecl>(Ctx)->isRedundantInlineQualifierFor(
1763 NameInScope))) {
1764 continue;
1765 }
1766 }
1767
1768 // Suppress transparent contexts like export or HLSLBufferDecl context
1769 if (Ctx->isTransparentContext())
1770 continue;
1771
1772 // Skip non-named contexts such as linkage specifications and ExportDecls.
1773 const NamedDecl *ND = dyn_cast<NamedDecl>(Ctx);
1774 if (!ND)
1775 continue;
1776
1777 Contexts.push_back(Ctx);
1778 NameInScope = ND->getDeclName();
1779 }
1780
1781 for (const DeclContext *DC : llvm::reverse(Contexts)) {
1782 if (const auto *Spec = dyn_cast<ClassTemplateSpecializationDecl>(DC)) {
1783 OS << Spec->getName();
1784 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
1785 printTemplateArgumentList(
1786 OS, TemplateArgs.asArray(), P,
1787 Spec->getSpecializedTemplate()->getTemplateParameters());
1788 } else if (const auto *ND = dyn_cast<NamespaceDecl>(DC)) {
1789 if (ND->isAnonymousNamespace()) {
1790 OS << (P.MSVCFormatting ? "`anonymous namespace\'"
1791 : "(anonymous namespace)");
1792 }
1793 else
1794 OS << *ND;
1795 } else if (const auto *RD = llvm::dyn_cast<RecordDecl>(DC)) {
1797 // As part of a scope we want to print anonymous names as:
1798 // ..::(anonymous struct)::..
1799 //
1800 // I.e., suppress tag locations, suppress leading keyword, *don't*
1801 // suppress tag in name
1802 Copy.SuppressTagKeyword = true;
1803 Copy.SuppressTagKeywordInAnonNames = false;
1804 Copy.AnonymousTagNameStyle =
1805 llvm::to_underlying(PrintingPolicy::AnonymousTagMode::Plain);
1806 RD->printName(OS, Copy);
1807 } else if (const auto *FD = dyn_cast<FunctionDecl>(DC)) {
1808 const FunctionProtoType *FT = nullptr;
1809 if (FD->hasWrittenPrototype())
1810 FT = dyn_cast<FunctionProtoType>(FD->getType()->castAs<FunctionType>());
1811
1812 OS << *FD << '(';
1813 if (FT) {
1814 unsigned NumParams = FD->getNumParams();
1815 for (unsigned i = 0; i < NumParams; ++i) {
1816 if (i)
1817 OS << ", ";
1818 OS << FD->getParamDecl(i)->getType().stream(P);
1819 }
1820
1821 if (FT->isVariadic()) {
1822 if (NumParams > 0)
1823 OS << ", ";
1824 OS << "...";
1825 }
1826 }
1827 OS << ')';
1828 } else if (const auto *ED = dyn_cast<EnumDecl>(DC)) {
1829 // C++ [dcl.enum]p10: Each enum-name and each unscoped
1830 // enumerator is declared in the scope that immediately contains
1831 // the enum-specifier. Each scoped enumerator is declared in the
1832 // scope of the enumeration.
1833 // For the case of unscoped enumerator, do not include in the qualified
1834 // name any information about its enum enclosing scope, as its visibility
1835 // is global.
1836 if (ED->isScoped())
1837 OS << *ED;
1838 else
1839 continue;
1840 } else {
1841 OS << *cast<NamedDecl>(DC);
1842 }
1843 OS << "::";
1844 }
1845}
1846
1848 const PrintingPolicy &Policy,
1849 bool Qualified) const {
1850 if (Qualified)
1851 printQualifiedName(OS, Policy);
1852 else
1853 printName(OS, Policy);
1854}
1855
1856template<typename T> static bool isRedeclarableImpl(Redeclarable<T> *) {
1857 return true;
1858}
1859static bool isRedeclarableImpl(...) { return false; }
1861 switch (K) {
1862#define DECL(Type, Base) \
1863 case Decl::Type: \
1864 return isRedeclarableImpl((Type##Decl *)nullptr);
1865#define ABSTRACT_DECL(DECL)
1866#include "clang/AST/DeclNodes.inc"
1867 }
1868 llvm_unreachable("unknown decl kind");
1869}
1870
1872 bool IsKnownNewer) const {
1873 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
1874
1875 // Never replace one imported declaration with another; we need both results
1876 // when re-exporting.
1877 if (OldD->isFromASTFile() && isFromASTFile())
1878 return false;
1879
1880 // A kind mismatch implies that the declaration is not replaced.
1881 if (OldD->getKind() != getKind())
1882 return false;
1883
1884 // For method declarations, we never replace. (Why?)
1885 if (isa<ObjCMethodDecl>(this))
1886 return false;
1887
1888 // For parameters, pick the newer one. This is either an error or (in
1889 // Objective-C) permitted as an extension.
1890 if (isa<ParmVarDecl>(this))
1891 return true;
1892
1893 // Inline namespaces can give us two declarations with the same
1894 // name and kind in the same scope but different contexts; we should
1895 // keep both declarations in this case.
1896 if (!this->getDeclContext()->getRedeclContext()->Equals(
1897 OldD->getDeclContext()->getRedeclContext()))
1898 return false;
1899
1900 // Using declarations can be replaced if they import the same name from the
1901 // same context.
1902 if (const auto *UD = dyn_cast<UsingDecl>(this))
1903 return UD->getQualifier().getCanonical() ==
1904
1905 cast<UsingDecl>(OldD)->getQualifier().getCanonical();
1906 if (const auto *UUVD = dyn_cast<UnresolvedUsingValueDecl>(this))
1907 return UUVD->getQualifier().getCanonical() ==
1908 cast<UnresolvedUsingValueDecl>(OldD)->getQualifier().getCanonical();
1909
1910 if (isRedeclarable(getKind())) {
1911 if (getCanonicalDecl() != OldD->getCanonicalDecl())
1912 return false;
1913
1914 if (IsKnownNewer)
1915 return true;
1916
1917 // Check whether this is actually newer than OldD. We want to keep the
1918 // newer declaration. This loop will usually only iterate once, because
1919 // OldD is usually the previous declaration.
1920 for (const auto *D : redecls()) {
1921 if (D == OldD)
1922 break;
1923
1924 // If we reach the canonical declaration, then OldD is not actually older
1925 // than this one.
1926 //
1927 // FIXME: In this case, we should not add this decl to the lookup table.
1928 if (D->isCanonicalDecl())
1929 return false;
1930 }
1931
1932 // It's a newer declaration of the same kind of declaration in the same
1933 // scope: we want this decl instead of the existing one.
1934 return true;
1935 }
1936
1937 // In all other cases, we need to keep both declarations in case they have
1938 // different visibility. Any attempt to use the name will result in an
1939 // ambiguity if more than one is visible.
1940 return false;
1941}
1942
1944 switch (getFormalLinkage()) {
1945 case Linkage::Invalid:
1946 llvm_unreachable("Linkage hasn't been computed!");
1947 case Linkage::None:
1948 return false;
1949 case Linkage::Internal:
1950 return true;
1953 llvm_unreachable("Non-formal linkage is not allowed here!");
1954 case Linkage::Module:
1955 case Linkage::External:
1956 return true;
1957 }
1958 llvm_unreachable("Unhandled Linkage enum");
1959}
1960
1961NamedDecl *NamedDecl::getUnderlyingDeclImpl() {
1962 NamedDecl *ND = this;
1963 if (auto *UD = dyn_cast<UsingShadowDecl>(ND))
1964 ND = UD->getTargetDecl();
1965
1966 if (auto *AD = dyn_cast<ObjCCompatibleAliasDecl>(ND))
1967 return AD->getClassInterface();
1968
1969 if (auto *AD = dyn_cast<NamespaceAliasDecl>(ND))
1970 return AD->getNamespace();
1971
1972 return ND;
1973}
1974
1976 if (!isCXXClassMember())
1977 return false;
1978
1979 const NamedDecl *D = this;
1980 if (isa<UsingShadowDecl>(D))
1981 D = cast<UsingShadowDecl>(D)->getTargetDecl();
1982
1984 return true;
1985 if (const auto *MD = dyn_cast_if_present<CXXMethodDecl>(D->getAsFunction()))
1986 return MD->isInstance();
1987 return false;
1988}
1989
1990//===----------------------------------------------------------------------===//
1991// DeclaratorDecl Implementation
1992//===----------------------------------------------------------------------===//
1993
1994template <typename DeclT>
1996 if (decl->getNumTemplateParameterLists() > 0)
1997 return decl->getTemplateParameterList(0)->getTemplateLoc();
1998 return decl->getInnerLocStart();
1999}
2000
2003 if (TSI) return TSI->getTypeLoc().getBeginLoc();
2004 return SourceLocation();
2005}
2006
2009 if (TSI) return TSI->getTypeLoc().getEndLoc();
2010 return SourceLocation();
2011}
2012
2014 if (QualifierLoc) {
2015 // Make sure the extended decl info is allocated.
2016 if (!hasExtInfo()) {
2017 // Save (non-extended) type source info pointer.
2018 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2019 // Allocate external info struct.
2020 DeclInfo = new (getASTContext()) ExtInfo;
2021 // Restore savedTInfo into (extended) decl info.
2022 getExtInfo()->TInfo = savedTInfo;
2023 }
2024 // Set qualifier info.
2025 getExtInfo()->QualifierLoc = QualifierLoc;
2026 } else if (hasExtInfo()) {
2027 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
2028 getExtInfo()->QualifierLoc = QualifierLoc;
2029 }
2030}
2031
2033 assert(AC);
2034 // Make sure the extended decl info is allocated.
2035 if (!hasExtInfo()) {
2036 // Save (non-extended) type source info pointer.
2037 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2038 // Allocate external info struct.
2039 DeclInfo = new (getASTContext()) ExtInfo;
2040 // Restore savedTInfo into (extended) decl info.
2041 getExtInfo()->TInfo = savedTInfo;
2042 }
2043 // Set requires clause info.
2044 getExtInfo()->TrailingRequiresClause = AC;
2045}
2046
2049 assert(!TPLists.empty());
2050 // Make sure the extended decl info is allocated.
2051 if (!hasExtInfo()) {
2052 // Save (non-extended) type source info pointer.
2053 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2054 // Allocate external info struct.
2055 DeclInfo = new (getASTContext()) ExtInfo;
2056 // Restore savedTInfo into (extended) decl info.
2057 getExtInfo()->TInfo = savedTInfo;
2058 }
2059 // Set the template parameter lists info.
2060 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
2061}
2062
2066
2067// Helper function: returns true if QT is or contains a type
2068// having a postfix component.
2069static bool typeIsPostfix(QualType QT) {
2070 while (true) {
2071 const Type* T = QT.getTypePtr();
2072 switch (T->getTypeClass()) {
2073 default:
2074 return false;
2075 case Type::Pointer:
2076 QT = cast<PointerType>(T)->getPointeeType();
2077 break;
2078 case Type::BlockPointer:
2079 QT = cast<BlockPointerType>(T)->getPointeeType();
2080 break;
2081 case Type::MemberPointer:
2082 QT = cast<MemberPointerType>(T)->getPointeeType();
2083 break;
2084 case Type::LValueReference:
2085 case Type::RValueReference:
2086 QT = cast<ReferenceType>(T)->getPointeeType();
2087 break;
2088 case Type::PackExpansion:
2089 QT = cast<PackExpansionType>(T)->getPattern();
2090 break;
2091 case Type::Paren:
2092 case Type::ConstantArray:
2093 case Type::DependentSizedArray:
2094 case Type::IncompleteArray:
2095 case Type::VariableArray:
2096 case Type::FunctionProto:
2097 case Type::FunctionNoProto:
2098 return true;
2099 }
2100 }
2101}
2102
2104 SourceLocation RangeEnd = getLocation();
2105 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
2106 // If the declaration has no name or the type extends past the name take the
2107 // end location of the type.
2108 if (!getDeclName() || typeIsPostfix(TInfo->getType()))
2109 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2110 }
2111 return SourceRange(getOuterLocStart(), RangeEnd);
2112}
2113
2116 // Free previous template parameters (if any).
2117 if (NumTemplParamLists > 0) {
2118 Context.Deallocate(TemplParamLists);
2119 TemplParamLists = nullptr;
2121 }
2122 // Set info on matched template parameter lists (if any).
2123 if (!TPLists.empty()) {
2124 TemplParamLists = new (Context) TemplateParameterList *[TPLists.size()];
2125 NumTemplParamLists = TPLists.size();
2126 llvm::copy(TPLists, TemplParamLists);
2127 }
2128}
2129
2130//===----------------------------------------------------------------------===//
2131// VarDecl Implementation
2132//===----------------------------------------------------------------------===//
2133
2135 switch (SC) {
2136 case SC_None: break;
2137 case SC_Auto: return "auto";
2138 case SC_Extern: return "extern";
2139 case SC_PrivateExtern: return "__private_extern__";
2140 case SC_Register: return "register";
2141 case SC_Static: return "static";
2142 }
2143
2144 llvm_unreachable("Invalid storage class");
2145}
2146
2148 SourceLocation StartLoc, SourceLocation IdLoc,
2149 const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
2150 StorageClass SC)
2151 : DeclaratorDecl(DK, DC, IdLoc, Id, T, TInfo, StartLoc),
2153 static_assert(sizeof(VarDeclBitfields) <= sizeof(unsigned),
2154 "VarDeclBitfields too large!");
2155 static_assert(sizeof(ParmVarDeclBitfields) <= sizeof(unsigned),
2156 "ParmVarDeclBitfields too large!");
2157 static_assert(sizeof(NonParmVarDeclBitfields) <= sizeof(unsigned),
2158 "NonParmVarDeclBitfields too large!");
2159 AllBits = 0;
2160 VarDeclBits.SClass = SC;
2161 // Everything else is implicitly initialized to false.
2162}
2163
2165 SourceLocation IdL, const IdentifierInfo *Id,
2166 QualType T, TypeSourceInfo *TInfo, StorageClass S) {
2167 return new (C, DC) VarDecl(Var, C, DC, StartL, IdL, Id, T, TInfo, S);
2168}
2169
2171 return new (C, ID)
2172 VarDecl(Var, C, nullptr, SourceLocation(), SourceLocation(), nullptr,
2173 QualType(), nullptr, SC_None);
2174}
2175
2177 assert(isLegalForVariable(SC));
2178 VarDeclBits.SClass = SC;
2179}
2180
2182 switch (VarDeclBits.TSCSpec) {
2183 case TSCS_unspecified:
2184 if (!hasAttr<ThreadAttr>() &&
2185 !(getASTContext().getLangOpts().OpenMPUseTLS &&
2186 getASTContext().getTargetInfo().isTLSSupported() &&
2188 return TLS_None;
2189 return ((getASTContext().getLangOpts().isCompatibleWithMSVC(
2192 ? TLS_Dynamic
2193 : TLS_Static;
2194 case TSCS___thread: // Fall through.
2195 case TSCS__Thread_local:
2196 return TLS_Static;
2197 case TSCS_thread_local:
2198 return TLS_Dynamic;
2199 }
2200 llvm_unreachable("Unknown thread storage class specifier!");
2201}
2202
2204 if (const Expr *Init = getInit()) {
2205 SourceLocation InitEnd = Init->getEndLoc();
2206 // If Init is implicit, ignore its source range and fallback on
2207 // DeclaratorDecl::getSourceRange() to handle postfix elements.
2208 if (InitEnd.isValid() && InitEnd != getLocation())
2209 return SourceRange(getOuterLocStart(), InitEnd);
2210 }
2212}
2213
2214template<typename T>
2216 // C++ [dcl.link]p1: All function types, function names with external linkage,
2217 // and variable names with external linkage have a language linkage.
2218 if (!D.hasExternalFormalLinkage())
2219 return NoLanguageLinkage;
2220
2221 // Language linkage is a C++ concept, but saying that everything else in C has
2222 // C language linkage fits the implementation nicely.
2223 if (!D.getASTContext().getLangOpts().CPlusPlus)
2224 return CLanguageLinkage;
2225
2226 // C++ [dcl.link]p4: A C language linkage is ignored in determining the
2227 // language linkage of the names of class members and the function type of
2228 // class member functions.
2229 const DeclContext *DC = D.getDeclContext();
2230 if (DC->isRecord())
2231 return CXXLanguageLinkage;
2232
2233 // If the first decl is in an extern "C" context, any other redeclaration
2234 // will have C language linkage. If the first one is not in an extern "C"
2235 // context, we would have reported an error for any other decl being in one.
2237 return CLanguageLinkage;
2238 return CXXLanguageLinkage;
2239}
2240
2241template<typename T>
2242static bool isDeclExternC(const T &D) {
2243 // Since the context is ignored for class members, they can only have C++
2244 // language linkage or no language linkage.
2245 const DeclContext *DC = D.getDeclContext();
2246 if (DC->isRecord()) {
2247 assert(D.getASTContext().getLangOpts().CPlusPlus);
2248 return false;
2249 }
2250
2251 return D.getLanguageLinkage() == CLanguageLinkage;
2252}
2253
2257
2259 return isDeclExternC(*this);
2260}
2261
2265
2269
2271
2275 return DeclarationOnly;
2276
2277 // C++ [basic.def]p2:
2278 // A declaration is a definition unless [...] it contains the 'extern'
2279 // specifier or a linkage-specification and neither an initializer [...],
2280 // it declares a non-inline static data member in a class declaration [...],
2281 // it declares a static data member outside a class definition and the variable
2282 // was defined within the class with the constexpr specifier [...],
2283 // C++1y [temp.expl.spec]p15:
2284 // An explicit specialization of a static data member or an explicit
2285 // specialization of a static data member template is a definition if the
2286 // declaration includes an initializer; otherwise, it is a declaration.
2287 //
2288 // FIXME: How do you declare (but not define) a partial specialization of
2289 // a static data member template outside the containing class?
2290 if (isStaticDataMember()) {
2291 if (isOutOfLine() &&
2292 !(getCanonicalDecl()->isInline() &&
2294 (hasInit() ||
2295 // If the first declaration is out-of-line, this may be an
2296 // instantiation of an out-of-line partial specialization of a variable
2297 // template for which we have not yet instantiated the initializer.
2303 return Definition;
2304 if (!isOutOfLine() && isInline())
2305 return Definition;
2306 return DeclarationOnly;
2307 }
2308 // C99 6.7p5:
2309 // A definition of an identifier is a declaration for that identifier that
2310 // [...] causes storage to be reserved for that object.
2311 // Note: that applies for all non-file-scope objects.
2312 // C99 6.9.2p1:
2313 // If the declaration of an identifier for an object has file scope and an
2314 // initializer, the declaration is an external definition for the identifier
2315 if (hasInit())
2316 return Definition;
2317
2318 if (hasDefiningAttr())
2319 return Definition;
2320
2321 if (const auto *SAA = getAttr<SelectAnyAttr>())
2322 if (!SAA->isInherited())
2323 return Definition;
2324
2325 // A variable template specialization (other than a static data member
2326 // template or an explicit specialization) is a declaration until we
2327 // instantiate its initializer.
2328 if (auto *VTSD = dyn_cast<VarTemplateSpecializationDecl>(this)) {
2329 if (VTSD->getTemplateSpecializationKind() != TSK_ExplicitSpecialization &&
2331 !VTSD->IsCompleteDefinition)
2332 return DeclarationOnly;
2333 }
2334
2335 if (hasExternalStorage())
2336 return DeclarationOnly;
2337
2338 // [dcl.link] p7:
2339 // A declaration directly contained in a linkage-specification is treated
2340 // as if it contains the extern specifier for the purpose of determining
2341 // the linkage of the declared name and whether it is a definition.
2342 if (isSingleLineLanguageLinkage(*this))
2343 return DeclarationOnly;
2344
2345 // C99 6.9.2p2:
2346 // A declaration of an object that has file scope without an initializer,
2347 // and without a storage class specifier or the scs 'static', constitutes
2348 // a tentative definition.
2349 // No such thing in C++.
2350 if (!C.getLangOpts().CPlusPlus && isFileVarDecl())
2351 return TentativeDefinition;
2352
2353 // What's left is (in C, block-scope) declarations without initializers or
2354 // external storage. These are definitions.
2355 return Definition;
2356}
2357
2361 return nullptr;
2362
2363 VarDecl *LastTentative = nullptr;
2364
2365 // Loop through the declaration chain, starting with the most recent.
2367 Decl = Decl->getPreviousDecl()) {
2368 Kind = Decl->isThisDeclarationADefinition();
2369 if (Kind == Definition)
2370 return nullptr;
2371 // Record the first (most recent) TentativeDefinition that is encountered.
2372 if (Kind == TentativeDefinition && !LastTentative)
2373 LastTentative = Decl;
2374 }
2375
2376 return LastTentative;
2377}
2378
2381 for (auto *I : First->redecls()) {
2382 if (I->isThisDeclarationADefinition(C) == Definition)
2383 return I;
2384 }
2385 return nullptr;
2386}
2387
2390
2391 const VarDecl *First = getFirstDecl();
2392 for (auto *I : First->redecls()) {
2393 Kind = std::max(Kind, I->isThisDeclarationADefinition(C));
2394 if (Kind == Definition)
2395 break;
2396 }
2397
2398 return Kind;
2399}
2400
2401const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
2402 for (auto *I : redecls()) {
2403 if (auto Expr = I->getInit()) {
2404 D = I;
2405 return Expr;
2406 }
2407 }
2408 return nullptr;
2409}
2410
2411bool VarDecl::hasInit() const {
2412 if (auto *P = dyn_cast<ParmVarDecl>(this))
2413 if (P->hasUnparsedDefaultArg() || P->hasUninstantiatedDefaultArg())
2414 return false;
2415
2416 if (auto *Eval = getEvaluatedStmt())
2417 return Eval->Value.isValid();
2418
2419 return !Init.isNull();
2420}
2421
2423 if (!hasInit())
2424 return nullptr;
2425
2426 if (auto *S = dyn_cast<Stmt *>(Init))
2427 return cast<Expr>(S);
2428
2429 auto *Eval = getEvaluatedStmt();
2430
2431 return cast<Expr>(Eval->Value.get(
2432 Eval->Value.isOffset() ? getASTContext().getExternalSource() : nullptr));
2433}
2434
2436 if (auto *ES = Init.dyn_cast<EvaluatedStmt *>())
2437 return ES->Value.getAddressOfPointer(getASTContext().getExternalSource());
2438
2439 return Init.getAddrOfPtr1();
2440}
2441
2443 VarDecl *Def = nullptr;
2444 for (auto *I : redecls()) {
2445 if (I->hasInit())
2446 return I;
2447
2448 if (I->isThisDeclarationADefinition()) {
2449 if (isStaticDataMember())
2450 return I;
2451 Def = I;
2452 }
2453 }
2454 return Def;
2455}
2456
2458 if (!hasInit())
2459 return false;
2460
2462 if (!ES->CheckedForSideEffects) {
2463 const Expr *E = getInit();
2464 ES->HasSideEffects =
2466 // We can get a value-dependent initializer during error recovery.
2467 (E->isValueDependent() || getType()->isDependentType() ||
2468 !evaluateValue());
2469 ES->CheckedForSideEffects = true;
2470 }
2471 return ES->HasSideEffects;
2472}
2473
2475 if (Decl::isOutOfLine())
2476 return true;
2477
2478 if (!isStaticDataMember())
2479 return false;
2480
2481 // If this static data member was instantiated from a static data member of
2482 // a class template, check whether that static data member was defined
2483 // out-of-line.
2485 return VD->isOutOfLine();
2486
2487 return false;
2488}
2489
2491 if (auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init)) {
2492 Eval->~EvaluatedStmt();
2493 getASTContext().Deallocate(Eval);
2494 }
2495
2496 Init = I;
2497}
2498
2500 const LangOptions &Lang = C.getLangOpts();
2501
2502 // OpenCL permits const integral variables to be used in constant
2503 // expressions, like in C++98.
2504 if (!Lang.CPlusPlus && !Lang.OpenCL && !Lang.C23)
2505 return false;
2506
2507 // Function parameters are never usable in constant expressions.
2508 if (isa<ParmVarDecl>(this))
2509 return false;
2510
2511 // The values of weak variables are never usable in constant expressions.
2512 if (isWeak())
2513 return false;
2514
2515 // In C++11, any variable of reference type can be used in a constant
2516 // expression if it is initialized by a constant expression.
2517 if (Lang.CPlusPlus11 && getType()->isReferenceType())
2518 return true;
2519
2520 // Only const objects can be used in constant expressions in C++. C++98 does
2521 // not require the variable to be non-volatile, but we consider this to be a
2522 // defect.
2523 if (!getType().isConstant(C) || getType().isVolatileQualified())
2524 return false;
2525
2526 // In C++, but not in C, const, non-volatile variables of integral or
2527 // enumeration types can be used in constant expressions.
2528 if (getType()->isIntegralOrEnumerationType() && !Lang.C23)
2529 return true;
2530
2531 // C23 6.6p7: An identifier that is:
2532 // ...
2533 // - declared with storage-class specifier constexpr and has an object type,
2534 // is a named constant, ... such a named constant is a constant expression
2535 // with the type and value of the declared object.
2536 // Additionally, in C++11, non-volatile constexpr variables can be used in
2537 // constant expressions.
2538 return (Lang.CPlusPlus11 || Lang.C23) && isConstexpr();
2539}
2540
2542 // C++2a [expr.const]p3:
2543 // A variable is usable in constant expressions after its initializing
2544 // declaration is encountered...
2545 const VarDecl *DefVD = nullptr;
2546 const Expr *Init = getAnyInitializer(DefVD);
2547 if (!Init || Init->isValueDependent() || getType()->isDependentType())
2548 return false;
2549 // ... if it is a constexpr variable, or it is of reference type or of
2550 // const-qualified integral or enumeration type, ...
2551 if (!DefVD->mightBeUsableInConstantExpressions(Context))
2552 return false;
2553 // ... and its initializer is a constant initializer.
2554 if ((Context.getLangOpts().CPlusPlus || getLangOpts().C23) &&
2555 !DefVD->hasConstantInitialization())
2556 return false;
2557 // C++98 [expr.const]p1:
2558 // An integral constant-expression can involve only [...] const variables
2559 // or static data members of integral or enumeration types initialized with
2560 // [integer] constant expressions (dcl.init)
2561 if ((Context.getLangOpts().CPlusPlus || Context.getLangOpts().OpenCL) &&
2562 !Context.getLangOpts().CPlusPlus11 && !DefVD->hasICEInitializer(Context))
2563 return false;
2564 return true;
2565}
2566
2567/// Convert the initializer for this declaration to the elaborated EvaluatedStmt
2568/// form, which contains extra information on the evaluated value of the
2569/// initializer.
2571 auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init);
2572 if (!Eval) {
2573 // Note: EvaluatedStmt contains an APValue, which usually holds
2574 // resources not allocated from the ASTContext. We need to do some
2575 // work to avoid leaking those, but we do so in VarDecl::evaluateValue
2576 // where we can detect whether there's anything to clean up or not.
2577 Eval = new (getASTContext()) EvaluatedStmt;
2578 Eval->Value = cast<Stmt *>(Init);
2579 Init = Eval;
2580 }
2581 return Eval;
2582}
2583
2585 return dyn_cast_if_present<EvaluatedStmt *>(Init);
2586}
2587
2590 return evaluateValueImpl(Notes, hasConstantInitialization());
2591}
2592
2593APValue *VarDecl::evaluateValueImpl(SmallVectorImpl<PartialDiagnosticAt> &Notes,
2594 bool IsConstantInitialization) const {
2596
2597 const auto *Init = getInit();
2598 assert(!Init->isValueDependent());
2599
2600 // We only produce notes indicating why an initializer is non-constant the
2601 // first time it is evaluated. FIXME: The notes won't always be emitted the
2602 // first time we try evaluation, so might not be produced at all.
2603 if (Eval->WasEvaluated)
2604 return Eval->Evaluated.isAbsent() ? nullptr : &Eval->Evaluated;
2605
2606 if (Eval->IsEvaluating) {
2607 // FIXME: Produce a diagnostic for self-initialization.
2608 return nullptr;
2609 }
2610
2611 Eval->IsEvaluating = true;
2612
2613 ASTContext &Ctx = getASTContext();
2614 bool Result = Init->EvaluateAsInitializer(Eval->Evaluated, Ctx, this, Notes,
2615 IsConstantInitialization);
2616
2617 // In C++, or in C23 if we're initialising a 'constexpr' variable, this isn't
2618 // a constant initializer if we produced notes. In that case, we can't keep
2619 // the result, because it may only be correct under the assumption that the
2620 // initializer is a constant context.
2621 if (IsConstantInitialization &&
2622 (Ctx.getLangOpts().CPlusPlus ||
2623 (isConstexpr() && Ctx.getLangOpts().C23)) &&
2624 !Notes.empty())
2625 Result = false;
2626
2627 // Ensure the computed APValue is cleaned up later if evaluation succeeded,
2628 // or that it's empty (so that there's nothing to clean up) if evaluation
2629 // failed.
2630 if (!Result)
2631 Eval->Evaluated = APValue();
2632 else if (Eval->Evaluated.needsCleanup())
2633 Ctx.addDestruction(&Eval->Evaluated);
2634
2635 Eval->IsEvaluating = false;
2636 Eval->WasEvaluated = true;
2637
2638 return Result ? &Eval->Evaluated : nullptr;
2639}
2640
2642 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2643 if (Eval->WasEvaluated)
2644 return &Eval->Evaluated;
2645
2646 return nullptr;
2647}
2648
2649bool VarDecl::hasICEInitializer(const ASTContext &Context) const {
2650 const Expr *Init = getInit();
2651 assert(Init && "no initializer");
2652
2654 if (!Eval->CheckedForICEInit) {
2655 Eval->CheckedForICEInit = true;
2656 Eval->HasICEInit = Init->isIntegerConstantExpr(Context);
2657 }
2658 return Eval->HasICEInit;
2659}
2660
2662 // In C, all globals and constexpr variables should have constant
2663 // initialization. For constexpr variables in C check that initializer is a
2664 // constant initializer because they can be used in constant expressions.
2666 !isConstexpr())
2667 return true;
2668
2669 // In C++, it depends on whether the evaluation at the point of definition
2670 // was evaluatable as a constant initializer.
2671 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2672 return Eval->HasConstantInitialization;
2673
2674 return false;
2675}
2676
2680 // If we ask for the value before we know whether we have a constant
2681 // initializer, we can compute the wrong value (for example, due to
2682 // std::is_constant_evaluated()).
2683 assert(!Eval->WasEvaluated &&
2684 "already evaluated var value before checking for constant init");
2685 assert((getASTContext().getLangOpts().CPlusPlus ||
2687 "only meaningful in C++/C23");
2688
2689 assert(!getInit()->isValueDependent());
2690
2691 // Evaluate the initializer to check whether it's a constant expression.
2693 evaluateValueImpl(Notes, true) && Notes.empty();
2694
2695 // If evaluation as a constant initializer failed, allow re-evaluation as a
2696 // non-constant initializer if we later find we want the value.
2697 if (!Eval->HasConstantInitialization)
2698 Eval->WasEvaluated = false;
2699
2700 return Eval->HasConstantInitialization;
2701}
2702
2703template<typename DeclT>
2704static DeclT *getDefinitionOrSelf(DeclT *D) {
2705 assert(D);
2706 if (auto *Def = D->getDefinition())
2707 return Def;
2708 return D;
2709}
2710
2712 return hasAttr<BlocksAttr>() && NonParmVarDeclBits.EscapingByref;
2713}
2714
2716 return hasAttr<BlocksAttr>() && !NonParmVarDeclBits.EscapingByref;
2717}
2718
2720 QualType T = getType();
2721 return T->isDependentType() || T->isUndeducedType() ||
2722 llvm::any_of(specific_attrs<AlignedAttr>(), [](const AlignedAttr *AA) {
2723 return AA->isAlignmentDependent();
2724 });
2725}
2726
2728 const VarDecl *VD = this;
2729
2730 // If this is an instantiated member, walk back to the template from which
2731 // it was instantiated.
2733 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
2735 while (auto *NewVD = VD->getInstantiatedFromStaticDataMember())
2736 VD = NewVD;
2737 }
2738 }
2739
2740 // If it's an instantiated variable template specialization, find the
2741 // template or partial specialization from which it was instantiated.
2742 if (auto *VDTemplSpec = dyn_cast<VarTemplateSpecializationDecl>(VD)) {
2743 if (isTemplateInstantiation(VDTemplSpec->getTemplateSpecializationKind())) {
2744 auto From = VDTemplSpec->getInstantiatedFrom();
2745 if (auto *VTD = From.dyn_cast<VarTemplateDecl *>()) {
2746 while (!VTD->isMemberSpecialization()) {
2747 auto *NewVTD = VTD->getInstantiatedFromMemberTemplate();
2748 if (!NewVTD)
2749 break;
2750 VTD = NewVTD;
2751 }
2752 return getDefinitionOrSelf(VTD->getTemplatedDecl());
2753 }
2754 if (auto *VTPSD =
2755 From.dyn_cast<VarTemplatePartialSpecializationDecl *>()) {
2756 while (!VTPSD->isMemberSpecialization()) {
2757 auto *NewVTPSD = VTPSD->getInstantiatedFromMember();
2758 if (!NewVTPSD)
2759 break;
2760 VTPSD = NewVTPSD;
2761 }
2762 return getDefinitionOrSelf<VarDecl>(VTPSD);
2763 }
2764 }
2765 }
2766
2767 // If this is the pattern of a variable template, find where it was
2768 // instantiated from. FIXME: Is this necessary?
2770 while (!VarTemplate->isMemberSpecialization()) {
2771 auto *NewVT = VarTemplate->getInstantiatedFromMemberTemplate();
2772 if (!NewVT)
2773 break;
2774 VarTemplate = NewVT;
2775 }
2776
2777 return getDefinitionOrSelf(VarTemplate->getTemplatedDecl());
2778 }
2779
2780 if (VD == this)
2781 return nullptr;
2782 return getDefinitionOrSelf(const_cast<VarDecl*>(VD));
2783}
2784
2787 return cast<VarDecl>(MSI->getInstantiatedFrom());
2788
2789 return nullptr;
2790}
2791
2793 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2794 return Spec->getSpecializationKind();
2795
2797 return MSI->getTemplateSpecializationKind();
2798
2799 return TSK_Undeclared;
2800}
2801
2805 return MSI->getTemplateSpecializationKind();
2806
2807 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2808 return Spec->getSpecializationKind();
2809
2810 return TSK_Undeclared;
2811}
2812
2814 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2815 return Spec->getPointOfInstantiation();
2816
2818 return MSI->getPointOfInstantiation();
2819
2820 return SourceLocation();
2821}
2822
2824 return dyn_cast_if_present<VarTemplateDecl *>(
2825 getASTContext().getTemplateOrSpecializationInfo(this));
2826}
2827
2831
2833 const auto &LangOpts = getASTContext().getLangOpts();
2834 // In CUDA mode without relocatable device code, variables of form 'extern
2835 // __shared__ Foo foo[]' are pointers to the base of the GPU core's shared
2836 // memory pool. These are never undefined variables, even if they appear
2837 // inside of an anon namespace or static function.
2838 //
2839 // With CUDA relocatable device code enabled, these variables don't get
2840 // special handling; they're treated like regular extern variables.
2841 if (LangOpts.CUDA && !LangOpts.GPURelocatableDeviceCode &&
2844 return true;
2845
2846 return hasDefinition();
2847}
2848
2849bool VarDecl::isNoDestroy(const ASTContext &Ctx) const {
2850 if (!hasGlobalStorage())
2851 return false;
2853 return true;
2855 return false;
2856
2858 RSDKind K = Ctx.getLangOpts().getRegisterStaticDestructors();
2859 return K == RSDKind::None ||
2860 (K == RSDKind::ThreadLocal && getTLSKind() == TLS_None);
2861}
2862
2865 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2866 if (Eval->HasConstantDestruction)
2867 return QualType::DK_none;
2868
2869 if (isNoDestroy(Ctx))
2870 return QualType::DK_none;
2871
2872 return getType().isDestructedType();
2873}
2874
2876 assert(hasInit() && "Expect initializer to check for flexible array init");
2877 auto *D = getType()->getAsRecordDecl();
2878 if (!D || !D->hasFlexibleArrayMember())
2879 return false;
2880 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2881 if (!List)
2882 return false;
2883 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2884 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2885 if (!InitTy)
2886 return false;
2887 return !InitTy->isZeroSize();
2888}
2889
2891 assert(hasInit() && "Expect initializer to check for flexible array init");
2892 auto *RD = getType()->getAsRecordDecl();
2893 if (!RD || !RD->hasFlexibleArrayMember())
2894 return CharUnits::Zero();
2895 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2896 if (!List || List->getNumInits() == 0)
2897 return CharUnits::Zero();
2898 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2899 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2900 if (!InitTy)
2901 return CharUnits::Zero();
2902 CharUnits FlexibleArraySize = Ctx.getTypeSizeInChars(InitTy);
2903 const ASTRecordLayout &RL = Ctx.getASTRecordLayout(RD);
2904 CharUnits FlexibleArrayOffset =
2906 if (FlexibleArrayOffset + FlexibleArraySize < RL.getSize())
2907 return CharUnits::Zero();
2908 return FlexibleArrayOffset + FlexibleArraySize - RL.getSize();
2909}
2910
2912 if (isStaticDataMember())
2913 // FIXME: Remove ?
2914 // return getASTContext().getInstantiatedFromStaticDataMember(this);
2915 return dyn_cast_if_present<MemberSpecializationInfo *>(
2916 getASTContext().getTemplateOrSpecializationInfo(this));
2917 return nullptr;
2918}
2919
2921 SourceLocation PointOfInstantiation) {
2922 assert((isa<VarTemplateSpecializationDecl>(this) ||
2924 "not a variable or static data member template specialization");
2925
2927 dyn_cast<VarTemplateSpecializationDecl>(this)) {
2928 Spec->setSpecializationKind(TSK);
2929 if (TSK != TSK_ExplicitSpecialization &&
2930 PointOfInstantiation.isValid() &&
2931 Spec->getPointOfInstantiation().isInvalid()) {
2932 Spec->setPointOfInstantiation(PointOfInstantiation);
2934 L->InstantiationRequested(this);
2935 }
2937 MSI->setTemplateSpecializationKind(TSK);
2938 if (TSK != TSK_ExplicitSpecialization && PointOfInstantiation.isValid() &&
2939 MSI->getPointOfInstantiation().isInvalid()) {
2940 MSI->setPointOfInstantiation(PointOfInstantiation);
2942 L->InstantiationRequested(this);
2943 }
2944 }
2945}
2946
2947void
2950 assert(getASTContext().getTemplateOrSpecializationInfo(this).isNull() &&
2951 "Previous template or instantiation?");
2953}
2954
2955//===----------------------------------------------------------------------===//
2956// ParmVarDecl Implementation
2957//===----------------------------------------------------------------------===//
2958
2960 SourceLocation StartLoc, SourceLocation IdLoc,
2961 const IdentifierInfo *Id, QualType T,
2962 TypeSourceInfo *TInfo, StorageClass S,
2963 Expr *DefArg) {
2964 return new (C, DC) ParmVarDecl(ParmVar, C, DC, StartLoc, IdLoc, Id, T, TInfo,
2965 S, DefArg);
2966}
2967
2970 QualType T = TSI ? TSI->getType() : getType();
2971 if (const auto *DT = dyn_cast<DecayedType>(T))
2972 return DT->getOriginalType();
2973 return T;
2974}
2975
2977 return new (C, ID)
2978 ParmVarDecl(ParmVar, C, nullptr, SourceLocation(), SourceLocation(),
2979 nullptr, QualType(), nullptr, SC_None, nullptr);
2980}
2981
2983 if (!hasInheritedDefaultArg()) {
2984 SourceRange ArgRange = getDefaultArgRange();
2985 if (ArgRange.isValid())
2986 return SourceRange(getOuterLocStart(), ArgRange.getEnd());
2987 }
2988
2989 // DeclaratorDecl considers the range of postfix types as overlapping with the
2990 // declaration name, but this is not the case with parameters in ObjC methods.
2993
2995}
2996
2998 // ns_consumed only affects code generation in ARC
3000 return getASTContext().getLangOpts().ObjCAutoRefCount;
3001
3002 // FIXME: isParamDestroyedInCallee() should probably imply
3003 // isDestructedType()
3004 const auto *RT = getType()->getAsCanonical<RecordType>();
3005 if (RT && RT->getDecl()->getDefinitionOrSelf()->isParamDestroyedInCallee() &&
3006 getType().isDestructedType())
3007 return true;
3008
3009 return false;
3010}
3011
3013 assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
3014 assert(!hasUninstantiatedDefaultArg() &&
3015 "Default argument is not yet instantiated!");
3016
3017 Expr *Arg = getInit();
3018 if (auto *E = dyn_cast_if_present<FullExpr>(Arg))
3019 return E->getSubExpr();
3020
3021 return Arg;
3022}
3023
3025 ParmVarDeclBits.DefaultArgKind = DAK_Normal;
3026 Init = defarg;
3027}
3028
3030 switch (ParmVarDeclBits.DefaultArgKind) {
3031 case DAK_None:
3032 case DAK_Unparsed:
3033 // Nothing we can do here.
3034 return SourceRange();
3035
3036 case DAK_Uninstantiated:
3038
3039 case DAK_Normal:
3040 if (const Expr *E = getInit())
3041 return E->getSourceRange();
3042
3043 // Missing an actual expression, may be invalid.
3044 return SourceRange();
3045 }
3046 llvm_unreachable("Invalid default argument kind.");
3047}
3048
3050 ParmVarDeclBits.DefaultArgKind = DAK_Uninstantiated;
3051 Init = arg;
3052}
3053
3055 assert(hasUninstantiatedDefaultArg() &&
3056 "Wrong kind of initialization expression!");
3057 return cast_if_present<Expr>(cast<Stmt *>(Init));
3058}
3059
3061 // FIXME: We should just return false for DAK_None here once callers are
3062 // prepared for the case that we encountered an invalid default argument and
3063 // were unable to even build an invalid expression.
3065 !Init.isNull();
3066}
3067
3068void ParmVarDecl::setParameterIndexLarge(unsigned parameterIndex) {
3069 getASTContext().setParameterIndex(this, parameterIndex);
3070 ParmVarDeclBits.ParameterIndex = ParameterIndexSentinel;
3071}
3072
3073unsigned ParmVarDecl::getParameterIndexLarge() const {
3074 return getASTContext().getParameterIndex(this);
3075}
3076
3077//===----------------------------------------------------------------------===//
3078// FunctionDecl Implementation
3079//===----------------------------------------------------------------------===//
3080
3082 SourceLocation StartLoc,
3083 const DeclarationNameInfo &NameInfo, QualType T,
3084 TypeSourceInfo *TInfo, StorageClass S,
3086 ConstexprSpecKind ConstexprKind,
3087 const AssociatedConstraint &TrailingRequiresClause)
3088 : DeclaratorDecl(DK, DC, NameInfo.getLoc(), NameInfo.getName(), T, TInfo,
3089 StartLoc),
3090 DeclContext(DK), redeclarable_base(C), Body(), ODRHash(0),
3091 EndRangeLoc(NameInfo.getEndLoc()), DNLoc(NameInfo.getInfo()) {
3092 assert(T.isNull() || T->isFunctionType());
3093 FunctionDeclBits.SClass = S;
3095 FunctionDeclBits.IsInlineSpecified = isInlineSpecified;
3096 FunctionDeclBits.IsVirtualAsWritten = false;
3097 FunctionDeclBits.IsPureVirtual = false;
3098 FunctionDeclBits.HasInheritedPrototype = false;
3099 FunctionDeclBits.HasWrittenPrototype = true;
3100 FunctionDeclBits.IsDeleted = false;
3101 FunctionDeclBits.IsTrivial = false;
3102 FunctionDeclBits.IsTrivialForCall = false;
3103 FunctionDeclBits.IsDefaulted = false;
3104 FunctionDeclBits.IsExplicitlyDefaulted = false;
3105 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3106 FunctionDeclBits.IsIneligibleOrNotSelected = false;
3107 FunctionDeclBits.HasImplicitReturnZero = false;
3108 FunctionDeclBits.IsLateTemplateParsed = false;
3109 FunctionDeclBits.IsInstantiatedFromMemberTemplate = false;
3110 FunctionDeclBits.ConstexprKind = static_cast<uint64_t>(ConstexprKind);
3111 FunctionDeclBits.BodyContainsImmediateEscalatingExpression = false;
3112 FunctionDeclBits.InstantiationIsPending = false;
3113 FunctionDeclBits.UsesSEHTry = false;
3114 FunctionDeclBits.UsesFPIntrin = UsesFPIntrin;
3115 FunctionDeclBits.HasSkippedBody = false;
3116 FunctionDeclBits.WillHaveBody = false;
3117 FunctionDeclBits.IsMultiVersion = false;
3118 FunctionDeclBits.DeductionCandidateKind =
3119 static_cast<unsigned char>(DeductionCandidate::Normal);
3120 FunctionDeclBits.HasODRHash = false;
3121 FunctionDeclBits.FriendConstraintRefersToEnclosingTemplate = false;
3122
3123 if (TrailingRequiresClause)
3124 setTrailingRequiresClause(TrailingRequiresClause);
3125}
3126
3128 raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const {
3131 if (TemplateArgs)
3132 printTemplateArgumentList(OS, TemplateArgs->asArray(), Policy);
3133}
3134
3136 if (const auto *FT = getType()->getAs<FunctionProtoType>())
3137 return FT->isVariadic();
3138 return false;
3139}
3140
3143 ASTContext &Context, ArrayRef<DeclAccessPair> Lookups,
3144 StringLiteral *DeletedMessage) {
3145 static constexpr size_t Alignment =
3146 std::max({alignof(DefaultedOrDeletedFunctionInfo),
3147 alignof(DeclAccessPair), alignof(StringLiteral *)});
3148 size_t Size = totalSizeToAlloc<DeclAccessPair, StringLiteral *>(
3149 Lookups.size(), DeletedMessage != nullptr);
3150
3152 new (Context.Allocate(Size, Alignment)) DefaultedOrDeletedFunctionInfo;
3153 Info->NumLookups = Lookups.size();
3154 Info->HasDeletedMessage = DeletedMessage != nullptr;
3155
3156 llvm::uninitialized_copy(Lookups, Info->getTrailingObjects<DeclAccessPair>());
3157 if (DeletedMessage)
3158 *Info->getTrailingObjects<StringLiteral *>() = DeletedMessage;
3159 return Info;
3160}
3161
3164 assert(!FunctionDeclBits.HasDefaultedOrDeletedInfo && "already have this");
3165 assert(!Body && "can't replace function body with defaulted function info");
3166
3167 FunctionDeclBits.HasDefaultedOrDeletedInfo = true;
3169}
3170
3172 FunctionDeclBits.IsDeleted = D;
3173
3174 if (Message) {
3175 assert(isDeletedAsWritten() && "Function must be deleted");
3176 if (FunctionDeclBits.HasDefaultedOrDeletedInfo)
3177 DefaultedOrDeletedInfo->setDeletedMessage(Message);
3178 else
3180 getASTContext(), /*Lookups=*/{}, Message));
3181 }
3182}
3183
3185 StringLiteral *Message) {
3186 // We should never get here with the DefaultedOrDeletedInfo populated, but
3187 // no space allocated for the deleted message, since that would require
3188 // recreating this, but setDefaultedOrDeletedInfo() disallows overwriting
3189 // an already existing DefaultedOrDeletedFunctionInfo.
3190 assert(HasDeletedMessage &&
3191 "No space to store a delete message in this DefaultedOrDeletedInfo");
3192 *getTrailingObjects<StringLiteral *>() = Message;
3193}
3194
3197 return FunctionDeclBits.HasDefaultedOrDeletedInfo ? DefaultedOrDeletedInfo
3198 : nullptr;
3199}
3200
3202 for (const auto *I : redecls()) {
3203 if (I->doesThisDeclarationHaveABody()) {
3204 Definition = I;
3205 return true;
3206 }
3207 }
3208
3209 return false;
3210}
3211
3213 const Stmt *S = getBody();
3214 if (!S) {
3215 // Since we don't have a body for this function, we don't know if it's
3216 // trivial or not.
3217 return false;
3218 }
3219
3220 if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
3221 return true;
3222 return false;
3223}
3224
3226 if (!getFriendObjectKind())
3227 return false;
3228
3229 // Check for a friend function instantiated from a friend function
3230 // definition in a templated class.
3231 if (const FunctionDecl *InstantiatedFrom =
3233 return InstantiatedFrom->getFriendObjectKind() &&
3234 InstantiatedFrom->isThisDeclarationADefinition();
3235
3236 // Check for a friend function template instantiated from a friend
3237 // function template definition in a templated class.
3239 if (const FunctionTemplateDecl *InstantiatedFrom =
3240 Template->getInstantiatedFromMemberTemplate())
3241 return InstantiatedFrom->getFriendObjectKind() &&
3242 InstantiatedFrom->isThisDeclarationADefinition();
3243 }
3244
3245 return false;
3246}
3247
3249 bool CheckForPendingFriendDefinition) const {
3250 for (const FunctionDecl *FD : redecls()) {
3251 if (FD->isThisDeclarationADefinition()) {
3252 Definition = FD;
3253 return true;
3254 }
3255
3256 // If this is a friend function defined in a class template, it does not
3257 // have a body until it is used, nevertheless it is a definition, see
3258 // [temp.inst]p2:
3259 //
3260 // ... for the purpose of determining whether an instantiated redeclaration
3261 // is valid according to [basic.def.odr] and [class.mem], a declaration that
3262 // corresponds to a definition in the template is considered to be a
3263 // definition.
3264 //
3265 // The following code must produce redefinition error:
3266 //
3267 // template<typename T> struct C20 { friend void func_20() {} };
3268 // C20<int> c20i;
3269 // void func_20() {}
3270 //
3271 if (CheckForPendingFriendDefinition &&
3272 FD->isThisDeclarationInstantiatedFromAFriendDefinition()) {
3273 Definition = FD;
3274 return true;
3275 }
3276 }
3277
3278 return false;
3279}
3280
3282 if (!hasBody(Definition))
3283 return nullptr;
3284
3285 assert(!Definition->FunctionDeclBits.HasDefaultedOrDeletedInfo &&
3286 "definition should not have a body");
3287 if (Definition->Body)
3288 return Definition->Body.get(getASTContext().getExternalSource());
3289
3290 return nullptr;
3291}
3292
3294 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3295 Body = LazyDeclStmtPtr(B);
3296 if (B)
3297 EndRangeLoc = B->getEndLoc();
3298}
3299
3301 FunctionDeclBits.IsPureVirtual = P;
3302 if (P)
3303 if (auto *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
3304 Parent->markedVirtualFunctionPure();
3305}
3306
3307template<std::size_t Len>
3308static bool isNamed(const NamedDecl *ND, const char (&Str)[Len]) {
3309 const IdentifierInfo *II = ND->getIdentifier();
3310 return II && II->isStr(Str);
3311}
3312
3314 // C++23 [expr.const]/p17
3315 // An immediate-escalating function is
3316 // - the call operator of a lambda that is not declared with the consteval
3317 // specifier,
3318 if (isLambdaCallOperator(this) && !isConsteval())
3319 return true;
3320 // - a defaulted special member function that is not declared with the
3321 // consteval specifier,
3322 if (isDefaulted() && !isConsteval())
3323 return true;
3324
3325 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3326 CD && CD->isInheritingConstructor())
3327 return CD->getInheritedConstructor().getConstructor();
3328
3329 // Destructors are not immediate escalating.
3330 if (isa<CXXDestructorDecl>(this))
3331 return false;
3332
3333 // - a function that results from the instantiation of a templated entity
3334 // defined with the constexpr specifier.
3336 if (TK != TK_NonTemplate && TK != TK_DependentNonTemplate &&
3338 return true;
3339 return false;
3340}
3341
3343 // C++23 [expr.const]/p18
3344 // An immediate function is a function or constructor that is
3345 // - declared with the consteval specifier
3346 if (isConsteval())
3347 return true;
3348 // - an immediate-escalating function F whose function body contains an
3349 // immediate-escalating expression
3351 return true;
3352
3353 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3354 CD && CD->isInheritingConstructor())
3355 return CD->getInheritedConstructor()
3356 .getConstructor()
3357 ->isImmediateFunction();
3358
3360 P && P->isImmediateFunction())
3361 return true;
3362
3363 if (const auto *MD = dyn_cast<CXXMethodDecl>(this);
3364 MD && MD->isLambdaStaticInvoker())
3365 return MD->getParent()->getLambdaCallOperator()->isImmediateFunction();
3366
3367 return false;
3368}
3369
3371 return isNamed(this, "main") && !getLangOpts().Freestanding &&
3372 !getLangOpts().HLSL &&
3374 isExternC());
3375}
3376
3378 const TranslationUnitDecl *TUnit =
3379 dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
3380 if (!TUnit)
3381 return false;
3382
3383 // Even though we aren't really targeting MSVCRT if we are freestanding,
3384 // semantic analysis for these functions remains the same.
3385
3386 // MSVCRT entry points only exist on MSVCRT targets.
3387 if (!TUnit->getASTContext().getTargetInfo().getTriple().isOSMSVCRT() &&
3388 !TUnit->getASTContext().getTargetInfo().getTriple().isUEFI())
3389 return false;
3390
3391 // Nameless functions like constructors cannot be entry points.
3392 if (!getIdentifier())
3393 return false;
3394
3395 return llvm::StringSwitch<bool>(getName())
3396 .Cases({"main", // an ANSI console app
3397 "wmain", // a Unicode console App
3398 "WinMain", // an ANSI GUI app
3399 "wWinMain", // a Unicode GUI app
3400 "DllMain"}, // a DLL
3401 true)
3402 .Default(false);
3403}
3404
3406 if (!getDeclName().isAnyOperatorNewOrDelete())
3407 return false;
3408
3410 return false;
3411
3413 return false;
3414
3415 const auto *proto = getType()->castAs<FunctionProtoType>();
3416 if (proto->getNumParams() != 2 || proto->isVariadic())
3417 return false;
3418
3419 const ASTContext &Context =
3421 ->getASTContext();
3422
3423 // The result type and first argument type are constant across all
3424 // these operators. The second argument must be exactly void*.
3425 return (proto->getParamType(1).getCanonicalType() == Context.VoidPtrTy);
3426}
3427
3429 UnsignedOrNone *AlignmentParam, bool *IsNothrow) const {
3430 if (!getDeclName().isAnyOperatorNewOrDelete())
3431 return false;
3432
3434 return false;
3435
3436 // This can only fail for an invalid 'operator new' declaration.
3438 return false;
3439
3440 if (isVariadic())
3441 return false;
3442
3444 bool IsDelete = getDeclName().isAnyOperatorDelete();
3445 unsigned RequiredParameterCount =
3448 if (AlignmentParam)
3449 *AlignmentParam =
3450 /* type identity */ 1U + /* address */ IsDelete + /* size */ 1U;
3451 if (RequiredParameterCount == getNumParams())
3452 return true;
3453 if (getNumParams() > RequiredParameterCount + 1)
3454 return false;
3455 if (!getParamDecl(RequiredParameterCount)->getType()->isNothrowT())
3456 return false;
3457
3458 if (IsNothrow)
3459 *IsNothrow = true;
3460 return true;
3461 }
3462
3463 const auto *FPT = getType()->castAs<FunctionProtoType>();
3464 if (FPT->getNumParams() == 0 || FPT->getNumParams() > 4)
3465 return false;
3466
3467 // If this is a single-parameter function, it must be a replaceable global
3468 // allocation or deallocation function.
3469 if (FPT->getNumParams() == 1)
3470 return true;
3471
3472 unsigned Params = 1;
3473 QualType Ty = FPT->getParamType(Params);
3474 const ASTContext &Ctx = getASTContext();
3475
3476 auto Consume = [&] {
3477 ++Params;
3478 Ty = Params < FPT->getNumParams() ? FPT->getParamType(Params) : QualType();
3479 };
3480
3481 // In C++14, the next parameter can be a 'std::size_t' for sized delete.
3482 bool IsSizedDelete = false;
3483 if (Ctx.getLangOpts().SizedDeallocation &&
3484 getDeclName().isAnyOperatorDelete() &&
3485 Ctx.hasSameType(Ty, Ctx.getSizeType())) {
3486 IsSizedDelete = true;
3487 Consume();
3488 }
3489
3490 // In C++17, the next parameter can be a 'std::align_val_t' for aligned
3491 // new/delete.
3492 if (Ctx.getLangOpts().AlignedAllocation && !Ty.isNull() && Ty->isAlignValT()) {
3493 Consume();
3494 if (AlignmentParam)
3495 *AlignmentParam = Params;
3496 }
3497
3498 // If this is not a sized delete, the next parameter can be a
3499 // 'const std::nothrow_t&'.
3500 if (!IsSizedDelete && !Ty.isNull() && Ty->isReferenceType()) {
3501 Ty = Ty->getPointeeType();
3503 return false;
3504 if (Ty->isNothrowT()) {
3505 if (IsNothrow)
3506 *IsNothrow = true;
3507 Consume();
3508 }
3509 }
3510
3511 // Finally, recognize the not yet standard versions of new that take a
3512 // hot/cold allocation hint (__hot_cold_t). These are currently supported by
3513 // tcmalloc (see
3514 // https://github.com/google/tcmalloc/blob/220043886d4e2efff7a5702d5172cb8065253664/tcmalloc/malloc_extension.h#L53).
3515 if (!IsSizedDelete && !Ty.isNull() && Ty->isEnumeralType()) {
3516 QualType T = Ty;
3517 while (const auto *TD = T->getAs<TypedefType>())
3518 T = TD->getDecl()->getUnderlyingType();
3519 const IdentifierInfo *II =
3520 T->castAsCanonical<EnumType>()->getDecl()->getIdentifier();
3521 if (II && II->isStr("__hot_cold_t"))
3522 Consume();
3523 }
3524
3525 return Params == FPT->getNumParams();
3526}
3527
3529 if (!getBuiltinID())
3530 return false;
3531
3532 const FunctionDecl *Definition;
3533 if (!hasBody(Definition))
3534 return false;
3535
3536 if (!Definition->isInlineSpecified() ||
3537 !Definition->hasAttr<AlwaysInlineAttr>())
3538 return false;
3539
3540 ASTContext &Context = getASTContext();
3541 switch (Context.GetGVALinkageForFunction(Definition)) {
3542 case GVA_Internal:
3543 case GVA_DiscardableODR:
3544 case GVA_StrongODR:
3545 return false;
3547 case GVA_StrongExternal:
3548 return true;
3549 }
3550 llvm_unreachable("Unknown GVALinkage");
3551}
3552
3556
3557void FunctionDecl::setIsDestroyingOperatorDelete(bool IsDestroyingDelete) {
3558 getASTContext().setIsDestroyingOperatorDelete(this, IsDestroyingDelete);
3559}
3560
3564
3568
3570 UsualDeleteParams Params;
3571
3572 // This function should only be called for operator delete declarations.
3573 assert(getDeclName().isAnyOperatorDelete());
3574 if (!getDeclName().isAnyOperatorDelete())
3575 return Params;
3576
3578 auto AI = FPT->param_type_begin(), AE = FPT->param_type_end();
3579
3582 assert(AI != AE);
3583 ++AI;
3584 }
3585
3586 // The first argument after the type-identity parameter (if any) is
3587 // always a void* (or C* for a destroying operator delete for class
3588 // type C).
3589 ++AI;
3590
3591 // The next parameter may be a std::destroying_delete_t.
3593 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3594 Params.DestroyingDelete = true;
3595 assert(AI != AE);
3596 ++AI;
3597 }
3598
3599 // Figure out what other parameters we should be implicitly passing.
3600 if (AI != AE && (*AI)->isIntegerType()) {
3601 Params.Size = true;
3602 ++AI;
3603 } else
3604 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3605
3606 if (AI != AE && (*AI)->isAlignValT()) {
3608 ++AI;
3609 } else
3610 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3611
3612 assert(AI == AE && "unexpected usual deallocation function parameter");
3613 return Params;
3614}
3615
3619
3621 return isDeclExternC(*this);
3622}
3623
3625 if (DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>()))
3626 return true;
3628}
3629
3633
3635 if (const auto *Method = dyn_cast<CXXMethodDecl>(this))
3636 return Method->isStatic();
3637
3639 return false;
3640
3641 for (const DeclContext *DC = getDeclContext();
3642 DC->isNamespace();
3643 DC = DC->getParent()) {
3644 if (const auto *Namespace = cast<NamespaceDecl>(DC)) {
3645 if (!Namespace->getDeclName())
3646 return false;
3647 }
3648 }
3649
3650 return true;
3651}
3652
3656 return true;
3657
3658 if (auto *FnTy = getType()->getAs<FunctionType>())
3659 return FnTy->getNoReturnAttr();
3660
3661 return false;
3662}
3663
3667
3669 // C++20 [temp.friend]p9:
3670 // A non-template friend declaration with a requires-clause [or]
3671 // a friend function template with a constraint that depends on a template
3672 // parameter from an enclosing template [...] does not declare the same
3673 // function or function template as a declaration in any other scope.
3674
3675 // If this isn't a friend then it's not a member-like constrained friend.
3676 if (!getFriendObjectKind()) {
3677 return false;
3678 }
3679
3681 // If these friends don't have constraints, they aren't constrained, and
3682 // thus don't fall under temp.friend p9. Else the simple presence of a
3683 // constraint makes them unique.
3685 }
3686
3688}
3689
3703
3707
3711
3716
3718 if (!isMultiVersion())
3719 return false;
3720 if (hasAttr<TargetAttr>())
3721 return getAttr<TargetAttr>()->isDefaultVersion();
3722 return hasAttr<TargetVersionAttr>() &&
3723 getAttr<TargetVersionAttr>()->isDefaultVersion();
3724}
3725
3729
3733
3734void
3737
3739 FunctionTemplateDecl *PrevFunTmpl
3740 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : nullptr;
3741 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
3742 FunTmpl->setPreviousDecl(PrevFunTmpl);
3743 }
3744
3745 if (PrevDecl && PrevDecl->isInlined())
3746 setImplicitlyInline(true);
3747}
3748
3750
3751/// Returns a value indicating whether this function corresponds to a builtin
3752/// function.
3753///
3754/// The function corresponds to a built-in function if it is declared at
3755/// translation scope or within an extern "C" block and its name matches with
3756/// the name of a builtin. The returned value will be 0 for functions that do
3757/// not correspond to a builtin, a value of type \c Builtin::ID if in the
3758/// target-independent range \c [1,Builtin::First), or a target-specific builtin
3759/// value.
3760///
3761/// \param ConsiderWrapperFunctions If true, we should consider wrapper
3762/// functions as their wrapped builtins. This shouldn't be done in general, but
3763/// it's useful in Sema to diagnose calls to wrappers based on their semantics.
3764unsigned FunctionDecl::getBuiltinID(bool ConsiderWrapperFunctions) const {
3765 unsigned BuiltinID = 0;
3766
3767 if (const auto *ABAA = getAttr<ArmBuiltinAliasAttr>()) {
3768 BuiltinID = ABAA->getBuiltinName()->getBuiltinID();
3769 } else if (const auto *BAA = getAttr<BuiltinAliasAttr>()) {
3770 BuiltinID = BAA->getBuiltinName()->getBuiltinID();
3771 } else if (const auto *A = getAttr<BuiltinAttr>()) {
3772 BuiltinID = A->getID();
3773 }
3774
3775 if (!BuiltinID)
3776 return 0;
3777
3778 // If the function is marked "overloadable", it has a different mangled name
3779 // and is not the C library function.
3780 if (!ConsiderWrapperFunctions && hasAttr<OverloadableAttr>() &&
3782 return 0;
3783
3785 BuiltinID == Builtin::BI__builtin_counted_by_ref)
3786 return 0;
3787
3788 const ASTContext &Context = getASTContext();
3789 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3790 return BuiltinID;
3791
3792 // This function has the name of a known C library
3793 // function. Determine whether it actually refers to the C library
3794 // function or whether it just has the same name.
3795
3796 // If this is a static function, it's not a builtin.
3797 if (!ConsiderWrapperFunctions && getStorageClass() == SC_Static)
3798 return 0;
3799
3800 // OpenCL v1.2 s6.9.f - The library functions defined in
3801 // the C99 standard headers are not available.
3802 if (Context.getLangOpts().OpenCL &&
3803 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3804 return 0;
3805
3806 // CUDA does not have device-side standard library. printf and malloc are the
3807 // only special cases that are supported by device-side runtime.
3808 if (Context.getLangOpts().CUDA && hasAttr<CUDADeviceAttr>() &&
3810 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3811 return 0;
3812
3813 // As AMDGCN implementation of OpenMP does not have a device-side standard
3814 // library, none of the predefined library functions except printf and malloc
3815 // should be treated as a builtin i.e. 0 should be returned for them.
3816 if (Context.getTargetInfo().getTriple().isAMDGCN() &&
3817 Context.getLangOpts().OpenMPIsTargetDevice &&
3818 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID) &&
3819 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3820 return 0;
3821
3822 return BuiltinID;
3823}
3824
3825/// getNumParams - Return the number of parameters this function must have
3826/// based on its FunctionType. This is the length of the ParamInfo array
3827/// after it has been created.
3829 const auto *FPT = getType()->getAs<FunctionProtoType>();
3830 return FPT ? FPT->getNumParams() : 0;
3831}
3832
3833void FunctionDecl::setParams(ASTContext &C,
3834 ArrayRef<ParmVarDecl *> NewParamInfo) {
3835 assert(!ParamInfo && "Already has param info!");
3836 assert(NewParamInfo.size() == getNumParams() && "Parameter count mismatch!");
3837
3838 // Zero params -> null pointer.
3839 if (!NewParamInfo.empty()) {
3840 ParamInfo = new (C) ParmVarDecl*[NewParamInfo.size()];
3841 llvm::copy(NewParamInfo, ParamInfo);
3842 }
3843}
3844
3845/// getMinRequiredArguments - Returns the minimum number of arguments
3846/// needed to call this function. This may be fewer than the number of
3847/// function parameters, if some of the parameters have default
3848/// arguments (in C++) or are parameter packs (C++11).
3851 return getNumParams();
3852
3853 // Note that it is possible for a parameter with no default argument to
3854 // follow a parameter with a default argument.
3855 unsigned NumRequiredArgs = 0;
3856 unsigned MinParamsSoFar = 0;
3857 for (auto *Param : parameters()) {
3858 if (!Param->isParameterPack()) {
3859 ++MinParamsSoFar;
3860 if (!Param->hasDefaultArg())
3861 NumRequiredArgs = MinParamsSoFar;
3862 }
3863 }
3864 return NumRequiredArgs;
3865}
3866
3870
3872 return getNumParams() -
3873 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3874}
3875
3877 return getMinRequiredArguments() -
3878 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3879}
3880
3882 return getNumParams() == 1 ||
3883 (getNumParams() > 1 &&
3884 llvm::all_of(llvm::drop_begin(parameters()),
3885 [](ParmVarDecl *P) { return P->hasDefaultArg(); }));
3886}
3887
3888/// The combination of the extern and inline keywords under MSVC forces
3889/// the function to be required.
3890///
3891/// Note: This function assumes that we will only get called when isInlined()
3892/// would return true for this FunctionDecl.
3894 assert(isInlined() && "expected to get called on an inlined function!");
3895
3896 const ASTContext &Context = getASTContext();
3897 if (!Context.getTargetInfo().getCXXABI().isMicrosoft() &&
3899 return false;
3900
3901 for (const FunctionDecl *FD = getMostRecentDecl(); FD;
3902 FD = FD->getPreviousDecl())
3903 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3904 return true;
3905
3906 return false;
3907}
3908
3909static bool redeclForcesDefMSVC(const FunctionDecl *Redecl) {
3910 if (Redecl->getStorageClass() != SC_Extern)
3911 return false;
3912
3913 for (const FunctionDecl *FD = Redecl->getPreviousDecl(); FD;
3914 FD = FD->getPreviousDecl())
3915 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3916 return false;
3917
3918 return true;
3919}
3920
3921static bool RedeclForcesDefC99(const FunctionDecl *Redecl) {
3922 // Only consider file-scope declarations in this test.
3923 if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
3924 return false;
3925
3926 // Only consider explicit declarations; the presence of a builtin for a
3927 // libcall shouldn't affect whether a definition is externally visible.
3928 if (Redecl->isImplicit())
3929 return false;
3930
3931 if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
3932 return true; // Not an inline definition
3933
3934 return false;
3935}
3936
3937/// For a function declaration in C or C++, determine whether this
3938/// declaration causes the definition to be externally visible.
3939///
3940/// For instance, this determines if adding the current declaration to the set
3941/// of redeclarations of the given functions causes
3942/// isInlineDefinitionExternallyVisible to change from false to true.
3944 assert(!doesThisDeclarationHaveABody() &&
3945 "Must have a declaration without a body.");
3946
3947 const ASTContext &Context = getASTContext();
3948
3949 if (Context.getLangOpts().MSVCCompat) {
3950 const FunctionDecl *Definition;
3951 if (hasBody(Definition) && Definition->isInlined() &&
3952 redeclForcesDefMSVC(this))
3953 return true;
3954 }
3955
3956 if (Context.getLangOpts().CPlusPlus)
3957 return false;
3958
3959 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
3960 // With GNU inlining, a declaration with 'inline' but not 'extern', forces
3961 // an externally visible definition.
3962 //
3963 // FIXME: What happens if gnu_inline gets added on after the first
3964 // declaration?
3966 return false;
3967
3968 const FunctionDecl *Prev = this;
3969 bool FoundBody = false;
3970 while ((Prev = Prev->getPreviousDecl())) {
3971 FoundBody |= Prev->doesThisDeclarationHaveABody();
3972
3973 if (Prev->doesThisDeclarationHaveABody()) {
3974 // If it's not the case that both 'inline' and 'extern' are
3975 // specified on the definition, then it is always externally visible.
3976 if (!Prev->isInlineSpecified() ||
3977 Prev->getStorageClass() != SC_Extern)
3978 return false;
3979 } else if (Prev->isInlineSpecified() &&
3980 Prev->getStorageClass() != SC_Extern) {
3981 return false;
3982 }
3983 }
3984 return FoundBody;
3985 }
3986
3987 // C99 6.7.4p6:
3988 // [...] If all of the file scope declarations for a function in a
3989 // translation unit include the inline function specifier without extern,
3990 // then the definition in that translation unit is an inline definition.
3992 return false;
3993 const FunctionDecl *Prev = this;
3994 bool FoundBody = false;
3995 while ((Prev = Prev->getPreviousDecl())) {
3996 FoundBody |= Prev->doesThisDeclarationHaveABody();
3997 if (RedeclForcesDefC99(Prev))
3998 return false;
3999 }
4000 return FoundBody;
4001}
4002
4004 const TypeSourceInfo *TSI = getTypeSourceInfo();
4005
4006 if (!TSI)
4007 return FunctionTypeLoc();
4008
4009 TypeLoc TL = TSI->getTypeLoc();
4010 FunctionTypeLoc FTL;
4011
4012 while (!(FTL = TL.getAs<FunctionTypeLoc>())) {
4013 if (const auto PTL = TL.getAs<ParenTypeLoc>())
4014 TL = PTL.getInnerLoc();
4015 else if (const auto ATL = TL.getAs<AttributedTypeLoc>())
4016 TL = ATL.getEquivalentTypeLoc();
4017 else if (const auto MQTL = TL.getAs<MacroQualifiedTypeLoc>())
4018 TL = MQTL.getInnerLoc();
4019 else
4020 break;
4021 }
4022
4023 return FTL;
4024}
4025
4028 if (!FTL)
4029 return SourceRange();
4030
4031 // Skip self-referential return types.
4033 SourceRange RTRange = FTL.getReturnLoc().getSourceRange();
4034 SourceLocation Boundary = getNameInfo().getBeginLoc();
4035 if (RTRange.isInvalid() || Boundary.isInvalid() ||
4036 !SM.isBeforeInTranslationUnit(RTRange.getEnd(), Boundary))
4037 return SourceRange();
4038
4039 return RTRange;
4040}
4041
4043 unsigned NP = getNumParams();
4044 SourceLocation EllipsisLoc = getEllipsisLoc();
4045
4046 if (NP == 0 && EllipsisLoc.isInvalid())
4047 return SourceRange();
4048
4049 SourceLocation Begin =
4050 NP > 0 ? ParamInfo[0]->getSourceRange().getBegin() : EllipsisLoc;
4051 SourceLocation End = EllipsisLoc.isValid()
4052 ? EllipsisLoc
4053 : ParamInfo[NP - 1]->getSourceRange().getEnd();
4054
4055 return SourceRange(Begin, End);
4056}
4057
4062
4063/// For an inline function definition in C, or for a gnu_inline function
4064/// in C++, determine whether the definition will be externally visible.
4065///
4066/// Inline function definitions are always available for inlining optimizations.
4067/// However, depending on the language dialect, declaration specifiers, and
4068/// attributes, the definition of an inline function may or may not be
4069/// "externally" visible to other translation units in the program.
4070///
4071/// In C99, inline definitions are not externally visible by default. However,
4072/// if even one of the global-scope declarations is marked "extern inline", the
4073/// inline definition becomes externally visible (C99 6.7.4p6).
4074///
4075/// In GNU89 mode, or if the gnu_inline attribute is attached to the function
4076/// definition, we use the GNU semantics for inline, which are nearly the
4077/// opposite of C99 semantics. In particular, "inline" by itself will create
4078/// an externally visible symbol, but "extern inline" will not create an
4079/// externally visible symbol.
4082 hasAttr<AliasAttr>()) &&
4083 "Must be a function definition");
4084 assert(isInlined() && "Function must be inline");
4085 ASTContext &Context = getASTContext();
4086
4087 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
4088 // Note: If you change the logic here, please change
4089 // doesDeclarationForceExternallyVisibleDefinition as well.
4090 //
4091 // If it's not the case that both 'inline' and 'extern' are
4092 // specified on the definition, then this inline definition is
4093 // externally visible.
4094 if (Context.getLangOpts().CPlusPlus)
4095 return false;
4097 return true;
4098
4099 // If any declaration is 'inline' but not 'extern', then this definition
4100 // is externally visible.
4101 for (auto *Redecl : redecls()) {
4102 if (Redecl->isInlineSpecified() &&
4103 Redecl->getStorageClass() != SC_Extern)
4104 return true;
4105 }
4106
4107 return false;
4108 }
4109
4110 // The rest of this function is C-only.
4111 assert(!Context.getLangOpts().CPlusPlus &&
4112 "should not use C inline rules in C++");
4113
4114 // C99 6.7.4p6:
4115 // [...] If all of the file scope declarations for a function in a
4116 // translation unit include the inline function specifier without extern,
4117 // then the definition in that translation unit is an inline definition.
4118 for (auto *Redecl : redecls()) {
4119 if (RedeclForcesDefC99(Redecl))
4120 return true;
4121 }
4122
4123 // C99 6.7.4p6:
4124 // An inline definition does not provide an external definition for the
4125 // function, and does not forbid an external definition in another
4126 // translation unit.
4127 return false;
4128}
4129
4130/// getOverloadedOperator - Which C++ overloaded operator this
4131/// function represents, if any.
4137
4138/// getLiteralIdentifier - The literal suffix identifier this function
4139/// represents, if any.
4143 return nullptr;
4144}
4145
4147 if (TemplateOrSpecialization.isNull())
4148 return TK_NonTemplate;
4149 if (const auto *ND = dyn_cast<NamedDecl *>(TemplateOrSpecialization)) {
4150 if (isa<FunctionDecl>(ND))
4152 assert(isa<FunctionTemplateDecl>(ND) &&
4153 "No other valid types in NamedDecl");
4154 return TK_FunctionTemplate;
4155 }
4156 if (isa<MemberSpecializationInfo *>(TemplateOrSpecialization))
4158 if (isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization))
4161 TemplateOrSpecialization))
4163
4164 llvm_unreachable("Did we miss a TemplateOrSpecialization type?");
4165}
4166
4169 return cast<FunctionDecl>(Info->getInstantiatedFrom());
4170
4171 return nullptr;
4172}
4173
4175 if (auto *MSI = dyn_cast_if_present<MemberSpecializationInfo *>(
4176 TemplateOrSpecialization))
4177 return MSI;
4178 if (auto *FTSI = dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4179 TemplateOrSpecialization))
4180 return FTSI->getMemberSpecializationInfo();
4181 return nullptr;
4182}
4183
4184void
4185FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
4186 FunctionDecl *FD,
4188 assert(TemplateOrSpecialization.isNull() &&
4189 "Member function is already a specialization");
4191 = new (C) MemberSpecializationInfo(FD, TSK);
4192 TemplateOrSpecialization = Info;
4193}
4194
4196 return dyn_cast_if_present<FunctionTemplateDecl>(
4197 dyn_cast_if_present<NamedDecl *>(TemplateOrSpecialization));
4198}
4199
4202 assert(TemplateOrSpecialization.isNull() &&
4203 "Member function is already a specialization");
4204 TemplateOrSpecialization = Template;
4205}
4206
4208 return isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization) ||
4210 TemplateOrSpecialization);
4211}
4212
4214 assert(TemplateOrSpecialization.isNull() &&
4215 "Function is already a specialization");
4216 TemplateOrSpecialization = FD;
4217}
4218
4220 return dyn_cast_if_present<FunctionDecl>(
4221 TemplateOrSpecialization.dyn_cast<NamedDecl *>());
4222}
4223
4225 // If the function is invalid, it can't be implicitly instantiated.
4226 if (isInvalidDecl())
4227 return false;
4228
4230 case TSK_Undeclared:
4233 return false;
4234
4236 return true;
4237
4239 // Handled below.
4240 break;
4241 }
4242
4243 // Find the actual template from which we will instantiate.
4244 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
4245 bool HasPattern = false;
4246 if (PatternDecl)
4247 HasPattern = PatternDecl->hasBody(PatternDecl);
4248
4249 // C++0x [temp.explicit]p9:
4250 // Except for inline functions, other explicit instantiation declarations
4251 // have the effect of suppressing the implicit instantiation of the entity
4252 // to which they refer.
4253 if (!HasPattern || !PatternDecl)
4254 return true;
4255
4256 return PatternDecl->isInlined();
4257}
4258
4260 // FIXME: Remove this, it's not clear what it means. (Which template
4261 // specialization kind?)
4263}
4264
4267 // If this is a generic lambda call operator specialization, its
4268 // instantiation pattern is always its primary template's pattern
4269 // even if its primary template was instantiated from another
4270 // member template (which happens with nested generic lambdas).
4271 // Since a lambda's call operator's body is transformed eagerly,
4272 // we don't have to go hunting for a prototype definition template
4273 // (i.e. instantiated-from-member-template) to use as an instantiation
4274 // pattern.
4275
4277 dyn_cast<CXXMethodDecl>(this))) {
4278 assert(getPrimaryTemplate() && "not a generic lambda call operator?");
4279 return getDefinitionOrSelf(getPrimaryTemplate()->getTemplatedDecl());
4280 }
4281
4282 // Check for a declaration of this function that was instantiated from a
4283 // friend definition.
4284 const FunctionDecl *FD = nullptr;
4285 if (!isDefined(FD, /*CheckForPendingFriendDefinition=*/true))
4286 FD = this;
4287
4289 if (ForDefinition &&
4291 return nullptr;
4293 }
4294
4295 if (ForDefinition &&
4297 return nullptr;
4298
4299 if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
4300 // If we hit a point where the user provided a specialization of this
4301 // template, we're done looking.
4302 while (!ForDefinition || !Primary->isMemberSpecialization()) {
4303 auto *NewPrimary = Primary->getInstantiatedFromMemberTemplate();
4304 if (!NewPrimary)
4305 break;
4306 Primary = NewPrimary;
4307 }
4308
4309 return getDefinitionOrSelf(Primary->getTemplatedDecl());
4310 }
4311
4312 return nullptr;
4313}
4314
4317 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4318 TemplateOrSpecialization)) {
4319 return Info->getTemplate();
4320 }
4321 return nullptr;
4322}
4323
4326 return dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4327 TemplateOrSpecialization);
4328}
4329
4333 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4334 TemplateOrSpecialization)) {
4335 return Info->TemplateArguments;
4336 }
4337 return nullptr;
4338}
4339
4343 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4344 TemplateOrSpecialization)) {
4345 return Info->TemplateArgumentsAsWritten;
4346 }
4348 dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4349 TemplateOrSpecialization)) {
4350 return Info->TemplateArgumentsAsWritten;
4351 }
4352 return nullptr;
4353}
4354
4355void FunctionDecl::setFunctionTemplateSpecialization(
4357 TemplateArgumentList *TemplateArgs, void *InsertPos,
4359 const TemplateArgumentListInfo *TemplateArgsAsWritten,
4360 SourceLocation PointOfInstantiation) {
4361 assert((TemplateOrSpecialization.isNull() ||
4362 isa<MemberSpecializationInfo *>(TemplateOrSpecialization)) &&
4363 "Member function is already a specialization");
4364 assert(TSK != TSK_Undeclared &&
4365 "Must specify the type of function template specialization");
4366 assert((TemplateOrSpecialization.isNull() ||
4369 "Member specialization must be an explicit specialization");
4372 C, this, Template, TSK, TemplateArgs, TemplateArgsAsWritten,
4373 PointOfInstantiation,
4374 dyn_cast_if_present<MemberSpecializationInfo *>(
4375 TemplateOrSpecialization));
4376 TemplateOrSpecialization = Info;
4377 Template->addSpecialization(Info, InsertPos);
4378}
4379
4381 ASTContext &Context, const UnresolvedSetImpl &Templates,
4382 const TemplateArgumentListInfo *TemplateArgs) {
4383 assert(TemplateOrSpecialization.isNull());
4386 TemplateArgs);
4387 TemplateOrSpecialization = Info;
4388}
4389
4392 return dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4393 TemplateOrSpecialization);
4394}
4395
4398 ASTContext &Context, const UnresolvedSetImpl &Candidates,
4399 const TemplateArgumentListInfo *TArgs) {
4400 const auto *TArgsWritten =
4401 TArgs ? ASTTemplateArgumentListInfo::Create(Context, *TArgs) : nullptr;
4402 return new (Context.Allocate(
4403 totalSizeToAlloc<FunctionTemplateDecl *>(Candidates.size())))
4404 DependentFunctionTemplateSpecializationInfo(Candidates, TArgsWritten);
4405}
4406
4407DependentFunctionTemplateSpecializationInfo::
4408 DependentFunctionTemplateSpecializationInfo(
4409 const UnresolvedSetImpl &Candidates,
4410 const ASTTemplateArgumentListInfo *TemplateArgsWritten)
4411 : NumCandidates(Candidates.size()),
4412 TemplateArgumentsAsWritten(TemplateArgsWritten) {
4413 std::transform(Candidates.begin(), Candidates.end(), getTrailingObjects(),
4414 [](NamedDecl *ND) {
4416 });
4417}
4418
4420 // For a function template specialization, query the specialization
4421 // information object.
4423 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4424 TemplateOrSpecialization))
4425 return FTSInfo->getTemplateSpecializationKind();
4426
4427 if (MemberSpecializationInfo *MSInfo =
4428 dyn_cast_if_present<MemberSpecializationInfo *>(
4429 TemplateOrSpecialization))
4430 return MSInfo->getTemplateSpecializationKind();
4431
4432 // A dependent function template specialization is an explicit specialization,
4433 // except when it's a friend declaration.
4435 TemplateOrSpecialization) &&
4438
4439 return TSK_Undeclared;
4440}
4441
4444 // This is the same as getTemplateSpecializationKind(), except that for a
4445 // function that is both a function template specialization and a member
4446 // specialization, we prefer the member specialization information. Eg:
4447 //
4448 // template<typename T> struct A {
4449 // template<typename U> void f() {}
4450 // template<> void f<int>() {}
4451 // };
4452 //
4453 // Within the templated CXXRecordDecl, A<T>::f<int> is a dependent function
4454 // template specialization; both getTemplateSpecializationKind() and
4455 // getTemplateSpecializationKindForInstantiation() will return
4456 // TSK_ExplicitSpecialization.
4457 //
4458 // For A<int>::f<int>():
4459 // * getTemplateSpecializationKind() will return TSK_ExplicitSpecialization
4460 // * getTemplateSpecializationKindForInstantiation() will return
4461 // TSK_ImplicitInstantiation
4462 //
4463 // This reflects the facts that A<int>::f<int> is an explicit specialization
4464 // of A<int>::f, and that A<int>::f<int> should be implicitly instantiated
4465 // from A::f<int> if a definition is needed.
4467 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4468 TemplateOrSpecialization)) {
4469 if (auto *MSInfo = FTSInfo->getMemberSpecializationInfo())
4470 return MSInfo->getTemplateSpecializationKind();
4471 return FTSInfo->getTemplateSpecializationKind();
4472 }
4473
4474 if (MemberSpecializationInfo *MSInfo =
4475 dyn_cast_if_present<MemberSpecializationInfo *>(
4476 TemplateOrSpecialization))
4477 return MSInfo->getTemplateSpecializationKind();
4478
4480 TemplateOrSpecialization) &&
4483
4484 return TSK_Undeclared;
4485}
4486
4487void
4489 SourceLocation PointOfInstantiation) {
4491 dyn_cast<FunctionTemplateSpecializationInfo *>(
4492 TemplateOrSpecialization)) {
4493 FTSInfo->setTemplateSpecializationKind(TSK);
4494 if (TSK != TSK_ExplicitSpecialization &&
4495 PointOfInstantiation.isValid() &&
4496 FTSInfo->getPointOfInstantiation().isInvalid()) {
4497 FTSInfo->setPointOfInstantiation(PointOfInstantiation);
4499 L->InstantiationRequested(this);
4500 }
4501 } else if (MemberSpecializationInfo *MSInfo =
4502 dyn_cast<MemberSpecializationInfo *>(
4503 TemplateOrSpecialization)) {
4504 MSInfo->setTemplateSpecializationKind(TSK);
4505 if (TSK != TSK_ExplicitSpecialization &&
4506 PointOfInstantiation.isValid() &&
4507 MSInfo->getPointOfInstantiation().isInvalid()) {
4508 MSInfo->setPointOfInstantiation(PointOfInstantiation);
4510 L->InstantiationRequested(this);
4511 }
4512 } else
4513 llvm_unreachable("Function cannot have a template specialization kind");
4514}
4515
4518 = TemplateOrSpecialization.dyn_cast<
4520 return FTSInfo->getPointOfInstantiation();
4521 if (MemberSpecializationInfo *MSInfo =
4522 TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo *>())
4523 return MSInfo->getPointOfInstantiation();
4524
4525 return SourceLocation();
4526}
4527
4529 if (Decl::isOutOfLine())
4530 return true;
4531
4532 // If this function was instantiated from a member function of a
4533 // class template, check whether that member function was defined out-of-line.
4535 const FunctionDecl *Definition;
4536 if (FD->hasBody(Definition))
4537 return Definition->isOutOfLine();
4538 }
4539
4540 // If this function was instantiated from a function template,
4541 // check whether that function template was defined out-of-line.
4542 if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
4543 const FunctionDecl *Definition;
4544 if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
4545 return Definition->isOutOfLine();
4546 }
4547
4548 return false;
4549}
4550
4552 return SourceRange(getOuterLocStart(), EndRangeLoc);
4553}
4554
4556 IdentifierInfo *FnInfo = getIdentifier();
4557
4558 if (!FnInfo)
4559 return 0;
4560
4561 // Builtin handling.
4562 switch (getBuiltinID()) {
4563 case Builtin::BI__builtin_memset:
4564 case Builtin::BI__builtin___memset_chk:
4565 case Builtin::BImemset:
4566 return Builtin::BImemset;
4567
4568 case Builtin::BI__builtin_memcpy:
4569 case Builtin::BI__builtin___memcpy_chk:
4570 case Builtin::BImemcpy:
4571 return Builtin::BImemcpy;
4572
4573 case Builtin::BI__builtin_mempcpy:
4574 case Builtin::BI__builtin___mempcpy_chk:
4575 case Builtin::BImempcpy:
4576 return Builtin::BImempcpy;
4577
4578 case Builtin::BI__builtin_trivially_relocate:
4579 case Builtin::BI__builtin_memmove:
4580 case Builtin::BI__builtin___memmove_chk:
4581 case Builtin::BImemmove:
4582 return Builtin::BImemmove;
4583
4584 case Builtin::BIstrlcpy:
4585 case Builtin::BI__builtin___strlcpy_chk:
4586 return Builtin::BIstrlcpy;
4587
4588 case Builtin::BIstrlcat:
4589 case Builtin::BI__builtin___strlcat_chk:
4590 return Builtin::BIstrlcat;
4591
4592 case Builtin::BI__builtin_memcmp:
4593 case Builtin::BImemcmp:
4594 return Builtin::BImemcmp;
4595
4596 case Builtin::BI__builtin_bcmp:
4597 case Builtin::BIbcmp:
4598 return Builtin::BIbcmp;
4599
4600 case Builtin::BI__builtin_strncpy:
4601 case Builtin::BI__builtin___strncpy_chk:
4602 case Builtin::BIstrncpy:
4603 return Builtin::BIstrncpy;
4604
4605 case Builtin::BI__builtin_strncmp:
4606 case Builtin::BIstrncmp:
4607 return Builtin::BIstrncmp;
4608
4609 case Builtin::BI__builtin_strncasecmp:
4610 case Builtin::BIstrncasecmp:
4611 return Builtin::BIstrncasecmp;
4612
4613 case Builtin::BI__builtin_strncat:
4614 case Builtin::BI__builtin___strncat_chk:
4615 case Builtin::BIstrncat:
4616 return Builtin::BIstrncat;
4617
4618 case Builtin::BI__builtin_strndup:
4619 case Builtin::BIstrndup:
4620 return Builtin::BIstrndup;
4621
4622 case Builtin::BI__builtin_strlen:
4623 case Builtin::BIstrlen:
4624 return Builtin::BIstrlen;
4625
4626 case Builtin::BI__builtin_bzero:
4627 case Builtin::BIbzero:
4628 return Builtin::BIbzero;
4629
4630 case Builtin::BI__builtin_bcopy:
4631 case Builtin::BIbcopy:
4632 return Builtin::BIbcopy;
4633
4634 case Builtin::BIfree:
4635 return Builtin::BIfree;
4636
4637 default:
4638 if (isExternC()) {
4639 if (FnInfo->isStr("memset"))
4640 return Builtin::BImemset;
4641 if (FnInfo->isStr("memcpy"))
4642 return Builtin::BImemcpy;
4643 if (FnInfo->isStr("mempcpy"))
4644 return Builtin::BImempcpy;
4645 if (FnInfo->isStr("memmove"))
4646 return Builtin::BImemmove;
4647 if (FnInfo->isStr("memcmp"))
4648 return Builtin::BImemcmp;
4649 if (FnInfo->isStr("bcmp"))
4650 return Builtin::BIbcmp;
4651 if (FnInfo->isStr("strncpy"))
4652 return Builtin::BIstrncpy;
4653 if (FnInfo->isStr("strncmp"))
4654 return Builtin::BIstrncmp;
4655 if (FnInfo->isStr("strncasecmp"))
4656 return Builtin::BIstrncasecmp;
4657 if (FnInfo->isStr("strncat"))
4658 return Builtin::BIstrncat;
4659 if (FnInfo->isStr("strndup"))
4660 return Builtin::BIstrndup;
4661 if (FnInfo->isStr("strlen"))
4662 return Builtin::BIstrlen;
4663 if (FnInfo->isStr("bzero"))
4664 return Builtin::BIbzero;
4665 if (FnInfo->isStr("bcopy"))
4666 return Builtin::BIbcopy;
4667 } else if (isInStdNamespace()) {
4668 if (FnInfo->isStr("free"))
4669 return Builtin::BIfree;
4670 }
4671 break;
4672 }
4673 return 0;
4674}
4675
4677 assert(hasODRHash());
4678 return ODRHash;
4679}
4680
4682 if (hasODRHash())
4683 return ODRHash;
4684
4685 if (auto *FT = getInstantiatedFromMemberFunction()) {
4686 setHasODRHash(true);
4687 ODRHash = FT->getODRHash();
4688 return ODRHash;
4689 }
4690
4691 class ODRHash Hash;
4692 Hash.AddFunctionDecl(this);
4693 setHasODRHash(true);
4694 ODRHash = Hash.CalculateHash();
4695 return ODRHash;
4696}
4697
4698//===----------------------------------------------------------------------===//
4699// FieldDecl Implementation
4700//===----------------------------------------------------------------------===//
4701
4703 SourceLocation StartLoc, SourceLocation IdLoc,
4704 const IdentifierInfo *Id, QualType T,
4705 TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
4706 InClassInitStyle InitStyle) {
4707 return new (C, DC) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
4708 BW, Mutable, InitStyle);
4709}
4710
4712 return new (C, ID) FieldDecl(Field, nullptr, SourceLocation(),
4713 SourceLocation(), nullptr, QualType(), nullptr,
4714 nullptr, false, ICIS_NoInit);
4715}
4716
4718 if (!isImplicit() || getDeclName())
4719 return false;
4720
4721 if (const auto *Record = getType()->getAsCanonical<RecordType>())
4722 return Record->getDecl()->isAnonymousStructOrUnion();
4723
4724 return false;
4725}
4726
4728 if (!hasInClassInitializer())
4729 return nullptr;
4730
4731 LazyDeclStmtPtr InitPtr = BitField ? InitAndBitWidth->Init : Init;
4732 return cast_if_present<Expr>(
4733 InitPtr.isOffset() ? InitPtr.get(getASTContext().getExternalSource())
4734 : InitPtr.get(nullptr));
4735}
4736
4738 setLazyInClassInitializer(LazyDeclStmtPtr(NewInit));
4739}
4740
4741void FieldDecl::setLazyInClassInitializer(LazyDeclStmtPtr NewInit) {
4743 if (BitField)
4744 InitAndBitWidth->Init = NewInit;
4745 else
4746 Init = NewInit;
4747}
4748
4750 const auto *CE = dyn_cast_if_present<ConstantExpr>(getBitWidth());
4751 return CE && CE->getAPValueResult().isInt();
4752}
4753
4755 assert(isBitField() && "not a bitfield");
4758 ->getAPValueResult()
4759 .getInt()
4760 .getZExtValue();
4761}
4762
4765 getBitWidthValue() == 0;
4766}
4767
4768bool FieldDecl::isZeroSize(const ASTContext &Ctx) const {
4770 return true;
4771
4772 // C++2a [intro.object]p7:
4773 // An object has nonzero size if it
4774 // -- is not a potentially-overlapping subobject, or
4776 return false;
4777
4778 // -- is not of class type, or
4779 const auto *RT = getType()->getAsCanonical<RecordType>();
4780 if (!RT)
4781 return false;
4782 const RecordDecl *RD = RT->getDecl()->getDefinition();
4783 if (!RD) {
4784 assert(isInvalidDecl() && "valid field has incomplete type");
4785 return false;
4786 }
4787
4788 // -- [has] virtual member functions or virtual base classes, or
4789 // -- has subobjects of nonzero size or bit-fields of nonzero length
4790 const auto *CXXRD = cast<CXXRecordDecl>(RD);
4791 if (!CXXRD->isEmpty())
4792 return false;
4793
4794 // Otherwise, [...] the circumstances under which the object has zero size
4795 // are implementation-defined.
4796 if (!Ctx.getTargetInfo().getCXXABI().isMicrosoft())
4797 return true;
4798
4799 // MS ABI: has nonzero size if it is a class type with class type fields,
4800 // whether or not they have nonzero size
4801 return !llvm::any_of(CXXRD->fields(), [](const FieldDecl *Field) {
4802 return Field->getType()->isRecordType();
4803 });
4804}
4805
4809
4810void FieldDecl::setCachedFieldIndex() const {
4811 assert(this == getCanonicalDecl() &&
4812 "should be called on the canonical decl");
4813
4814 unsigned Index = 0;
4815 const RecordDecl *RD = getParent()->getDefinition();
4816 assert(RD && "requested index for field of struct with no definition");
4817
4818 for (auto *Field : RD->fields()) {
4819 Field->getCanonicalDecl()->CachedFieldIndex = Index + 1;
4820 assert(Field->getCanonicalDecl()->CachedFieldIndex == Index + 1 &&
4821 "overflow in field numbering");
4822 ++Index;
4823 }
4824
4825 assert(CachedFieldIndex && "failed to find field in parent");
4826}
4827
4829 const Expr *FinalExpr = getInClassInitializer();
4830 if (!FinalExpr)
4831 FinalExpr = getBitWidth();
4832 if (FinalExpr)
4833 return SourceRange(getInnerLocStart(), FinalExpr->getEndLoc());
4835}
4836
4838 assert((getParent()->isLambda() || getParent()->isCapturedRecord()) &&
4839 "capturing type in non-lambda or captured record.");
4840 assert(StorageKind == ISK_NoInit && !BitField &&
4841 "bit-field or field with default member initializer cannot capture "
4842 "VLA type");
4843 StorageKind = ISK_CapturedVLAType;
4844 CapturedVLAType = VLAType;
4845}
4846
4847void FieldDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
4848 // Print unnamed members using name of their type.
4850 this->getType().print(OS, Policy);
4851 return;
4852 }
4853 // Otherwise, do the normal printing.
4854 DeclaratorDecl::printName(OS, Policy);
4855}
4856
4858 const auto *CAT = getType()->getAs<CountAttributedType>();
4859 if (!CAT)
4860 return nullptr;
4861
4862 const auto *CountDRE = cast<DeclRefExpr>(CAT->getCountExpr());
4863 const auto *CountDecl = CountDRE->getDecl();
4864 if (const auto *IFD = dyn_cast<IndirectFieldDecl>(CountDecl))
4865 CountDecl = IFD->getAnonField();
4866
4867 return dyn_cast<FieldDecl>(CountDecl);
4868}
4869
4870//===----------------------------------------------------------------------===//
4871// TagDecl Implementation
4872//===----------------------------------------------------------------------===//
4873
4875 SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl,
4876 SourceLocation StartL)
4877 : TypeDecl(DK, DC, L, Id, StartL), DeclContext(DK), redeclarable_base(C),
4878 TypedefNameDeclOrQualifier((TypedefNameDecl *)nullptr) {
4879 assert((DK != Enum || TK == TagTypeKind::Enum) &&
4880 "EnumDecl not matched with TagTypeKind::Enum");
4881 setPreviousDecl(PrevDecl);
4882 setTagKind(TK);
4883 setCompleteDefinition(false);
4884 setBeingDefined(false);
4886 setFreeStanding(false);
4888 TagDeclBits.IsThisDeclarationADemotedDefinition = false;
4889}
4890
4894
4896 SourceLocation RBraceLoc = BraceRange.getEnd();
4897 SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
4898 return SourceRange(getOuterLocStart(), E);
4899}
4900
4902
4904 TypedefNameDeclOrQualifier = TDD;
4905 assert(isLinkageValid());
4906}
4907
4909 setBeingDefined(true);
4910
4911 if (auto *D = dyn_cast<CXXRecordDecl>(this)) {
4912 struct CXXRecordDecl::DefinitionData *Data =
4913 new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
4914 for (auto *I : redecls())
4915 cast<CXXRecordDecl>(I)->DefinitionData = Data;
4916 }
4917}
4918
4920 assert((!isa<CXXRecordDecl>(this) ||
4922 "definition completed but not started");
4923
4925 setBeingDefined(false);
4926
4928 L->CompletedTagDefinition(this);
4929}
4930
4933 return const_cast<TagDecl *>(this);
4934
4935 if (const auto *CXXRD = dyn_cast<CXXRecordDecl>(this))
4936 return CXXRD->getDefinition();
4937
4938 for (TagDecl *R :
4940 if (R->isCompleteDefinition() || R->isBeingDefined())
4941 return R;
4942 return nullptr;
4943}
4944
4946 if (QualifierLoc) {
4947 // Make sure the extended qualifier info is allocated.
4948 if (!hasExtInfo())
4949 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
4950 // Set qualifier info.
4951 getExtInfo()->QualifierLoc = QualifierLoc;
4952 } else {
4953 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
4954 if (hasExtInfo()) {
4955 if (getExtInfo()->NumTemplParamLists == 0) {
4956 getASTContext().Deallocate(getExtInfo());
4957 TypedefNameDeclOrQualifier = (TypedefNameDecl *)nullptr;
4958 }
4959 else
4960 getExtInfo()->QualifierLoc = QualifierLoc;
4961 }
4962 }
4963}
4964
4966 llvm::raw_ostream &OS, const PrintingPolicy &Policy) const {
4967 PresumedLoc PLoc =
4969 if (!PLoc.isValid())
4970 return;
4971
4972 OS << " at ";
4973 StringRef File = PLoc.getFilename();
4974 llvm::SmallString<1024> WrittenFile(File);
4975 if (auto *Callbacks = Policy.Callbacks)
4976 WrittenFile = Callbacks->remapPath(File);
4977 // Fix inconsistent path separator created by
4978 // clang::DirectoryLookup::LookupFile when the file path is relative
4979 // path.
4980 llvm::sys::path::Style Style =
4981 llvm::sys::path::is_absolute(WrittenFile)
4982 ? llvm::sys::path::Style::native
4983 : (Policy.MSVCFormatting ? llvm::sys::path::Style::windows_backslash
4984 : llvm::sys::path::Style::posix);
4985 llvm::sys::path::native(WrittenFile, Style);
4986 OS << WrittenFile << ':' << PLoc.getLine() << ':' << PLoc.getColumn();
4987}
4988
4989void TagDecl::printAnonymousTagDecl(llvm::raw_ostream &OS,
4990 const PrintingPolicy &Policy) const {
4992 assert(Typedef->getIdentifier() && "Typedef without identifier?");
4993 OS << Typedef->getIdentifier()->getName();
4994 return;
4995 }
4996
4997 bool SuppressTagKeywordInName = Policy.SuppressTagKeywordInAnonNames;
4998
4999 // Emit leading keyword. Since we printed a leading keyword make sure we
5000 // don't print the tag as part of the name too.
5001 if (!Policy.SuppressTagKeyword) {
5002 OS << getKindName() << ' ';
5003 SuppressTagKeywordInName = true;
5004 }
5005
5006 // Make an unambiguous representation for anonymous types, e.g.
5007 // (anonymous enum at /usr/include/string.h:120:9)
5008 OS << (Policy.MSVCFormatting ? '`' : '(');
5009
5010 if (isa<CXXRecordDecl>(this) && cast<CXXRecordDecl>(this)->isLambda()) {
5011 OS << "lambda";
5012 SuppressTagKeywordInName = true;
5013 } else if ((isa<RecordDecl>(this) &&
5014 cast<RecordDecl>(this)->isAnonymousStructOrUnion())) {
5015 OS << "anonymous";
5016 } else {
5017 OS << "unnamed";
5018 }
5019
5020 if (!SuppressTagKeywordInName)
5021 OS << ' ' << getKindName();
5022
5023 if (Policy.AnonymousTagNameStyle ==
5026
5027 OS << (Policy.MSVCFormatting ? '\'' : ')');
5028}
5029
5030void TagDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
5032 // If the name is supposed to have an identifier but does not have one, then
5033 // the tag is anonymous and we should print it differently.
5034 if (Name.isIdentifier() && !Name.getAsIdentifierInfo()) {
5035 printAnonymousTagDecl(OS, Policy);
5036
5037 return;
5038 }
5039
5040 // Otherwise, do the normal printing.
5041 Name.print(OS, Policy);
5042}
5043
5046 assert(!TPLists.empty());
5047 // Make sure the extended decl info is allocated.
5048 if (!hasExtInfo())
5049 // Allocate external info struct.
5050 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
5051 // Set the template parameter lists info.
5052 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
5053}
5054
5055//===----------------------------------------------------------------------===//
5056// EnumDecl Implementation
5057//===----------------------------------------------------------------------===//
5058
5059EnumDecl::EnumDecl(ASTContext &C, DeclContext *DC, SourceLocation StartLoc,
5060 SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl,
5061 bool Scoped, bool ScopedUsingClassTag, bool Fixed)
5062 : TagDecl(Enum, TagTypeKind::Enum, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
5063 assert(Scoped || !ScopedUsingClassTag);
5064 IntegerType = nullptr;
5065 setNumPositiveBits(0);
5066 setNumNegativeBits(0);
5067 setScoped(Scoped);
5068 setScopedUsingClassTag(ScopedUsingClassTag);
5069 setFixed(Fixed);
5070 setHasODRHash(false);
5071 ODRHash = 0;
5072}
5073
5074void EnumDecl::anchor() {}
5075
5077 SourceLocation StartLoc, SourceLocation IdLoc,
5078 IdentifierInfo *Id,
5079 EnumDecl *PrevDecl, bool IsScoped,
5080 bool IsScopedUsingClassTag, bool IsFixed) {
5081 return new (C, DC) EnumDecl(C, DC, StartLoc, IdLoc, Id, PrevDecl, IsScoped,
5082 IsScopedUsingClassTag, IsFixed);
5083}
5084
5086 return new (C, ID) EnumDecl(C, nullptr, SourceLocation(), SourceLocation(),
5087 nullptr, nullptr, false, false, false);
5088}
5089
5091 if (const TypeSourceInfo *TI = getIntegerTypeSourceInfo())
5092 return TI->getTypeLoc().getSourceRange();
5093 return SourceRange();
5094}
5095
5097 QualType NewPromotionType,
5098 unsigned NumPositiveBits,
5099 unsigned NumNegativeBits) {
5100 assert(!isCompleteDefinition() && "Cannot redefine enums!");
5101 if (!IntegerType)
5102 IntegerType = NewType.getTypePtr();
5103 PromotionType = NewPromotionType;
5104 setNumPositiveBits(NumPositiveBits);
5105 setNumNegativeBits(NumNegativeBits);
5107}
5108
5110 if (const auto *A = getAttr<EnumExtensibilityAttr>())
5111 return A->getExtensibility() == EnumExtensibilityAttr::Closed;
5112 return true;
5113}
5114
5116 return isClosed() && hasAttr<FlagEnumAttr>();
5117}
5118
5120 return isClosed() && !hasAttr<FlagEnumAttr>();
5121}
5122
5125 return MSI->getTemplateSpecializationKind();
5126
5127 return TSK_Undeclared;
5128}
5129
5131 SourceLocation PointOfInstantiation) {
5133 assert(MSI && "Not an instantiated member enumeration?");
5135 if (TSK != TSK_ExplicitSpecialization &&
5136 PointOfInstantiation.isValid() &&
5138 MSI->setPointOfInstantiation(PointOfInstantiation);
5139}
5140
5143 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
5144 EnumDecl *ED = getInstantiatedFromMemberEnum();
5145 while (auto *NewED = ED->getInstantiatedFromMemberEnum())
5146 ED = NewED;
5147 return ::getDefinitionOrSelf(ED);
5148 }
5149 }
5150
5152 "couldn't find pattern for enum instantiation");
5153 return nullptr;
5154}
5155
5157 if (SpecializationInfo)
5158 return cast<EnumDecl>(SpecializationInfo->getInstantiatedFrom());
5159
5160 return nullptr;
5161}
5162
5163void EnumDecl::setInstantiationOfMemberEnum(ASTContext &C, EnumDecl *ED,
5165 assert(!SpecializationInfo && "Member enum is already a specialization");
5166 SpecializationInfo = new (C) MemberSpecializationInfo(ED, TSK);
5167}
5168
5170 if (hasODRHash())
5171 return ODRHash;
5172
5173 class ODRHash Hash;
5174 Hash.AddEnumDecl(this);
5175 setHasODRHash(true);
5176 ODRHash = Hash.CalculateHash();
5177 return ODRHash;
5178}
5179
5181 auto Res = TagDecl::getSourceRange();
5182 // Set end-point to enum-base, e.g. enum foo : ^bar
5183 if (auto *TSI = getIntegerTypeSourceInfo()) {
5184 // TagDecl doesn't know about the enum base.
5185 if (!getBraceRange().getEnd().isValid())
5186 Res.setEnd(TSI->getTypeLoc().getEndLoc());
5187 }
5188 return Res;
5189}
5190
5191void EnumDecl::getValueRange(llvm::APInt &Max, llvm::APInt &Min) const {
5192 unsigned Bitwidth = getASTContext().getIntWidth(getIntegerType());
5193 unsigned NumNegativeBits = getNumNegativeBits();
5194 unsigned NumPositiveBits = getNumPositiveBits();
5195
5196 if (NumNegativeBits) {
5197 unsigned NumBits = std::max(NumNegativeBits, NumPositiveBits + 1);
5198 Max = llvm::APInt(Bitwidth, 1) << (NumBits - 1);
5199 Min = -Max;
5200 } else {
5201 Max = llvm::APInt(Bitwidth, 1) << NumPositiveBits;
5202 Min = llvm::APInt::getZero(Bitwidth);
5203 }
5204}
5205
5206//===----------------------------------------------------------------------===//
5207// RecordDecl Implementation
5208//===----------------------------------------------------------------------===//
5209
5211 DeclContext *DC, SourceLocation StartLoc,
5212 SourceLocation IdLoc, IdentifierInfo *Id,
5213 RecordDecl *PrevDecl)
5214 : TagDecl(DK, TK, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
5215 assert(classof(static_cast<Decl *>(this)) && "Invalid Kind!");
5218 setHasObjectMember(false);
5219 setHasVolatileMember(false);
5230 setIsRandomized(false);
5231 setODRHash(0);
5232}
5233
5235 SourceLocation StartLoc, SourceLocation IdLoc,
5236 IdentifierInfo *Id, RecordDecl* PrevDecl) {
5237 return new (C, DC)
5238 RecordDecl(Record, TK, C, DC, StartLoc, IdLoc, Id, PrevDecl);
5239}
5240
5242 GlobalDeclID ID) {
5243 return new (C, ID)
5245 SourceLocation(), nullptr, nullptr);
5246}
5247
5249 if (auto RD = dyn_cast<CXXRecordDecl>(this))
5250 return RD->isLambda();
5251 return false;
5252}
5253
5257
5259 addAttr(CapturedRecordAttr::CreateImplicit(getASTContext()));
5260}
5261
5263 if (isUnion())
5264 return true;
5265
5266 if (const RecordDecl *Def = getDefinition()) {
5267 for (const FieldDecl *FD : Def->fields()) {
5268 const RecordType *RT = FD->getType()->getAsCanonical<RecordType>();
5269 if (RT && RT->getDecl()->isOrContainsUnion())
5270 return true;
5271 }
5272 }
5273
5274 return false;
5275}
5276
5279 LoadFieldsFromExternalStorage();
5280 // This is necessary for correctness for C++ with modules.
5281 // FIXME: Come up with a test case that breaks without definition.
5282 if (RecordDecl *D = getDefinition(); D && D != this)
5283 return D->field_begin();
5285}
5286
5290
5291/// completeDefinition - Notes that the definition of this type is now
5292/// complete.
5294 assert(!isCompleteDefinition() && "Cannot redefine record!");
5296
5297 ASTContext &Ctx = getASTContext();
5298
5299 // Layouts are dumped when computed, so if we are dumping for all complete
5300 // types, we need to force usage to get types that wouldn't be used elsewhere.
5301 //
5302 // If the type is dependent, then we can't compute its layout because there
5303 // is no way for us to know the size or alignment of a dependent type. Also
5304 // ignore declarations marked as invalid since 'getASTRecordLayout()' asserts
5305 // on that.
5306 if (Ctx.getLangOpts().DumpRecordLayoutsComplete && !isDependentType() &&
5307 !isInvalidDecl())
5308 (void)Ctx.getASTRecordLayout(this);
5309}
5310
5311/// isMsStruct - Get whether or not this record uses ms_struct layout.
5312/// This which can be turned on with an attribute, pragma, or the
5313/// -mms-bitfields command-line option.
5316 return false;
5318 return true;
5319 auto LayoutCompatibility = C.getLangOpts().getLayoutCompatibility();
5320 if (LayoutCompatibility == LangOptions::LayoutCompatibilityKind::Default)
5321 return C.defaultsToMsStruct();
5322 return LayoutCompatibility == LangOptions::LayoutCompatibilityKind::Microsoft;
5323}
5324
5326 std::tie(FirstDecl, LastDecl) = DeclContext::BuildDeclChain(Decls, false);
5327 LastDecl->NextInContextAndBits.setPointer(nullptr);
5328 setIsRandomized(true);
5329}
5330
5331void RecordDecl::LoadFieldsFromExternalStorage() const {
5333 assert(hasExternalLexicalStorage() && Source && "No external storage?");
5334
5335 // Notify that we have a RecordDecl doing some initialization.
5336 ExternalASTSource::Deserializing TheFields(Source);
5337
5340 Source->FindExternalLexicalDecls(this, [](Decl::Kind K) {
5342 }, Decls);
5343
5344#ifndef NDEBUG
5345 // Check that all decls we got were FieldDecls.
5346 for (unsigned i=0, e=Decls.size(); i != e; ++i)
5347 assert(isa<FieldDecl>(Decls[i]) || isa<IndirectFieldDecl>(Decls[i]));
5348#endif
5349
5350 if (Decls.empty())
5351 return;
5352
5353 auto [ExternalFirst, ExternalLast] =
5354 BuildDeclChain(Decls,
5355 /*FieldsAlreadyLoaded=*/false);
5356 ExternalLast->NextInContextAndBits.setPointer(FirstDecl);
5357 FirstDecl = ExternalFirst;
5358 if (!LastDecl)
5359 LastDecl = ExternalLast;
5360}
5361
5362bool RecordDecl::mayInsertExtraPadding(bool EmitRemark) const {
5363 ASTContext &Context = getASTContext();
5364 const SanitizerMask EnabledAsanMask = Context.getLangOpts().Sanitize.Mask &
5365 (SanitizerKind::Address | SanitizerKind::KernelAddress);
5366 if (!EnabledAsanMask || !Context.getLangOpts().SanitizeAddressFieldPadding)
5367 return false;
5368 const auto &NoSanitizeList = Context.getNoSanitizeList();
5369 const auto *CXXRD = dyn_cast<CXXRecordDecl>(this);
5370 // We may be able to relax some of these requirements.
5371 int ReasonToReject = -1;
5372 if (!CXXRD || CXXRD->isExternCContext())
5373 ReasonToReject = 0; // is not C++.
5374 else if (CXXRD->hasAttr<PackedAttr>())
5375 ReasonToReject = 1; // is packed.
5376 else if (CXXRD->isUnion())
5377 ReasonToReject = 2; // is a union.
5378 else if (CXXRD->isTriviallyCopyable())
5379 ReasonToReject = 3; // is trivially copyable.
5380 else if (CXXRD->hasTrivialDestructor())
5381 ReasonToReject = 4; // has trivial destructor.
5382 else if (CXXRD->isStandardLayout())
5383 ReasonToReject = 5; // is standard layout.
5384 else if (NoSanitizeList.containsLocation(EnabledAsanMask, getLocation(),
5385 "field-padding"))
5386 ReasonToReject = 6; // is in an excluded file.
5388 EnabledAsanMask, getQualifiedNameAsString(), "field-padding"))
5389 ReasonToReject = 7; // The type is excluded.
5390
5391 if (EmitRemark) {
5392 if (ReasonToReject >= 0)
5393 Context.getDiagnostics().Report(
5394 getLocation(),
5395 diag::remark_sanitize_address_insert_extra_padding_rejected)
5396 << getQualifiedNameAsString() << ReasonToReject;
5397 else
5398 Context.getDiagnostics().Report(
5399 getLocation(),
5400 diag::remark_sanitize_address_insert_extra_padding_accepted)
5402 }
5403 return ReasonToReject < 0;
5404}
5405
5407 for (const auto *I : fields()) {
5408 if (I->getIdentifier())
5409 return I;
5410
5411 if (const auto *RD = I->getType()->getAsRecordDecl())
5412 if (const FieldDecl *NamedDataMember = RD->findFirstNamedDataMember())
5413 return NamedDataMember;
5414 }
5415
5416 // We didn't find a named data member.
5417 return nullptr;
5418}
5419
5421 if (hasODRHash())
5422 return RecordDeclBits.ODRHash;
5423
5424 // Only calculate hash on first call of getODRHash per record.
5425 ODRHash Hash;
5426 Hash.AddRecordDecl(this);
5427 // For RecordDecl the ODRHash is stored in the remaining
5428 // bits of RecordDeclBits, adjust the hash to accommodate.
5429 static_assert(sizeof(Hash.CalculateHash()) * CHAR_BIT == 32);
5430 setODRHash(Hash.CalculateHash() >> (32 - NumOdrHashBits));
5431 return RecordDeclBits.ODRHash;
5432}
5433
5434//===----------------------------------------------------------------------===//
5435// BlockDecl Implementation
5436//===----------------------------------------------------------------------===//
5437
5439 : Decl(Block, DC, CaretLoc), DeclContext(Block) {
5440 setIsVariadic(false);
5441 setCapturesCXXThis(false);
5444 setDoesNotEscape(false);
5445 setCanAvoidCopyToHeap(false);
5446}
5447
5449 assert(!ParamInfo && "Already has param info!");
5450
5451 // Zero params -> null pointer.
5452 if (!NewParamInfo.empty()) {
5453 NumParams = NewParamInfo.size();
5454 ParamInfo = new (getASTContext()) ParmVarDecl*[NewParamInfo.size()];
5455 llvm::copy(NewParamInfo, ParamInfo);
5456 }
5457}
5458
5460 bool CapturesCXXThis) {
5461 this->setCapturesCXXThis(CapturesCXXThis);
5462 this->NumCaptures = Captures.size();
5463
5464 if (Captures.empty()) {
5465 this->Captures = nullptr;
5466 return;
5467 }
5468
5469 this->Captures = Captures.copy(Context).data();
5470}
5471
5472bool BlockDecl::capturesVariable(const VarDecl *variable) const {
5473 for (const auto &I : captures())
5474 // Only auto vars can be captured, so no redeclaration worries.
5475 if (I.getVariable() == variable)
5476 return true;
5477
5478 return false;
5479}
5480
5482 return SourceRange(getLocation(), Body ? Body->getEndLoc() : getLocation());
5483}
5484
5485//===----------------------------------------------------------------------===//
5486// Other Decl Allocation/Deallocation Method Implementations
5487//===----------------------------------------------------------------------===//
5488
5489void TranslationUnitDecl::anchor() {}
5490
5492 return new (C, (DeclContext *)nullptr) TranslationUnitDecl(C);
5493}
5494
5496 AnonymousNamespace = D;
5497
5498 if (ASTMutationListener *Listener = Ctx.getASTMutationListener())
5499 Listener->AddedAnonymousNamespace(this, D);
5500}
5501
5502void PragmaCommentDecl::anchor() {}
5503
5504PragmaCommentDecl *PragmaCommentDecl::Create(const ASTContext &C,
5506 SourceLocation CommentLoc,
5507 PragmaMSCommentKind CommentKind,
5508 StringRef Arg) {
5509 PragmaCommentDecl *PCD =
5510 new (C, DC, additionalSizeToAlloc<char>(Arg.size() + 1))
5511 PragmaCommentDecl(DC, CommentLoc, CommentKind);
5512 llvm::copy(Arg, PCD->getTrailingObjects());
5513 PCD->getTrailingObjects()[Arg.size()] = '\0';
5514 return PCD;
5515}
5516
5518 GlobalDeclID ID,
5519 unsigned ArgSize) {
5520 return new (C, ID, additionalSizeToAlloc<char>(ArgSize + 1))
5521 PragmaCommentDecl(nullptr, SourceLocation(), PCK_Unknown);
5522}
5523
5524void PragmaDetectMismatchDecl::anchor() {}
5525
5528 SourceLocation Loc, StringRef Name,
5529 StringRef Value) {
5530 size_t ValueStart = Name.size() + 1;
5531 PragmaDetectMismatchDecl *PDMD =
5532 new (C, DC, additionalSizeToAlloc<char>(ValueStart + Value.size() + 1))
5533 PragmaDetectMismatchDecl(DC, Loc, ValueStart);
5534 llvm::copy(Name, PDMD->getTrailingObjects());
5535 PDMD->getTrailingObjects()[Name.size()] = '\0';
5536 llvm::copy(Value, PDMD->getTrailingObjects() + ValueStart);
5537 PDMD->getTrailingObjects()[ValueStart + Value.size()] = '\0';
5538 return PDMD;
5539}
5540
5543 unsigned NameValueSize) {
5544 return new (C, ID, additionalSizeToAlloc<char>(NameValueSize + 1))
5545 PragmaDetectMismatchDecl(nullptr, SourceLocation(), 0);
5546}
5547
5548void ExternCContextDecl::anchor() {}
5549
5550ExternCContextDecl *ExternCContextDecl::Create(const ASTContext &C,
5551 TranslationUnitDecl *DC) {
5552 return new (C, DC) ExternCContextDecl(DC);
5553}
5554
5555void LabelDecl::anchor() {}
5556
5558 SourceLocation IdentL, IdentifierInfo *II) {
5559 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, IdentL);
5560}
5561
5563 SourceLocation IdentL, IdentifierInfo *II,
5564 SourceLocation GnuLabelL) {
5565 assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
5566 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, GnuLabelL);
5567}
5568
5570 return new (C, ID) LabelDecl(nullptr, SourceLocation(), nullptr, nullptr,
5571 SourceLocation());
5572}
5573
5574void LabelDecl::setMSAsmLabel(StringRef Name) {
5575char *Buffer = new (getASTContext(), 1) char[Name.size() + 1];
5576llvm::copy(Name, Buffer);
5577Buffer[Name.size()] = '\0';
5578MSAsmName = Buffer;
5579}
5580
5581void ValueDecl::anchor() {}
5582
5583bool ValueDecl::isWeak() const {
5584 auto *MostRecent = getMostRecentDecl();
5585 return MostRecent->hasAttr<WeakAttr>() ||
5586 MostRecent->hasAttr<WeakRefAttr>() || isWeakImported();
5587}
5588
5590 if (auto *Var = llvm::dyn_cast<VarDecl>(this))
5591 return Var->isInitCapture();
5592 return false;
5593}
5594
5596 if (const auto *NTTP = dyn_cast<NonTypeTemplateParmDecl>(this))
5597 return NTTP->isParameterPack();
5598
5599 return isa_and_nonnull<PackExpansionType>(getType().getTypePtrOrNull());
5600}
5601
5602void ImplicitParamDecl::anchor() {}
5603
5605 SourceLocation IdLoc,
5607 ImplicitParamKind ParamKind) {
5608 return new (C, DC) ImplicitParamDecl(C, DC, IdLoc, Id, Type, ParamKind);
5609}
5610
5612 ImplicitParamKind ParamKind) {
5613 return new (C, nullptr) ImplicitParamDecl(C, Type, ParamKind);
5614}
5615
5620
5623 const DeclarationNameInfo &NameInfo, QualType T,
5624 TypeSourceInfo *TInfo, StorageClass SC, bool UsesFPIntrin,
5626 ConstexprSpecKind ConstexprKind,
5627 const AssociatedConstraint &TrailingRequiresClause) {
5628 FunctionDecl *New = new (C, DC) FunctionDecl(
5629 Function, C, DC, StartLoc, NameInfo, T, TInfo, SC, UsesFPIntrin,
5630 isInlineSpecified, ConstexprKind, TrailingRequiresClause);
5631 New->setHasWrittenPrototype(hasWrittenPrototype);
5632 return New;
5633}
5634
5636 return new (C, ID) FunctionDecl(
5638 nullptr, SC_None, false, false, ConstexprSpecKind::Unspecified,
5639 /*TrailingRequiresClause=*/{});
5640}
5641
5643 return hasAttr<CUDAGlobalAttr>() ||
5644 DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>());
5645}
5646
5648 return new (C, DC) BlockDecl(DC, L);
5649}
5650
5654
5655OutlinedFunctionDecl::OutlinedFunctionDecl(DeclContext *DC, unsigned NumParams)
5656 : Decl(OutlinedFunction, DC, SourceLocation()),
5657 DeclContext(OutlinedFunction), NumParams(NumParams),
5658 BodyAndNothrow(nullptr, false) {}
5659
5661 DeclContext *DC,
5662 unsigned NumParams) {
5663 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5664 OutlinedFunctionDecl(DC, NumParams);
5665}
5666
5669 unsigned NumParams) {
5670 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5671 OutlinedFunctionDecl(nullptr, NumParams);
5672}
5673
5675 return BodyAndNothrow.getPointer();
5676}
5677void OutlinedFunctionDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5678
5679bool OutlinedFunctionDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5681 BodyAndNothrow.setInt(Nothrow);
5682}
5683
5684CapturedDecl::CapturedDecl(DeclContext *DC, unsigned NumParams)
5685 : Decl(Captured, DC, SourceLocation()), DeclContext(Captured),
5686 NumParams(NumParams), ContextParam(0), BodyAndNothrow(nullptr, false) {}
5687
5689 unsigned NumParams) {
5690 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5691 CapturedDecl(DC, NumParams);
5692}
5693
5695 unsigned NumParams) {
5696 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5697 CapturedDecl(nullptr, NumParams);
5698}
5699
5700Stmt *CapturedDecl::getBody() const { return BodyAndNothrow.getPointer(); }
5701void CapturedDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5702
5703bool CapturedDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5704void CapturedDecl::setNothrow(bool Nothrow) { BodyAndNothrow.setInt(Nothrow); }
5705
5708 QualType T, Expr *E, const llvm::APSInt &V)
5709 : ValueDecl(EnumConstant, DC, L, Id, T), Init((Stmt *)E) {
5710 setInitVal(C, V);
5711}
5712
5715 IdentifierInfo *Id, QualType T,
5716 Expr *E, const llvm::APSInt &V) {
5717 return new (C, CD) EnumConstantDecl(C, CD, L, Id, T, E, V);
5718}
5719
5721 GlobalDeclID ID) {
5722 return new (C, ID) EnumConstantDecl(C, nullptr, SourceLocation(), nullptr,
5723 QualType(), nullptr, llvm::APSInt());
5724}
5725
5726void IndirectFieldDecl::anchor() {}
5727
5728IndirectFieldDecl::IndirectFieldDecl(ASTContext &C, DeclContext *DC,
5730 QualType T,
5732 : ValueDecl(IndirectField, DC, L, N, T), Chaining(CH.data()),
5733 ChainingSize(CH.size()) {
5734 // In C++, indirect field declarations conflict with tag declarations in the
5735 // same scope, so add them to IDNS_Tag so that tag redeclaration finds them.
5736 if (C.getLangOpts().CPlusPlus)
5738}
5739
5742 const IdentifierInfo *Id,
5743 QualType T,
5745 return new (C, DC) IndirectFieldDecl(C, DC, L, Id, T, CH);
5746}
5747
5749 GlobalDeclID ID) {
5750 return new (C, ID) IndirectFieldDecl(C, nullptr, SourceLocation(),
5751 DeclarationName(), QualType(), {});
5752}
5753
5756 if (Init)
5757 End = Init->getEndLoc();
5758 return SourceRange(getLocation(), End);
5759}
5760
5761void TypeDecl::anchor() {}
5762
5764 SourceLocation StartLoc, SourceLocation IdLoc,
5765 const IdentifierInfo *Id,
5766 TypeSourceInfo *TInfo) {
5767 return new (C, DC) TypedefDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5768}
5769
5770void TypedefNameDecl::anchor() {}
5771
5773 if (auto *TT = getTypeSourceInfo()->getType()->getAs<TagType>()) {
5774 auto *OwningTypedef = TT->getDecl()->getTypedefNameForAnonDecl();
5775 auto *ThisTypedef = this;
5776 if (AnyRedecl && OwningTypedef) {
5777 OwningTypedef = OwningTypedef->getCanonicalDecl();
5778 ThisTypedef = ThisTypedef->getCanonicalDecl();
5779 }
5780 if (OwningTypedef == ThisTypedef)
5781 return TT->getDecl()->getDefinitionOrSelf();
5782 }
5783
5784 return nullptr;
5785}
5786
5787bool TypedefNameDecl::isTransparentTagSlow() const {
5788 auto determineIsTransparent = [&]() {
5789 if (auto *TT = getUnderlyingType()->getAs<TagType>()) {
5790 if (auto *TD = TT->getDecl()) {
5791 if (TD->getName() != getName())
5792 return false;
5793 SourceLocation TTLoc = getLocation();
5794 SourceLocation TDLoc = TD->getLocation();
5795 if (!TTLoc.isMacroID() || !TDLoc.isMacroID())
5796 return false;
5798 return SM.getSpellingLoc(TTLoc) == SM.getSpellingLoc(TDLoc);
5799 }
5800 }
5801 return false;
5802 };
5803
5804 bool isTransparent = determineIsTransparent();
5805 MaybeModedTInfo.setInt((isTransparent << 1) | 1);
5806 return isTransparent;
5807}
5808
5810 return new (C, ID) TypedefDecl(C, nullptr, SourceLocation(), SourceLocation(),
5811 nullptr, nullptr);
5812}
5813
5815 SourceLocation StartLoc,
5816 SourceLocation IdLoc,
5817 const IdentifierInfo *Id,
5818 TypeSourceInfo *TInfo) {
5819 return new (C, DC) TypeAliasDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5820}
5821
5823 GlobalDeclID ID) {
5824 return new (C, ID) TypeAliasDecl(C, nullptr, SourceLocation(),
5825 SourceLocation(), nullptr, nullptr);
5826}
5827
5829 SourceLocation RangeEnd = getLocation();
5830 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
5831 if (typeIsPostfix(TInfo->getType()))
5832 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5833 }
5834 return SourceRange(getBeginLoc(), RangeEnd);
5835}
5836
5838 SourceLocation RangeEnd = getBeginLoc();
5839 if (TypeSourceInfo *TInfo = getTypeSourceInfo())
5840 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5841 return SourceRange(getBeginLoc(), RangeEnd);
5842}
5843
5844void FileScopeAsmDecl::anchor() {}
5845
5847 Expr *Str, SourceLocation AsmLoc,
5848 SourceLocation RParenLoc) {
5849 return new (C, DC) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);
5850}
5851
5853 GlobalDeclID ID) {
5854 return new (C, ID) FileScopeAsmDecl(nullptr, nullptr, SourceLocation(),
5855 SourceLocation());
5856}
5857
5861
5862void TopLevelStmtDecl::anchor() {}
5863
5864TopLevelStmtDecl *TopLevelStmtDecl::Create(ASTContext &C, Stmt *Statement) {
5865 assert(C.getLangOpts().IncrementalExtensions &&
5866 "Must be used only in incremental mode");
5867
5868 SourceLocation Loc = Statement ? Statement->getBeginLoc() : SourceLocation();
5869 DeclContext *DC = C.getTranslationUnitDecl();
5870
5871 return new (C, DC) TopLevelStmtDecl(DC, Loc, Statement);
5872}
5873
5875 GlobalDeclID ID) {
5876 return new (C, ID)
5877 TopLevelStmtDecl(/*DC=*/nullptr, SourceLocation(), /*S=*/nullptr);
5878}
5879
5881 return SourceRange(getLocation(), Statement->getEndLoc());
5882}
5883
5885 assert(S);
5886 Statement = S;
5887 setLocation(Statement->getBeginLoc());
5888}
5889
5890void EmptyDecl::anchor() {}
5891
5893 return new (C, DC) EmptyDecl(DC, L);
5894}
5895
5897 return new (C, ID) EmptyDecl(nullptr, SourceLocation());
5898}
5899
5900HLSLBufferDecl::HLSLBufferDecl(DeclContext *DC, bool CBuffer,
5901 SourceLocation KwLoc, IdentifierInfo *ID,
5902 SourceLocation IDLoc, SourceLocation LBrace)
5903 : NamedDecl(Decl::Kind::HLSLBuffer, DC, IDLoc, DeclarationName(ID)),
5904 DeclContext(Decl::Kind::HLSLBuffer), LBraceLoc(LBrace), KwLoc(KwLoc),
5905 IsCBuffer(CBuffer), HasValidPackoffset(false), LayoutStruct(nullptr) {}
5906
5908 DeclContext *LexicalParent, bool CBuffer,
5909 SourceLocation KwLoc, IdentifierInfo *ID,
5910 SourceLocation IDLoc,
5911 SourceLocation LBrace) {
5912 // For hlsl like this
5913 // cbuffer A {
5914 // cbuffer B {
5915 // }
5916 // }
5917 // compiler should treat it as
5918 // cbuffer A {
5919 // }
5920 // cbuffer B {
5921 // }
5922 // FIXME: support nested buffers if required for back-compat.
5923 DeclContext *DC = LexicalParent;
5924 HLSLBufferDecl *Result =
5925 new (C, DC) HLSLBufferDecl(DC, CBuffer, KwLoc, ID, IDLoc, LBrace);
5926 return Result;
5927}
5928
5931 ArrayRef<Decl *> DefaultCBufferDecls) {
5932 DeclContext *DC = LexicalParent;
5933 IdentifierInfo *II = &C.Idents.get("$Globals", tok::TokenKind::identifier);
5934 HLSLBufferDecl *Result = new (C, DC) HLSLBufferDecl(
5935 DC, true, SourceLocation(), II, SourceLocation(), SourceLocation());
5936 Result->setImplicit(true);
5937 Result->setDefaultBufferDecls(DefaultCBufferDecls);
5938 return Result;
5939}
5940
5942 GlobalDeclID ID) {
5943 return new (C, ID) HLSLBufferDecl(nullptr, false, SourceLocation(), nullptr,
5945}
5946
5948 assert(LayoutStruct == nullptr && "layout struct has already been set");
5949 LayoutStruct = LS;
5950 addDecl(LS);
5951}
5952
5953void HLSLBufferDecl::setDefaultBufferDecls(ArrayRef<Decl *> Decls) {
5954 assert(!Decls.empty());
5955 assert(DefaultBufferDecls.empty() && "default decls are already set");
5956 assert(isImplicit() &&
5957 "default decls can only be added to the implicit/default constant "
5958 "buffer $Globals");
5959
5960 // allocate array for default decls with ASTContext allocator
5961 Decl **DeclsArray = new (getASTContext()) Decl *[Decls.size()];
5962 llvm::copy(Decls, DeclsArray);
5963 DefaultBufferDecls = ArrayRef<Decl *>(DeclsArray, Decls.size());
5964}
5965
5968 return buffer_decl_iterator(llvm::iterator_range(DefaultBufferDecls.begin(),
5969 DefaultBufferDecls.end()),
5971}
5972
5974 return buffer_decl_iterator(
5975 llvm::iterator_range(DefaultBufferDecls.end(), DefaultBufferDecls.end()),
5977}
5978
5980 return DefaultBufferDecls.empty() && decls_empty();
5981}
5982
5983//===----------------------------------------------------------------------===//
5984// HLSLRootSignatureDecl Implementation
5985//===----------------------------------------------------------------------===//
5986
5987HLSLRootSignatureDecl::HLSLRootSignatureDecl(
5989 llvm::dxbc::RootSignatureVersion Version, unsigned NumElems)
5990 : NamedDecl(Decl::Kind::HLSLRootSignature, DC, Loc, DeclarationName(ID)),
5991 Version(Version), NumElems(NumElems) {}
5992
5993HLSLRootSignatureDecl *HLSLRootSignatureDecl::Create(
5995 llvm::dxbc::RootSignatureVersion Version,
5997 HLSLRootSignatureDecl *RSDecl =
5998 new (C, DC,
5999 additionalSizeToAlloc<llvm::hlsl::rootsig::RootElement>(
6000 RootElements.size()))
6001 HLSLRootSignatureDecl(DC, Loc, ID, Version, RootElements.size());
6002 auto *StoredElems = RSDecl->getElems();
6003 llvm::uninitialized_copy(RootElements, StoredElems);
6004 return RSDecl;
6005}
6006
6009 HLSLRootSignatureDecl *Result = new (C, ID)
6010 HLSLRootSignatureDecl(nullptr, SourceLocation(), nullptr,
6011 /*Version*/ llvm::dxbc::RootSignatureVersion::V1_1,
6012 /*NumElems=*/0);
6013 return Result;
6014}
6015
6016//===----------------------------------------------------------------------===//
6017// ImportDecl Implementation
6018//===----------------------------------------------------------------------===//
6019
6020/// Retrieve the number of module identifiers needed to name the given
6021/// module.
6022static unsigned getNumModuleIdentifiers(Module *Mod) {
6023 unsigned Result = 1;
6024 while (Mod->Parent) {
6025 Mod = Mod->Parent;
6026 ++Result;
6027 }
6028 return Result;
6029}
6030
6031ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
6032 Module *Imported,
6033 ArrayRef<SourceLocation> IdentifierLocs)
6034 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
6035 NextLocalImportAndComplete(nullptr, true) {
6036 assert(getNumModuleIdentifiers(Imported) == IdentifierLocs.size());
6037 auto *StoredLocs = getTrailingObjects();
6038 llvm::uninitialized_copy(IdentifierLocs, StoredLocs);
6039}
6040
6041ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
6042 Module *Imported, SourceLocation EndLoc)
6043 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
6044 NextLocalImportAndComplete(nullptr, false) {
6045 *getTrailingObjects() = EndLoc;
6046}
6047
6049 SourceLocation StartLoc, Module *Imported,
6050 ArrayRef<SourceLocation> IdentifierLocs) {
6051 return new (C, DC,
6052 additionalSizeToAlloc<SourceLocation>(IdentifierLocs.size()))
6053 ImportDecl(DC, StartLoc, Imported, IdentifierLocs);
6054}
6055
6057 SourceLocation StartLoc,
6058 Module *Imported,
6059 SourceLocation EndLoc) {
6060 ImportDecl *Import = new (C, DC, additionalSizeToAlloc<SourceLocation>(1))
6061 ImportDecl(DC, StartLoc, Imported, EndLoc);
6062 Import->setImplicit();
6063 return Import;
6064}
6065
6067 unsigned NumLocations) {
6068 return new (C, ID, additionalSizeToAlloc<SourceLocation>(NumLocations))
6069 ImportDecl(EmptyShell());
6070}
6071
6073 if (!isImportComplete())
6074 return {};
6075
6076 return getTrailingObjects(getNumModuleIdentifiers(getImportedModule()));
6077}
6078
6080 if (!isImportComplete())
6081 return SourceRange(getLocation(), *getTrailingObjects());
6082
6083 return SourceRange(getLocation(), getIdentifierLocs().back());
6084}
6085
6086//===----------------------------------------------------------------------===//
6087// ExportDecl Implementation
6088//===----------------------------------------------------------------------===//
6089
6090void ExportDecl::anchor() {}
6091
6093 SourceLocation ExportLoc) {
6094 return new (C, DC) ExportDecl(DC, ExportLoc);
6095}
6096
6098 return new (C, ID) ExportDecl(nullptr, SourceLocation());
6099}
6100
6102 bool IncludeLocallyStreaming) {
6103 if (IncludeLocallyStreaming)
6104 if (FD->hasAttr<ArmLocallyStreamingAttr>())
6105 return true;
6106
6107 assert(!FD->getType().isNull() && "Expected a valid FunctionDecl");
6108 if (const auto *FPT = FD->getType()->getAs<FunctionProtoType>())
6109 if (FPT->getAArch64SMEAttributes() & FunctionType::SME_PStateSMEnabledMask)
6110 return true;
6111
6112 return false;
6113}
6114
6116 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6117 return (T && FunctionType::getArmZAState(T->getAArch64SMEAttributes()) !=
6119 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZA());
6120}
6121
6123 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6124 return (T && FunctionType::getArmZT0State(T->getAArch64SMEAttributes()) !=
6126 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZT0());
6127}
Defines the clang::ASTContext interface.
#define V(N, I)
This file provides some common utility functions for processing Lambda related AST Constructs.
Defines enum values for all the target-independent builtin functions.
Defines the C++ Decl subclasses, other than those for templates (found in DeclTemplate....
Defines the C++ template declaration subclasses.
static bool isFirstInExternCContext(T *D)
Definition Decl.cpp:574
static bool isRedeclarableImpl(Redeclarable< T > *)
Definition Decl.cpp:1856
static bool isDeclExternC(const T &D)
Definition Decl.cpp:2242
static bool hasExplicitVisibilityAlready(LVComputationKind computation)
Does this computation kind permit us to consider additional visibility settings from attributes and t...
Definition Decl.cpp:159
static bool RedeclForcesDefC99(const FunctionDecl *Redecl)
Definition Decl.cpp:3921
static bool isExportedFromModuleInterfaceUnit(const NamedDecl *D)
Definition Decl.cpp:1190
static bool isRedeclarable(Decl::Kind K)
Definition Decl.cpp:1860
static bool redeclForcesDefMSVC(const FunctionDecl *Redecl)
Definition Decl.cpp:3909
static bool usesTypeVisibility(const NamedDecl *D)
Is the given declaration a "type" or a "value" for the purposes of visibility computation?
Definition Decl.cpp:180
static std::optional< Visibility > getVisibilityOf(const NamedDecl *D, NamedDecl::ExplicitVisibilityKind kind)
Return the explicit visibility of the given declaration.
Definition Decl.cpp:222
static LanguageLinkage getDeclLanguageLinkage(const T &D)
Definition Decl.cpp:2215
static LVComputationKind withExplicitVisibilityAlready(LVComputationKind Kind)
Given an LVComputationKind, return one of the same type/value sort that records that it already has e...
Definition Decl.cpp:166
static std::enable_if_t<!std::is_base_of_v< RedeclarableTemplateDecl, T >, bool > isExplicitMemberSpecialization(const T *D)
Does the given declaration have member specialization information, and if so, is it an explicit speci...
Definition Decl.cpp:190
static unsigned getNumModuleIdentifiers(Module *Mod)
Retrieve the number of module identifiers needed to name the given module.
Definition Decl.cpp:6022
static bool isSingleLineLanguageLinkage(const Decl &D)
Definition Decl.cpp:579
static bool useInlineVisibilityHidden(const NamedDecl *D)
Definition Decl.cpp:546
static bool shouldConsiderTemplateVisibility(const FunctionDecl *fn, const FunctionTemplateSpecializationInfo *specInfo)
Definition Decl.cpp:373
static bool hasDirectVisibilityAttribute(const NamedDecl *D, LVComputationKind computation)
Does the given declaration have a direct visibility attribute that would match the given rules?
Definition Decl.cpp:419
static DeclT * getDefinitionOrSelf(DeclT *D)
Definition Decl.cpp:2704
static Visibility getVisibilityFromAttr(const T *attr)
Given a visibility attribute, return the explicit visibility associated with it.
Definition Decl.cpp:208
static const Decl * getOutermostFuncOrBlockContext(const Decl *D)
Definition Decl.cpp:302
static bool typeIsPostfix(QualType QT)
Definition Decl.cpp:2069
static LinkageInfo getExternalLinkageFor(const NamedDecl *D)
Definition Decl.cpp:586
static StorageClass getStorageClass(const Decl *D)
Definition Decl.cpp:590
static std::optional< Visibility > getExplicitVisibilityAux(const NamedDecl *ND, NamedDecl::ExplicitVisibilityKind kind, bool IsMostRecent)
Definition Decl.cpp:1232
static SourceLocation getTemplateOrInnerLocStart(const DeclT *decl)
Definition Decl.cpp:1995
static bool isNamed(const NamedDecl *ND, const char(&Str)[Len])
Definition Decl.cpp:3308
static std::optional< Visibility > getExplicitVisibility(const NamedDecl *D, LVComputationKind kind)
Definition Decl.cpp:171
static bool hasDefinition(const ObjCObjectPointerType *ObjPtr)
Defines the clang::Expr interface and subclasses for C++ expressions.
TokenType getType() const
Returns the token's type, e.g.
Defines the clang::IdentifierInfo, clang::IdentifierTable, and clang::Selector interfaces.
Forward-declares and imports various common LLVM datatypes that clang wants to use unqualified.
Defines the clang::LangOptions interface.
llvm::MachO::Record Record
Definition MachO.h:31
Defines the clang::Module class, which describes a module in the source code.
This file contains the declaration of the ODRHash class, which calculates a hash based on AST nodes,...
#define SM(sm)
*collection of selector each with an associated kind and an ordered *collection of selectors A selector has a kind
Implements a partial diagnostic that can be emitted anwyhere in a DiagnosticBuilder stream.
Defines the clang::SanitizerKind enum.
static bool hasAttr(const Decl *D, bool IgnoreImplicitAttr)
Definition SemaCUDA.cpp:187
Defines the clang::SourceLocation class and associated facilities.
Defines the SourceManager interface.
Defines various enumerations that describe declaration and type specifiers.
Defines the TargetCXXABI class, which abstracts details of the C++ ABI that we're targeting.
Defines the clang::TypeLoc interface and its subclasses.
C Language Family Type Representation.
static const TypeInfo & getInfo(unsigned id)
Definition Types.cpp:44
Defines the clang::Visibility enumeration and various utility functions.
APValue - This class implements a discriminated union of [uninitialized] [APSInt] [APFloat],...
Definition APValue.h:122
bool isAbsent() const
Definition APValue.h:481
bool needsCleanup() const
Returns whether the object performed allocations.
Definition APValue.cpp:444
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition ASTContext.h:226
SourceManager & getSourceManager()
Definition ASTContext.h:859
const ConstantArrayType * getAsConstantArrayType(QualType T) const
unsigned getIntWidth(QualType T) const
void setTemplateOrSpecializationInfo(VarDecl *Inst, TemplateOrSpecializationInfo TSI)
bool isTypeAwareOperatorNewOrDelete(const FunctionDecl *FD) const
const ASTRecordLayout & getASTRecordLayout(const RecordDecl *D) const
Get or compute information about the layout of the specified record (struct/union/class) D,...
void setIsTypeAwareOperatorNewOrDelete(const FunctionDecl *FD, bool IsTypeAware)
void Deallocate(void *Ptr) const
Definition ASTContext.h:878
const LangOptions & getLangOpts() const
Definition ASTContext.h:952
void setParameterIndex(const ParmVarDecl *D, unsigned index)
Used by ParmVarDecl to store on the side the index of the parameter when it exceeds the size of the n...
Decl * getPrimaryMergedDecl(Decl *D)
bool isDestroyingOperatorDelete(const FunctionDecl *FD) const
CharUnits getTypeSizeInChars(QualType T) const
Return the size of the specified (complete) type T, in characters.
void setInstantiatedFromStaticDataMember(VarDecl *Inst, VarDecl *Tmpl, TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
Note that the static data member Inst is an instantiation of the static data member template Tmpl of ...
static bool hasSameType(QualType T1, QualType T2)
Determine whether the given types T1 and T2 are equivalent.
QualType getSizeType() const
Return the unique type for "size_t" (C99 7.17), defined in <stddef.h>.
const TargetInfo & getTargetInfo() const
Definition ASTContext.h:917
CharUnits toCharUnitsFromBits(int64_t BitSize) const
Convert a size in bits to a size in characters.
void addDestruction(T *Ptr) const
If T isn't trivially destructible, calls AddDeallocation to register it for destruction.
ExternalASTSource * getExternalSource() const
Retrieve a pointer to the external AST source associated with this AST context, if any.
unsigned getParameterIndex(const ParmVarDecl *D) const
Used by ParmVarDecl to retrieve on the side the index of the parameter when it exceeds the size of th...
void setIsDestroyingOperatorDelete(const FunctionDecl *FD, bool IsDestroying)
An abstract interface that should be implemented by listeners that want to be notified when an AST en...
ASTRecordLayout - This class contains layout information for one RecordDecl, which is a struct/union/...
CharUnits getSize() const
getSize - Get the record size in characters.
unsigned getFieldCount() const
getFieldCount - Get the number of fields in the layout.
uint64_t getFieldOffset(unsigned FieldNo) const
getFieldOffset - Get the offset of the given field index, in bits.
Type source information for an attributed type.
Definition TypeLoc.h:1008
BlockDecl(DeclContext *DC, SourceLocation CaretLoc)
Definition Decl.cpp:5438
void setParams(ArrayRef< ParmVarDecl * > NewParamInfo)
Definition Decl.cpp:5448
void setDoesNotEscape(bool B=true)
Definition Decl.h:4841
void setCapturesCXXThis(bool B=true)
Definition Decl.h:4822
void setCanAvoidCopyToHeap(bool B=true)
Definition Decl.h:4846
void setIsConversionFromLambda(bool val=true)
Definition Decl.h:4836
void setBlockMissingReturnType(bool val=true)
Definition Decl.h:4828
ArrayRef< Capture > captures() const
Definition Decl.h:4816
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5481
static BlockDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5651
void setIsVariadic(bool value)
Definition Decl.h:4765
bool capturesVariable(const VarDecl *var) const
Definition Decl.cpp:5472
void setCaptures(ASTContext &Context, ArrayRef< Capture > Captures, bool CapturesCXXThis)
Definition Decl.cpp:5459
static BlockDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5647
Represents a C++ struct/union/class.
Definition DeclCXX.h:258
CXXRecordDecl * getInstantiatedFromMemberClass() const
If this record is an instantiation of a member class, retrieves the member class from which it was in...
Definition DeclCXX.cpp:2030
void setBody(Stmt *B)
Definition Decl.cpp:5701
static CapturedDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5694
bool isNothrow() const
Definition Decl.cpp:5703
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5704
static CapturedDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5688
Stmt * getBody() const override
getBody - If this Decl represents a declaration for a body of code, such as a function or method defi...
Definition Decl.cpp:5700
CharUnits - This is an opaque type for sizes expressed in character units.
Definition CharUnits.h:38
static CharUnits Zero()
Zero - Construct a CharUnits quantity of zero.
Definition CharUnits.h:53
CXXRecordDecl * getTemplatedDecl() const
Get the underlying class declarations of the template.
Represents a class template specialization, which refers to a class template with a given set of temp...
ClassTemplateDecl * getSpecializedTemplate() const
Retrieve the template that this specialization specializes.
const TemplateArgumentList & getTemplateArgs() const
Retrieve the template arguments of the class template specialization.
bool isExplicitInstantiationOrSpecialization() const
True if this declaration is an explicit specialization, explicit instantiation declaration,...
bool isZeroSize() const
Return true if the size is zero.
Definition TypeBase.h:3880
Represents a sugar type with __counted_by or __sized_by annotations, including their _or_null variant...
Definition TypeBase.h:3486
A POD class for pairing a NamedDecl* with an access specifier.
decl_iterator - Iterates through the declarations stored within this context.
Definition DeclBase.h:2343
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition DeclBase.h:1462
DeclContext * getParent()
getParent - Returns the containing DeclContext.
Definition DeclBase.h:2122
bool Equals(const DeclContext *DC) const
Determine whether this declaration context is equivalent to the declaration context DC.
Definition DeclBase.h:2251
FunctionDeclBitfields FunctionDeclBits
Definition DeclBase.h:2057
bool isFileContext() const
Definition DeclBase.h:2193
static std::pair< Decl *, Decl * > BuildDeclChain(ArrayRef< Decl * > Decls, bool FieldsAlreadyLoaded)
Build up a chain of declarations.
bool isTransparentContext() const
isTransparentContext - Determines whether this context is a "transparent" context,...
TagDeclBitfields TagDeclBits
Definition DeclBase.h:2053
bool isExternCXXContext() const
Determines whether this context or some of its ancestors is a linkage specification context that spec...
bool isNamespace() const
Definition DeclBase.h:2211
bool isTranslationUnit() const
Definition DeclBase.h:2198
bool isRecord() const
Definition DeclBase.h:2202
DeclContext * getRedeclContext()
getRedeclContext - Retrieve the context in which an entity conflicts with other entities of the same ...
RecordDeclBitfields RecordDeclBits
Definition DeclBase.h:2055
Decl * FirstDecl
FirstDecl - The first declaration stored within this declaration context.
Definition DeclBase.h:2092
DeclContext(Decl::Kind K)
void addDecl(Decl *D)
Add the declaration D into this context.
llvm::iterator_range< decl_iterator > decl_range
Definition DeclBase.h:2382
decl_iterator decls_end() const
Definition DeclBase.h:2388
bool hasExternalLexicalStorage() const
Whether this DeclContext has external storage containing additional declarations that are lexically i...
Definition DeclBase.h:2701
Decl * LastDecl
LastDecl - The last declaration stored within this declaration context.
Definition DeclBase.h:2098
bool decls_empty() const
bool isInlineNamespace() const
bool isFunctionOrMethod() const
Definition DeclBase.h:2174
bool isExternCContext() const
Determines whether this context or some of its ancestors is a linkage specification context that spec...
Decl::Kind getDeclKind() const
Definition DeclBase.h:2115
decl_iterator decls_begin() const
Decl - This represents one declaration (or definition), e.g.
Definition DeclBase.h:86
Decl()=delete
Decl * getPreviousDecl()
Retrieve the previous declaration that declares the same entity as this declaration,...
Definition DeclBase.h:1074
bool isInStdNamespace() const
Definition DeclBase.cpp:450
SourceLocation getEndLoc() const LLVM_READONLY
Definition DeclBase.h:443
FriendObjectKind getFriendObjectKind() const
Determines whether this declaration is the object of a friend declaration and, if so,...
Definition DeclBase.h:1239
T * getAttr() const
Definition DeclBase.h:581
ASTContext & getASTContext() const LLVM_READONLY
Definition DeclBase.cpp:547
void addAttr(Attr *A)
bool isImplicit() const
isImplicit - Indicates whether the declaration was implicitly generated by the implementation.
Definition DeclBase.h:601
bool isInNamedModule() const
Whether this declaration comes from a named module.
virtual bool isOutOfLine() const
Determine whether this declaration is declared out of line (outside its semantic context).
Definition Decl.cpp:99
bool isWeakImported() const
Determine whether this is a weak-imported symbol.
Definition DeclBase.cpp:871
ModuleOwnershipKind getModuleOwnershipKind() const
Get the kind of module ownership for this declaration.
Definition DeclBase.h:889
ASTMutationListener * getASTMutationListener() const
Definition DeclBase.cpp:557
bool hasCachedLinkage() const
Definition DeclBase.h:429
Kind
Lists the kind of concrete classes of Decl.
Definition DeclBase.h:89
@ FOK_None
Not a friend object.
Definition DeclBase.h:1230
bool isCanonicalDecl() const
Whether this particular Decl is a canonical one.
Definition DeclBase.h:997
Module * getOwningModule() const
Get the module that owns this declaration (for visibility purposes).
Definition DeclBase.h:850
FunctionDecl * getAsFunction() LLVM_READONLY
Returns the function itself, or the templated function if this is a function template.
Definition DeclBase.cpp:273
bool isFromASTFile() const
Determine whether this declaration came from an AST file (such as a precompiled header or module) rat...
Definition DeclBase.h:801
Linkage getCachedLinkage() const
Definition DeclBase.h:421
bool isTemplateParameter() const
isTemplateParameter - Determines whether this declaration is a template parameter.
Definition DeclBase.h:2806
bool isInvalidDecl() const
Definition DeclBase.h:596
bool hasDefiningAttr() const
Return true if this declaration has an attribute which acts as definition of the entity,...
Definition DeclBase.cpp:634
llvm::iterator_range< specific_attr_iterator< T > > specific_attrs() const
Definition DeclBase.h:567
SourceLocation getLocation() const
Definition DeclBase.h:447
IdentifierNamespace
IdentifierNamespace - The different namespaces in which declarations may appear.
Definition DeclBase.h:115
@ IDNS_Tag
Tags, declared with 'struct foo;' and referenced with 'struct foo'.
Definition DeclBase.h:125
redecl_range redecls() const
Returns an iterator range for all the redeclarations of the same decl.
Definition DeclBase.h:1062
void setLocation(SourceLocation L)
Definition DeclBase.h:448
friend class LinkageComputer
Definition DeclBase.h:337
DeclContext * getDeclContext()
Definition DeclBase.h:456
bool isInAnonymousNamespace() const
Definition DeclBase.cpp:440
void setCachedLinkage(Linkage L) const
Definition DeclBase.h:425
friend class RecordDecl
Definition DeclBase.h:338
Module * getOwningModuleForLinkage() const
Get the module that owns this declaration for linkage purposes.
Definition Decl.cpp:1637
DeclContext * getLexicalDeclContext()
getLexicalDeclContext - The declaration context where this Decl was lexically declared (LexicalDC).
Definition DeclBase.h:931
bool hasAttr() const
Definition DeclBase.h:585
friend class DeclContext
Definition DeclBase.h:260
virtual Decl * getCanonicalDecl()
Retrieves the "canonical" declaration of the given declaration.
Definition DeclBase.h:991
@ VisiblePromoted
This declaration has an owning module, and is not visible to the current TU but we promoted it to be ...
Definition DeclBase.h:237
@ VisibleWhenImported
This declaration has an owning module, and is visible when that module is imported.
Definition DeclBase.h:229
@ Unowned
This declaration is not owned by a module.
Definition DeclBase.h:218
@ ReachableWhenImported
This declaration has an owning module, and is visible to lookups that occurs within that module.
Definition DeclBase.h:242
@ ModulePrivate
This declaration has an owning module, but is only visible to lookups that occur within that module.
Definition DeclBase.h:248
@ Visible
This declaration has an owning module, but is globally visible (typically because its owning module i...
Definition DeclBase.h:225
Kind getKind() const
Definition DeclBase.h:450
const LangOptions & getLangOpts() const LLVM_READONLY
Helper to get the language options from the ASTContext.
Definition DeclBase.cpp:553
The name of a declaration.
const IdentifierInfo * getCXXLiteralIdentifier() const
If this name is the name of a literal operator, retrieve the identifier associated with it.
bool isAnyOperatorDelete() const
OverloadedOperatorKind getCXXOverloadedOperator() const
If this name is the name of an overloadable operator in C++ (e.g., operator+), retrieve the kind of o...
SourceLocation getTypeSpecEndLoc() const
Definition Decl.cpp:2007
SourceLocation getInnerLocStart() const
Return start of source range ignoring outer template declarations.
Definition Decl.h:822
SourceLocation getOuterLocStart() const
Return start of source range taking into account any outer template declarations.
Definition Decl.cpp:2063
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2103
SourceLocation getTypeSpecStartLoc() const
Definition Decl.cpp:2001
SourceLocation getBeginLoc() const LLVM_READONLY
Definition Decl.h:831
const AssociatedConstraint & getTrailingRequiresClause() const
Get the constraint-expression introduced by the trailing requires-clause in the function/member decla...
Definition Decl.h:855
DeclaratorDecl(Kind DK, DeclContext *DC, SourceLocation L, DeclarationName N, QualType T, TypeSourceInfo *TInfo, SourceLocation StartL)
Definition Decl.h:800
void setQualifierInfo(NestedNameSpecifierLoc QualifierLoc)
Definition Decl.cpp:2013
void setTrailingRequiresClause(const AssociatedConstraint &AC)
Definition Decl.cpp:2032
TypeSourceInfo * getTypeSourceInfo() const
Definition Decl.h:809
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:2047
Provides information about a dependent function-template specialization declaration.
static DependentFunctionTemplateSpecializationInfo * Create(ASTContext &Context, const UnresolvedSetImpl &Candidates, const TemplateArgumentListInfo *TemplateArgs)
Definition Decl.cpp:4397
static EmptyDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5892
static EmptyDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5896
EnumConstantDecl(const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V)
Definition Decl.cpp:5706
static EnumConstantDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5720
void setInitVal(const ASTContext &C, const llvm::APSInt &V)
Definition Decl.h:3463
static EnumConstantDecl * Create(ASTContext &C, EnumDecl *DC, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V)
Definition Decl.cpp:5713
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5754
Represents an enum.
Definition Decl.h:4028
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this enumeration is an instantiation of a member enumeration of a class template specialization,...
Definition Decl.h:4300
unsigned getNumNegativeBits() const
Returns the width in bits required to store all the negative enumerators of this enum.
Definition Decl.h:4238
unsigned getODRHash()
Definition Decl.cpp:5169
void setTemplateSpecializationKind(TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
For an enumeration member that was instantiated from a member enumeration of a templated class,...
Definition Decl.cpp:5130
static EnumDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl, bool IsScoped, bool IsScopedUsingClassTag, bool IsFixed)
Definition Decl.cpp:5076
TypeSourceInfo * getIntegerTypeSourceInfo() const
Return the type source info for the underlying integer type, if no type source info exists,...
Definition Decl.h:4217
static EnumDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5085
bool isClosedFlag() const
Returns true if this enum is annotated with flag_enum and isn't annotated with enum_extensibility(ope...
Definition Decl.cpp:5115
SourceRange getIntegerTypeRange() const LLVM_READONLY
Retrieve the source range that covers the underlying type if specified.
Definition Decl.cpp:5090
SourceRange getSourceRange() const override LLVM_READONLY
Overrides to provide correct range when there's an enum-base specifier with forward declarations.
Definition Decl.cpp:5180
QualType getIntegerType() const
Return the integer type this enum decl corresponds to.
Definition Decl.h:4201
EnumDecl * getInstantiatedFromMemberEnum() const
Returns the enumeration (declared within the template) from which this enumeration type was instantia...
Definition Decl.cpp:5156
unsigned getNumPositiveBits() const
Returns the width in bits required to store all the non-negative enumerators of this enum.
Definition Decl.h:4227
TemplateSpecializationKind getTemplateSpecializationKind() const
If this enumeration is a member of a specialization of a templated class, determine what kind of temp...
Definition Decl.cpp:5123
bool isClosed() const
Returns true if this enum is either annotated with enum_extensibility(closed) or isn't annotated with...
Definition Decl.cpp:5109
EnumDecl * getTemplateInstantiationPattern() const
Retrieve the enum definition from which this enumeration could be instantiated, if it is an instantia...
Definition Decl.cpp:5141
bool isClosedNonFlag() const
Returns true if this enum is annotated with neither flag_enum nor enum_extensibility(open).
Definition Decl.cpp:5119
void getValueRange(llvm::APInt &Max, llvm::APInt &Min) const
Calculates the [Min,Max) values the enum can store based on the NumPositiveBits and NumNegativeBits.
Definition Decl.cpp:5191
static ExportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation ExportLoc)
Definition Decl.cpp:6092
static ExportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:6097
This represents one expression.
Definition Expr.h:112
bool isValueDependent() const
Determines whether the value of this expression depends on.
Definition Expr.h:177
bool HasSideEffects(const ASTContext &Ctx, bool IncludePossibleEffects=true) const
HasSideEffects - This routine returns true for all those expressions which have any effect other than...
Definition Expr.cpp:3688
QualType getType() const
Definition Expr.h:144
static ExternCContextDecl * Create(const ASTContext &C, TranslationUnitDecl *TU)
Definition Decl.cpp:5550
RAII class for safely pairing a StartedDeserializing call with FinishedDeserializing.
Abstract interface for external sources of AST nodes.
Represents a member of a struct/union/class.
Definition Decl.h:3175
Expr * getInClassInitializer() const
Get the C++11 default member initializer for this member, or null if one has not been set.
Definition Decl.cpp:4727
bool isBitField() const
Determines whether this field is a bitfield.
Definition Decl.h:3278
bool hasInClassInitializer() const
Determine whether this member has a C++11 default member initializer.
Definition Decl.h:3355
FieldDecl(Kind DK, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, Expr *BW, bool Mutable, InClassInitStyle InitStyle)
Definition Decl.h:3235
LazyDeclStmtPtr Init
Definition Decl.h:3225
unsigned getBitWidthValue() const
Computes the bit width of this field, if this is a bit field.
Definition Decl.cpp:4754
bool isAnonymousStructOrUnion() const
Determines whether this field is a representative for an anonymous struct or union.
Definition Decl.cpp:4717
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4828
bool hasConstantIntegerBitWidth() const
Determines whether the bit width of this field is a constant integer.
Definition Decl.cpp:4749
static FieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:4711
void setInClassInitializer(Expr *NewInit)
Set the C++11 in-class initializer for this member.
Definition Decl.cpp:4737
const RecordDecl * getParent() const
Returns the parent of this field declaration, which is the struct in which this field is defined.
Definition Decl.h:3411
bool isZeroSize(const ASTContext &Ctx) const
Determine if this field is a subobject of zero size, that is, either a zero-length bit-field or a fie...
Definition Decl.cpp:4768
InitAndBitWidthStorage * InitAndBitWidth
Definition Decl.h:3229
static FieldDecl * Create(const ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, Expr *BW, bool Mutable, InClassInitStyle InitStyle)
Definition Decl.cpp:4702
FieldDecl * getCanonicalDecl() override
Retrieves the canonical declaration of this field.
Definition Decl.h:3422
static bool classofKind(Kind K)
Definition Decl.h:3427
bool isUnnamedBitField() const
Determines whether this is an unnamed bitfield.
Definition Decl.h:3281
bool isZeroLengthBitField() const
Is this a zero-length bit-field?
Definition Decl.cpp:4763
Expr * getBitWidth() const
Returns the expression that represents the bit width, if this field is a bit field.
Definition Decl.h:3291
void printName(raw_ostream &OS, const PrintingPolicy &Policy) const override
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:4847
const FieldDecl * findCountedByField() const
Find the FieldDecl specified in a FAM's "counted_by" attribute.
Definition Decl.cpp:4857
bool isPotentiallyOverlapping() const
Determine if this field is of potentially-overlapping class type, that is, subobject with the [[no_un...
Definition Decl.cpp:4806
void setCapturedVLAType(const VariableArrayType *VLAType)
Set the captured variable length array type for this field.
Definition Decl.cpp:4837
const VariableArrayType * CapturedVLAType
Definition Decl.h:3231
std::string getAsmString() const
Definition Decl.cpp:5858
const Expr * getAsmStringExpr() const
Definition Decl.h:4637
static FileScopeAsmDecl * Create(ASTContext &C, DeclContext *DC, Expr *Str, SourceLocation AsmLoc, SourceLocation RParenLoc)
Definition Decl.cpp:5846
static FileScopeAsmDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5852
Stashed information about a defaulted/deleted function body.
Definition Decl.h:2043
static DefaultedOrDeletedFunctionInfo * Create(ASTContext &Context, ArrayRef< DeclAccessPair > Lookups, StringLiteral *DeletedMessage=nullptr)
Definition Decl.cpp:3142
void setDeletedMessage(StringLiteral *Message)
Definition Decl.cpp:3184
Represents a function declaration or definition.
Definition Decl.h:2015
unsigned getMemoryFunctionKind() const
Identify a memory copying or setting function.
Definition Decl.cpp:4555
static constexpr unsigned RequiredTypeAwareDeleteParameterCount
Count of mandatory parameters for type aware operator delete.
Definition Decl.h:2657
bool isTargetClonesMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target-clones functional...
Definition Decl.cpp:3726
bool isMultiVersion() const
True if this function is considered a multiversioned function.
Definition Decl.h:2704
static FunctionDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation NLoc, DeclarationName N, QualType T, TypeSourceInfo *TInfo, StorageClass SC, bool UsesFPIntrin=false, bool isInlineSpecified=false, bool hasWrittenPrototype=true, ConstexprSpecKind ConstexprKind=ConstexprSpecKind::Unspecified, const AssociatedConstraint &TrailingRequiresClause={})
Definition Decl.h:2204
const ParmVarDecl * getParamDecl(unsigned i) const
Definition Decl.h:2812
bool hasTrivialBody() const
Returns whether the function has a trivial body that does not require any specific codegen.
Definition Decl.cpp:3212
DefaultedOrDeletedFunctionInfo * getDefaultedOrDeletedInfo() const
Definition Decl.cpp:3196
unsigned getMinRequiredArguments() const
Returns the minimum number of arguments needed to call this function.
Definition Decl.cpp:3849
bool isFunctionTemplateSpecialization() const
Determine whether this function is a function template specialization.
Definition Decl.cpp:4207
void setPreviousDeclaration(FunctionDecl *PrevDecl)
Definition Decl.cpp:3735
void setDescribedFunctionTemplate(FunctionTemplateDecl *Template)
Definition Decl.cpp:4200
FunctionTemplateDecl * getDescribedFunctionTemplate() const
Retrieves the function template that is described by this function declaration.
Definition Decl.cpp:4195
void setIsPureVirtual(bool P=true)
Definition Decl.cpp:3300
bool isImmediateFunction() const
Definition Decl.cpp:3342
void setDefaultedOrDeletedInfo(DefaultedOrDeletedFunctionInfo *Info)
Definition Decl.cpp:3162
SourceLocation getEllipsisLoc() const
Returns the location of the ellipsis of a variadic function.
Definition Decl.h:2238
SourceRange getReturnTypeSourceRange() const
Attempt to compute an informative source range covering the function return type.
Definition Decl.cpp:4026
bool isDestroyingOperatorDelete() const
Determine whether this is a destroying operator delete.
Definition Decl.cpp:3553
static FunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5635
unsigned getBuiltinID(bool ConsiderWrapperFunctions=false) const
Returns a value indicating whether this function corresponds to a builtin function.
Definition Decl.cpp:3764
SourceLocation getPointOfInstantiation() const
Retrieve the (first) point of instantiation of a function template specialization or a member of a cl...
Definition Decl.cpp:4516
bool isMemberLikeConstrainedFriend() const
Determine whether a function is a friend function that cannot be redeclared outside of its class,...
Definition Decl.cpp:3668
bool hasCXXExplicitFunctionObjectParameter() const
Definition Decl.cpp:3867
bool isInlined() const
Determine whether this function should be inlined, because it is either marked "inline" or "constexpr...
Definition Decl.h:2936
bool UsesFPIntrin() const
Determine whether the function was declared in source context that requires constrained FP intrinsics...
Definition Decl.h:2924
bool isNoReturn() const
Determines whether this function is known to be 'noreturn', through an attribute on its declaration o...
Definition Decl.cpp:3653
ArrayRef< ParmVarDecl * > parameters() const
Definition Decl.h:2789
bool isCPUSpecificMultiVersion() const
True if this function is a multiversioned processor specific function as a part of the cpu_specific/c...
Definition Decl.cpp:3708
FunctionDecl * getTemplateInstantiationPattern(bool ForDefinition=true) const
Retrieve the function declaration from which this function could be instantiated, if it is an instant...
Definition Decl.cpp:4266
bool isMSExternInline() const
The combination of the extern and inline keywords under MSVC forces the function to be required.
Definition Decl.cpp:3893
unsigned getMinRequiredExplicitArguments() const
Returns the minimum number of non-object arguments needed to call this function.
Definition Decl.cpp:3876
bool BodyContainsImmediateEscalatingExpressions() const
Definition Decl.h:2505
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:3616
FunctionTemplateDecl * getPrimaryTemplate() const
Retrieve the primary template that this function template specialization either specializes or was in...
Definition Decl.cpp:4315
bool hasWrittenPrototype() const
Whether this function has a written prototype.
Definition Decl.h:2463
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this function is an instantiation of a member function of a class template specialization,...
Definition Decl.cpp:4174
FunctionTemplateSpecializationInfo * getTemplateSpecializationInfo() const
If this function is actually a function template specialization, retrieve information about this func...
Definition Decl.cpp:4325
FunctionDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:3749
FunctionTypeLoc getFunctionTypeLoc() const
Find the source location information for how the type of this function was written.
Definition Decl.cpp:4003
bool isVariadic() const
Whether this function is variadic.
Definition Decl.cpp:3135
bool doesThisDeclarationHaveABody() const
Returns whether this specific declaration of the function has a body.
Definition Decl.h:2341
bool isConstexprSpecified() const
Definition Decl.h:2494
DependentFunctionTemplateSpecializationInfo * getDependentSpecializationInfo() const
Definition Decl.cpp:4391
const TemplateArgumentList * getTemplateSpecializationArgs() const
Retrieve the template arguments used to produce this function template specialization from the primar...
Definition Decl.cpp:4331
SourceRange getExceptionSpecSourceRange() const
Attempt to compute an informative source range covering the function exception specification,...
Definition Decl.cpp:4058
bool hasBody() const override
Returns true if this Decl represents a declaration for a body of code, such as a function or method d...
Definition Decl.h:2268
bool isMSVCRTEntryPoint() const
Determines whether this function is a MSVCRT user defined entry point.
Definition Decl.cpp:3377
unsigned getODRHash()
Returns ODRHash of the function.
Definition Decl.cpp:4681
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Determine the kind of template specialization this function represents for the purpose of template in...
Definition Decl.cpp:4443
FunctionDecl(Kind DK, ASTContext &C, DeclContext *DC, SourceLocation StartLoc, const DeclarationNameInfo &NameInfo, QualType T, TypeSourceInfo *TInfo, StorageClass S, bool UsesFPIntrin, bool isInlineSpecified, ConstexprSpecKind ConstexprKind, const AssociatedConstraint &TrailingRequiresClause)
Definition Decl.cpp:3081
bool isTemplateInstantiation() const
Determines if the given function was instantiated from a function template.
Definition Decl.cpp:4259
unsigned getNumNonObjectParams() const
Definition Decl.cpp:3871
TemplatedKind
The kind of templated function a FunctionDecl can be.
Definition Decl.h:2020
@ TK_FunctionTemplateSpecialization
Definition Decl.h:2031
@ TK_DependentFunctionTemplateSpecialization
Definition Decl.h:2034
UsualDeleteParams getUsualDeleteParams() const
Definition Decl.cpp:3569
StorageClass getStorageClass() const
Returns the storage class as written in the source.
Definition Decl.h:2903
bool isOutOfLine() const override
Determine whether this is or was instantiated from an out-of-line definition of a member function.
Definition Decl.cpp:4528
bool isInlineBuiltinDeclaration() const
Determine if this function provides an inline implementation of a builtin.
Definition Decl.cpp:3528
bool FriendConstraintRefersToEnclosingTemplate() const
Definition Decl.h:2722
TemplatedKind getTemplatedKind() const
What kind of templated function this is.
Definition Decl.cpp:4146
void setInstantiatedFromDecl(FunctionDecl *FD)
Specify that this function declaration was instantiated from a FunctionDecl FD.
Definition Decl.cpp:4213
bool isDeletedAsWritten() const
Definition Decl.h:2559
bool isReservedGlobalPlacementOperator() const
Determines whether this operator new or delete is one of the reserved global placement operators: voi...
Definition Decl.cpp:3405
void setDependentTemplateSpecialization(ASTContext &Context, const UnresolvedSetImpl &Templates, const TemplateArgumentListInfo *TemplateArgs)
Specifies that this function declaration is actually a dependent function template specialization.
Definition Decl.cpp:4380
bool isInExternCContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:3624
static constexpr unsigned RequiredTypeAwareNewParameterCount
Count of mandatory parameters for type aware operator new.
Definition Decl.h:2653
bool isImplicitlyInstantiable() const
Determines whether this function is a function template specialization or a member of a class templat...
Definition Decl.cpp:4224
bool isExternC() const
Determines whether this function is a function with external, C linkage.
Definition Decl.cpp:3620
Stmt * getBody() const override
getBody - If this Decl represents a declaration for a body of code, such as a function or method defi...
Definition Decl.h:2315
FunctionDecl * getMostRecentDecl()
Returns the most recent (re)declaration of this declaration.
redecl_range redecls() const
Returns an iterator range for all the redeclarations of the same decl.
bool isDefined() const
Definition Decl.h:2291
LazyDeclStmtPtr Body
The body of the function.
Definition Decl.h:2081
bool isImmediateEscalating() const
Definition Decl.cpp:3313
void setIsDestroyingOperatorDelete(bool IsDestroyingDelete)
Definition Decl.cpp:3557
bool isUsableAsGlobalAllocationFunctionInConstantEvaluation(UnsignedOrNone *AlignmentParam=nullptr, bool *IsNothrow=nullptr) const
Determines whether this function is one of the replaceable global allocation functions described in i...
Definition Decl.cpp:3428
DefaultedOrDeletedFunctionInfo * DefaultedOrDeletedInfo
Information about a future defaulted function definition.
Definition Decl.h:2083
bool isTypeAwareOperatorNewOrDelete() const
Determine whether this is a type aware operator new or delete.
Definition Decl.cpp:3561
bool isInExternCXXContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:3630
bool isMain() const
Determines whether this function is "main", which is the entry point into an executable program.
Definition Decl.cpp:3370
void setImplicitlyInline(bool I=true)
Flag that this function is implicitly inline.
Definition Decl.h:2931
bool isTargetVersionMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target-version functiona...
Definition Decl.cpp:3730
void setIsTypeAwareOperatorNewOrDelete(bool IsTypeAwareOperator=true)
Definition Decl.cpp:3565
bool isThisDeclarationInstantiatedFromAFriendDefinition() const
Determine whether this specific declaration of the function is a friend declaration that was instanti...
Definition Decl.cpp:3225
bool isCPUDispatchMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the cpu_specific/cpu_dispatc...
Definition Decl.cpp:3704
bool isDefaulted() const
Whether this function is defaulted.
Definition Decl.h:2400
bool isReferenceableKernel() const
Definition Decl.cpp:5642
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4551
FunctionDecl * getInstantiatedFromDecl() const
Definition Decl.cpp:4219
void setTemplateSpecializationKind(TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4488
const IdentifierInfo * getLiteralIdentifier() const
getLiteralIdentifier - The literal suffix identifier this function represents, if any.
Definition Decl.cpp:4140
OverloadedOperatorKind getOverloadedOperator() const
getOverloadedOperator - Which C++ overloaded operator this function represents, if any.
Definition Decl.cpp:4132
TemplateSpecializationKind getTemplateSpecializationKind() const
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4419
bool doesDeclarationForceExternallyVisibleDefinition() const
For a function declaration in C or C++, determine whether this declaration causes the definition to b...
Definition Decl.cpp:3943
bool isConsteval() const
Definition Decl.h:2497
bool isTargetMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target functionality.
Definition Decl.cpp:3712
bool isAnalyzerNoReturn() const
Determines whether this function is known to be 'noreturn' for analyzer, through an analyzer_noreturn...
Definition Decl.cpp:3664
void setBody(Stmt *B)
Definition Decl.cpp:3293
bool isGlobal() const
Determines whether this is a global function.
Definition Decl.cpp:3634
bool hasOneParamOrDefaultArgs() const
Determine whether this function has a single parameter, or multiple parameters where all but the firs...
Definition Decl.cpp:3881
void setDeletedAsWritten(bool D=true, StringLiteral *Message=nullptr)
Definition Decl.cpp:3171
bool isTargetMultiVersionDefault() const
True if this function is the default version of a multiversioned dispatch function as a part of the t...
Definition Decl.cpp:3717
FunctionDecl * getInstantiatedFromMemberFunction() const
If this function is an instantiation of a member function of a class template specialization,...
Definition Decl.cpp:4167
bool isInlineDefinitionExternallyVisible() const
For an inline function definition in C, or for a gnu_inline function in C++, determine whether the de...
Definition Decl.cpp:4080
unsigned getNumParams() const
Return the number of parameters this function must have based on its FunctionType.
Definition Decl.cpp:3828
DeclarationNameInfo getNameInfo() const
Definition Decl.h:2226
Redeclarable< FunctionDecl > redeclarable_base
Definition Decl.h:2175
bool hasBody(const FunctionDecl *&Definition) const
Returns true if the function has a body.
Definition Decl.cpp:3201
SourceRange getParametersSourceRange() const
Attempt to compute an informative source range covering the function parameters, including the ellips...
Definition Decl.cpp:4042
FunctionDecl * getPreviousDecl()
Return the previous declaration of this declaration or NULL if this is the first declaration.
bool isInlineSpecified() const
Determine whether the "inline" keyword was specified for this function.
Definition Decl.h:2914
MultiVersionKind getMultiVersionKind() const
Gets the kind of multiversioning attribute this declaration has.
Definition Decl.cpp:3690
void getNameForDiagnostic(raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const override
Appends a human-readable name for this declaration into the given stream.
Definition Decl.cpp:3127
bool willHaveBody() const
True if this function will eventually have a body, once it's fully parsed.
Definition Decl.h:2700
const ASTTemplateArgumentListInfo * getTemplateSpecializationArgsAsWritten() const
Retrieve the template argument list as written in the sources, if any.
Definition Decl.cpp:4341
Represents a prototype with parameter type info, e.g.
Definition TypeBase.h:5357
param_type_iterator param_type_begin() const
Definition TypeBase.h:5801
unsigned getNumParams() const
Definition TypeBase.h:5635
bool isVariadic() const
Whether this function prototype is variadic.
Definition TypeBase.h:5761
param_type_iterator param_type_end() const
Definition TypeBase.h:5805
Declaration of a template function.
Provides information about a function template specialization, which is a FunctionDecl that has been ...
TemplateArgumentList * TemplateArguments
The template arguments used to produce the function template specialization from the function templat...
FunctionTemplateDecl * getTemplate() const
Retrieve the template from which this function was specialized.
static FunctionTemplateSpecializationInfo * Create(ASTContext &C, FunctionDecl *FD, FunctionTemplateDecl *Template, TemplateSpecializationKind TSK, TemplateArgumentList *TemplateArgs, const TemplateArgumentListInfo *TemplateArgsAsWritten, SourceLocation POI, MemberSpecializationInfo *MSInfo)
bool isExplicitInstantiationOrSpecialization() const
True if this declaration is an explicit specialization, explicit instantiation declaration,...
Wrapper for source info for functions.
Definition TypeLoc.h:1644
SourceRange getExceptionSpecRange() const
Definition TypeLoc.h:1696
TypeLoc getReturnLoc() const
Definition TypeLoc.h:1725
FunctionType - C99 6.7.5.3 - Function Declarators.
Definition TypeBase.h:4553
static ArmStateValue getArmZT0State(unsigned AttrBits)
Definition TypeBase.h:4862
static ArmStateValue getArmZAState(unsigned AttrBits)
Definition TypeBase.h:4858
static std::string ExtractStringFromGCCAsmStmtComponent(const Expr *E)
Definition Stmt.cpp:554
HLSLBufferDecl - Represent a cbuffer or tbuffer declaration.
Definition Decl.h:5211
buffer_decl_iterator buffer_decls_begin() const
Definition Decl.cpp:5967
static HLSLBufferDecl * Create(ASTContext &C, DeclContext *LexicalParent, bool CBuffer, SourceLocation KwLoc, IdentifierInfo *ID, SourceLocation IDLoc, SourceLocation LBrace)
Definition Decl.cpp:5907
void addLayoutStruct(CXXRecordDecl *LS)
Definition Decl.cpp:5947
bool buffer_decls_empty()
Definition Decl.cpp:5979
llvm::concat_iterator< Decl *const, SmallVector< Decl * >::const_iterator, decl_iterator > buffer_decl_iterator
Definition Decl.h:5281
static HLSLBufferDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5941
buffer_decl_iterator buffer_decls_end() const
Definition Decl.cpp:5973
static HLSLBufferDecl * CreateDefaultCBuffer(ASTContext &C, DeclContext *LexicalParent, ArrayRef< Decl * > DefaultCBufferDecls)
Definition Decl.cpp:5930
static HLSLRootSignatureDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation Loc, IdentifierInfo *ID, llvm::dxbc::RootSignatureVersion Version, ArrayRef< llvm::hlsl::rootsig::RootElement > RootElements)
Definition Decl.cpp:5993
static HLSLRootSignatureDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:6008
One of these records is kept for each identifier that is lexed.
ReservedIdentifierStatus isReserved(const LangOptions &LangOpts) const
Determine whether this is a name reserved for the implementation (C99 7.1.3, C++ [lib....
bool isStr(const char(&Str)[StrLen]) const
Return true if this is the identifier for the specified string.
ImplicitParamDecl(ASTContext &C, DeclContext *DC, SourceLocation IdLoc, const IdentifierInfo *Id, QualType Type, ImplicitParamKind ParamKind)
Definition Decl.h:1777
static ImplicitParamDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation IdLoc, IdentifierInfo *Id, QualType T, ImplicitParamKind ParamKind)
Create implicit parameter.
Definition Decl.cpp:5604
static ImplicitParamDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5616
static ImportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, Module *Imported, ArrayRef< SourceLocation > IdentifierLocs)
Create a new module import declaration.
Definition Decl.cpp:6048
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:6079
static ImportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumLocations)
Create a new, deserialized module import declaration.
Definition Decl.cpp:6066
friend class ASTContext
Definition Decl.h:5071
ArrayRef< SourceLocation > getIdentifierLocs() const
Retrieves the locations of each of the identifiers that make up the complete module name in the impor...
Definition Decl.cpp:6072
Module * getImportedModule() const
Retrieve the module that was imported by the import declaration.
Definition Decl.h:5128
static ImportDecl * CreateImplicit(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, Module *Imported, SourceLocation EndLoc)
Create a new module import declaration for an implicitly-generated import.
Definition Decl.cpp:6056
static bool classofKind(Kind K)
Definition Decl.h:3524
static IndirectFieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5748
static IndirectFieldDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L, const IdentifierInfo *Id, QualType T, MutableArrayRef< NamedDecl * > CH)
Definition Decl.cpp:5740
void setMSAsmLabel(StringRef Name)
Definition Decl.cpp:5574
static LabelDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation IdentL, IdentifierInfo *II)
Definition Decl.cpp:5557
static LabelDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5569
@ Microsoft
Use Microsoft C++ ABI rules for bit-field layout and fundamental types alignment.
@ Default
Use default layout rules of the target.
RegisterStaticDestructorsKind
Controls which variables have static destructors registered.
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
LinkageInfo getTypeLinkageAndVisibility(const Type *T)
Definition Type.cpp:5087
LinkageInfo computeLVForDecl(const NamedDecl *D, LVComputationKind computation, bool IgnoreVarTypeLinkage=false)
Definition Decl.cpp:1460
LinkageInfo getLVForDecl(const NamedDecl *D, LVComputationKind computation)
getLVForDecl - Get the linkage and visibility for the given declaration.
Definition Decl.cpp:1578
LinkageInfo getDeclLinkageAndVisibility(const NamedDecl *D)
Definition Decl.cpp:1627
Visibility getVisibility() const
Definition Visibility.h:89
static LinkageInfo external()
Definition Visibility.h:72
static LinkageInfo none()
Definition Visibility.h:81
void setLinkage(Linkage L)
Definition Visibility.h:92
void mergeExternalVisibility(Linkage L)
Definition Visibility.h:101
void mergeMaybeWithVisibility(LinkageInfo other, bool withVis)
Merge linkage and conditionally merge visibility.
Definition Visibility.h:143
Linkage getLinkage() const
Definition Visibility.h:88
static LinkageInfo internal()
Definition Visibility.h:75
static LinkageInfo visible_none()
Definition Visibility.h:84
static LinkageInfo uniqueExternal()
Definition Visibility.h:78
void mergeVisibility(Visibility newVis, bool newExplicit)
Merge in the visibility 'newVis'.
Definition Visibility.h:116
bool isVisibilityExplicit() const
Definition Visibility.h:90
void merge(LinkageInfo other)
Merge both linkage and visibility.
Definition Visibility.h:137
Provides information a specialization of a member of a class template, which may be a member function...
void setTemplateSpecializationKind(TemplateSpecializationKind TSK)
Set the template specialization kind.
TemplateSpecializationKind getTemplateSpecializationKind() const
Determine what kind of template specialization this is.
SourceLocation getPointOfInstantiation() const
Retrieve the first point of instantiation of this member.
void setPointOfInstantiation(SourceLocation POI)
Set the first point of instantiation.
NamedDecl * getInstantiatedFrom() const
Retrieve the member declaration from which this member was instantiated.
Describes a module or submodule.
Definition Module.h:246
Module * Parent
The parent of this module.
Definition Module.h:295
ModuleKind Kind
The kind of this module.
Definition Module.h:291
@ ModuleImplementationUnit
This is a C++20 module implementation unit.
Definition Module.h:269
@ ModuleMapModule
This is a module that was defined by a module map and built out of header files.
Definition Module.h:260
@ ImplicitGlobalModuleFragment
This is an implicit fragment of the global module which contains only language linkage declarations (...
Definition Module.h:287
@ ModulePartitionInterface
This is a C++20 module partition interface.
Definition Module.h:272
@ ModuleInterfaceUnit
This is a C++20 module interface unit.
Definition Module.h:266
@ ModuleHeaderUnit
This is a C++20 header unit.
Definition Module.h:263
@ ModulePartitionImplementation
This is a C++20 module partition implementation.
Definition Module.h:275
@ PrivateModuleFragment
This is the private module fragment within some C++ module.
Definition Module.h:282
@ ExplicitGlobalModuleFragment
This is the explicit Global Module Fragment of a modular TU.
Definition Module.h:279
This represents a decl that may have a name.
Definition Decl.h:274
NamedDecl * getUnderlyingDecl()
Looks through UsingDecls and ObjCCompatibleAliasDecls for the underlying named decl.
Definition Decl.h:487
ExplicitVisibilityKind
Kinds of explicit visibility.
Definition Decl.h:452
@ VisibilityForValue
Do an LV computation for, ultimately, a non-type declaration.
Definition Decl.h:461
@ VisibilityForType
Do an LV computation for, ultimately, a type.
Definition Decl.h:456
Linkage getLinkageInternal() const
Determine what kind of linkage this entity has.
Definition Decl.cpp:1182
IdentifierInfo * getIdentifier() const
Get the identifier that names this declaration, if there is one.
Definition Decl.h:295
NamedDecl(Kind DK, DeclContext *DC, SourceLocation L, DeclarationName N)
Definition Decl.h:286
LinkageInfo getLinkageAndVisibility() const
Determines the linkage and visibility of this entity.
Definition Decl.cpp:1227
bool isLinkageValid() const
True if the computed linkage is valid.
Definition Decl.cpp:1085
StringRef getName() const
Get the name of identifier for this declaration as a StringRef.
Definition Decl.h:301
bool isPlaceholderVar(const LangOptions &LangOpts) const
Definition Decl.cpp:1095
DeclarationName getDeclName() const
Get the actual, stored name of the declaration, which may be a special name.
Definition Decl.h:340
std::string getQualifiedNameAsString() const
Definition Decl.cpp:1681
std::optional< Visibility > getExplicitVisibility(ExplicitVisibilityKind kind) const
If visibility was explicitly specified for this declaration, return that visibility.
Definition Decl.cpp:1314
NamedDecl * getMostRecentDecl()
Definition Decl.h:501
virtual void getNameForDiagnostic(raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const
Appends a human-readable name for this declaration into the given stream.
Definition Decl.cpp:1847
bool declarationReplaces(const NamedDecl *OldD, bool IsKnownNewer=true) const
Determine whether this declaration, if known to be well-formed within its context,...
Definition Decl.cpp:1871
ObjCStringFormatFamily getObjCFStringFormattingFamily() const
Definition Decl.cpp:1169
Linkage getFormalLinkage() const
Get the linkage from a semantic point of view.
Definition Decl.cpp:1207
void printQualifiedName(raw_ostream &OS) const
Returns a human-readable qualified name for this declaration, like A::B::i, for i being member of nam...
Definition Decl.cpp:1688
virtual void printName(raw_ostream &OS, const PrintingPolicy &Policy) const
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:1673
bool isCXXInstanceMember() const
Determine whether the given declaration is an instance member of a C++ class.
Definition Decl.cpp:1975
bool hasLinkage() const
Determine whether this declaration has linkage.
Definition Decl.cpp:1943
ReservedIdentifierStatus isReserved(const LangOptions &LangOpts) const
Determine if the declaration obeys the reserved identifier rules of the given language.
Definition Decl.cpp:1132
bool isCXXClassMember() const
Determine whether this declaration is a C++ class member.
Definition Decl.h:397
void printNestedNameSpecifier(raw_ostream &OS) const
Print only the nested name specifier part of a fully-qualified name, including the '::' at the end.
Definition Decl.cpp:1715
Represent a C++ namespace.
Definition Decl.h:592
A C++ nested-name-specifier augmented with source location information.
bool containsType(SanitizerMask Mask, StringRef MangledTypeName, StringRef Category=StringRef()) const
bool containsLocation(SanitizerMask Mask, SourceLocation Loc, StringRef Category=StringRef()) const
void AddEnumDecl(const EnumDecl *Enum)
Definition ODRHash.cpp:763
void AddFunctionDecl(const FunctionDecl *Function, bool SkipBody=false)
Definition ODRHash.cpp:670
void AddRecordDecl(const RecordDecl *Record)
Definition ODRHash.cpp:625
unsigned CalculateHash()
Definition ODRHash.cpp:231
Represents a partial function definition.
Definition Decl.h:4896
static OutlinedFunctionDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5660
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5680
static OutlinedFunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5668
Stmt * getBody() const override
getBody - If this Decl represents a declaration for a body of code, such as a function or method defi...
Definition Decl.cpp:5674
Represents a parameter to a function.
Definition Decl.h:1805
void setDefaultArg(Expr *defarg)
Definition Decl.cpp:3024
static ParmVarDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:2976
ParmVarDecl(Kind DK, ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass S, Expr *DefArg)
Definition Decl.h:1811
bool hasUnparsedDefaultArg() const
Determines whether this parameter has a default argument that has not yet been parsed.
Definition Decl.h:1934
SourceRange getDefaultArgRange() const
Retrieve the source range that covers the entire default argument.
Definition Decl.cpp:3029
void setUninstantiatedDefaultArg(Expr *arg)
Definition Decl.cpp:3049
bool hasUninstantiatedDefaultArg() const
Definition Decl.h:1938
bool isDestroyedInCallee() const
Determines whether this parameter is destroyed in the callee function.
Definition Decl.cpp:2997
bool hasInheritedDefaultArg() const
Definition Decl.h:1950
bool isExplicitObjectParameter() const
Definition Decl.h:1893
QualType getOriginalType() const
Definition Decl.cpp:2968
static ParmVarDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass S, Expr *DefArg)
Definition Decl.cpp:2959
Expr * getDefaultArg()
Definition Decl.cpp:3012
Expr * getUninstantiatedDefaultArg()
Definition Decl.cpp:3054
bool hasDefaultArg() const
Determines whether this parameter has a default argument, either parsed or not.
Definition Decl.cpp:3060
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2982
static PragmaCommentDecl * Create(const ASTContext &C, TranslationUnitDecl *DC, SourceLocation CommentLoc, PragmaMSCommentKind CommentKind, StringRef Arg)
Definition Decl.cpp:5504
static PragmaCommentDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned ArgSize)
Definition Decl.cpp:5517
Represents a #pragma detect_mismatch line.
Definition Decl.h:201
static PragmaDetectMismatchDecl * Create(const ASTContext &C, TranslationUnitDecl *DC, SourceLocation Loc, StringRef Name, StringRef Value)
Definition Decl.cpp:5527
static PragmaDetectMismatchDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NameValueSize)
Definition Decl.cpp:5542
Represents an unpacked "presumed" location which can be presented to the user.
unsigned getColumn() const
Return the presumed column number of this location.
const char * getFilename() const
Return the presumed filename of this location.
unsigned getLine() const
Return the presumed line number of this location.
void print(raw_ostream &OS) const override
Definition Decl.cpp:80
virtual bool isScopeVisible(const DeclContext *DC) const
When printing type to be inserted into code in specific context, this callback can be used to avoid p...
A (possibly-)qualified type.
Definition TypeBase.h:937
bool isNull() const
Return true if this QualType doesn't point to a type yet.
Definition TypeBase.h:1004
const Type * getTypePtr() const
Retrieves a pointer to the underlying (unqualified) type.
Definition TypeBase.h:8431
void print(raw_ostream &OS, const PrintingPolicy &Policy, const Twine &PlaceHolder=Twine(), unsigned Indentation=0) const
DestructionKind isDestructedType() const
Returns a nonzero value if objects of this type require non-trivial work to clean up after.
Definition TypeBase.h:1551
unsigned getCVRQualifiers() const
Retrieve the set of CVR (const-volatile-restrict) qualifiers applied to this type.
Definition TypeBase.h:8477
Represents a struct/union/class.
Definition Decl.h:4342
bool hasLoadedFieldsFromExternalStorage() const
Definition Decl.h:4411
unsigned getODRHash()
Get precomputed ODRHash or add a new one.
Definition Decl.cpp:5420
bool isLambda() const
Determine whether this record is a class describing a lambda function object.
Definition Decl.cpp:5248
bool isMsStruct(const ASTContext &C) const
Get whether or not this is an ms_struct which can be turned on with an attribute, pragma,...
Definition Decl.cpp:5314
void setAnonymousStructOrUnion(bool Anon)
Definition Decl.h:4398
RecordDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl)
Definition Decl.cpp:5210
const FieldDecl * findFirstNamedDataMember() const
Finds the first data member which has a name.
Definition Decl.cpp:5406
field_iterator noload_field_begin() const
Definition Decl.cpp:5287
void setArgPassingRestrictions(RecordArgPassingKind Kind)
Definition Decl.h:4488
void setNonTrivialToPrimitiveCopy(bool V)
Definition Decl.h:4432
bool isCapturedRecord() const
Determine whether this record is a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5254
void setHasNonTrivialToPrimitiveCopyCUnion(bool V)
Definition Decl.h:4464
field_range fields() const
Definition Decl.h:4545
void setHasNonTrivialToPrimitiveDestructCUnion(bool V)
Definition Decl.h:4456
void setHasFlexibleArrayMember(bool V)
Definition Decl.h:4379
void setParamDestroyedInCallee(bool V)
Definition Decl.h:4496
void setNonTrivialToPrimitiveDestroy(bool V)
Definition Decl.h:4440
void setHasObjectMember(bool val)
Definition Decl.h:4403
static RecordDecl * Create(const ASTContext &C, TagKind TK, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl=nullptr)
Definition Decl.cpp:5234
void setHasVolatileMember(bool val)
Definition Decl.h:4407
void setHasNonTrivialToPrimitiveDefaultInitializeCUnion(bool V)
Definition Decl.h:4448
void reorderDecls(const SmallVectorImpl< Decl * > &Decls)
Definition Decl.cpp:5325
void setIsRandomized(bool V)
Definition Decl.h:4502
static RecordDecl * CreateDeserialized(const ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5241
bool mayInsertExtraPadding(bool EmitRemark=false) const
Whether we are allowed to insert extra padding between fields.
Definition Decl.cpp:5362
static bool classof(const Decl *D)
Definition Decl.h:4582
bool isOrContainsUnion() const
Returns whether this record is a union, or contains (at any nesting level) a union member.
Definition Decl.cpp:5262
virtual void completeDefinition()
Note that the definition of this type is now complete.
Definition Decl.cpp:5293
RecordDecl * getDefinition() const
Returns the RecordDecl that actually defines this struct/union/class.
Definition Decl.h:4526
void setCapturedRecord()
Mark the record as a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5258
specific_decl_iterator< FieldDecl > field_iterator
Definition Decl.h:4542
void setHasUninitializedExplicitInitFields(bool V)
Definition Decl.h:4472
void setNonTrivialToPrimitiveDefaultInitialize(bool V)
Definition Decl.h:4424
RecordDecl * getDefinitionOrSelf() const
Definition Decl.h:4530
friend class DeclContext
Definition Decl.h:4346
void setHasLoadedFieldsFromExternalStorage(bool val) const
Definition Decl.h:4415
field_iterator field_begin() const
Definition Decl.cpp:5277
Declaration of a redeclarable template.
bool isMemberSpecialization() const
Determines whether this template was a specialization of a member template.
Provides common interface for the Decls that can be redeclared.
TagDecl * getNextRedeclaration() const
void setPreviousDecl(FunctionDecl *PrevDecl)
Encodes a location in the source.
bool isValid() const
Return true if this is a valid SourceLocation object.
This class handles loading and caching of source files into memory.
PresumedLoc getPresumedLoc(SourceLocation Loc, bool UseLineDirectives=true) const
Returns the "presumed" location of a SourceLocation specifies.
A trivial tuple used to represent a source range.
bool isInvalid() const
SourceLocation getEnd() const
Stmt - This represents one statement.
Definition Stmt.h:86
SourceLocation getEndLoc() const LLVM_READONLY
Definition Stmt.cpp:367
SourceRange getSourceRange() const LLVM_READONLY
SourceLocation tokens are not useful in isolation - they are low level value objects created/interpre...
Definition Stmt.cpp:343
StringLiteral - This represents a string literal expression, e.g.
Definition Expr.h:1802
Represents the declaration of a struct/union/class/enum.
Definition Decl.h:3732
void setTagKind(TagKind TK)
Definition Decl.h:3936
void setCompleteDefinitionRequired(bool V=true)
True if this complete decl is required to be complete for some existing use.
Definition Decl.h:3848
SourceRange getBraceRange() const
Definition Decl.h:3809
TagTypeKind TagKind
Definition Decl.h:3737
bool isBeingDefined() const
Return true if this decl is currently being defined.
Definition Decl.h:3853
redecl_range redecls() const
Returns an iterator range for all the redeclarations of the same decl.
TagDecl * getDefinition() const
Returns the TagDecl that actually defines this struct/union/class/enum.
Definition Decl.cpp:4931
void setEmbeddedInDeclarator(bool isInDeclarator)
True if this tag declaration is "embedded" (i.e., defined or declared for the very first time) in the...
Definition Decl.h:3863
StringRef getKindName() const
Definition Decl.h:3928
bool isCompleteDefinition() const
Return true if this decl has its body fully specified.
Definition Decl.h:3833
redeclarable_base::redecl_iterator redecl_iterator
Definition Decl.h:3800
TypedefNameDecl * getTypedefNameForAnonDecl() const
Definition Decl.h:3969
void startDefinition()
Starts the definition of this tag declaration.
Definition Decl.cpp:4908
TagDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:4901
void setTypedefNameForAnonDecl(TypedefNameDecl *TDD)
Definition Decl.cpp:4903
SourceLocation getOuterLocStart() const
Return SourceLocation representing start of source range taking into account any outer template decla...
Definition Decl.cpp:4891
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4895
void printAnonymousTagDeclLocation(llvm::raw_ostream &OS, const PrintingPolicy &Policy) const
Definition Decl.cpp:4965
bool isUnion() const
Definition Decl.h:3943
void setBeingDefined(bool V=true)
True if this decl is currently being defined.
Definition Decl.h:3787
void setQualifierInfo(NestedNameSpecifierLoc QualifierLoc)
Definition Decl.cpp:4945
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:5044
void completeDefinition()
Completes the definition of this tag declaration.
Definition Decl.cpp:4919
void printName(raw_ostream &OS, const PrintingPolicy &Policy) const override
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:5030
Redeclarable< TagDecl > redeclarable_base
Definition Decl.h:3767
void setFreeStanding(bool isFreeStanding=true)
True if this tag is free standing, e.g. "struct foo;".
Definition Decl.h:3871
redeclarable_base::redecl_range redecl_range
Definition Decl.h:3799
bool isDependentType() const
Whether this declaration declares a type that is dependent, i.e., a type that somehow depends on temp...
Definition Decl.h:3878
void printAnonymousTagDecl(llvm::raw_ostream &OS, const PrintingPolicy &Policy) const
Definition Decl.cpp:4989
TagDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl, SourceLocation StartL)
Definition Decl.cpp:4874
void setCompleteDefinition(bool V=true)
True if this decl has its body fully specified.
Definition Decl.h:3836
bool isMicrosoft() const
Is this ABI an MSVC-compatible ABI?
const llvm::Triple & getTriple() const
Returns the target triple of the primary target.
TargetCXXABI getCXXABI() const
Get the C++ ABI currently in use.
A convenient class for passing around template argument information.
A template argument list.
ArrayRef< TemplateArgument > asArray() const
Produce this as an array ref.
@ Declaration
The template argument is a declaration that was provided for a pointer, reference,...
@ Template
The template argument is a template name that was provided for a template template parameter.
@ StructuralValue
The template argument is a non-type template argument that can't be represented by the special-case D...
@ Pack
The template argument is actually a parameter pack.
@ TemplateExpansion
The template argument is a pack expansion of a template name that was provided for a template templat...
@ NullPtr
The template argument is a null pointer or null pointer to member that was provided for a non-type te...
@ Type
The template argument is a type.
@ Null
Represents an empty template argument, e.g., one that has not been deduced.
@ Integral
The template argument is an integral value stored in an llvm::APSInt that was provided for an integra...
@ Expression
The template argument is an expression, and we've not resolved it to one of the other forms yet,...
TemplateParameterList * getTemplateParameters() const
Get the list of template parameters.
Stores a list of template parameters for a TemplateDecl and its derived classes.
static TopLevelStmtDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5874
static TopLevelStmtDecl * Create(ASTContext &C, Stmt *Statement)
Definition Decl.cpp:5864
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5880
void setStmt(Stmt *S)
Definition Decl.cpp:5884
The top declaration context.
Definition Decl.h:105
static TranslationUnitDecl * Create(ASTContext &C)
Definition Decl.cpp:5491
ASTContext & getASTContext() const
Definition Decl.h:141
void setAnonymousNamespace(NamespaceDecl *D)
Definition Decl.cpp:5495
static TypeAliasDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5822
static TypeAliasDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5814
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5837
friend class ASTContext
Definition Decl.h:3529
TypeDecl(Kind DK, DeclContext *DC, SourceLocation L, const IdentifierInfo *Id, SourceLocation StartL=SourceLocation())
Definition Decl.h:3544
SourceLocation getBeginLoc() const LLVM_READONLY
Definition Decl.h:3562
Base wrapper for a particular "section" of type source info.
Definition TypeLoc.h:59
T getAs() const
Convert to the specified TypeLoc type, returning a null TypeLoc if this TypeLoc is not of the desired...
Definition TypeLoc.h:89
SourceRange getSourceRange() const LLVM_READONLY
Get the full source range.
Definition TypeLoc.h:154
SourceLocation getEndLoc() const
Get the end source location.
Definition TypeLoc.cpp:227
SourceLocation getBeginLoc() const
Get the begin source location.
Definition TypeLoc.cpp:193
A container of type source information.
Definition TypeBase.h:8402
TypeLoc getTypeLoc() const
Return the TypeLoc wrapper for the type source info.
Definition TypeLoc.h:267
QualType getType() const
Return the type wrapped by this type source info.
Definition TypeBase.h:8413
The base class of the type hierarchy.
Definition TypeBase.h:1866
CXXRecordDecl * getAsCXXRecordDecl() const
Retrieves the CXXRecordDecl that this type refers to, either because the type is a RecordType or beca...
Definition Type.h:26
bool isNothrowT() const
Definition Type.cpp:3245
RecordDecl * getAsRecordDecl() const
Retrieves the RecordDecl this type refers to.
Definition Type.h:41
bool isIntegerType() const
isIntegerType() does not include complex integers (a GCC extension).
Definition TypeBase.h:9078
const T * castAs() const
Member-template castAs<specific type>.
Definition TypeBase.h:9328
bool isReferenceType() const
Definition TypeBase.h:8692
bool isEnumeralType() const
Definition TypeBase.h:8799
bool isAlignValT() const
Definition Type.cpp:3254
QualType getPointeeType() const
If this is a pointer, ObjC object pointer, or block pointer, this returns the respective pointee.
Definition Type.cpp:754
DeducedType * getContainedDeducedType() const
Get the DeducedType whose type will be deduced for a variable with an initializer of this type.
Definition Type.cpp:2074
const T * getAsCanonical() const
If this type is canonically the specified type, return its canonical type cast to that specified type...
Definition TypeBase.h:2971
Linkage getLinkage() const
Determine the linkage of this type.
Definition Type.cpp:4974
const T * getAs() const
Member-template getAs<specific type>'.
Definition TypeBase.h:9261
static TypedefDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5763
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5828
static TypedefDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5809
Base class for declarations which introduce a typedef-name.
Definition Decl.h:3577
TypeSourceInfo * getTypeSourceInfo() const
Definition Decl.h:3627
QualType getUnderlyingType() const
Definition Decl.h:3632
TagDecl * getAnonDeclWithTypedefName(bool AnyRedecl=false) const
Retrieves the tag declaration for which this is the typedef name for linkage purposes,...
Definition Decl.cpp:5772
A set of unresolved declarations.
Represent the declaration of a variable (in which case it is an lvalue) a function (in which case it ...
Definition Decl.h:712
ValueDecl(Kind DK, DeclContext *DC, SourceLocation L, DeclarationName N, QualType T)
Definition Decl.h:718
QualType getType() const
Definition Decl.h:723
bool isParameterPack() const
Determine whether this value is actually a function parameter pack, init-capture pack,...
Definition Decl.cpp:5595
bool isWeak() const
Determine whether this symbol is weakly-imported, or declared with the weak or weak-ref attr.
Definition Decl.cpp:5583
bool isInitCapture() const
Whether this variable is the implicit variable for a lambda init-capture.
Definition Decl.cpp:5589
Represents a variable declaration or definition.
Definition Decl.h:926
VarTemplateDecl * getDescribedVarTemplate() const
Retrieves the variable template that is described by this variable declaration.
Definition Decl.cpp:2823
static VarDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass S)
Definition Decl.cpp:2164
Stmt ** getInitAddress()
Retrieve the address of the initializer expression.
Definition Decl.cpp:2435
DefinitionKind isThisDeclarationADefinition() const
Definition Decl.h:1323
bool isConstexpr() const
Whether this variable is (C++11) constexpr.
Definition Decl.h:1584
void setInstantiationOfStaticDataMember(VarDecl *VD, TemplateSpecializationKind TSK)
Specify that this variable is an instantiation of the static data member VD.
Definition Decl.cpp:2948
TLSKind getTLSKind() const
Definition Decl.cpp:2181
@ DAK_Uninstantiated
Definition Decl.h:1003
bool hasInit() const
Definition Decl.cpp:2411
bool hasICEInitializer(const ASTContext &Context) const
Determine whether the initializer of this variable is an integer constant expression.
Definition Decl.cpp:2649
ParmVarDeclBitfields ParmVarDeclBits
Definition Decl.h:1124
VarDecl * getMostRecentDecl()
Returns the most recent (re)declaration of this declaration.
DefinitionKind hasDefinition() const
Definition Decl.h:1329
static const char * getStorageClassSpecifierString(StorageClass SC)
Return the string used to specify the storage class SC.
Definition Decl.cpp:2134
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2203
bool isOutOfLine() const override
Determine whether this is or was instantiated from an out-of-line definition of a static data member.
Definition Decl.cpp:2474
VarDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:2270
bool hasFlexibleArrayInit(const ASTContext &Ctx) const
Whether this variable has a flexible array member initialized with one or more elements.
Definition Decl.cpp:2875
bool isNoDestroy(const ASTContext &) const
Is destruction of this variable entirely suppressed?
Definition Decl.cpp:2849
bool isInitCapture() const
Whether this variable is the implicit variable for a lambda init-capture.
Definition Decl.h:1593
void setStorageClass(StorageClass SC)
Definition Decl.cpp:2176
bool hasInitWithSideEffects() const
Checks whether this declaration has an initializer with side effects.
Definition Decl.cpp:2457
APValue * evaluateValue() const
Attempt to evaluate the value of the initializer attached to this declaration, and produce notes expl...
Definition Decl.cpp:2588
bool isStaticDataMember() const
Determines whether this is a static data member.
Definition Decl.h:1298
redecl_range redecls() const
Returns an iterator range for all the redeclarations of the same decl.
static VarDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:2170
VarDecl * getTemplateInstantiationPattern() const
Retrieve the variable declaration from which this variable could be instantiated, if it is an instant...
Definition Decl.cpp:2727
bool hasGlobalStorage() const
Returns true for all variables that do not have local storage.
Definition Decl.h:1241
VarDeclBitfields VarDeclBits
Definition Decl.h:1123
CharUnits getFlexibleArrayInitChars(const ASTContext &Ctx) const
If hasFlexibleArrayInit is true, compute the number of additional bytes necessary to store those elem...
Definition Decl.cpp:2890
bool hasConstantInitialization() const
Determine whether this variable has constant initialization.
Definition Decl.cpp:2661
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:2254
unsigned AllBits
Definition Decl.h:1122
EvaluatedStmt * getEvaluatedStmt() const
Definition Decl.cpp:2584
bool mightBeUsableInConstantExpressions(const ASTContext &C) const
Determine whether this variable's value might be usable in a constant expression, according to the re...
Definition Decl.cpp:2499
EvaluatedStmt * ensureEvaluatedStmt() const
Convert the initializer for this declaration to the elaborated EvaluatedStmt form,...
Definition Decl.cpp:2570
VarDecl * getInstantiatedFromStaticDataMember() const
If this variable is an instantiated static data member of a class template specialization,...
Definition Decl.cpp:2785
bool isFileVarDecl() const
Returns true for file scoped variable declaration.
Definition Decl.h:1357
void setTemplateSpecializationKind(TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
For a static data member that was instantiated from a static data member of a class template,...
Definition Decl.cpp:2920
QualType::DestructionKind needsDestruction(const ASTContext &Ctx) const
Would the destruction of this variable have any effect, and if so, what kind?
Definition Decl.cpp:2864
bool checkForConstantInitialization(SmallVectorImpl< PartialDiagnosticAt > &Notes) const
Evaluate the initializer of this variable to determine whether it's a constant initializer.
Definition Decl.cpp:2677
bool isInline() const
Whether this variable is (C++1z) inline.
Definition Decl.h:1566
const Expr * getInit() const
Definition Decl.h:1383
bool isNonEscapingByref() const
Indicates the capture is a __block variable that is never captured by an escaping block.
Definition Decl.cpp:2715
bool isInExternCContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:2262
NonParmVarDeclBitfields NonParmVarDeclBits
Definition Decl.h:1125
bool hasExternalStorage() const
Returns true if a variable has extern or private_extern storage.
Definition Decl.h:1232
InitType Init
The initializer for this variable or, for a ParmVarDecl, the C++ default argument.
Definition Decl.h:972
Redeclarable< VarDecl > redeclarable_base
Definition Decl.h:1132
APValue * getEvaluatedValue() const
Return the already-evaluated value of this variable's initializer, or NULL if the value is not yet kn...
Definition Decl.cpp:2641
VarDecl * getInitializingDeclaration()
Get the initializing declaration of this variable, if any.
Definition Decl.cpp:2442
TLSKind
Kinds of thread-local storage.
Definition Decl.h:944
@ TLS_Static
TLS with a known-constant initializer.
Definition Decl.h:949
@ TLS_Dynamic
TLS with a dynamic initializer.
Definition Decl.h:952
@ TLS_None
Not a TLS variable.
Definition Decl.h:946
void setInit(Expr *I)
Definition Decl.cpp:2490
VarDecl * getActingDefinition()
Get the tentative definition that acts as the real definition in a TU.
Definition Decl.cpp:2358
@ TentativeDefinition
This declaration is a tentative definition.
Definition Decl.h:1313
@ DeclarationOnly
This declaration is only a declaration.
Definition Decl.h:1310
@ Definition
This declaration is definitely a definition.
Definition Decl.h:1316
void setDescribedVarTemplate(VarTemplateDecl *Template)
Definition Decl.cpp:2828
bool isExternC() const
Determines whether this variable is a variable with external, C linkage.
Definition Decl.cpp:2258
VarDecl(Kind DK, ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass SC)
Definition Decl.cpp:2147
StorageDuration getStorageDuration() const
Get the storage duration of this variable, per C++ [basic.stc].
Definition Decl.h:1244
StorageClass getStorageClass() const
Returns the storage class as written in the source.
Definition Decl.h:1168
bool isEscapingByref() const
Indicates the capture is a __block variable that is captured by a block that can potentially escape (...
Definition Decl.cpp:2711
bool isThisDeclarationADemotedDefinition() const
If this definition should pretend to be a declaration.
Definition Decl.h:1491
VarDecl * getPreviousDecl()
Return the previous declaration of this declaration or NULL if this is the first declaration.
bool isUsableInConstantExpressions(const ASTContext &C) const
Determine whether this variable's value can be used in a constant expression, according to the releva...
Definition Decl.cpp:2541
bool isInExternCXXContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:2266
SourceLocation getPointOfInstantiation() const
If this variable is an instantiation of a variable template or a static data member of a class templa...
Definition Decl.cpp:2813
bool hasDependentAlignment() const
Determines if this variable's alignment is dependent.
Definition Decl.cpp:2719
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Get the template specialization kind of this variable for the purposes of template instantiation.
Definition Decl.cpp:2803
VarDecl * getDefinition()
Definition Decl.h:1345
TemplateSpecializationKind getTemplateSpecializationKind() const
If this variable is an instantiation of a variable template or a static data member of a class templa...
Definition Decl.cpp:2792
const Expr * getAnyInitializer() const
Get the initializer for this variable, no matter which declaration it is attached to.
Definition Decl.h:1373
bool isKnownToBeDefined() const
Definition Decl.cpp:2832
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this variable is an instantiation of a static data member of a class template specialization,...
Definition Decl.cpp:2911
Declaration of a variable template.
VarDecl * getTemplatedDecl() const
Get the underlying variable declarations of the template.
Represents a variable template specialization, which refers to a variable template with a given set o...
const TemplateArgumentList & getTemplateArgs() const
Retrieve the template arguments of the variable template specialization.
VarTemplateDecl * getSpecializedTemplate() const
Retrieve the template that this specialization specializes.
bool isExplicitInstantiationOrSpecialization() const
True if this declaration is an explicit specialization, explicit instantiation declaration,...
Represents a C array with a specified size that is not an integer-constant-expression.
Definition TypeBase.h:4016
Defines the Linkage enumeration and various utility functions.
Defines the clang::TargetInfo interface.
#define CHAR_BIT
Definition limits.h:71
const internal::VariadicAllOfMatcher< Type > type
Matches Types in the clang AST.
const internal::VariadicAllOfMatcher< Decl > decl
Matches declarations.
std::variant< struct RequiresDecl, struct HeaderDecl, struct UmbrellaDirDecl, struct ModuleDecl, struct ExcludeDecl, struct ExportDecl, struct ExportAsDecl, struct ExternModuleDecl, struct UseDecl, struct LinkDecl, struct ConfigMacrosDecl, struct ConflictDecl > Decl
All declarations that can appear in a module declaration.
The JSON file list parser is used to communicate input to InstallAPI.
OverloadedOperatorKind
Enumeration specifying the different kinds of C++ overloaded operators.
@ OO_None
Not an overloaded operator.
bool isa(CodeGen::Address addr)
Definition Address.h:330
bool isTemplateInstantiation(TemplateSpecializationKind Kind)
Determine whether this template specialization kind refers to an instantiation of an entity (as oppos...
Definition Specifiers.h:212
@ CPlusPlus
LazyOffsetPtr< Stmt, uint64_t, &ExternalASTSource::GetExternalDeclStmt > LazyDeclStmtPtr
A lazy pointer to a statement.
@ GVA_StrongODR
Definition Linkage.h:77
@ GVA_StrongExternal
Definition Linkage.h:76
@ GVA_AvailableExternally
Definition Linkage.h:74
@ GVA_DiscardableODR
Definition Linkage.h:75
@ GVA_Internal
Definition Linkage.h:73
bool isReservedInAllContexts(ReservedIdentifierStatus Status)
Determine whether an identifier is reserved in all contexts.
PragmaMSCommentKind
Definition PragmaKinds.h:14
@ PCK_Unknown
Definition PragmaKinds.h:15
ConstexprSpecKind
Define the kind of constexpr specifier.
Definition Specifiers.h:35
Decl * getPrimaryMergedDecl(Decl *D)
Get the primary declaration for a declaration from an AST file.
Definition Decl.cpp:76
InClassInitStyle
In-class initialization styles for non-static data members.
Definition Specifiers.h:271
@ ICIS_NoInit
No in-class initializer.
Definition Specifiers.h:272
Linkage getFormalLinkage(Linkage L)
Definition Linkage.h:106
nullptr
This class represents a compute construct, representing a 'Kind' of ‘parallel’, 'serial',...
LanguageLinkage
Describes the different kinds of language linkage (C++ [dcl.link]) that an entity may have.
Definition Linkage.h:63
@ CLanguageLinkage
Definition Linkage.h:64
@ CXXLanguageLinkage
Definition Linkage.h:65
@ NoLanguageLinkage
Definition Linkage.h:66
StorageClass
Storage classes.
Definition Specifiers.h:248
@ SC_Auto
Definition Specifiers.h:256
@ SC_PrivateExtern
Definition Specifiers.h:253
@ SC_Extern
Definition Specifiers.h:251
@ SC_Register
Definition Specifiers.h:257
@ SC_Static
Definition Specifiers.h:252
@ SC_None
Definition Specifiers.h:250
@ TSCS_thread_local
C++11 thread_local.
Definition Specifiers.h:241
@ TSCS_unspecified
Definition Specifiers.h:236
@ TSCS__Thread_local
C11 _Thread_local.
Definition Specifiers.h:244
@ TSCS___thread
GNU __thread.
Definition Specifiers.h:238
Linkage
Describes the different kinds of linkage (C++ [basic.link], C99 6.2.2) that an entity may have.
Definition Linkage.h:24
@ VisibleNone
No linkage according to the standard, but is visible from other translation units because of types de...
Definition Linkage.h:48
@ None
No linkage, which means that the entity is unique and can only be referred to from within its scope.
Definition Linkage.h:30
@ UniqueExternal
External linkage within a unique namespace.
Definition Linkage.h:44
@ Internal
Internal linkage, which indicates that the entity can be referred to from within the translation unit...
Definition Linkage.h:35
@ External
External linkage, which indicates that the entity can be referred to from other translation units.
Definition Linkage.h:58
@ Module
Module linkage, which indicates that the entity can be referred to from other translation units withi...
Definition Linkage.h:54
@ SD_Automatic
Automatic storage duration (most local variables).
Definition Specifiers.h:341
bool isLambdaCallOperator(const CXXMethodDecl *MD)
Definition ASTLambda.h:28
@ Result
The result type of a method or function.
Definition TypeBase.h:905
@ Template
We are parsing a template declaration.
Definition Parser.h:81
bool hasArmZT0State(const FunctionDecl *FD)
Returns whether the given FunctionDecl has Arm ZT0 state.
Definition Decl.cpp:6122
TagTypeKind
The kind of a tag type.
Definition TypeBase.h:5981
@ Struct
The "struct" keyword.
Definition TypeBase.h:5983
@ Enum
The "enum" keyword.
Definition TypeBase.h:5995
@ VarTemplate
The name was classified as a variable template name.
Definition Sema.h:585
bool isTypeAwareAllocation(TypeAwareAllocationMode Mode)
Definition ExprCXX.h:2254
@ CanPassInRegs
The argument of this type can be passed directly in registers.
Definition Decl.h:4321
bool isLegalForVariable(StorageClass SC)
Checks whether the given storage class is legal for variables.
Definition Specifiers.h:266
MultiVersionKind
Definition Decl.h:1994
bool isReservedAtGlobalScope(ReservedIdentifierStatus Status)
Determine whether an identifier is reserved for use as a name at global scope.
bool isExternalFormalLinkage(Linkage L)
Definition Linkage.h:117
TemplateSpecializationKind
Describes the kind of template specialization that a particular template specialization declaration r...
Definition Specifiers.h:188
@ TSK_ExplicitInstantiationDefinition
This template specialization was instantiated from a template due to an explicit instantiation defini...
Definition Specifiers.h:206
@ TSK_ExplicitInstantiationDeclaration
This template specialization was instantiated from a template due to an explicit instantiation declar...
Definition Specifiers.h:202
@ TSK_ExplicitSpecialization
This template specialization was declared or defined by an explicit specialization (C++ [temp....
Definition Specifiers.h:198
@ TSK_ImplicitInstantiation
This template specialization was implicitly instantiated from a template.
Definition Specifiers.h:194
@ TSK_Undeclared
This template specialization was formed from a template-id but has not yet been declared,...
Definition Specifiers.h:191
U cast(CodeGen::Address addr)
Definition Address.h:327
@ Enum
The "enum" keyword introduces the elaborated-type-specifier.
Definition TypeBase.h:5970
bool IsArmStreamingFunction(const FunctionDecl *FD, bool IncludeLocallyStreaming)
Returns whether the given FunctionDecl has an __arm[_locally]_streaming attribute.
Definition Decl.cpp:6101
ReservedIdentifierStatus
bool isExternallyVisible(Linkage L)
Definition Linkage.h:90
ImplicitParamKind
Defines the kind of the implicit parameter: is this an implicit parameter with pointer to 'this',...
Definition Decl.h:1741
@ Other
Other implicit parameter.
Definition Decl.h:1761
Visibility
Describes the different kinds of visibility that a declaration may have.
Definition Visibility.h:34
@ HiddenVisibility
Objects with "hidden" visibility are not seen by the dynamic linker.
Definition Visibility.h:37
@ ProtectedVisibility
Objects with "protected" visibility are seen by the dynamic linker but always dynamically resolve to ...
Definition Visibility.h:42
@ DefaultVisibility
Objects with "default" visibility are seen by the dynamic linker and act like normal objects.
Definition Visibility.h:46
bool isGenericLambdaCallOperatorSpecialization(const CXXMethodDecl *MD)
Definition ASTLambda.h:60
bool hasArmZAState(const FunctionDecl *FD)
Returns whether the given FunctionDecl has Arm ZA state.
Definition Decl.cpp:6115
#define false
Definition stdbool.h:26
#define true
Definition stdbool.h:25
Represents an explicit template argument list in C++, e.g., the "<int>" in "sort<int>".
static const ASTTemplateArgumentListInfo * Create(const ASTContext &C, const TemplateArgumentListInfo &List)
bool isNull() const
Definition Decl.h:99
A placeholder type used to construct an empty shell of a decl-derived type that will be filled in lat...
Definition DeclBase.h:102
DeclarationNameInfo - A collector data type for bundling together a DeclarationName and the correspon...
SourceLocation getBeginLoc() const
getBeginLoc - Retrieve the location of the first token.
Structure used to store a statement, the constant value to which it was evaluated (if any),...
Definition Decl.h:887
bool HasConstantDestruction
Whether this variable is known to have constant destruction.
Definition Decl.h:905
bool WasEvaluated
Whether this statement was already evaluated.
Definition Decl.h:889
bool CheckedForSideEffects
Definition Decl.h:913
bool CheckedForICEInit
Definition Decl.h:910
LazyDeclStmtPtr Value
Definition Decl.h:915
APValue Evaluated
Definition Decl.h:916
bool IsEvaluating
Whether this statement is being evaluated.
Definition Decl.h:892
bool HasConstantInitialization
Whether this variable is known to have constant initialization.
Definition Decl.h:898
bool HasICEInit
In C++98, whether the initializer is an ICE.
Definition Decl.h:909
Kinds of LV computation.
Definition Linkage.h:29
bool isTypeVisibility() const
Definition Linkage.h:53
unsigned IgnoreExplicitVisibility
Whether explicit visibility attributes should be ignored.
Definition Linkage.h:37
unsigned IgnoreAllVisibility
Whether all visibility should be ignored.
Definition Linkage.h:41
static LVComputationKind forLinkageOnly()
Do an LV computation when we only care about the linkage.
Definition Linkage.h:61
bool isValueVisibility() const
Definition Linkage.h:56
bool isOffset() const
Whether this pointer is currently stored as an offset.
T * get(ExternalASTSource *Source) const
Retrieve the pointer to the AST node that this lazy pointer points to.
Describes how types, statements, expressions, and declarations should be printed.
unsigned SuppressUnwrittenScope
Suppress printing parts of scope specifiers that are never written, e.g., for anonymous namespaces.
unsigned MSVCFormatting
Use whitespace and punctuation like MSVC does.
unsigned SuppressTagKeyword
Whether type printing should skip printing the tag keyword.
unsigned SuppressInlineNamespace
Suppress printing parts of scope specifiers that correspond to inline namespaces.
const PrintingCallbacks * Callbacks
Callbacks to use to allow the behavior of printing to be customized.
@ Plain
E.g., (anonymous enum)/(unnamed struct)/etc.
@ SourceLocation
When printing an anonymous tag name, also print the location of that entity (e.g.,...
unsigned SuppressTagKeywordInAnonNames
Whether type printing should skip printing the tag keyword of anonymous entities.
TemplateParameterList ** TemplParamLists
A new-allocated array of size NumTemplParamLists, containing pointers to the "outer" template paramet...
Definition Decl.h:767
unsigned NumTemplParamLists
The number of "outer" template parameter lists.
Definition Decl.h:760
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Sets info about "outer" template parameter lists.
Definition Decl.cpp:2114
The parameters to pass to a usual operator delete.
Definition ExprCXX.h:2345
TypeAwareAllocationMode TypeAwareDelete
Definition ExprCXX.h:2346
AlignedAllocationMode Alignment
Definition ExprCXX.h:2349