clang 22.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,
172 LVComputationKind kind) {
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'.
225 if (kind == NamedDecl::VisibilityForType) {
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()) {
1196 return false;
1199 return D->isInNamedModule();
1200 }
1201 llvm_unreachable("unexpected module ownership kind");
1202}
1203
1204/// Get the linkage from a semantic point of view. Entities in
1205/// anonymous namespaces are external (in c++98).
1207 Linkage InternalLinkage = getLinkageInternal();
1208
1209 // C++ [basic.link]p4.8:
1210 // - if the declaration of the name is attached to a named module and is not
1211 // exported
1212 // the name has module linkage;
1213 //
1214 // [basic.namespace.general]/p2
1215 // A namespace is never attached to a named module and never has a name with
1216 // module linkage.
1217 if (isInNamedModule() && InternalLinkage == Linkage::External &&
1220 !isa<NamespaceDecl>(this))
1221 InternalLinkage = Linkage::Module;
1222
1223 return clang::getFormalLinkage(InternalLinkage);
1224}
1225
1227 return LinkageComputer{}.getDeclLinkageAndVisibility(this);
1228}
1229
1230static std::optional<Visibility>
1233 bool IsMostRecent) {
1234 assert(!IsMostRecent || ND == ND->getMostRecentDecl());
1235
1236 if (isa<ConceptDecl>(ND))
1237 return {};
1238
1239 // Check the declaration itself first.
1240 if (std::optional<Visibility> V = getVisibilityOf(ND, kind))
1241 return V;
1242
1243 // If this is a member class of a specialization of a class template
1244 // and the corresponding decl has explicit visibility, use that.
1245 if (const auto *RD = dyn_cast<CXXRecordDecl>(ND)) {
1246 CXXRecordDecl *InstantiatedFrom = RD->getInstantiatedFromMemberClass();
1247 if (InstantiatedFrom)
1248 return getVisibilityOf(InstantiatedFrom, kind);
1249 }
1250
1251 // If there wasn't explicit visibility there, and this is a
1252 // specialization of a class template, check for visibility
1253 // on the pattern.
1254 if (const auto *spec = dyn_cast<ClassTemplateSpecializationDecl>(ND)) {
1255 // Walk all the template decl till this point to see if there are
1256 // explicit visibility attributes.
1257 const auto *TD = spec->getSpecializedTemplate()->getTemplatedDecl();
1258 while (TD != nullptr) {
1259 auto Vis = getVisibilityOf(TD, kind);
1260 if (Vis != std::nullopt)
1261 return Vis;
1262 TD = TD->getPreviousDecl();
1263 }
1264 return std::nullopt;
1265 }
1266
1267 // Use the most recent declaration.
1268 if (!IsMostRecent && !isa<NamespaceDecl>(ND)) {
1269 const NamedDecl *MostRecent = ND->getMostRecentDecl();
1270 if (MostRecent != ND)
1271 return getExplicitVisibilityAux(MostRecent, kind, true);
1272 }
1273
1274 if (const auto *Var = dyn_cast<VarDecl>(ND)) {
1275 if (Var->isStaticDataMember()) {
1276 VarDecl *InstantiatedFrom = Var->getInstantiatedFromStaticDataMember();
1277 if (InstantiatedFrom)
1278 return getVisibilityOf(InstantiatedFrom, kind);
1279 }
1280
1281 if (const auto *VTSD = dyn_cast<VarTemplateSpecializationDecl>(Var))
1282 return getVisibilityOf(VTSD->getSpecializedTemplate()->getTemplatedDecl(),
1283 kind);
1284
1285 return std::nullopt;
1286 }
1287 // Also handle function template specializations.
1288 if (const auto *fn = dyn_cast<FunctionDecl>(ND)) {
1289 // If the function is a specialization of a template with an
1290 // explicit visibility attribute, use that.
1291 if (FunctionTemplateSpecializationInfo *templateInfo
1293 return getVisibilityOf(templateInfo->getTemplate()->getTemplatedDecl(),
1294 kind);
1295
1296 // If the function is a member of a specialization of a class template
1297 // and the corresponding decl has explicit visibility, use that.
1298 FunctionDecl *InstantiatedFrom = fn->getInstantiatedFromMemberFunction();
1299 if (InstantiatedFrom)
1300 return getVisibilityOf(InstantiatedFrom, kind);
1301
1302 return std::nullopt;
1303 }
1304
1305 // The visibility of a template is stored in the templated decl.
1306 if (const auto *TD = dyn_cast<TemplateDecl>(ND))
1307 return getVisibilityOf(TD->getTemplatedDecl(), kind);
1308
1309 return std::nullopt;
1310}
1311
1312std::optional<Visibility>
1316
1317LinkageInfo LinkageComputer::getLVForClosure(const DeclContext *DC,
1318 Decl *ContextDecl,
1319 LVComputationKind computation) {
1320 // This lambda has its linkage/visibility determined by its owner.
1321 const NamedDecl *Owner;
1322 if (!ContextDecl)
1323 Owner = dyn_cast<NamedDecl>(DC);
1324 else if (isa<ParmVarDecl>(ContextDecl))
1325 Owner =
1326 dyn_cast<NamedDecl>(ContextDecl->getDeclContext()->getRedeclContext());
1327 else if (isa<ImplicitConceptSpecializationDecl>(ContextDecl)) {
1328 // Replace with the concept's owning decl, which is either a namespace or a
1329 // TU, so this needs a dyn_cast.
1330 Owner = dyn_cast<NamedDecl>(ContextDecl->getDeclContext());
1331 } else {
1332 Owner = cast<NamedDecl>(ContextDecl);
1333 }
1334
1335 if (!Owner)
1336 return LinkageInfo::none();
1337
1338 // If the owner has a deduced type, we need to skip querying the linkage and
1339 // visibility of that type, because it might involve this closure type. The
1340 // only effect of this is that we might give a lambda VisibleNoLinkage rather
1341 // than NoLinkage when we don't strictly need to, which is benign.
1342 auto *VD = dyn_cast<VarDecl>(Owner);
1343 LinkageInfo OwnerLV =
1344 VD && VD->getType()->getContainedDeducedType()
1345 ? computeLVForDecl(Owner, computation, /*IgnoreVarTypeLinkage*/true)
1346 : getLVForDecl(Owner, computation);
1347
1348 // A lambda never formally has linkage. But if the owner is externally
1349 // visible, then the lambda is too. We apply the same rules to blocks.
1350 if (!isExternallyVisible(OwnerLV.getLinkage()))
1351 return LinkageInfo::none();
1352 return LinkageInfo(Linkage::VisibleNone, OwnerLV.getVisibility(),
1353 OwnerLV.isVisibilityExplicit());
1354}
1355
1356LinkageInfo LinkageComputer::getLVForLocalDecl(const NamedDecl *D,
1357 LVComputationKind computation) {
1358 if (const auto *Function = dyn_cast<FunctionDecl>(D)) {
1359 if (Function->isInAnonymousNamespace() &&
1361 return LinkageInfo::internal();
1362
1363 // This is a "void f();" which got merged with a file static.
1364 if (Function->getCanonicalDecl()->getStorageClass() == SC_Static)
1365 return LinkageInfo::internal();
1366
1367 LinkageInfo LV;
1368 if (!hasExplicitVisibilityAlready(computation)) {
1369 if (std::optional<Visibility> Vis =
1370 getExplicitVisibility(Function, computation))
1371 LV.mergeVisibility(*Vis, true);
1372 }
1373
1374 // Note that Sema::MergeCompatibleFunctionDecls already takes care of
1375 // merging storage classes and visibility attributes, so we don't have to
1376 // look at previous decls in here.
1377
1378 return LV;
1379 }
1380
1381 if (const auto *Var = dyn_cast<VarDecl>(D)) {
1382 if (Var->hasExternalStorage()) {
1383 if (Var->isInAnonymousNamespace() && !isFirstInExternCContext(Var))
1384 return LinkageInfo::internal();
1385
1386 LinkageInfo LV;
1387 if (Var->getStorageClass() == SC_PrivateExtern)
1389 else if (!hasExplicitVisibilityAlready(computation)) {
1390 if (std::optional<Visibility> Vis =
1391 getExplicitVisibility(Var, computation))
1392 LV.mergeVisibility(*Vis, true);
1393 }
1394
1395 if (const VarDecl *Prev = Var->getPreviousDecl()) {
1396 LinkageInfo PrevLV = getLVForDecl(Prev, computation);
1397 if (PrevLV.getLinkage() != Linkage::Invalid)
1398 LV.setLinkage(PrevLV.getLinkage());
1399 LV.mergeVisibility(PrevLV);
1400 }
1401
1402 return LV;
1403 }
1404
1405 if (!Var->isStaticLocal())
1406 return LinkageInfo::none();
1407 }
1408
1409 ASTContext &Context = D->getASTContext();
1410 if (!Context.getLangOpts().CPlusPlus)
1411 return LinkageInfo::none();
1412
1413 const Decl *OuterD = getOutermostFuncOrBlockContext(D);
1414 if (!OuterD || OuterD->isInvalidDecl())
1415 return LinkageInfo::none();
1416
1417 LinkageInfo LV;
1418 if (const auto *BD = dyn_cast<BlockDecl>(OuterD)) {
1419 if (!BD->getBlockManglingNumber())
1420 return LinkageInfo::none();
1421
1422 LV = getLVForClosure(BD->getDeclContext()->getRedeclContext(),
1423 BD->getBlockManglingContextDecl(), computation);
1424 } else {
1425 const auto *FD = cast<FunctionDecl>(OuterD);
1426 if (!FD->isInlined() &&
1427 !isTemplateInstantiation(FD->getTemplateSpecializationKind()))
1428 return LinkageInfo::none();
1429
1430 // If a function is hidden by -fvisibility-inlines-hidden option and
1431 // is not explicitly attributed as a hidden function,
1432 // we should not make static local variables in the function hidden.
1433 LV = getLVForDecl(FD, computation);
1435 !LV.isVisibilityExplicit() &&
1436 !Context.getLangOpts().VisibilityInlinesHiddenStaticLocalVar) {
1437 assert(cast<VarDecl>(D)->isStaticLocal());
1438 // If this was an implicitly hidden inline method, check again for
1439 // explicit visibility on the parent class, and use that for static locals
1440 // if present.
1441 if (const auto *MD = dyn_cast<CXXMethodDecl>(FD))
1442 LV = getLVForDecl(MD->getParent(), computation);
1443 if (!LV.isVisibilityExplicit()) {
1444 Visibility globalVisibility =
1445 computation.isValueVisibility()
1446 ? Context.getLangOpts().getValueVisibilityMode()
1447 : Context.getLangOpts().getTypeVisibilityMode();
1448 return LinkageInfo(Linkage::VisibleNone, globalVisibility,
1449 /*visibilityExplicit=*/false);
1450 }
1451 }
1452 }
1454 return LinkageInfo::none();
1455 return LinkageInfo(Linkage::VisibleNone, LV.getVisibility(),
1457}
1458
1460 LVComputationKind computation,
1461 bool IgnoreVarTypeLinkage) {
1462 // Internal_linkage attribute overrides other considerations.
1463 if (D->hasAttr<InternalLinkageAttr>())
1464 return LinkageInfo::internal();
1465
1466 // Objective-C: treat all Objective-C declarations as having external
1467 // linkage.
1468 switch (D->getKind()) {
1469 default:
1470 break;
1471
1472 // Per C++ [basic.link]p2, only the names of objects, references,
1473 // functions, types, templates, namespaces, and values ever have linkage.
1474 //
1475 // Note that the name of a typedef, namespace alias, using declaration,
1476 // and so on are not the name of the corresponding type, namespace, or
1477 // declaration, so they do *not* have linkage.
1478 case Decl::ImplicitParam:
1479 case Decl::Label:
1480 case Decl::NamespaceAlias:
1481 case Decl::ParmVar:
1482 case Decl::Using:
1483 case Decl::UsingEnum:
1484 case Decl::UsingShadow:
1485 case Decl::UsingDirective:
1486 return LinkageInfo::none();
1487
1488 case Decl::EnumConstant:
1489 // C++ [basic.link]p4: an enumerator has the linkage of its enumeration.
1490 if (D->getASTContext().getLangOpts().CPlusPlus)
1491 return getLVForDecl(cast<EnumDecl>(D->getDeclContext()), computation);
1493
1494 case Decl::Typedef:
1495 case Decl::TypeAlias:
1496 // A typedef declaration has linkage if it gives a type a name for
1497 // linkage purposes.
1498 if (!cast<TypedefNameDecl>(D)
1499 ->getAnonDeclWithTypedefName(/*AnyRedecl*/true))
1500 return LinkageInfo::none();
1501 break;
1502
1503 case Decl::TemplateTemplateParm: // count these as external
1504 case Decl::NonTypeTemplateParm:
1505 case Decl::ObjCAtDefsField:
1506 case Decl::ObjCCategory:
1507 case Decl::ObjCCategoryImpl:
1508 case Decl::ObjCCompatibleAlias:
1509 case Decl::ObjCImplementation:
1510 case Decl::ObjCMethod:
1511 case Decl::ObjCProperty:
1512 case Decl::ObjCPropertyImpl:
1513 case Decl::ObjCProtocol:
1514 return getExternalLinkageFor(D);
1515
1516 case Decl::CXXRecord: {
1517 const auto *Record = cast<CXXRecordDecl>(D);
1518 if (Record->isLambda()) {
1519 if (Record->hasKnownLambdaInternalLinkage() ||
1520 !Record->getLambdaManglingNumber()) {
1521 // This lambda has no mangling number, so it's internal.
1522 return LinkageInfo::internal();
1523 }
1524
1525 return getLVForClosure(
1526 Record->getDeclContext()->getRedeclContext(),
1527 Record->getLambdaContextDecl(), computation);
1528 }
1529
1530 break;
1531 }
1532
1533 case Decl::TemplateParamObject: {
1534 // The template parameter object can be referenced from anywhere its type
1535 // and value can be referenced.
1536 auto *TPO = cast<TemplateParamObjectDecl>(D);
1537 LinkageInfo LV = getLVForType(*TPO->getType(), computation);
1538 LV.merge(getLVForValue(TPO->getValue(), computation));
1539 return LV;
1540 }
1541 }
1542
1543 // Handle linkage for namespace-scope names.
1545 return getLVForNamespaceScopeDecl(D, computation, IgnoreVarTypeLinkage);
1546
1547 // C++ [basic.link]p5:
1548 // In addition, a member function, static data member, a named
1549 // class or enumeration of class scope, or an unnamed class or
1550 // enumeration defined in a class-scope typedef declaration such
1551 // that the class or enumeration has the typedef name for linkage
1552 // purposes (7.1.3), has external linkage if the name of the class
1553 // has external linkage.
1554 if (D->getDeclContext()->isRecord())
1555 return getLVForClassMember(D, computation, IgnoreVarTypeLinkage);
1556
1557 // C++ [basic.link]p6:
1558 // The name of a function declared in block scope and the name of
1559 // an object declared by a block scope extern declaration have
1560 // linkage. If there is a visible declaration of an entity with
1561 // linkage having the same name and type, ignoring entities
1562 // declared outside the innermost enclosing namespace scope, the
1563 // block scope declaration declares that same entity and receives
1564 // the linkage of the previous declaration. If there is more than
1565 // one such matching entity, the program is ill-formed. Otherwise,
1566 // if no matching entity is found, the block scope entity receives
1567 // external linkage.
1569 return getLVForLocalDecl(D, computation);
1570
1571 // C++ [basic.link]p6:
1572 // Names not covered by these rules have no linkage.
1573 return LinkageInfo::none();
1574}
1575
1576/// getLVForDecl - Get the linkage and visibility for the given declaration.
1578 LVComputationKind computation) {
1579 // Internal_linkage attribute overrides other considerations.
1580 if (D->hasAttr<InternalLinkageAttr>())
1581 return LinkageInfo::internal();
1582
1583 if (computation.IgnoreAllVisibility && D->hasCachedLinkage())
1584 return LinkageInfo(D->getCachedLinkage(), DefaultVisibility, false);
1585
1586 if (std::optional<LinkageInfo> LI = lookup(D, computation))
1587 return *LI;
1588
1589 LinkageInfo LV = computeLVForDecl(D, computation);
1590 if (D->hasCachedLinkage())
1591 assert(D->getCachedLinkage() == LV.getLinkage());
1592
1594 cache(D, computation, LV);
1595
1596#ifndef NDEBUG
1597 // In C (because of gnu inline) and in c++ with microsoft extensions an
1598 // static can follow an extern, so we can have two decls with different
1599 // linkages.
1600 const LangOptions &Opts = D->getASTContext().getLangOpts();
1601 if (!Opts.CPlusPlus || Opts.MicrosoftExt)
1602 return LV;
1603
1604 // We have just computed the linkage for this decl. By induction we know
1605 // that all other computed linkages match, check that the one we just
1606 // computed also does.
1607 // We can't assume the redecl chain is well formed at this point,
1608 // so keep track of already visited declarations.
1609 for (llvm::SmallPtrSet<const Decl *, 4> AlreadyVisited{D}; /**/; /**/) {
1610 D = cast<NamedDecl>(const_cast<NamedDecl *>(D)->getNextRedeclarationImpl());
1611 if (!AlreadyVisited.insert(D).second)
1612 break;
1613 if (D->isInvalidDecl())
1614 continue;
1615 if (auto OldLinkage = D->getCachedLinkage();
1616 OldLinkage != Linkage::Invalid) {
1617 assert(LV.getLinkage() == OldLinkage);
1618 break;
1619 }
1620 }
1621#endif
1622
1623 return LV;
1624}
1625
1635
1637 if (isa<NamespaceDecl>(this))
1638 // Namespaces never have module linkage. It is the entities within them
1639 // that [may] do.
1640 return nullptr;
1641
1642 Module *M = getOwningModule();
1643 if (!M)
1644 return nullptr;
1645
1646 switch (M->Kind) {
1648 // Module map modules have no special linkage semantics.
1649 return nullptr;
1650
1655 return M;
1656
1660 // The global module shouldn't change the linkage.
1661 return nullptr;
1662
1664 // The private module fragment is part of its containing module for linkage
1665 // purposes.
1666 return M->Parent;
1667 }
1668
1669 llvm_unreachable("unknown module kind");
1670}
1671
1672void NamedDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
1673 Name.print(OS, Policy);
1674}
1675
1676void NamedDecl::printName(raw_ostream &OS) const {
1677 printName(OS, getASTContext().getPrintingPolicy());
1678}
1679
1681 std::string QualName;
1682 llvm::raw_string_ostream OS(QualName);
1683 printQualifiedName(OS, getASTContext().getPrintingPolicy());
1684 return QualName;
1685}
1686
1687void NamedDecl::printQualifiedName(raw_ostream &OS) const {
1688 printQualifiedName(OS, getASTContext().getPrintingPolicy());
1689}
1690
1692 const PrintingPolicy &P) const {
1693 if (getDeclContext()->isFunctionOrMethod()) {
1694 // We do not print '(anonymous)' for function parameters without name.
1695 printName(OS, P);
1696 return;
1697 }
1699 if (getDeclName()) {
1700 printName(OS, P);
1701 } else {
1702 // Give the printName override a chance to pick a different name before we
1703 // fall back to "(anonymous)".
1704 SmallString<64> NameBuffer;
1705 llvm::raw_svector_ostream NameOS(NameBuffer);
1706 printName(NameOS, P);
1707 if (NameBuffer.empty())
1708 OS << "(anonymous)";
1709 else
1710 OS << NameBuffer;
1711 }
1712}
1713
1714void NamedDecl::printNestedNameSpecifier(raw_ostream &OS) const {
1715 printNestedNameSpecifier(OS, getASTContext().getPrintingPolicy());
1716}
1717
1719 const PrintingPolicy &P) const {
1720 const DeclContext *Ctx = getDeclContext();
1721
1722 // For ObjC methods and properties, look through categories and use the
1723 // interface as context.
1724 if (auto *MD = dyn_cast<ObjCMethodDecl>(this)) {
1725 if (auto *ID = MD->getClassInterface())
1726 Ctx = ID;
1727 } else if (auto *PD = dyn_cast<ObjCPropertyDecl>(this)) {
1728 if (auto *MD = PD->getGetterMethodDecl())
1729 if (auto *ID = MD->getClassInterface())
1730 Ctx = ID;
1731 } else if (auto *ID = dyn_cast<ObjCIvarDecl>(this)) {
1732 if (auto *CI = ID->getContainingInterface())
1733 Ctx = CI;
1734 }
1735
1736 if (Ctx->isFunctionOrMethod())
1737 return;
1738
1739 using ContextsTy = SmallVector<const DeclContext *, 8>;
1740 ContextsTy Contexts;
1741
1742 // Collect named contexts.
1743 DeclarationName NameInScope = getDeclName();
1744 for (; Ctx; Ctx = Ctx->getParent()) {
1745 if (P.Callbacks && P.Callbacks->isScopeVisible(Ctx))
1746 continue;
1747
1748 // Suppress anonymous namespace if requested.
1750 cast<NamespaceDecl>(Ctx)->isAnonymousNamespace())
1751 continue;
1752
1753 // Suppress inline namespace if it doesn't make the result ambiguous.
1754 if (Ctx->isInlineNamespace() && NameInScope) {
1756 llvm::to_underlying(
1759 llvm::to_underlying(
1761 cast<NamespaceDecl>(Ctx)->isRedundantInlineQualifierFor(
1762 NameInScope))) {
1763 continue;
1764 }
1765 }
1766
1767 // Suppress transparent contexts like export or HLSLBufferDecl context
1768 if (Ctx->isTransparentContext())
1769 continue;
1770
1771 // Skip non-named contexts such as linkage specifications and ExportDecls.
1772 const NamedDecl *ND = dyn_cast<NamedDecl>(Ctx);
1773 if (!ND)
1774 continue;
1775
1776 Contexts.push_back(Ctx);
1777 NameInScope = ND->getDeclName();
1778 }
1779
1780 for (const DeclContext *DC : llvm::reverse(Contexts)) {
1781 if (const auto *Spec = dyn_cast<ClassTemplateSpecializationDecl>(DC)) {
1782 OS << Spec->getName();
1783 const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
1784 printTemplateArgumentList(
1785 OS, TemplateArgs.asArray(), P,
1786 Spec->getSpecializedTemplate()->getTemplateParameters());
1787 } else if (const auto *ND = dyn_cast<NamespaceDecl>(DC)) {
1788 if (ND->isAnonymousNamespace()) {
1789 OS << (P.MSVCFormatting ? "`anonymous namespace\'"
1790 : "(anonymous namespace)");
1791 }
1792 else
1793 OS << *ND;
1794 } else if (const auto *RD = dyn_cast<RecordDecl>(DC)) {
1795 if (TypedefNameDecl *TD = RD->getTypedefNameForAnonDecl())
1796 OS << *TD;
1797 else if (!RD->getIdentifier())
1798 OS << "(anonymous " << RD->getKindName() << ')';
1799 else
1800 OS << *RD;
1801 } else if (const auto *FD = dyn_cast<FunctionDecl>(DC)) {
1802 const FunctionProtoType *FT = nullptr;
1803 if (FD->hasWrittenPrototype())
1804 FT = dyn_cast<FunctionProtoType>(FD->getType()->castAs<FunctionType>());
1805
1806 OS << *FD << '(';
1807 if (FT) {
1808 unsigned NumParams = FD->getNumParams();
1809 for (unsigned i = 0; i < NumParams; ++i) {
1810 if (i)
1811 OS << ", ";
1812 OS << FD->getParamDecl(i)->getType().stream(P);
1813 }
1814
1815 if (FT->isVariadic()) {
1816 if (NumParams > 0)
1817 OS << ", ";
1818 OS << "...";
1819 }
1820 }
1821 OS << ')';
1822 } else if (const auto *ED = dyn_cast<EnumDecl>(DC)) {
1823 // C++ [dcl.enum]p10: Each enum-name and each unscoped
1824 // enumerator is declared in the scope that immediately contains
1825 // the enum-specifier. Each scoped enumerator is declared in the
1826 // scope of the enumeration.
1827 // For the case of unscoped enumerator, do not include in the qualified
1828 // name any information about its enum enclosing scope, as its visibility
1829 // is global.
1830 if (ED->isScoped())
1831 OS << *ED;
1832 else
1833 continue;
1834 } else {
1835 OS << *cast<NamedDecl>(DC);
1836 }
1837 OS << "::";
1838 }
1839}
1840
1842 const PrintingPolicy &Policy,
1843 bool Qualified) const {
1844 if (Qualified)
1845 printQualifiedName(OS, Policy);
1846 else
1847 printName(OS, Policy);
1848}
1849
1850template<typename T> static bool isRedeclarableImpl(Redeclarable<T> *) {
1851 return true;
1852}
1853static bool isRedeclarableImpl(...) { return false; }
1855 switch (K) {
1856#define DECL(Type, Base) \
1857 case Decl::Type: \
1858 return isRedeclarableImpl((Type##Decl *)nullptr);
1859#define ABSTRACT_DECL(DECL)
1860#include "clang/AST/DeclNodes.inc"
1861 }
1862 llvm_unreachable("unknown decl kind");
1863}
1864
1866 bool IsKnownNewer) const {
1867 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
1868
1869 // Never replace one imported declaration with another; we need both results
1870 // when re-exporting.
1871 if (OldD->isFromASTFile() && isFromASTFile())
1872 return false;
1873
1874 // A kind mismatch implies that the declaration is not replaced.
1875 if (OldD->getKind() != getKind())
1876 return false;
1877
1878 // For method declarations, we never replace. (Why?)
1879 if (isa<ObjCMethodDecl>(this))
1880 return false;
1881
1882 // For parameters, pick the newer one. This is either an error or (in
1883 // Objective-C) permitted as an extension.
1884 if (isa<ParmVarDecl>(this))
1885 return true;
1886
1887 // Inline namespaces can give us two declarations with the same
1888 // name and kind in the same scope but different contexts; we should
1889 // keep both declarations in this case.
1890 if (!this->getDeclContext()->getRedeclContext()->Equals(
1891 OldD->getDeclContext()->getRedeclContext()))
1892 return false;
1893
1894 // Using declarations can be replaced if they import the same name from the
1895 // same context.
1896 if (const auto *UD = dyn_cast<UsingDecl>(this))
1897 return UD->getQualifier().getCanonical() ==
1898
1899 cast<UsingDecl>(OldD)->getQualifier().getCanonical();
1900 if (const auto *UUVD = dyn_cast<UnresolvedUsingValueDecl>(this))
1901 return UUVD->getQualifier().getCanonical() ==
1902 cast<UnresolvedUsingValueDecl>(OldD)->getQualifier().getCanonical();
1903
1904 if (isRedeclarable(getKind())) {
1905 if (getCanonicalDecl() != OldD->getCanonicalDecl())
1906 return false;
1907
1908 if (IsKnownNewer)
1909 return true;
1910
1911 // Check whether this is actually newer than OldD. We want to keep the
1912 // newer declaration. This loop will usually only iterate once, because
1913 // OldD is usually the previous declaration.
1914 for (const auto *D : redecls()) {
1915 if (D == OldD)
1916 break;
1917
1918 // If we reach the canonical declaration, then OldD is not actually older
1919 // than this one.
1920 //
1921 // FIXME: In this case, we should not add this decl to the lookup table.
1922 if (D->isCanonicalDecl())
1923 return false;
1924 }
1925
1926 // It's a newer declaration of the same kind of declaration in the same
1927 // scope: we want this decl instead of the existing one.
1928 return true;
1929 }
1930
1931 // In all other cases, we need to keep both declarations in case they have
1932 // different visibility. Any attempt to use the name will result in an
1933 // ambiguity if more than one is visible.
1934 return false;
1935}
1936
1938 switch (getFormalLinkage()) {
1939 case Linkage::Invalid:
1940 llvm_unreachable("Linkage hasn't been computed!");
1941 case Linkage::None:
1942 return false;
1943 case Linkage::Internal:
1944 return true;
1947 llvm_unreachable("Non-formal linkage is not allowed here!");
1948 case Linkage::Module:
1949 case Linkage::External:
1950 return true;
1951 }
1952 llvm_unreachable("Unhandled Linkage enum");
1953}
1954
1955NamedDecl *NamedDecl::getUnderlyingDeclImpl() {
1956 NamedDecl *ND = this;
1957 if (auto *UD = dyn_cast<UsingShadowDecl>(ND))
1958 ND = UD->getTargetDecl();
1959
1960 if (auto *AD = dyn_cast<ObjCCompatibleAliasDecl>(ND))
1961 return AD->getClassInterface();
1962
1963 if (auto *AD = dyn_cast<NamespaceAliasDecl>(ND))
1964 return AD->getNamespace();
1965
1966 return ND;
1967}
1968
1970 if (!isCXXClassMember())
1971 return false;
1972
1973 const NamedDecl *D = this;
1974 if (isa<UsingShadowDecl>(D))
1975 D = cast<UsingShadowDecl>(D)->getTargetDecl();
1976
1978 return true;
1979 if (const auto *MD = dyn_cast_if_present<CXXMethodDecl>(D->getAsFunction()))
1980 return MD->isInstance();
1981 return false;
1982}
1983
1984//===----------------------------------------------------------------------===//
1985// DeclaratorDecl Implementation
1986//===----------------------------------------------------------------------===//
1987
1988template <typename DeclT>
1990 if (decl->getNumTemplateParameterLists() > 0)
1991 return decl->getTemplateParameterList(0)->getTemplateLoc();
1992 return decl->getInnerLocStart();
1993}
1994
1997 if (TSI) return TSI->getTypeLoc().getBeginLoc();
1998 return SourceLocation();
1999}
2000
2003 if (TSI) return TSI->getTypeLoc().getEndLoc();
2004 return SourceLocation();
2005}
2006
2008 if (QualifierLoc) {
2009 // Make sure the extended decl info is allocated.
2010 if (!hasExtInfo()) {
2011 // Save (non-extended) type source info pointer.
2012 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2013 // Allocate external info struct.
2014 DeclInfo = new (getASTContext()) ExtInfo;
2015 // Restore savedTInfo into (extended) decl info.
2016 getExtInfo()->TInfo = savedTInfo;
2017 }
2018 // Set qualifier info.
2019 getExtInfo()->QualifierLoc = QualifierLoc;
2020 } else if (hasExtInfo()) {
2021 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
2022 getExtInfo()->QualifierLoc = QualifierLoc;
2023 }
2024}
2025
2027 assert(AC);
2028 // Make sure the extended decl info is allocated.
2029 if (!hasExtInfo()) {
2030 // Save (non-extended) type source info pointer.
2031 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2032 // Allocate external info struct.
2033 DeclInfo = new (getASTContext()) ExtInfo;
2034 // Restore savedTInfo into (extended) decl info.
2035 getExtInfo()->TInfo = savedTInfo;
2036 }
2037 // Set requires clause info.
2038 getExtInfo()->TrailingRequiresClause = AC;
2039}
2040
2043 assert(!TPLists.empty());
2044 // Make sure the extended decl info is allocated.
2045 if (!hasExtInfo()) {
2046 // Save (non-extended) type source info pointer.
2047 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2048 // Allocate external info struct.
2049 DeclInfo = new (getASTContext()) ExtInfo;
2050 // Restore savedTInfo into (extended) decl info.
2051 getExtInfo()->TInfo = savedTInfo;
2052 }
2053 // Set the template parameter lists info.
2054 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
2055}
2056
2060
2061// Helper function: returns true if QT is or contains a type
2062// having a postfix component.
2063static bool typeIsPostfix(QualType QT) {
2064 while (true) {
2065 const Type* T = QT.getTypePtr();
2066 switch (T->getTypeClass()) {
2067 default:
2068 return false;
2069 case Type::Pointer:
2070 QT = cast<PointerType>(T)->getPointeeType();
2071 break;
2072 case Type::BlockPointer:
2073 QT = cast<BlockPointerType>(T)->getPointeeType();
2074 break;
2075 case Type::MemberPointer:
2076 QT = cast<MemberPointerType>(T)->getPointeeType();
2077 break;
2078 case Type::LValueReference:
2079 case Type::RValueReference:
2080 QT = cast<ReferenceType>(T)->getPointeeType();
2081 break;
2082 case Type::PackExpansion:
2083 QT = cast<PackExpansionType>(T)->getPattern();
2084 break;
2085 case Type::Paren:
2086 case Type::ConstantArray:
2087 case Type::DependentSizedArray:
2088 case Type::IncompleteArray:
2089 case Type::VariableArray:
2090 case Type::FunctionProto:
2091 case Type::FunctionNoProto:
2092 return true;
2093 }
2094 }
2095}
2096
2098 SourceLocation RangeEnd = getLocation();
2099 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
2100 // If the declaration has no name or the type extends past the name take the
2101 // end location of the type.
2102 if (!getDeclName() || typeIsPostfix(TInfo->getType()))
2103 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2104 }
2105 return SourceRange(getOuterLocStart(), RangeEnd);
2106}
2107
2110 // Free previous template parameters (if any).
2111 if (NumTemplParamLists > 0) {
2112 Context.Deallocate(TemplParamLists);
2113 TemplParamLists = nullptr;
2115 }
2116 // Set info on matched template parameter lists (if any).
2117 if (!TPLists.empty()) {
2118 TemplParamLists = new (Context) TemplateParameterList *[TPLists.size()];
2119 NumTemplParamLists = TPLists.size();
2120 llvm::copy(TPLists, TemplParamLists);
2121 }
2122}
2123
2124//===----------------------------------------------------------------------===//
2125// VarDecl Implementation
2126//===----------------------------------------------------------------------===//
2127
2129 switch (SC) {
2130 case SC_None: break;
2131 case SC_Auto: return "auto";
2132 case SC_Extern: return "extern";
2133 case SC_PrivateExtern: return "__private_extern__";
2134 case SC_Register: return "register";
2135 case SC_Static: return "static";
2136 }
2137
2138 llvm_unreachable("Invalid storage class");
2139}
2140
2142 SourceLocation StartLoc, SourceLocation IdLoc,
2143 const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
2144 StorageClass SC)
2145 : DeclaratorDecl(DK, DC, IdLoc, Id, T, TInfo, StartLoc),
2147 static_assert(sizeof(VarDeclBitfields) <= sizeof(unsigned),
2148 "VarDeclBitfields too large!");
2149 static_assert(sizeof(ParmVarDeclBitfields) <= sizeof(unsigned),
2150 "ParmVarDeclBitfields too large!");
2151 static_assert(sizeof(NonParmVarDeclBitfields) <= sizeof(unsigned),
2152 "NonParmVarDeclBitfields too large!");
2153 AllBits = 0;
2154 VarDeclBits.SClass = SC;
2155 // Everything else is implicitly initialized to false.
2156}
2157
2159 SourceLocation IdL, const IdentifierInfo *Id,
2161 return new (C, DC) VarDecl(Var, C, DC, StartL, IdL, Id, T, TInfo, S);
2162}
2163
2165 return new (C, ID)
2166 VarDecl(Var, C, nullptr, SourceLocation(), SourceLocation(), nullptr,
2167 QualType(), nullptr, SC_None);
2168}
2169
2171 assert(isLegalForVariable(SC));
2172 VarDeclBits.SClass = SC;
2173}
2174
2176 switch (VarDeclBits.TSCSpec) {
2177 case TSCS_unspecified:
2178 if (!hasAttr<ThreadAttr>() &&
2179 !(getASTContext().getLangOpts().OpenMPUseTLS &&
2180 getASTContext().getTargetInfo().isTLSSupported() &&
2182 return TLS_None;
2183 return ((getASTContext().getLangOpts().isCompatibleWithMSVC(
2186 ? TLS_Dynamic
2187 : TLS_Static;
2188 case TSCS___thread: // Fall through.
2189 case TSCS__Thread_local:
2190 return TLS_Static;
2191 case TSCS_thread_local:
2192 return TLS_Dynamic;
2193 }
2194 llvm_unreachable("Unknown thread storage class specifier!");
2195}
2196
2198 if (const Expr *Init = getInit()) {
2199 SourceLocation InitEnd = Init->getEndLoc();
2200 // If Init is implicit, ignore its source range and fallback on
2201 // DeclaratorDecl::getSourceRange() to handle postfix elements.
2202 if (InitEnd.isValid() && InitEnd != getLocation())
2203 return SourceRange(getOuterLocStart(), InitEnd);
2204 }
2206}
2207
2208template<typename T>
2210 // C++ [dcl.link]p1: All function types, function names with external linkage,
2211 // and variable names with external linkage have a language linkage.
2212 if (!D.hasExternalFormalLinkage())
2213 return NoLanguageLinkage;
2214
2215 // Language linkage is a C++ concept, but saying that everything else in C has
2216 // C language linkage fits the implementation nicely.
2217 if (!D.getASTContext().getLangOpts().CPlusPlus)
2218 return CLanguageLinkage;
2219
2220 // C++ [dcl.link]p4: A C language linkage is ignored in determining the
2221 // language linkage of the names of class members and the function type of
2222 // class member functions.
2223 const DeclContext *DC = D.getDeclContext();
2224 if (DC->isRecord())
2225 return CXXLanguageLinkage;
2226
2227 // If the first decl is in an extern "C" context, any other redeclaration
2228 // will have C language linkage. If the first one is not in an extern "C"
2229 // context, we would have reported an error for any other decl being in one.
2231 return CLanguageLinkage;
2232 return CXXLanguageLinkage;
2233}
2234
2235template<typename T>
2236static bool isDeclExternC(const T &D) {
2237 // Since the context is ignored for class members, they can only have C++
2238 // language linkage or no language linkage.
2239 const DeclContext *DC = D.getDeclContext();
2240 if (DC->isRecord()) {
2241 assert(D.getASTContext().getLangOpts().CPlusPlus);
2242 return false;
2243 }
2244
2245 return D.getLanguageLinkage() == CLanguageLinkage;
2246}
2247
2251
2253 return isDeclExternC(*this);
2254}
2255
2259
2263
2265
2269 return DeclarationOnly;
2270
2271 // C++ [basic.def]p2:
2272 // A declaration is a definition unless [...] it contains the 'extern'
2273 // specifier or a linkage-specification and neither an initializer [...],
2274 // it declares a non-inline static data member in a class declaration [...],
2275 // it declares a static data member outside a class definition and the variable
2276 // was defined within the class with the constexpr specifier [...],
2277 // C++1y [temp.expl.spec]p15:
2278 // An explicit specialization of a static data member or an explicit
2279 // specialization of a static data member template is a definition if the
2280 // declaration includes an initializer; otherwise, it is a declaration.
2281 //
2282 // FIXME: How do you declare (but not define) a partial specialization of
2283 // a static data member template outside the containing class?
2284 if (isStaticDataMember()) {
2285 if (isOutOfLine() &&
2286 !(getCanonicalDecl()->isInline() &&
2288 (hasInit() ||
2289 // If the first declaration is out-of-line, this may be an
2290 // instantiation of an out-of-line partial specialization of a variable
2291 // template for which we have not yet instantiated the initializer.
2297 return Definition;
2298 if (!isOutOfLine() && isInline())
2299 return Definition;
2300 return DeclarationOnly;
2301 }
2302 // C99 6.7p5:
2303 // A definition of an identifier is a declaration for that identifier that
2304 // [...] causes storage to be reserved for that object.
2305 // Note: that applies for all non-file-scope objects.
2306 // C99 6.9.2p1:
2307 // If the declaration of an identifier for an object has file scope and an
2308 // initializer, the declaration is an external definition for the identifier
2309 if (hasInit())
2310 return Definition;
2311
2312 if (hasDefiningAttr())
2313 return Definition;
2314
2315 if (const auto *SAA = getAttr<SelectAnyAttr>())
2316 if (!SAA->isInherited())
2317 return Definition;
2318
2319 // A variable template specialization (other than a static data member
2320 // template or an explicit specialization) is a declaration until we
2321 // instantiate its initializer.
2322 if (auto *VTSD = dyn_cast<VarTemplateSpecializationDecl>(this)) {
2323 if (VTSD->getTemplateSpecializationKind() != TSK_ExplicitSpecialization &&
2325 !VTSD->IsCompleteDefinition)
2326 return DeclarationOnly;
2327 }
2328
2329 if (hasExternalStorage())
2330 return DeclarationOnly;
2331
2332 // [dcl.link] p7:
2333 // A declaration directly contained in a linkage-specification is treated
2334 // as if it contains the extern specifier for the purpose of determining
2335 // the linkage of the declared name and whether it is a definition.
2336 if (isSingleLineLanguageLinkage(*this))
2337 return DeclarationOnly;
2338
2339 // C99 6.9.2p2:
2340 // A declaration of an object that has file scope without an initializer,
2341 // and without a storage class specifier or the scs 'static', constitutes
2342 // a tentative definition.
2343 // No such thing in C++.
2344 if (!C.getLangOpts().CPlusPlus && isFileVarDecl())
2345 return TentativeDefinition;
2346
2347 // What's left is (in C, block-scope) declarations without initializers or
2348 // external storage. These are definitions.
2349 return Definition;
2350}
2351
2355 return nullptr;
2356
2357 VarDecl *LastTentative = nullptr;
2358
2359 // Loop through the declaration chain, starting with the most recent.
2361 Decl = Decl->getPreviousDecl()) {
2362 Kind = Decl->isThisDeclarationADefinition();
2363 if (Kind == Definition)
2364 return nullptr;
2365 // Record the first (most recent) TentativeDefinition that is encountered.
2366 if (Kind == TentativeDefinition && !LastTentative)
2367 LastTentative = Decl;
2368 }
2369
2370 return LastTentative;
2371}
2372
2375 for (auto *I : First->redecls()) {
2376 if (I->isThisDeclarationADefinition(C) == Definition)
2377 return I;
2378 }
2379 return nullptr;
2380}
2381
2384
2385 const VarDecl *First = getFirstDecl();
2386 for (auto *I : First->redecls()) {
2387 Kind = std::max(Kind, I->isThisDeclarationADefinition(C));
2388 if (Kind == Definition)
2389 break;
2390 }
2391
2392 return Kind;
2393}
2394
2395const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
2396 for (auto *I : redecls()) {
2397 if (auto Expr = I->getInit()) {
2398 D = I;
2399 return Expr;
2400 }
2401 }
2402 return nullptr;
2403}
2404
2405bool VarDecl::hasInit() const {
2406 if (auto *P = dyn_cast<ParmVarDecl>(this))
2407 if (P->hasUnparsedDefaultArg() || P->hasUninstantiatedDefaultArg())
2408 return false;
2409
2410 if (auto *Eval = getEvaluatedStmt())
2411 return Eval->Value.isValid();
2412
2413 return !Init.isNull();
2414}
2415
2417 if (!hasInit())
2418 return nullptr;
2419
2420 if (auto *S = dyn_cast<Stmt *>(Init))
2421 return cast<Expr>(S);
2422
2423 auto *Eval = getEvaluatedStmt();
2424
2425 return cast<Expr>(Eval->Value.get(
2426 Eval->Value.isOffset() ? getASTContext().getExternalSource() : nullptr));
2427}
2428
2430 if (auto *ES = Init.dyn_cast<EvaluatedStmt *>())
2431 return ES->Value.getAddressOfPointer(getASTContext().getExternalSource());
2432
2433 return Init.getAddrOfPtr1();
2434}
2435
2437 VarDecl *Def = nullptr;
2438 for (auto *I : redecls()) {
2439 if (I->hasInit())
2440 return I;
2441
2442 if (I->isThisDeclarationADefinition()) {
2443 if (isStaticDataMember())
2444 return I;
2445 Def = I;
2446 }
2447 }
2448 return Def;
2449}
2450
2452 if (!hasInit())
2453 return false;
2454
2456 if (!ES->CheckedForSideEffects) {
2457 const Expr *E = getInit();
2458 ES->HasSideEffects =
2460 // We can get a value-dependent initializer during error recovery.
2461 (E->isValueDependent() || getType()->isDependentType() ||
2462 !evaluateValue());
2463 ES->CheckedForSideEffects = true;
2464 }
2465 return ES->HasSideEffects;
2466}
2467
2469 if (Decl::isOutOfLine())
2470 return true;
2471
2472 if (!isStaticDataMember())
2473 return false;
2474
2475 // If this static data member was instantiated from a static data member of
2476 // a class template, check whether that static data member was defined
2477 // out-of-line.
2479 return VD->isOutOfLine();
2480
2481 return false;
2482}
2483
2485 if (auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init)) {
2486 Eval->~EvaluatedStmt();
2487 getASTContext().Deallocate(Eval);
2488 }
2489
2490 Init = I;
2491}
2492
2494 const LangOptions &Lang = C.getLangOpts();
2495
2496 // OpenCL permits const integral variables to be used in constant
2497 // expressions, like in C++98.
2498 if (!Lang.CPlusPlus && !Lang.OpenCL && !Lang.C23)
2499 return false;
2500
2501 // Function parameters are never usable in constant expressions.
2502 if (isa<ParmVarDecl>(this))
2503 return false;
2504
2505 // The values of weak variables are never usable in constant expressions.
2506 if (isWeak())
2507 return false;
2508
2509 // In C++11, any variable of reference type can be used in a constant
2510 // expression if it is initialized by a constant expression.
2511 if (Lang.CPlusPlus11 && getType()->isReferenceType())
2512 return true;
2513
2514 // Only const objects can be used in constant expressions in C++. C++98 does
2515 // not require the variable to be non-volatile, but we consider this to be a
2516 // defect.
2517 if (!getType().isConstant(C) || getType().isVolatileQualified())
2518 return false;
2519
2520 // In C++, but not in C, const, non-volatile variables of integral or
2521 // enumeration types can be used in constant expressions.
2522 if (getType()->isIntegralOrEnumerationType() && !Lang.C23)
2523 return true;
2524
2525 // C23 6.6p7: An identifier that is:
2526 // ...
2527 // - declared with storage-class specifier constexpr and has an object type,
2528 // is a named constant, ... such a named constant is a constant expression
2529 // with the type and value of the declared object.
2530 // Additionally, in C++11, non-volatile constexpr variables can be used in
2531 // constant expressions.
2532 return (Lang.CPlusPlus11 || Lang.C23) && isConstexpr();
2533}
2534
2536 // C++2a [expr.const]p3:
2537 // A variable is usable in constant expressions after its initializing
2538 // declaration is encountered...
2539 const VarDecl *DefVD = nullptr;
2540 const Expr *Init = getAnyInitializer(DefVD);
2541 if (!Init || Init->isValueDependent() || getType()->isDependentType())
2542 return false;
2543 // ... if it is a constexpr variable, or it is of reference type or of
2544 // const-qualified integral or enumeration type, ...
2545 if (!DefVD->mightBeUsableInConstantExpressions(Context))
2546 return false;
2547 // ... and its initializer is a constant initializer.
2548 if ((Context.getLangOpts().CPlusPlus || getLangOpts().C23) &&
2549 !DefVD->hasConstantInitialization())
2550 return false;
2551 // C++98 [expr.const]p1:
2552 // An integral constant-expression can involve only [...] const variables
2553 // or static data members of integral or enumeration types initialized with
2554 // [integer] constant expressions (dcl.init)
2555 if ((Context.getLangOpts().CPlusPlus || Context.getLangOpts().OpenCL) &&
2556 !Context.getLangOpts().CPlusPlus11 && !DefVD->hasICEInitializer(Context))
2557 return false;
2558 return true;
2559}
2560
2561/// Convert the initializer for this declaration to the elaborated EvaluatedStmt
2562/// form, which contains extra information on the evaluated value of the
2563/// initializer.
2565 auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init);
2566 if (!Eval) {
2567 // Note: EvaluatedStmt contains an APValue, which usually holds
2568 // resources not allocated from the ASTContext. We need to do some
2569 // work to avoid leaking those, but we do so in VarDecl::evaluateValue
2570 // where we can detect whether there's anything to clean up or not.
2571 Eval = new (getASTContext()) EvaluatedStmt;
2572 Eval->Value = cast<Stmt *>(Init);
2573 Init = Eval;
2574 }
2575 return Eval;
2576}
2577
2579 return dyn_cast_if_present<EvaluatedStmt *>(Init);
2580}
2581
2584 return evaluateValueImpl(Notes, hasConstantInitialization());
2585}
2586
2587APValue *VarDecl::evaluateValueImpl(SmallVectorImpl<PartialDiagnosticAt> &Notes,
2588 bool IsConstantInitialization) const {
2590
2591 const auto *Init = getInit();
2592 assert(!Init->isValueDependent());
2593
2594 // We only produce notes indicating why an initializer is non-constant the
2595 // first time it is evaluated. FIXME: The notes won't always be emitted the
2596 // first time we try evaluation, so might not be produced at all.
2597 if (Eval->WasEvaluated)
2598 return Eval->Evaluated.isAbsent() ? nullptr : &Eval->Evaluated;
2599
2600 if (Eval->IsEvaluating) {
2601 // FIXME: Produce a diagnostic for self-initialization.
2602 return nullptr;
2603 }
2604
2605 Eval->IsEvaluating = true;
2606
2607 ASTContext &Ctx = getASTContext();
2608 bool Result = Init->EvaluateAsInitializer(Eval->Evaluated, Ctx, this, Notes,
2609 IsConstantInitialization);
2610
2611 // In C++, or in C23 if we're initialising a 'constexpr' variable, this isn't
2612 // a constant initializer if we produced notes. In that case, we can't keep
2613 // the result, because it may only be correct under the assumption that the
2614 // initializer is a constant context.
2615 if (IsConstantInitialization &&
2616 (Ctx.getLangOpts().CPlusPlus ||
2617 (isConstexpr() && Ctx.getLangOpts().C23)) &&
2618 !Notes.empty())
2619 Result = false;
2620
2621 // Ensure the computed APValue is cleaned up later if evaluation succeeded,
2622 // or that it's empty (so that there's nothing to clean up) if evaluation
2623 // failed.
2624 if (!Result)
2625 Eval->Evaluated = APValue();
2626 else if (Eval->Evaluated.needsCleanup())
2627 Ctx.addDestruction(&Eval->Evaluated);
2628
2629 Eval->IsEvaluating = false;
2630 Eval->WasEvaluated = true;
2631
2632 return Result ? &Eval->Evaluated : nullptr;
2633}
2634
2636 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2637 if (Eval->WasEvaluated)
2638 return &Eval->Evaluated;
2639
2640 return nullptr;
2641}
2642
2643bool VarDecl::hasICEInitializer(const ASTContext &Context) const {
2644 const Expr *Init = getInit();
2645 assert(Init && "no initializer");
2646
2648 if (!Eval->CheckedForICEInit) {
2649 Eval->CheckedForICEInit = true;
2650 Eval->HasICEInit = Init->isIntegerConstantExpr(Context);
2651 }
2652 return Eval->HasICEInit;
2653}
2654
2656 // In C, all globals and constexpr variables should have constant
2657 // initialization. For constexpr variables in C check that initializer is a
2658 // constant initializer because they can be used in constant expressions.
2660 !isConstexpr())
2661 return true;
2662
2663 // In C++, it depends on whether the evaluation at the point of definition
2664 // was evaluatable as a constant initializer.
2665 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2666 return Eval->HasConstantInitialization;
2667
2668 return false;
2669}
2670
2674 // If we ask for the value before we know whether we have a constant
2675 // initializer, we can compute the wrong value (for example, due to
2676 // std::is_constant_evaluated()).
2677 assert(!Eval->WasEvaluated &&
2678 "already evaluated var value before checking for constant init");
2679 assert((getASTContext().getLangOpts().CPlusPlus ||
2681 "only meaningful in C++/C23");
2682
2683 assert(!getInit()->isValueDependent());
2684
2685 // Evaluate the initializer to check whether it's a constant expression.
2687 evaluateValueImpl(Notes, true) && Notes.empty();
2688
2689 // If evaluation as a constant initializer failed, allow re-evaluation as a
2690 // non-constant initializer if we later find we want the value.
2691 if (!Eval->HasConstantInitialization)
2692 Eval->WasEvaluated = false;
2693
2694 return Eval->HasConstantInitialization;
2695}
2696
2697template<typename DeclT>
2698static DeclT *getDefinitionOrSelf(DeclT *D) {
2699 assert(D);
2700 if (auto *Def = D->getDefinition())
2701 return Def;
2702 return D;
2703}
2704
2706 return hasAttr<BlocksAttr>() && NonParmVarDeclBits.EscapingByref;
2707}
2708
2710 return hasAttr<BlocksAttr>() && !NonParmVarDeclBits.EscapingByref;
2711}
2712
2714 QualType T = getType();
2715 return T->isDependentType() || T->isUndeducedType() ||
2716 llvm::any_of(specific_attrs<AlignedAttr>(), [](const AlignedAttr *AA) {
2717 return AA->isAlignmentDependent();
2718 });
2719}
2720
2722 const VarDecl *VD = this;
2723
2724 // If this is an instantiated member, walk back to the template from which
2725 // it was instantiated.
2727 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
2729 while (auto *NewVD = VD->getInstantiatedFromStaticDataMember())
2730 VD = NewVD;
2731 }
2732 }
2733
2734 // If it's an instantiated variable template specialization, find the
2735 // template or partial specialization from which it was instantiated.
2736 if (auto *VDTemplSpec = dyn_cast<VarTemplateSpecializationDecl>(VD)) {
2737 if (isTemplateInstantiation(VDTemplSpec->getTemplateSpecializationKind())) {
2738 auto From = VDTemplSpec->getInstantiatedFrom();
2739 if (auto *VTD = From.dyn_cast<VarTemplateDecl *>()) {
2740 while (!VTD->isMemberSpecialization()) {
2741 auto *NewVTD = VTD->getInstantiatedFromMemberTemplate();
2742 if (!NewVTD)
2743 break;
2744 VTD = NewVTD;
2745 }
2746 return getDefinitionOrSelf(VTD->getTemplatedDecl());
2747 }
2748 if (auto *VTPSD =
2749 From.dyn_cast<VarTemplatePartialSpecializationDecl *>()) {
2750 while (!VTPSD->isMemberSpecialization()) {
2751 auto *NewVTPSD = VTPSD->getInstantiatedFromMember();
2752 if (!NewVTPSD)
2753 break;
2754 VTPSD = NewVTPSD;
2755 }
2756 return getDefinitionOrSelf<VarDecl>(VTPSD);
2757 }
2758 }
2759 }
2760
2761 // If this is the pattern of a variable template, find where it was
2762 // instantiated from. FIXME: Is this necessary?
2764 while (!VarTemplate->isMemberSpecialization()) {
2765 auto *NewVT = VarTemplate->getInstantiatedFromMemberTemplate();
2766 if (!NewVT)
2767 break;
2768 VarTemplate = NewVT;
2769 }
2770
2771 return getDefinitionOrSelf(VarTemplate->getTemplatedDecl());
2772 }
2773
2774 if (VD == this)
2775 return nullptr;
2776 return getDefinitionOrSelf(const_cast<VarDecl*>(VD));
2777}
2778
2781 return cast<VarDecl>(MSI->getInstantiatedFrom());
2782
2783 return nullptr;
2784}
2785
2787 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2788 return Spec->getSpecializationKind();
2789
2791 return MSI->getTemplateSpecializationKind();
2792
2793 return TSK_Undeclared;
2794}
2795
2799 return MSI->getTemplateSpecializationKind();
2800
2801 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2802 return Spec->getSpecializationKind();
2803
2804 return TSK_Undeclared;
2805}
2806
2808 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2809 return Spec->getPointOfInstantiation();
2810
2812 return MSI->getPointOfInstantiation();
2813
2814 return SourceLocation();
2815}
2816
2818 return dyn_cast_if_present<VarTemplateDecl *>(
2819 getASTContext().getTemplateOrSpecializationInfo(this));
2820}
2821
2825
2827 const auto &LangOpts = getASTContext().getLangOpts();
2828 // In CUDA mode without relocatable device code, variables of form 'extern
2829 // __shared__ Foo foo[]' are pointers to the base of the GPU core's shared
2830 // memory pool. These are never undefined variables, even if they appear
2831 // inside of an anon namespace or static function.
2832 //
2833 // With CUDA relocatable device code enabled, these variables don't get
2834 // special handling; they're treated like regular extern variables.
2835 if (LangOpts.CUDA && !LangOpts.GPURelocatableDeviceCode &&
2838 return true;
2839
2840 return hasDefinition();
2841}
2842
2843bool VarDecl::isNoDestroy(const ASTContext &Ctx) const {
2844 if (!hasGlobalStorage())
2845 return false;
2847 return true;
2849 return false;
2850
2852 RSDKind K = Ctx.getLangOpts().getRegisterStaticDestructors();
2853 return K == RSDKind::None ||
2854 (K == RSDKind::ThreadLocal && getTLSKind() == TLS_None);
2855}
2856
2859 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2860 if (Eval->HasConstantDestruction)
2861 return QualType::DK_none;
2862
2863 if (isNoDestroy(Ctx))
2864 return QualType::DK_none;
2865
2866 return getType().isDestructedType();
2867}
2868
2870 assert(hasInit() && "Expect initializer to check for flexible array init");
2871 auto *D = getType()->getAsRecordDecl();
2872 if (!D || !D->hasFlexibleArrayMember())
2873 return false;
2874 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2875 if (!List)
2876 return false;
2877 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2878 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2879 if (!InitTy)
2880 return false;
2881 return !InitTy->isZeroSize();
2882}
2883
2885 assert(hasInit() && "Expect initializer to check for flexible array init");
2886 auto *RD = getType()->getAsRecordDecl();
2887 if (!RD || !RD->hasFlexibleArrayMember())
2888 return CharUnits::Zero();
2889 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2890 if (!List || List->getNumInits() == 0)
2891 return CharUnits::Zero();
2892 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2893 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2894 if (!InitTy)
2895 return CharUnits::Zero();
2896 CharUnits FlexibleArraySize = Ctx.getTypeSizeInChars(InitTy);
2897 const ASTRecordLayout &RL = Ctx.getASTRecordLayout(RD);
2898 CharUnits FlexibleArrayOffset =
2900 if (FlexibleArrayOffset + FlexibleArraySize < RL.getSize())
2901 return CharUnits::Zero();
2902 return FlexibleArrayOffset + FlexibleArraySize - RL.getSize();
2903}
2904
2906 if (isStaticDataMember())
2907 // FIXME: Remove ?
2908 // return getASTContext().getInstantiatedFromStaticDataMember(this);
2909 return dyn_cast_if_present<MemberSpecializationInfo *>(
2910 getASTContext().getTemplateOrSpecializationInfo(this));
2911 return nullptr;
2912}
2913
2915 SourceLocation PointOfInstantiation) {
2916 assert((isa<VarTemplateSpecializationDecl>(this) ||
2918 "not a variable or static data member template specialization");
2919
2921 dyn_cast<VarTemplateSpecializationDecl>(this)) {
2922 Spec->setSpecializationKind(TSK);
2923 if (TSK != TSK_ExplicitSpecialization &&
2924 PointOfInstantiation.isValid() &&
2925 Spec->getPointOfInstantiation().isInvalid()) {
2926 Spec->setPointOfInstantiation(PointOfInstantiation);
2928 L->InstantiationRequested(this);
2929 }
2931 MSI->setTemplateSpecializationKind(TSK);
2932 if (TSK != TSK_ExplicitSpecialization && PointOfInstantiation.isValid() &&
2933 MSI->getPointOfInstantiation().isInvalid()) {
2934 MSI->setPointOfInstantiation(PointOfInstantiation);
2936 L->InstantiationRequested(this);
2937 }
2938 }
2939}
2940
2941void
2944 assert(getASTContext().getTemplateOrSpecializationInfo(this).isNull() &&
2945 "Previous template or instantiation?");
2947}
2948
2949//===----------------------------------------------------------------------===//
2950// ParmVarDecl Implementation
2951//===----------------------------------------------------------------------===//
2952
2954 SourceLocation StartLoc, SourceLocation IdLoc,
2955 const IdentifierInfo *Id, QualType T,
2956 TypeSourceInfo *TInfo, StorageClass S,
2957 Expr *DefArg) {
2958 return new (C, DC) ParmVarDecl(ParmVar, C, DC, StartLoc, IdLoc, Id, T, TInfo,
2959 S, DefArg);
2960}
2961
2964 QualType T = TSI ? TSI->getType() : getType();
2965 if (const auto *DT = dyn_cast<DecayedType>(T))
2966 return DT->getOriginalType();
2967 return T;
2968}
2969
2971 return new (C, ID)
2972 ParmVarDecl(ParmVar, C, nullptr, SourceLocation(), SourceLocation(),
2973 nullptr, QualType(), nullptr, SC_None, nullptr);
2974}
2975
2977 if (!hasInheritedDefaultArg()) {
2978 SourceRange ArgRange = getDefaultArgRange();
2979 if (ArgRange.isValid())
2980 return SourceRange(getOuterLocStart(), ArgRange.getEnd());
2981 }
2982
2983 // DeclaratorDecl considers the range of postfix types as overlapping with the
2984 // declaration name, but this is not the case with parameters in ObjC methods.
2987
2989}
2990
2992 // ns_consumed only affects code generation in ARC
2994 return getASTContext().getLangOpts().ObjCAutoRefCount;
2995
2996 // FIXME: isParamDestroyedInCallee() should probably imply
2997 // isDestructedType()
2998 const auto *RT = getType()->getAsCanonical<RecordType>();
2999 if (RT && RT->getDecl()->getDefinitionOrSelf()->isParamDestroyedInCallee() &&
3000 getType().isDestructedType())
3001 return true;
3002
3003 return false;
3004}
3005
3007 assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
3008 assert(!hasUninstantiatedDefaultArg() &&
3009 "Default argument is not yet instantiated!");
3010
3011 Expr *Arg = getInit();
3012 if (auto *E = dyn_cast_if_present<FullExpr>(Arg))
3013 return E->getSubExpr();
3014
3015 return Arg;
3016}
3017
3019 ParmVarDeclBits.DefaultArgKind = DAK_Normal;
3020 Init = defarg;
3021}
3022
3024 switch (ParmVarDeclBits.DefaultArgKind) {
3025 case DAK_None:
3026 case DAK_Unparsed:
3027 // Nothing we can do here.
3028 return SourceRange();
3029
3030 case DAK_Uninstantiated:
3032
3033 case DAK_Normal:
3034 if (const Expr *E = getInit())
3035 return E->getSourceRange();
3036
3037 // Missing an actual expression, may be invalid.
3038 return SourceRange();
3039 }
3040 llvm_unreachable("Invalid default argument kind.");
3041}
3042
3044 ParmVarDeclBits.DefaultArgKind = DAK_Uninstantiated;
3045 Init = arg;
3046}
3047
3049 assert(hasUninstantiatedDefaultArg() &&
3050 "Wrong kind of initialization expression!");
3051 return cast_if_present<Expr>(cast<Stmt *>(Init));
3052}
3053
3055 // FIXME: We should just return false for DAK_None here once callers are
3056 // prepared for the case that we encountered an invalid default argument and
3057 // were unable to even build an invalid expression.
3059 !Init.isNull();
3060}
3061
3062void ParmVarDecl::setParameterIndexLarge(unsigned parameterIndex) {
3063 getASTContext().setParameterIndex(this, parameterIndex);
3064 ParmVarDeclBits.ParameterIndex = ParameterIndexSentinel;
3065}
3066
3067unsigned ParmVarDecl::getParameterIndexLarge() const {
3068 return getASTContext().getParameterIndex(this);
3069}
3070
3071//===----------------------------------------------------------------------===//
3072// FunctionDecl Implementation
3073//===----------------------------------------------------------------------===//
3074
3076 SourceLocation StartLoc,
3077 const DeclarationNameInfo &NameInfo, QualType T,
3078 TypeSourceInfo *TInfo, StorageClass S,
3080 ConstexprSpecKind ConstexprKind,
3081 const AssociatedConstraint &TrailingRequiresClause)
3082 : DeclaratorDecl(DK, DC, NameInfo.getLoc(), NameInfo.getName(), T, TInfo,
3083 StartLoc),
3084 DeclContext(DK), redeclarable_base(C), Body(), ODRHash(0),
3085 EndRangeLoc(NameInfo.getEndLoc()), DNLoc(NameInfo.getInfo()) {
3086 assert(T.isNull() || T->isFunctionType());
3087 FunctionDeclBits.SClass = S;
3089 FunctionDeclBits.IsInlineSpecified = isInlineSpecified;
3090 FunctionDeclBits.IsVirtualAsWritten = false;
3091 FunctionDeclBits.IsPureVirtual = false;
3092 FunctionDeclBits.HasInheritedPrototype = false;
3093 FunctionDeclBits.HasWrittenPrototype = true;
3094 FunctionDeclBits.IsDeleted = false;
3095 FunctionDeclBits.IsTrivial = false;
3096 FunctionDeclBits.IsTrivialForCall = false;
3097 FunctionDeclBits.IsDefaulted = false;
3098 FunctionDeclBits.IsExplicitlyDefaulted = false;
3099 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3100 FunctionDeclBits.IsIneligibleOrNotSelected = false;
3101 FunctionDeclBits.HasImplicitReturnZero = false;
3102 FunctionDeclBits.IsLateTemplateParsed = false;
3103 FunctionDeclBits.IsInstantiatedFromMemberTemplate = false;
3104 FunctionDeclBits.ConstexprKind = static_cast<uint64_t>(ConstexprKind);
3105 FunctionDeclBits.BodyContainsImmediateEscalatingExpression = false;
3106 FunctionDeclBits.InstantiationIsPending = false;
3107 FunctionDeclBits.UsesSEHTry = false;
3108 FunctionDeclBits.UsesFPIntrin = UsesFPIntrin;
3109 FunctionDeclBits.HasSkippedBody = false;
3110 FunctionDeclBits.WillHaveBody = false;
3111 FunctionDeclBits.IsMultiVersion = false;
3112 FunctionDeclBits.DeductionCandidateKind =
3113 static_cast<unsigned char>(DeductionCandidate::Normal);
3114 FunctionDeclBits.HasODRHash = false;
3115 FunctionDeclBits.FriendConstraintRefersToEnclosingTemplate = false;
3116
3117 if (TrailingRequiresClause)
3118 setTrailingRequiresClause(TrailingRequiresClause);
3119}
3120
3122 raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const {
3125 if (TemplateArgs)
3126 printTemplateArgumentList(OS, TemplateArgs->asArray(), Policy);
3127}
3128
3130 if (const auto *FT = getType()->getAs<FunctionProtoType>())
3131 return FT->isVariadic();
3132 return false;
3133}
3134
3137 ASTContext &Context, ArrayRef<DeclAccessPair> Lookups,
3138 StringLiteral *DeletedMessage) {
3139 static constexpr size_t Alignment =
3140 std::max({alignof(DefaultedOrDeletedFunctionInfo),
3141 alignof(DeclAccessPair), alignof(StringLiteral *)});
3142 size_t Size = totalSizeToAlloc<DeclAccessPair, StringLiteral *>(
3143 Lookups.size(), DeletedMessage != nullptr);
3144
3146 new (Context.Allocate(Size, Alignment)) DefaultedOrDeletedFunctionInfo;
3147 Info->NumLookups = Lookups.size();
3148 Info->HasDeletedMessage = DeletedMessage != nullptr;
3149
3150 llvm::uninitialized_copy(Lookups, Info->getTrailingObjects<DeclAccessPair>());
3151 if (DeletedMessage)
3152 *Info->getTrailingObjects<StringLiteral *>() = DeletedMessage;
3153 return Info;
3154}
3155
3158 assert(!FunctionDeclBits.HasDefaultedOrDeletedInfo && "already have this");
3159 assert(!Body && "can't replace function body with defaulted function info");
3160
3161 FunctionDeclBits.HasDefaultedOrDeletedInfo = true;
3163}
3164
3166 FunctionDeclBits.IsDeleted = D;
3167
3168 if (Message) {
3169 assert(isDeletedAsWritten() && "Function must be deleted");
3170 if (FunctionDeclBits.HasDefaultedOrDeletedInfo)
3171 DefaultedOrDeletedInfo->setDeletedMessage(Message);
3172 else
3174 getASTContext(), /*Lookups=*/{}, Message));
3175 }
3176}
3177
3179 StringLiteral *Message) {
3180 // We should never get here with the DefaultedOrDeletedInfo populated, but
3181 // no space allocated for the deleted message, since that would require
3182 // recreating this, but setDefaultedOrDeletedInfo() disallows overwriting
3183 // an already existing DefaultedOrDeletedFunctionInfo.
3184 assert(HasDeletedMessage &&
3185 "No space to store a delete message in this DefaultedOrDeletedInfo");
3186 *getTrailingObjects<StringLiteral *>() = Message;
3187}
3188
3191 return FunctionDeclBits.HasDefaultedOrDeletedInfo ? DefaultedOrDeletedInfo
3192 : nullptr;
3193}
3194
3196 for (const auto *I : redecls()) {
3197 if (I->doesThisDeclarationHaveABody()) {
3198 Definition = I;
3199 return true;
3200 }
3201 }
3202
3203 return false;
3204}
3205
3207 const Stmt *S = getBody();
3208 if (!S) {
3209 // Since we don't have a body for this function, we don't know if it's
3210 // trivial or not.
3211 return false;
3212 }
3213
3214 if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
3215 return true;
3216 return false;
3217}
3218
3220 if (!getFriendObjectKind())
3221 return false;
3222
3223 // Check for a friend function instantiated from a friend function
3224 // definition in a templated class.
3225 if (const FunctionDecl *InstantiatedFrom =
3227 return InstantiatedFrom->getFriendObjectKind() &&
3228 InstantiatedFrom->isThisDeclarationADefinition();
3229
3230 // Check for a friend function template instantiated from a friend
3231 // function template definition in a templated class.
3233 if (const FunctionTemplateDecl *InstantiatedFrom =
3234 Template->getInstantiatedFromMemberTemplate())
3235 return InstantiatedFrom->getFriendObjectKind() &&
3236 InstantiatedFrom->isThisDeclarationADefinition();
3237 }
3238
3239 return false;
3240}
3241
3243 bool CheckForPendingFriendDefinition) const {
3244 for (const FunctionDecl *FD : redecls()) {
3245 if (FD->isThisDeclarationADefinition()) {
3246 Definition = FD;
3247 return true;
3248 }
3249
3250 // If this is a friend function defined in a class template, it does not
3251 // have a body until it is used, nevertheless it is a definition, see
3252 // [temp.inst]p2:
3253 //
3254 // ... for the purpose of determining whether an instantiated redeclaration
3255 // is valid according to [basic.def.odr] and [class.mem], a declaration that
3256 // corresponds to a definition in the template is considered to be a
3257 // definition.
3258 //
3259 // The following code must produce redefinition error:
3260 //
3261 // template<typename T> struct C20 { friend void func_20() {} };
3262 // C20<int> c20i;
3263 // void func_20() {}
3264 //
3265 if (CheckForPendingFriendDefinition &&
3266 FD->isThisDeclarationInstantiatedFromAFriendDefinition()) {
3267 Definition = FD;
3268 return true;
3269 }
3270 }
3271
3272 return false;
3273}
3274
3276 if (!hasBody(Definition))
3277 return nullptr;
3278
3279 assert(!Definition->FunctionDeclBits.HasDefaultedOrDeletedInfo &&
3280 "definition should not have a body");
3281 if (Definition->Body)
3282 return Definition->Body.get(getASTContext().getExternalSource());
3283
3284 return nullptr;
3285}
3286
3288 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3289 Body = LazyDeclStmtPtr(B);
3290 if (B)
3291 EndRangeLoc = B->getEndLoc();
3292}
3293
3295 FunctionDeclBits.IsPureVirtual = P;
3296 if (P)
3297 if (auto *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
3298 Parent->markedVirtualFunctionPure();
3299}
3300
3301template<std::size_t Len>
3302static bool isNamed(const NamedDecl *ND, const char (&Str)[Len]) {
3303 const IdentifierInfo *II = ND->getIdentifier();
3304 return II && II->isStr(Str);
3305}
3306
3308 // C++23 [expr.const]/p17
3309 // An immediate-escalating function is
3310 // - the call operator of a lambda that is not declared with the consteval
3311 // specifier,
3312 if (isLambdaCallOperator(this) && !isConsteval())
3313 return true;
3314 // - a defaulted special member function that is not declared with the
3315 // consteval specifier,
3316 if (isDefaulted() && !isConsteval())
3317 return true;
3318
3319 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3320 CD && CD->isInheritingConstructor())
3321 return CD->getInheritedConstructor().getConstructor();
3322
3323 // Destructors are not immediate escalating.
3324 if (isa<CXXDestructorDecl>(this))
3325 return false;
3326
3327 // - a function that results from the instantiation of a templated entity
3328 // defined with the constexpr specifier.
3330 if (TK != TK_NonTemplate && TK != TK_DependentNonTemplate &&
3332 return true;
3333 return false;
3334}
3335
3337 // C++23 [expr.const]/p18
3338 // An immediate function is a function or constructor that is
3339 // - declared with the consteval specifier
3340 if (isConsteval())
3341 return true;
3342 // - an immediate-escalating function F whose function body contains an
3343 // immediate-escalating expression
3345 return true;
3346
3347 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3348 CD && CD->isInheritingConstructor())
3349 return CD->getInheritedConstructor()
3350 .getConstructor()
3351 ->isImmediateFunction();
3352
3354 P && P->isImmediateFunction())
3355 return true;
3356
3357 if (const auto *MD = dyn_cast<CXXMethodDecl>(this);
3358 MD && MD->isLambdaStaticInvoker())
3359 return MD->getParent()->getLambdaCallOperator()->isImmediateFunction();
3360
3361 return false;
3362}
3363
3365 return isNamed(this, "main") && !getLangOpts().Freestanding &&
3366 !getLangOpts().HLSL &&
3368 isExternC());
3369}
3370
3372 const TranslationUnitDecl *TUnit =
3373 dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
3374 if (!TUnit)
3375 return false;
3376
3377 // Even though we aren't really targeting MSVCRT if we are freestanding,
3378 // semantic analysis for these functions remains the same.
3379
3380 // MSVCRT entry points only exist on MSVCRT targets.
3381 if (!TUnit->getASTContext().getTargetInfo().getTriple().isOSMSVCRT() &&
3382 !TUnit->getASTContext().getTargetInfo().getTriple().isUEFI())
3383 return false;
3384
3385 // Nameless functions like constructors cannot be entry points.
3386 if (!getIdentifier())
3387 return false;
3388
3389 return llvm::StringSwitch<bool>(getName())
3390 .Cases({"main", // an ANSI console app
3391 "wmain", // a Unicode console App
3392 "WinMain", // an ANSI GUI app
3393 "wWinMain", // a Unicode GUI app
3394 "DllMain"}, // a DLL
3395 true)
3396 .Default(false);
3397}
3398
3400 if (!getDeclName().isAnyOperatorNewOrDelete())
3401 return false;
3402
3404 return false;
3405
3407 return false;
3408
3409 const auto *proto = getType()->castAs<FunctionProtoType>();
3410 if (proto->getNumParams() != 2 || proto->isVariadic())
3411 return false;
3412
3413 const ASTContext &Context =
3415 ->getASTContext();
3416
3417 // The result type and first argument type are constant across all
3418 // these operators. The second argument must be exactly void*.
3419 return (proto->getParamType(1).getCanonicalType() == Context.VoidPtrTy);
3420}
3421
3423 UnsignedOrNone *AlignmentParam, bool *IsNothrow) const {
3424 if (!getDeclName().isAnyOperatorNewOrDelete())
3425 return false;
3426
3428 return false;
3429
3430 // This can only fail for an invalid 'operator new' declaration.
3432 return false;
3433
3434 if (isVariadic())
3435 return false;
3436
3438 bool IsDelete = getDeclName().isAnyOperatorDelete();
3439 unsigned RequiredParameterCount =
3442 if (AlignmentParam)
3443 *AlignmentParam =
3444 /* type identity */ 1U + /* address */ IsDelete + /* size */ 1U;
3445 if (RequiredParameterCount == getNumParams())
3446 return true;
3447 if (getNumParams() > RequiredParameterCount + 1)
3448 return false;
3449 if (!getParamDecl(RequiredParameterCount)->getType()->isNothrowT())
3450 return false;
3451
3452 if (IsNothrow)
3453 *IsNothrow = true;
3454 return true;
3455 }
3456
3457 const auto *FPT = getType()->castAs<FunctionProtoType>();
3458 if (FPT->getNumParams() == 0 || FPT->getNumParams() > 4)
3459 return false;
3460
3461 // If this is a single-parameter function, it must be a replaceable global
3462 // allocation or deallocation function.
3463 if (FPT->getNumParams() == 1)
3464 return true;
3465
3466 unsigned Params = 1;
3467 QualType Ty = FPT->getParamType(Params);
3468 const ASTContext &Ctx = getASTContext();
3469
3470 auto Consume = [&] {
3471 ++Params;
3472 Ty = Params < FPT->getNumParams() ? FPT->getParamType(Params) : QualType();
3473 };
3474
3475 // In C++14, the next parameter can be a 'std::size_t' for sized delete.
3476 bool IsSizedDelete = false;
3477 if (Ctx.getLangOpts().SizedDeallocation &&
3478 getDeclName().isAnyOperatorDelete() &&
3479 Ctx.hasSameType(Ty, Ctx.getSizeType())) {
3480 IsSizedDelete = true;
3481 Consume();
3482 }
3483
3484 // In C++17, the next parameter can be a 'std::align_val_t' for aligned
3485 // new/delete.
3486 if (Ctx.getLangOpts().AlignedAllocation && !Ty.isNull() && Ty->isAlignValT()) {
3487 Consume();
3488 if (AlignmentParam)
3489 *AlignmentParam = Params;
3490 }
3491
3492 // If this is not a sized delete, the next parameter can be a
3493 // 'const std::nothrow_t&'.
3494 if (!IsSizedDelete && !Ty.isNull() && Ty->isReferenceType()) {
3495 Ty = Ty->getPointeeType();
3497 return false;
3498 if (Ty->isNothrowT()) {
3499 if (IsNothrow)
3500 *IsNothrow = true;
3501 Consume();
3502 }
3503 }
3504
3505 // Finally, recognize the not yet standard versions of new that take a
3506 // hot/cold allocation hint (__hot_cold_t). These are currently supported by
3507 // tcmalloc (see
3508 // https://github.com/google/tcmalloc/blob/220043886d4e2efff7a5702d5172cb8065253664/tcmalloc/malloc_extension.h#L53).
3509 if (!IsSizedDelete && !Ty.isNull() && Ty->isEnumeralType()) {
3510 QualType T = Ty;
3511 while (const auto *TD = T->getAs<TypedefType>())
3512 T = TD->getDecl()->getUnderlyingType();
3513 const IdentifierInfo *II =
3514 T->castAsCanonical<EnumType>()->getDecl()->getIdentifier();
3515 if (II && II->isStr("__hot_cold_t"))
3516 Consume();
3517 }
3518
3519 return Params == FPT->getNumParams();
3520}
3521
3523 if (!getBuiltinID())
3524 return false;
3525
3526 const FunctionDecl *Definition;
3527 if (!hasBody(Definition))
3528 return false;
3529
3530 if (!Definition->isInlineSpecified() ||
3531 !Definition->hasAttr<AlwaysInlineAttr>())
3532 return false;
3533
3534 ASTContext &Context = getASTContext();
3535 switch (Context.GetGVALinkageForFunction(Definition)) {
3536 case GVA_Internal:
3537 case GVA_DiscardableODR:
3538 case GVA_StrongODR:
3539 return false;
3541 case GVA_StrongExternal:
3542 return true;
3543 }
3544 llvm_unreachable("Unknown GVALinkage");
3545}
3546
3550
3551void FunctionDecl::setIsDestroyingOperatorDelete(bool IsDestroyingDelete) {
3552 getASTContext().setIsDestroyingOperatorDelete(this, IsDestroyingDelete);
3553}
3554
3558
3562
3564 UsualDeleteParams Params;
3565
3566 // This function should only be called for operator delete declarations.
3567 assert(getDeclName().isAnyOperatorDelete());
3568 if (!getDeclName().isAnyOperatorDelete())
3569 return Params;
3570
3572 auto AI = FPT->param_type_begin(), AE = FPT->param_type_end();
3573
3576 assert(AI != AE);
3577 ++AI;
3578 }
3579
3580 // The first argument after the type-identity parameter (if any) is
3581 // always a void* (or C* for a destroying operator delete for class
3582 // type C).
3583 ++AI;
3584
3585 // The next parameter may be a std::destroying_delete_t.
3587 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3588 Params.DestroyingDelete = true;
3589 assert(AI != AE);
3590 ++AI;
3591 }
3592
3593 // Figure out what other parameters we should be implicitly passing.
3594 if (AI != AE && (*AI)->isIntegerType()) {
3595 Params.Size = true;
3596 ++AI;
3597 } else
3598 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3599
3600 if (AI != AE && (*AI)->isAlignValT()) {
3602 ++AI;
3603 } else
3604 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3605
3606 assert(AI == AE && "unexpected usual deallocation function parameter");
3607 return Params;
3608}
3609
3613
3615 return isDeclExternC(*this);
3616}
3617
3619 if (DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>()))
3620 return true;
3622}
3623
3627
3629 if (const auto *Method = dyn_cast<CXXMethodDecl>(this))
3630 return Method->isStatic();
3631
3633 return false;
3634
3635 for (const DeclContext *DC = getDeclContext();
3636 DC->isNamespace();
3637 DC = DC->getParent()) {
3638 if (const auto *Namespace = cast<NamespaceDecl>(DC)) {
3639 if (!Namespace->getDeclName())
3640 return false;
3641 }
3642 }
3643
3644 return true;
3645}
3646
3650 return true;
3651
3652 if (auto *FnTy = getType()->getAs<FunctionType>())
3653 return FnTy->getNoReturnAttr();
3654
3655 return false;
3656}
3657
3661
3663 // C++20 [temp.friend]p9:
3664 // A non-template friend declaration with a requires-clause [or]
3665 // a friend function template with a constraint that depends on a template
3666 // parameter from an enclosing template [...] does not declare the same
3667 // function or function template as a declaration in any other scope.
3668
3669 // If this isn't a friend then it's not a member-like constrained friend.
3670 if (!getFriendObjectKind()) {
3671 return false;
3672 }
3673
3675 // If these friends don't have constraints, they aren't constrained, and
3676 // thus don't fall under temp.friend p9. Else the simple presence of a
3677 // constraint makes them unique.
3679 }
3680
3682}
3683
3697
3701
3705
3710
3712 if (!isMultiVersion())
3713 return false;
3714 if (hasAttr<TargetAttr>())
3715 return getAttr<TargetAttr>()->isDefaultVersion();
3716 return hasAttr<TargetVersionAttr>() &&
3717 getAttr<TargetVersionAttr>()->isDefaultVersion();
3718}
3719
3723
3727
3728void
3731
3733 FunctionTemplateDecl *PrevFunTmpl
3734 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : nullptr;
3735 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
3736 FunTmpl->setPreviousDecl(PrevFunTmpl);
3737 }
3738
3739 if (PrevDecl && PrevDecl->isInlined())
3740 setImplicitlyInline(true);
3741}
3742
3744
3745/// Returns a value indicating whether this function corresponds to a builtin
3746/// function.
3747///
3748/// The function corresponds to a built-in function if it is declared at
3749/// translation scope or within an extern "C" block and its name matches with
3750/// the name of a builtin. The returned value will be 0 for functions that do
3751/// not correspond to a builtin, a value of type \c Builtin::ID if in the
3752/// target-independent range \c [1,Builtin::First), or a target-specific builtin
3753/// value.
3754///
3755/// \param ConsiderWrapperFunctions If true, we should consider wrapper
3756/// functions as their wrapped builtins. This shouldn't be done in general, but
3757/// it's useful in Sema to diagnose calls to wrappers based on their semantics.
3758unsigned FunctionDecl::getBuiltinID(bool ConsiderWrapperFunctions) const {
3759 unsigned BuiltinID = 0;
3760
3761 if (const auto *ABAA = getAttr<ArmBuiltinAliasAttr>()) {
3762 BuiltinID = ABAA->getBuiltinName()->getBuiltinID();
3763 } else if (const auto *BAA = getAttr<BuiltinAliasAttr>()) {
3764 BuiltinID = BAA->getBuiltinName()->getBuiltinID();
3765 } else if (const auto *A = getAttr<BuiltinAttr>()) {
3766 BuiltinID = A->getID();
3767 }
3768
3769 if (!BuiltinID)
3770 return 0;
3771
3772 // If the function is marked "overloadable", it has a different mangled name
3773 // and is not the C library function.
3774 if (!ConsiderWrapperFunctions && hasAttr<OverloadableAttr>() &&
3776 return 0;
3777
3779 BuiltinID == Builtin::BI__builtin_counted_by_ref)
3780 return 0;
3781
3782 const ASTContext &Context = getASTContext();
3783 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3784 return BuiltinID;
3785
3786 // This function has the name of a known C library
3787 // function. Determine whether it actually refers to the C library
3788 // function or whether it just has the same name.
3789
3790 // If this is a static function, it's not a builtin.
3791 if (!ConsiderWrapperFunctions && getStorageClass() == SC_Static)
3792 return 0;
3793
3794 // OpenCL v1.2 s6.9.f - The library functions defined in
3795 // the C99 standard headers are not available.
3796 if (Context.getLangOpts().OpenCL &&
3797 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3798 return 0;
3799
3800 // CUDA does not have device-side standard library. printf and malloc are the
3801 // only special cases that are supported by device-side runtime.
3802 if (Context.getLangOpts().CUDA && hasAttr<CUDADeviceAttr>() &&
3804 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3805 return 0;
3806
3807 // As AMDGCN implementation of OpenMP does not have a device-side standard
3808 // library, none of the predefined library functions except printf and malloc
3809 // should be treated as a builtin i.e. 0 should be returned for them.
3810 if (Context.getTargetInfo().getTriple().isAMDGCN() &&
3811 Context.getLangOpts().OpenMPIsTargetDevice &&
3812 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID) &&
3813 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3814 return 0;
3815
3816 return BuiltinID;
3817}
3818
3819/// getNumParams - Return the number of parameters this function must have
3820/// based on its FunctionType. This is the length of the ParamInfo array
3821/// after it has been created.
3823 const auto *FPT = getType()->getAs<FunctionProtoType>();
3824 return FPT ? FPT->getNumParams() : 0;
3825}
3826
3827void FunctionDecl::setParams(ASTContext &C,
3828 ArrayRef<ParmVarDecl *> NewParamInfo) {
3829 assert(!ParamInfo && "Already has param info!");
3830 assert(NewParamInfo.size() == getNumParams() && "Parameter count mismatch!");
3831
3832 // Zero params -> null pointer.
3833 if (!NewParamInfo.empty()) {
3834 ParamInfo = new (C) ParmVarDecl*[NewParamInfo.size()];
3835 llvm::copy(NewParamInfo, ParamInfo);
3836 }
3837}
3838
3839/// getMinRequiredArguments - Returns the minimum number of arguments
3840/// needed to call this function. This may be fewer than the number of
3841/// function parameters, if some of the parameters have default
3842/// arguments (in C++) or are parameter packs (C++11).
3845 return getNumParams();
3846
3847 // Note that it is possible for a parameter with no default argument to
3848 // follow a parameter with a default argument.
3849 unsigned NumRequiredArgs = 0;
3850 unsigned MinParamsSoFar = 0;
3851 for (auto *Param : parameters()) {
3852 if (!Param->isParameterPack()) {
3853 ++MinParamsSoFar;
3854 if (!Param->hasDefaultArg())
3855 NumRequiredArgs = MinParamsSoFar;
3856 }
3857 }
3858 return NumRequiredArgs;
3859}
3860
3864
3866 return getNumParams() -
3867 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3868}
3869
3871 return getMinRequiredArguments() -
3872 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3873}
3874
3876 return getNumParams() == 1 ||
3877 (getNumParams() > 1 &&
3878 llvm::all_of(llvm::drop_begin(parameters()),
3879 [](ParmVarDecl *P) { return P->hasDefaultArg(); }));
3880}
3881
3882/// The combination of the extern and inline keywords under MSVC forces
3883/// the function to be required.
3884///
3885/// Note: This function assumes that we will only get called when isInlined()
3886/// would return true for this FunctionDecl.
3888 assert(isInlined() && "expected to get called on an inlined function!");
3889
3890 const ASTContext &Context = getASTContext();
3891 if (!Context.getTargetInfo().getCXXABI().isMicrosoft() &&
3893 return false;
3894
3895 for (const FunctionDecl *FD = getMostRecentDecl(); FD;
3896 FD = FD->getPreviousDecl())
3897 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3898 return true;
3899
3900 return false;
3901}
3902
3903static bool redeclForcesDefMSVC(const FunctionDecl *Redecl) {
3904 if (Redecl->getStorageClass() != SC_Extern)
3905 return false;
3906
3907 for (const FunctionDecl *FD = Redecl->getPreviousDecl(); FD;
3908 FD = FD->getPreviousDecl())
3909 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3910 return false;
3911
3912 return true;
3913}
3914
3915static bool RedeclForcesDefC99(const FunctionDecl *Redecl) {
3916 // Only consider file-scope declarations in this test.
3917 if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
3918 return false;
3919
3920 // Only consider explicit declarations; the presence of a builtin for a
3921 // libcall shouldn't affect whether a definition is externally visible.
3922 if (Redecl->isImplicit())
3923 return false;
3924
3925 if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
3926 return true; // Not an inline definition
3927
3928 return false;
3929}
3930
3931/// For a function declaration in C or C++, determine whether this
3932/// declaration causes the definition to be externally visible.
3933///
3934/// For instance, this determines if adding the current declaration to the set
3935/// of redeclarations of the given functions causes
3936/// isInlineDefinitionExternallyVisible to change from false to true.
3938 assert(!doesThisDeclarationHaveABody() &&
3939 "Must have a declaration without a body.");
3940
3941 const ASTContext &Context = getASTContext();
3942
3943 if (Context.getLangOpts().MSVCCompat) {
3944 const FunctionDecl *Definition;
3945 if (hasBody(Definition) && Definition->isInlined() &&
3946 redeclForcesDefMSVC(this))
3947 return true;
3948 }
3949
3950 if (Context.getLangOpts().CPlusPlus)
3951 return false;
3952
3953 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
3954 // With GNU inlining, a declaration with 'inline' but not 'extern', forces
3955 // an externally visible definition.
3956 //
3957 // FIXME: What happens if gnu_inline gets added on after the first
3958 // declaration?
3960 return false;
3961
3962 const FunctionDecl *Prev = this;
3963 bool FoundBody = false;
3964 while ((Prev = Prev->getPreviousDecl())) {
3965 FoundBody |= Prev->doesThisDeclarationHaveABody();
3966
3967 if (Prev->doesThisDeclarationHaveABody()) {
3968 // If it's not the case that both 'inline' and 'extern' are
3969 // specified on the definition, then it is always externally visible.
3970 if (!Prev->isInlineSpecified() ||
3971 Prev->getStorageClass() != SC_Extern)
3972 return false;
3973 } else if (Prev->isInlineSpecified() &&
3974 Prev->getStorageClass() != SC_Extern) {
3975 return false;
3976 }
3977 }
3978 return FoundBody;
3979 }
3980
3981 // C99 6.7.4p6:
3982 // [...] If all of the file scope declarations for a function in a
3983 // translation unit include the inline function specifier without extern,
3984 // then the definition in that translation unit is an inline definition.
3986 return false;
3987 const FunctionDecl *Prev = this;
3988 bool FoundBody = false;
3989 while ((Prev = Prev->getPreviousDecl())) {
3990 FoundBody |= Prev->doesThisDeclarationHaveABody();
3991 if (RedeclForcesDefC99(Prev))
3992 return false;
3993 }
3994 return FoundBody;
3995}
3996
3998 const TypeSourceInfo *TSI = getTypeSourceInfo();
3999
4000 if (!TSI)
4001 return FunctionTypeLoc();
4002
4003 TypeLoc TL = TSI->getTypeLoc();
4004 FunctionTypeLoc FTL;
4005
4006 while (!(FTL = TL.getAs<FunctionTypeLoc>())) {
4007 if (const auto PTL = TL.getAs<ParenTypeLoc>())
4008 TL = PTL.getInnerLoc();
4009 else if (const auto ATL = TL.getAs<AttributedTypeLoc>())
4010 TL = ATL.getEquivalentTypeLoc();
4011 else if (const auto MQTL = TL.getAs<MacroQualifiedTypeLoc>())
4012 TL = MQTL.getInnerLoc();
4013 else
4014 break;
4015 }
4016
4017 return FTL;
4018}
4019
4022 if (!FTL)
4023 return SourceRange();
4024
4025 // Skip self-referential return types.
4027 SourceRange RTRange = FTL.getReturnLoc().getSourceRange();
4028 SourceLocation Boundary = getNameInfo().getBeginLoc();
4029 if (RTRange.isInvalid() || Boundary.isInvalid() ||
4030 !SM.isBeforeInTranslationUnit(RTRange.getEnd(), Boundary))
4031 return SourceRange();
4032
4033 return RTRange;
4034}
4035
4037 unsigned NP = getNumParams();
4038 SourceLocation EllipsisLoc = getEllipsisLoc();
4039
4040 if (NP == 0 && EllipsisLoc.isInvalid())
4041 return SourceRange();
4042
4043 SourceLocation Begin =
4044 NP > 0 ? ParamInfo[0]->getSourceRange().getBegin() : EllipsisLoc;
4045 SourceLocation End = EllipsisLoc.isValid()
4046 ? EllipsisLoc
4047 : ParamInfo[NP - 1]->getSourceRange().getEnd();
4048
4049 return SourceRange(Begin, End);
4050}
4051
4056
4057/// For an inline function definition in C, or for a gnu_inline function
4058/// in C++, determine whether the definition will be externally visible.
4059///
4060/// Inline function definitions are always available for inlining optimizations.
4061/// However, depending on the language dialect, declaration specifiers, and
4062/// attributes, the definition of an inline function may or may not be
4063/// "externally" visible to other translation units in the program.
4064///
4065/// In C99, inline definitions are not externally visible by default. However,
4066/// if even one of the global-scope declarations is marked "extern inline", the
4067/// inline definition becomes externally visible (C99 6.7.4p6).
4068///
4069/// In GNU89 mode, or if the gnu_inline attribute is attached to the function
4070/// definition, we use the GNU semantics for inline, which are nearly the
4071/// opposite of C99 semantics. In particular, "inline" by itself will create
4072/// an externally visible symbol, but "extern inline" will not create an
4073/// externally visible symbol.
4076 hasAttr<AliasAttr>()) &&
4077 "Must be a function definition");
4078 assert(isInlined() && "Function must be inline");
4079 ASTContext &Context = getASTContext();
4080
4081 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
4082 // Note: If you change the logic here, please change
4083 // doesDeclarationForceExternallyVisibleDefinition as well.
4084 //
4085 // If it's not the case that both 'inline' and 'extern' are
4086 // specified on the definition, then this inline definition is
4087 // externally visible.
4088 if (Context.getLangOpts().CPlusPlus)
4089 return false;
4091 return true;
4092
4093 // If any declaration is 'inline' but not 'extern', then this definition
4094 // is externally visible.
4095 for (auto *Redecl : redecls()) {
4096 if (Redecl->isInlineSpecified() &&
4097 Redecl->getStorageClass() != SC_Extern)
4098 return true;
4099 }
4100
4101 return false;
4102 }
4103
4104 // The rest of this function is C-only.
4105 assert(!Context.getLangOpts().CPlusPlus &&
4106 "should not use C inline rules in C++");
4107
4108 // C99 6.7.4p6:
4109 // [...] If all of the file scope declarations for a function in a
4110 // translation unit include the inline function specifier without extern,
4111 // then the definition in that translation unit is an inline definition.
4112 for (auto *Redecl : redecls()) {
4113 if (RedeclForcesDefC99(Redecl))
4114 return true;
4115 }
4116
4117 // C99 6.7.4p6:
4118 // An inline definition does not provide an external definition for the
4119 // function, and does not forbid an external definition in another
4120 // translation unit.
4121 return false;
4122}
4123
4124/// getOverloadedOperator - Which C++ overloaded operator this
4125/// function represents, if any.
4131
4132/// getLiteralIdentifier - The literal suffix identifier this function
4133/// represents, if any.
4137 return nullptr;
4138}
4139
4141 if (TemplateOrSpecialization.isNull())
4142 return TK_NonTemplate;
4143 if (const auto *ND = dyn_cast<NamedDecl *>(TemplateOrSpecialization)) {
4144 if (isa<FunctionDecl>(ND))
4146 assert(isa<FunctionTemplateDecl>(ND) &&
4147 "No other valid types in NamedDecl");
4148 return TK_FunctionTemplate;
4149 }
4150 if (isa<MemberSpecializationInfo *>(TemplateOrSpecialization))
4152 if (isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization))
4155 TemplateOrSpecialization))
4157
4158 llvm_unreachable("Did we miss a TemplateOrSpecialization type?");
4159}
4160
4163 return cast<FunctionDecl>(Info->getInstantiatedFrom());
4164
4165 return nullptr;
4166}
4167
4169 if (auto *MSI = dyn_cast_if_present<MemberSpecializationInfo *>(
4170 TemplateOrSpecialization))
4171 return MSI;
4172 if (auto *FTSI = dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4173 TemplateOrSpecialization))
4174 return FTSI->getMemberSpecializationInfo();
4175 return nullptr;
4176}
4177
4178void
4179FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
4180 FunctionDecl *FD,
4182 assert(TemplateOrSpecialization.isNull() &&
4183 "Member function is already a specialization");
4185 = new (C) MemberSpecializationInfo(FD, TSK);
4186 TemplateOrSpecialization = Info;
4187}
4188
4190 return dyn_cast_if_present<FunctionTemplateDecl>(
4191 dyn_cast_if_present<NamedDecl *>(TemplateOrSpecialization));
4192}
4193
4196 assert(TemplateOrSpecialization.isNull() &&
4197 "Member function is already a specialization");
4198 TemplateOrSpecialization = Template;
4199}
4200
4202 return isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization) ||
4204 TemplateOrSpecialization);
4205}
4206
4208 assert(TemplateOrSpecialization.isNull() &&
4209 "Function is already a specialization");
4210 TemplateOrSpecialization = FD;
4211}
4212
4214 return dyn_cast_if_present<FunctionDecl>(
4215 TemplateOrSpecialization.dyn_cast<NamedDecl *>());
4216}
4217
4219 // If the function is invalid, it can't be implicitly instantiated.
4220 if (isInvalidDecl())
4221 return false;
4222
4224 case TSK_Undeclared:
4227 return false;
4228
4230 return true;
4231
4233 // Handled below.
4234 break;
4235 }
4236
4237 // Find the actual template from which we will instantiate.
4238 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
4239 bool HasPattern = false;
4240 if (PatternDecl)
4241 HasPattern = PatternDecl->hasBody(PatternDecl);
4242
4243 // C++0x [temp.explicit]p9:
4244 // Except for inline functions, other explicit instantiation declarations
4245 // have the effect of suppressing the implicit instantiation of the entity
4246 // to which they refer.
4247 if (!HasPattern || !PatternDecl)
4248 return true;
4249
4250 return PatternDecl->isInlined();
4251}
4252
4254 // FIXME: Remove this, it's not clear what it means. (Which template
4255 // specialization kind?)
4257}
4258
4261 // If this is a generic lambda call operator specialization, its
4262 // instantiation pattern is always its primary template's pattern
4263 // even if its primary template was instantiated from another
4264 // member template (which happens with nested generic lambdas).
4265 // Since a lambda's call operator's body is transformed eagerly,
4266 // we don't have to go hunting for a prototype definition template
4267 // (i.e. instantiated-from-member-template) to use as an instantiation
4268 // pattern.
4269
4271 dyn_cast<CXXMethodDecl>(this))) {
4272 assert(getPrimaryTemplate() && "not a generic lambda call operator?");
4273 return getDefinitionOrSelf(getPrimaryTemplate()->getTemplatedDecl());
4274 }
4275
4276 // Check for a declaration of this function that was instantiated from a
4277 // friend definition.
4278 const FunctionDecl *FD = nullptr;
4279 if (!isDefined(FD, /*CheckForPendingFriendDefinition=*/true))
4280 FD = this;
4281
4283 if (ForDefinition &&
4285 return nullptr;
4287 }
4288
4289 if (ForDefinition &&
4291 return nullptr;
4292
4293 if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
4294 // If we hit a point where the user provided a specialization of this
4295 // template, we're done looking.
4296 while (!ForDefinition || !Primary->isMemberSpecialization()) {
4297 auto *NewPrimary = Primary->getInstantiatedFromMemberTemplate();
4298 if (!NewPrimary)
4299 break;
4300 Primary = NewPrimary;
4301 }
4302
4303 return getDefinitionOrSelf(Primary->getTemplatedDecl());
4304 }
4305
4306 return nullptr;
4307}
4308
4311 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4312 TemplateOrSpecialization)) {
4313 return Info->getTemplate();
4314 }
4315 return nullptr;
4316}
4317
4320 return dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4321 TemplateOrSpecialization);
4322}
4323
4327 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4328 TemplateOrSpecialization)) {
4329 return Info->TemplateArguments;
4330 }
4331 return nullptr;
4332}
4333
4337 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4338 TemplateOrSpecialization)) {
4339 return Info->TemplateArgumentsAsWritten;
4340 }
4342 dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4343 TemplateOrSpecialization)) {
4344 return Info->TemplateArgumentsAsWritten;
4345 }
4346 return nullptr;
4347}
4348
4349void FunctionDecl::setFunctionTemplateSpecialization(
4351 TemplateArgumentList *TemplateArgs, void *InsertPos,
4353 const TemplateArgumentListInfo *TemplateArgsAsWritten,
4354 SourceLocation PointOfInstantiation) {
4355 assert((TemplateOrSpecialization.isNull() ||
4356 isa<MemberSpecializationInfo *>(TemplateOrSpecialization)) &&
4357 "Member function is already a specialization");
4358 assert(TSK != TSK_Undeclared &&
4359 "Must specify the type of function template specialization");
4360 assert((TemplateOrSpecialization.isNull() ||
4363 "Member specialization must be an explicit specialization");
4366 C, this, Template, TSK, TemplateArgs, TemplateArgsAsWritten,
4367 PointOfInstantiation,
4368 dyn_cast_if_present<MemberSpecializationInfo *>(
4369 TemplateOrSpecialization));
4370 TemplateOrSpecialization = Info;
4371 Template->addSpecialization(Info, InsertPos);
4372}
4373
4375 ASTContext &Context, const UnresolvedSetImpl &Templates,
4376 const TemplateArgumentListInfo *TemplateArgs) {
4377 assert(TemplateOrSpecialization.isNull());
4380 TemplateArgs);
4381 TemplateOrSpecialization = Info;
4382}
4383
4386 return dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4387 TemplateOrSpecialization);
4388}
4389
4392 ASTContext &Context, const UnresolvedSetImpl &Candidates,
4393 const TemplateArgumentListInfo *TArgs) {
4394 const auto *TArgsWritten =
4395 TArgs ? ASTTemplateArgumentListInfo::Create(Context, *TArgs) : nullptr;
4396 return new (Context.Allocate(
4397 totalSizeToAlloc<FunctionTemplateDecl *>(Candidates.size())))
4398 DependentFunctionTemplateSpecializationInfo(Candidates, TArgsWritten);
4399}
4400
4401DependentFunctionTemplateSpecializationInfo::
4402 DependentFunctionTemplateSpecializationInfo(
4403 const UnresolvedSetImpl &Candidates,
4404 const ASTTemplateArgumentListInfo *TemplateArgsWritten)
4405 : NumCandidates(Candidates.size()),
4406 TemplateArgumentsAsWritten(TemplateArgsWritten) {
4407 std::transform(Candidates.begin(), Candidates.end(), getTrailingObjects(),
4408 [](NamedDecl *ND) {
4410 });
4411}
4412
4414 // For a function template specialization, query the specialization
4415 // information object.
4417 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4418 TemplateOrSpecialization))
4419 return FTSInfo->getTemplateSpecializationKind();
4420
4421 if (MemberSpecializationInfo *MSInfo =
4422 dyn_cast_if_present<MemberSpecializationInfo *>(
4423 TemplateOrSpecialization))
4424 return MSInfo->getTemplateSpecializationKind();
4425
4426 // A dependent function template specialization is an explicit specialization,
4427 // except when it's a friend declaration.
4429 TemplateOrSpecialization) &&
4432
4433 return TSK_Undeclared;
4434}
4435
4438 // This is the same as getTemplateSpecializationKind(), except that for a
4439 // function that is both a function template specialization and a member
4440 // specialization, we prefer the member specialization information. Eg:
4441 //
4442 // template<typename T> struct A {
4443 // template<typename U> void f() {}
4444 // template<> void f<int>() {}
4445 // };
4446 //
4447 // Within the templated CXXRecordDecl, A<T>::f<int> is a dependent function
4448 // template specialization; both getTemplateSpecializationKind() and
4449 // getTemplateSpecializationKindForInstantiation() will return
4450 // TSK_ExplicitSpecialization.
4451 //
4452 // For A<int>::f<int>():
4453 // * getTemplateSpecializationKind() will return TSK_ExplicitSpecialization
4454 // * getTemplateSpecializationKindForInstantiation() will return
4455 // TSK_ImplicitInstantiation
4456 //
4457 // This reflects the facts that A<int>::f<int> is an explicit specialization
4458 // of A<int>::f, and that A<int>::f<int> should be implicitly instantiated
4459 // from A::f<int> if a definition is needed.
4461 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4462 TemplateOrSpecialization)) {
4463 if (auto *MSInfo = FTSInfo->getMemberSpecializationInfo())
4464 return MSInfo->getTemplateSpecializationKind();
4465 return FTSInfo->getTemplateSpecializationKind();
4466 }
4467
4468 if (MemberSpecializationInfo *MSInfo =
4469 dyn_cast_if_present<MemberSpecializationInfo *>(
4470 TemplateOrSpecialization))
4471 return MSInfo->getTemplateSpecializationKind();
4472
4474 TemplateOrSpecialization) &&
4477
4478 return TSK_Undeclared;
4479}
4480
4481void
4483 SourceLocation PointOfInstantiation) {
4485 dyn_cast<FunctionTemplateSpecializationInfo *>(
4486 TemplateOrSpecialization)) {
4487 FTSInfo->setTemplateSpecializationKind(TSK);
4488 if (TSK != TSK_ExplicitSpecialization &&
4489 PointOfInstantiation.isValid() &&
4490 FTSInfo->getPointOfInstantiation().isInvalid()) {
4491 FTSInfo->setPointOfInstantiation(PointOfInstantiation);
4493 L->InstantiationRequested(this);
4494 }
4495 } else if (MemberSpecializationInfo *MSInfo =
4496 dyn_cast<MemberSpecializationInfo *>(
4497 TemplateOrSpecialization)) {
4498 MSInfo->setTemplateSpecializationKind(TSK);
4499 if (TSK != TSK_ExplicitSpecialization &&
4500 PointOfInstantiation.isValid() &&
4501 MSInfo->getPointOfInstantiation().isInvalid()) {
4502 MSInfo->setPointOfInstantiation(PointOfInstantiation);
4504 L->InstantiationRequested(this);
4505 }
4506 } else
4507 llvm_unreachable("Function cannot have a template specialization kind");
4508}
4509
4512 = TemplateOrSpecialization.dyn_cast<
4514 return FTSInfo->getPointOfInstantiation();
4515 if (MemberSpecializationInfo *MSInfo =
4516 TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo *>())
4517 return MSInfo->getPointOfInstantiation();
4518
4519 return SourceLocation();
4520}
4521
4523 if (Decl::isOutOfLine())
4524 return true;
4525
4526 // If this function was instantiated from a member function of a
4527 // class template, check whether that member function was defined out-of-line.
4529 const FunctionDecl *Definition;
4530 if (FD->hasBody(Definition))
4531 return Definition->isOutOfLine();
4532 }
4533
4534 // If this function was instantiated from a function template,
4535 // check whether that function template was defined out-of-line.
4536 if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
4537 const FunctionDecl *Definition;
4538 if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
4539 return Definition->isOutOfLine();
4540 }
4541
4542 return false;
4543}
4544
4546 return SourceRange(getOuterLocStart(), EndRangeLoc);
4547}
4548
4550 IdentifierInfo *FnInfo = getIdentifier();
4551
4552 if (!FnInfo)
4553 return 0;
4554
4555 // Builtin handling.
4556 switch (getBuiltinID()) {
4557 case Builtin::BI__builtin_memset:
4558 case Builtin::BI__builtin___memset_chk:
4559 case Builtin::BImemset:
4560 return Builtin::BImemset;
4561
4562 case Builtin::BI__builtin_memcpy:
4563 case Builtin::BI__builtin___memcpy_chk:
4564 case Builtin::BImemcpy:
4565 return Builtin::BImemcpy;
4566
4567 case Builtin::BI__builtin_mempcpy:
4568 case Builtin::BI__builtin___mempcpy_chk:
4569 case Builtin::BImempcpy:
4570 return Builtin::BImempcpy;
4571
4572 case Builtin::BI__builtin_trivially_relocate:
4573 case Builtin::BI__builtin_memmove:
4574 case Builtin::BI__builtin___memmove_chk:
4575 case Builtin::BImemmove:
4576 return Builtin::BImemmove;
4577
4578 case Builtin::BIstrlcpy:
4579 case Builtin::BI__builtin___strlcpy_chk:
4580 return Builtin::BIstrlcpy;
4581
4582 case Builtin::BIstrlcat:
4583 case Builtin::BI__builtin___strlcat_chk:
4584 return Builtin::BIstrlcat;
4585
4586 case Builtin::BI__builtin_memcmp:
4587 case Builtin::BImemcmp:
4588 return Builtin::BImemcmp;
4589
4590 case Builtin::BI__builtin_bcmp:
4591 case Builtin::BIbcmp:
4592 return Builtin::BIbcmp;
4593
4594 case Builtin::BI__builtin_strncpy:
4595 case Builtin::BI__builtin___strncpy_chk:
4596 case Builtin::BIstrncpy:
4597 return Builtin::BIstrncpy;
4598
4599 case Builtin::BI__builtin_strncmp:
4600 case Builtin::BIstrncmp:
4601 return Builtin::BIstrncmp;
4602
4603 case Builtin::BI__builtin_strncasecmp:
4604 case Builtin::BIstrncasecmp:
4605 return Builtin::BIstrncasecmp;
4606
4607 case Builtin::BI__builtin_strncat:
4608 case Builtin::BI__builtin___strncat_chk:
4609 case Builtin::BIstrncat:
4610 return Builtin::BIstrncat;
4611
4612 case Builtin::BI__builtin_strndup:
4613 case Builtin::BIstrndup:
4614 return Builtin::BIstrndup;
4615
4616 case Builtin::BI__builtin_strlen:
4617 case Builtin::BIstrlen:
4618 return Builtin::BIstrlen;
4619
4620 case Builtin::BI__builtin_bzero:
4621 case Builtin::BIbzero:
4622 return Builtin::BIbzero;
4623
4624 case Builtin::BI__builtin_bcopy:
4625 case Builtin::BIbcopy:
4626 return Builtin::BIbcopy;
4627
4628 case Builtin::BIfree:
4629 return Builtin::BIfree;
4630
4631 default:
4632 if (isExternC()) {
4633 if (FnInfo->isStr("memset"))
4634 return Builtin::BImemset;
4635 if (FnInfo->isStr("memcpy"))
4636 return Builtin::BImemcpy;
4637 if (FnInfo->isStr("mempcpy"))
4638 return Builtin::BImempcpy;
4639 if (FnInfo->isStr("memmove"))
4640 return Builtin::BImemmove;
4641 if (FnInfo->isStr("memcmp"))
4642 return Builtin::BImemcmp;
4643 if (FnInfo->isStr("bcmp"))
4644 return Builtin::BIbcmp;
4645 if (FnInfo->isStr("strncpy"))
4646 return Builtin::BIstrncpy;
4647 if (FnInfo->isStr("strncmp"))
4648 return Builtin::BIstrncmp;
4649 if (FnInfo->isStr("strncasecmp"))
4650 return Builtin::BIstrncasecmp;
4651 if (FnInfo->isStr("strncat"))
4652 return Builtin::BIstrncat;
4653 if (FnInfo->isStr("strndup"))
4654 return Builtin::BIstrndup;
4655 if (FnInfo->isStr("strlen"))
4656 return Builtin::BIstrlen;
4657 if (FnInfo->isStr("bzero"))
4658 return Builtin::BIbzero;
4659 if (FnInfo->isStr("bcopy"))
4660 return Builtin::BIbcopy;
4661 } else if (isInStdNamespace()) {
4662 if (FnInfo->isStr("free"))
4663 return Builtin::BIfree;
4664 }
4665 break;
4666 }
4667 return 0;
4668}
4669
4671 assert(hasODRHash());
4672 return ODRHash;
4673}
4674
4676 if (hasODRHash())
4677 return ODRHash;
4678
4679 if (auto *FT = getInstantiatedFromMemberFunction()) {
4680 setHasODRHash(true);
4681 ODRHash = FT->getODRHash();
4682 return ODRHash;
4683 }
4684
4685 class ODRHash Hash;
4686 Hash.AddFunctionDecl(this);
4687 setHasODRHash(true);
4688 ODRHash = Hash.CalculateHash();
4689 return ODRHash;
4690}
4691
4692//===----------------------------------------------------------------------===//
4693// FieldDecl Implementation
4694//===----------------------------------------------------------------------===//
4695
4697 SourceLocation StartLoc, SourceLocation IdLoc,
4698 const IdentifierInfo *Id, QualType T,
4699 TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
4700 InClassInitStyle InitStyle) {
4701 return new (C, DC) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
4702 BW, Mutable, InitStyle);
4703}
4704
4706 return new (C, ID) FieldDecl(Field, nullptr, SourceLocation(),
4707 SourceLocation(), nullptr, QualType(), nullptr,
4708 nullptr, false, ICIS_NoInit);
4709}
4710
4712 if (!isImplicit() || getDeclName())
4713 return false;
4714
4715 if (const auto *Record = getType()->getAsCanonical<RecordType>())
4716 return Record->getDecl()->isAnonymousStructOrUnion();
4717
4718 return false;
4719}
4720
4722 if (!hasInClassInitializer())
4723 return nullptr;
4724
4725 LazyDeclStmtPtr InitPtr = BitField ? InitAndBitWidth->Init : Init;
4726 return cast_if_present<Expr>(
4727 InitPtr.isOffset() ? InitPtr.get(getASTContext().getExternalSource())
4728 : InitPtr.get(nullptr));
4729}
4730
4732 setLazyInClassInitializer(LazyDeclStmtPtr(NewInit));
4733}
4734
4735void FieldDecl::setLazyInClassInitializer(LazyDeclStmtPtr NewInit) {
4737 if (BitField)
4738 InitAndBitWidth->Init = NewInit;
4739 else
4740 Init = NewInit;
4741}
4742
4744 const auto *CE = dyn_cast_if_present<ConstantExpr>(getBitWidth());
4745 return CE && CE->getAPValueResult().isInt();
4746}
4747
4749 assert(isBitField() && "not a bitfield");
4752 ->getAPValueResult()
4753 .getInt()
4754 .getZExtValue();
4755}
4756
4759 getBitWidthValue() == 0;
4760}
4761
4762bool FieldDecl::isZeroSize(const ASTContext &Ctx) const {
4764 return true;
4765
4766 // C++2a [intro.object]p7:
4767 // An object has nonzero size if it
4768 // -- is not a potentially-overlapping subobject, or
4770 return false;
4771
4772 // -- is not of class type, or
4773 const auto *RT = getType()->getAsCanonical<RecordType>();
4774 if (!RT)
4775 return false;
4776 const RecordDecl *RD = RT->getDecl()->getDefinition();
4777 if (!RD) {
4778 assert(isInvalidDecl() && "valid field has incomplete type");
4779 return false;
4780 }
4781
4782 // -- [has] virtual member functions or virtual base classes, or
4783 // -- has subobjects of nonzero size or bit-fields of nonzero length
4784 const auto *CXXRD = cast<CXXRecordDecl>(RD);
4785 if (!CXXRD->isEmpty())
4786 return false;
4787
4788 // Otherwise, [...] the circumstances under which the object has zero size
4789 // are implementation-defined.
4790 if (!Ctx.getTargetInfo().getCXXABI().isMicrosoft())
4791 return true;
4792
4793 // MS ABI: has nonzero size if it is a class type with class type fields,
4794 // whether or not they have nonzero size
4795 return !llvm::any_of(CXXRD->fields(), [](const FieldDecl *Field) {
4796 return Field->getType()->isRecordType();
4797 });
4798}
4799
4803
4804void FieldDecl::setCachedFieldIndex() const {
4805 assert(this == getCanonicalDecl() &&
4806 "should be called on the canonical decl");
4807
4808 unsigned Index = 0;
4809 const RecordDecl *RD = getParent()->getDefinition();
4810 assert(RD && "requested index for field of struct with no definition");
4811
4812 for (auto *Field : RD->fields()) {
4813 Field->getCanonicalDecl()->CachedFieldIndex = Index + 1;
4814 assert(Field->getCanonicalDecl()->CachedFieldIndex == Index + 1 &&
4815 "overflow in field numbering");
4816 ++Index;
4817 }
4818
4819 assert(CachedFieldIndex && "failed to find field in parent");
4820}
4821
4823 const Expr *FinalExpr = getInClassInitializer();
4824 if (!FinalExpr)
4825 FinalExpr = getBitWidth();
4826 if (FinalExpr)
4827 return SourceRange(getInnerLocStart(), FinalExpr->getEndLoc());
4829}
4830
4832 assert((getParent()->isLambda() || getParent()->isCapturedRecord()) &&
4833 "capturing type in non-lambda or captured record.");
4834 assert(StorageKind == ISK_NoInit && !BitField &&
4835 "bit-field or field with default member initializer cannot capture "
4836 "VLA type");
4837 StorageKind = ISK_CapturedVLAType;
4838 CapturedVLAType = VLAType;
4839}
4840
4841void FieldDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
4842 // Print unnamed members using name of their type.
4844 this->getType().print(OS, Policy);
4845 return;
4846 }
4847 // Otherwise, do the normal printing.
4848 DeclaratorDecl::printName(OS, Policy);
4849}
4850
4852 const auto *CAT = getType()->getAs<CountAttributedType>();
4853 if (!CAT)
4854 return nullptr;
4855
4856 const auto *CountDRE = cast<DeclRefExpr>(CAT->getCountExpr());
4857 const auto *CountDecl = CountDRE->getDecl();
4858 if (const auto *IFD = dyn_cast<IndirectFieldDecl>(CountDecl))
4859 CountDecl = IFD->getAnonField();
4860
4861 return dyn_cast<FieldDecl>(CountDecl);
4862}
4863
4864//===----------------------------------------------------------------------===//
4865// TagDecl Implementation
4866//===----------------------------------------------------------------------===//
4867
4869 SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl,
4870 SourceLocation StartL)
4871 : TypeDecl(DK, DC, L, Id, StartL), DeclContext(DK), redeclarable_base(C),
4872 TypedefNameDeclOrQualifier((TypedefNameDecl *)nullptr) {
4873 assert((DK != Enum || TK == TagTypeKind::Enum) &&
4874 "EnumDecl not matched with TagTypeKind::Enum");
4875 setPreviousDecl(PrevDecl);
4876 setTagKind(TK);
4877 setCompleteDefinition(false);
4878 setBeingDefined(false);
4880 setFreeStanding(false);
4882 TagDeclBits.IsThisDeclarationADemotedDefinition = false;
4883}
4884
4888
4890 SourceLocation RBraceLoc = BraceRange.getEnd();
4891 SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
4892 return SourceRange(getOuterLocStart(), E);
4893}
4894
4896
4898 TypedefNameDeclOrQualifier = TDD;
4899 assert(isLinkageValid());
4900}
4901
4903 setBeingDefined(true);
4904
4905 if (auto *D = dyn_cast<CXXRecordDecl>(this)) {
4906 struct CXXRecordDecl::DefinitionData *Data =
4907 new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
4908 for (auto *I : redecls())
4909 cast<CXXRecordDecl>(I)->DefinitionData = Data;
4910 }
4911}
4912
4914 assert((!isa<CXXRecordDecl>(this) ||
4916 "definition completed but not started");
4917
4919 setBeingDefined(false);
4920
4922 L->CompletedTagDefinition(this);
4923}
4924
4927 return const_cast<TagDecl *>(this);
4928
4929 if (const auto *CXXRD = dyn_cast<CXXRecordDecl>(this))
4930 return CXXRD->getDefinition();
4931
4932 for (TagDecl *R :
4934 if (R->isCompleteDefinition() || R->isBeingDefined())
4935 return R;
4936 return nullptr;
4937}
4938
4940 if (QualifierLoc) {
4941 // Make sure the extended qualifier info is allocated.
4942 if (!hasExtInfo())
4943 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
4944 // Set qualifier info.
4945 getExtInfo()->QualifierLoc = QualifierLoc;
4946 } else {
4947 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
4948 if (hasExtInfo()) {
4949 if (getExtInfo()->NumTemplParamLists == 0) {
4950 getASTContext().Deallocate(getExtInfo());
4951 TypedefNameDeclOrQualifier = (TypedefNameDecl *)nullptr;
4952 }
4953 else
4954 getExtInfo()->QualifierLoc = QualifierLoc;
4955 }
4956 }
4957}
4958
4959void TagDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
4961 // If the name is supposed to have an identifier but does not have one, then
4962 // the tag is anonymous and we should print it differently.
4963 if (Name.isIdentifier() && !Name.getAsIdentifierInfo()) {
4964 // If the caller wanted to print a qualified name, they've already printed
4965 // the scope. And if the caller doesn't want that, the scope information
4966 // is already printed as part of the type.
4967 PrintingPolicy Copy(Policy);
4968 Copy.SuppressScope = true;
4969 QualType(getASTContext().getCanonicalTagType(this)).print(OS, Copy);
4970 return;
4971 }
4972 // Otherwise, do the normal printing.
4973 Name.print(OS, Policy);
4974}
4975
4978 assert(!TPLists.empty());
4979 // Make sure the extended decl info is allocated.
4980 if (!hasExtInfo())
4981 // Allocate external info struct.
4982 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
4983 // Set the template parameter lists info.
4984 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
4985}
4986
4987//===----------------------------------------------------------------------===//
4988// EnumDecl Implementation
4989//===----------------------------------------------------------------------===//
4990
4991EnumDecl::EnumDecl(ASTContext &C, DeclContext *DC, SourceLocation StartLoc,
4992 SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl,
4993 bool Scoped, bool ScopedUsingClassTag, bool Fixed)
4994 : TagDecl(Enum, TagTypeKind::Enum, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
4995 assert(Scoped || !ScopedUsingClassTag);
4996 IntegerType = nullptr;
4997 setNumPositiveBits(0);
4998 setNumNegativeBits(0);
4999 setScoped(Scoped);
5000 setScopedUsingClassTag(ScopedUsingClassTag);
5001 setFixed(Fixed);
5002 setHasODRHash(false);
5003 ODRHash = 0;
5004}
5005
5006void EnumDecl::anchor() {}
5007
5009 SourceLocation StartLoc, SourceLocation IdLoc,
5010 IdentifierInfo *Id,
5011 EnumDecl *PrevDecl, bool IsScoped,
5012 bool IsScopedUsingClassTag, bool IsFixed) {
5013 return new (C, DC) EnumDecl(C, DC, StartLoc, IdLoc, Id, PrevDecl, IsScoped,
5014 IsScopedUsingClassTag, IsFixed);
5015}
5016
5018 return new (C, ID) EnumDecl(C, nullptr, SourceLocation(), SourceLocation(),
5019 nullptr, nullptr, false, false, false);
5020}
5021
5023 if (const TypeSourceInfo *TI = getIntegerTypeSourceInfo())
5024 return TI->getTypeLoc().getSourceRange();
5025 return SourceRange();
5026}
5027
5029 QualType NewPromotionType,
5030 unsigned NumPositiveBits,
5031 unsigned NumNegativeBits) {
5032 assert(!isCompleteDefinition() && "Cannot redefine enums!");
5033 if (!IntegerType)
5034 IntegerType = NewType.getTypePtr();
5035 PromotionType = NewPromotionType;
5036 setNumPositiveBits(NumPositiveBits);
5037 setNumNegativeBits(NumNegativeBits);
5039}
5040
5042 if (const auto *A = getAttr<EnumExtensibilityAttr>())
5043 return A->getExtensibility() == EnumExtensibilityAttr::Closed;
5044 return true;
5045}
5046
5048 return isClosed() && hasAttr<FlagEnumAttr>();
5049}
5050
5052 return isClosed() && !hasAttr<FlagEnumAttr>();
5053}
5054
5057 return MSI->getTemplateSpecializationKind();
5058
5059 return TSK_Undeclared;
5060}
5061
5063 SourceLocation PointOfInstantiation) {
5065 assert(MSI && "Not an instantiated member enumeration?");
5067 if (TSK != TSK_ExplicitSpecialization &&
5068 PointOfInstantiation.isValid() &&
5070 MSI->setPointOfInstantiation(PointOfInstantiation);
5071}
5072
5075 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
5076 EnumDecl *ED = getInstantiatedFromMemberEnum();
5077 while (auto *NewED = ED->getInstantiatedFromMemberEnum())
5078 ED = NewED;
5079 return ::getDefinitionOrSelf(ED);
5080 }
5081 }
5082
5084 "couldn't find pattern for enum instantiation");
5085 return nullptr;
5086}
5087
5089 if (SpecializationInfo)
5090 return cast<EnumDecl>(SpecializationInfo->getInstantiatedFrom());
5091
5092 return nullptr;
5093}
5094
5095void EnumDecl::setInstantiationOfMemberEnum(ASTContext &C, EnumDecl *ED,
5097 assert(!SpecializationInfo && "Member enum is already a specialization");
5098 SpecializationInfo = new (C) MemberSpecializationInfo(ED, TSK);
5099}
5100
5102 if (hasODRHash())
5103 return ODRHash;
5104
5105 class ODRHash Hash;
5106 Hash.AddEnumDecl(this);
5107 setHasODRHash(true);
5108 ODRHash = Hash.CalculateHash();
5109 return ODRHash;
5110}
5111
5113 auto Res = TagDecl::getSourceRange();
5114 // Set end-point to enum-base, e.g. enum foo : ^bar
5115 if (auto *TSI = getIntegerTypeSourceInfo()) {
5116 // TagDecl doesn't know about the enum base.
5117 if (!getBraceRange().getEnd().isValid())
5118 Res.setEnd(TSI->getTypeLoc().getEndLoc());
5119 }
5120 return Res;
5121}
5122
5123void EnumDecl::getValueRange(llvm::APInt &Max, llvm::APInt &Min) const {
5124 unsigned Bitwidth = getASTContext().getIntWidth(getIntegerType());
5125 unsigned NumNegativeBits = getNumNegativeBits();
5126 unsigned NumPositiveBits = getNumPositiveBits();
5127
5128 if (NumNegativeBits) {
5129 unsigned NumBits = std::max(NumNegativeBits, NumPositiveBits + 1);
5130 Max = llvm::APInt(Bitwidth, 1) << (NumBits - 1);
5131 Min = -Max;
5132 } else {
5133 Max = llvm::APInt(Bitwidth, 1) << NumPositiveBits;
5134 Min = llvm::APInt::getZero(Bitwidth);
5135 }
5136}
5137
5138//===----------------------------------------------------------------------===//
5139// RecordDecl Implementation
5140//===----------------------------------------------------------------------===//
5141
5143 DeclContext *DC, SourceLocation StartLoc,
5144 SourceLocation IdLoc, IdentifierInfo *Id,
5145 RecordDecl *PrevDecl)
5146 : TagDecl(DK, TK, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
5147 assert(classof(static_cast<Decl *>(this)) && "Invalid Kind!");
5150 setHasObjectMember(false);
5151 setHasVolatileMember(false);
5162 setIsRandomized(false);
5163 setODRHash(0);
5164}
5165
5167 SourceLocation StartLoc, SourceLocation IdLoc,
5168 IdentifierInfo *Id, RecordDecl* PrevDecl) {
5169 return new (C, DC)
5170 RecordDecl(Record, TK, C, DC, StartLoc, IdLoc, Id, PrevDecl);
5171}
5172
5174 GlobalDeclID ID) {
5175 return new (C, ID)
5177 SourceLocation(), nullptr, nullptr);
5178}
5179
5181 if (auto RD = dyn_cast<CXXRecordDecl>(this))
5182 return RD->isLambda();
5183 return false;
5184}
5185
5189
5191 addAttr(CapturedRecordAttr::CreateImplicit(getASTContext()));
5192}
5193
5195 if (isUnion())
5196 return true;
5197
5198 if (const RecordDecl *Def = getDefinition()) {
5199 for (const FieldDecl *FD : Def->fields()) {
5200 const RecordType *RT = FD->getType()->getAsCanonical<RecordType>();
5201 if (RT && RT->getDecl()->isOrContainsUnion())
5202 return true;
5203 }
5204 }
5205
5206 return false;
5207}
5208
5211 LoadFieldsFromExternalStorage();
5212 // This is necessary for correctness for C++ with modules.
5213 // FIXME: Come up with a test case that breaks without definition.
5214 if (RecordDecl *D = getDefinition(); D && D != this)
5215 return D->field_begin();
5217}
5218
5222
5223/// completeDefinition - Notes that the definition of this type is now
5224/// complete.
5226 assert(!isCompleteDefinition() && "Cannot redefine record!");
5228
5229 ASTContext &Ctx = getASTContext();
5230
5231 // Layouts are dumped when computed, so if we are dumping for all complete
5232 // types, we need to force usage to get types that wouldn't be used elsewhere.
5233 //
5234 // If the type is dependent, then we can't compute its layout because there
5235 // is no way for us to know the size or alignment of a dependent type. Also
5236 // ignore declarations marked as invalid since 'getASTRecordLayout()' asserts
5237 // on that.
5238 if (Ctx.getLangOpts().DumpRecordLayoutsComplete && !isDependentType() &&
5239 !isInvalidDecl())
5240 (void)Ctx.getASTRecordLayout(this);
5241}
5242
5243/// isMsStruct - Get whether or not this record uses ms_struct layout.
5244/// This which can be turned on with an attribute, pragma, or the
5245/// -mms-bitfields command-line option.
5247 return hasAttr<MSStructAttr>() || C.getLangOpts().MSBitfields == 1;
5248}
5249
5251 std::tie(FirstDecl, LastDecl) = DeclContext::BuildDeclChain(Decls, false);
5252 LastDecl->NextInContextAndBits.setPointer(nullptr);
5253 setIsRandomized(true);
5254}
5255
5256void RecordDecl::LoadFieldsFromExternalStorage() const {
5258 assert(hasExternalLexicalStorage() && Source && "No external storage?");
5259
5260 // Notify that we have a RecordDecl doing some initialization.
5261 ExternalASTSource::Deserializing TheFields(Source);
5262
5265 Source->FindExternalLexicalDecls(this, [](Decl::Kind K) {
5267 }, Decls);
5268
5269#ifndef NDEBUG
5270 // Check that all decls we got were FieldDecls.
5271 for (unsigned i=0, e=Decls.size(); i != e; ++i)
5272 assert(isa<FieldDecl>(Decls[i]) || isa<IndirectFieldDecl>(Decls[i]));
5273#endif
5274
5275 if (Decls.empty())
5276 return;
5277
5278 auto [ExternalFirst, ExternalLast] =
5279 BuildDeclChain(Decls,
5280 /*FieldsAlreadyLoaded=*/false);
5281 ExternalLast->NextInContextAndBits.setPointer(FirstDecl);
5282 FirstDecl = ExternalFirst;
5283 if (!LastDecl)
5284 LastDecl = ExternalLast;
5285}
5286
5287bool RecordDecl::mayInsertExtraPadding(bool EmitRemark) const {
5288 ASTContext &Context = getASTContext();
5289 const SanitizerMask EnabledAsanMask = Context.getLangOpts().Sanitize.Mask &
5290 (SanitizerKind::Address | SanitizerKind::KernelAddress);
5291 if (!EnabledAsanMask || !Context.getLangOpts().SanitizeAddressFieldPadding)
5292 return false;
5293 const auto &NoSanitizeList = Context.getNoSanitizeList();
5294 const auto *CXXRD = dyn_cast<CXXRecordDecl>(this);
5295 // We may be able to relax some of these requirements.
5296 int ReasonToReject = -1;
5297 if (!CXXRD || CXXRD->isExternCContext())
5298 ReasonToReject = 0; // is not C++.
5299 else if (CXXRD->hasAttr<PackedAttr>())
5300 ReasonToReject = 1; // is packed.
5301 else if (CXXRD->isUnion())
5302 ReasonToReject = 2; // is a union.
5303 else if (CXXRD->isTriviallyCopyable())
5304 ReasonToReject = 3; // is trivially copyable.
5305 else if (CXXRD->hasTrivialDestructor())
5306 ReasonToReject = 4; // has trivial destructor.
5307 else if (CXXRD->isStandardLayout())
5308 ReasonToReject = 5; // is standard layout.
5309 else if (NoSanitizeList.containsLocation(EnabledAsanMask, getLocation(),
5310 "field-padding"))
5311 ReasonToReject = 6; // is in an excluded file.
5313 EnabledAsanMask, getQualifiedNameAsString(), "field-padding"))
5314 ReasonToReject = 7; // The type is excluded.
5315
5316 if (EmitRemark) {
5317 if (ReasonToReject >= 0)
5318 Context.getDiagnostics().Report(
5319 getLocation(),
5320 diag::remark_sanitize_address_insert_extra_padding_rejected)
5321 << getQualifiedNameAsString() << ReasonToReject;
5322 else
5323 Context.getDiagnostics().Report(
5324 getLocation(),
5325 diag::remark_sanitize_address_insert_extra_padding_accepted)
5327 }
5328 return ReasonToReject < 0;
5329}
5330
5332 for (const auto *I : fields()) {
5333 if (I->getIdentifier())
5334 return I;
5335
5336 if (const auto *RD = I->getType()->getAsRecordDecl())
5337 if (const FieldDecl *NamedDataMember = RD->findFirstNamedDataMember())
5338 return NamedDataMember;
5339 }
5340
5341 // We didn't find a named data member.
5342 return nullptr;
5343}
5344
5346 if (hasODRHash())
5347 return RecordDeclBits.ODRHash;
5348
5349 // Only calculate hash on first call of getODRHash per record.
5350 ODRHash Hash;
5351 Hash.AddRecordDecl(this);
5352 // For RecordDecl the ODRHash is stored in the remaining
5353 // bits of RecordDeclBits, adjust the hash to accommodate.
5354 static_assert(sizeof(Hash.CalculateHash()) * CHAR_BIT == 32);
5355 setODRHash(Hash.CalculateHash() >> (32 - NumOdrHashBits));
5356 return RecordDeclBits.ODRHash;
5357}
5358
5359//===----------------------------------------------------------------------===//
5360// BlockDecl Implementation
5361//===----------------------------------------------------------------------===//
5362
5364 : Decl(Block, DC, CaretLoc), DeclContext(Block) {
5365 setIsVariadic(false);
5366 setCapturesCXXThis(false);
5369 setDoesNotEscape(false);
5370 setCanAvoidCopyToHeap(false);
5371}
5372
5374 assert(!ParamInfo && "Already has param info!");
5375
5376 // Zero params -> null pointer.
5377 if (!NewParamInfo.empty()) {
5378 NumParams = NewParamInfo.size();
5379 ParamInfo = new (getASTContext()) ParmVarDecl*[NewParamInfo.size()];
5380 llvm::copy(NewParamInfo, ParamInfo);
5381 }
5382}
5383
5385 bool CapturesCXXThis) {
5386 this->setCapturesCXXThis(CapturesCXXThis);
5387 this->NumCaptures = Captures.size();
5388
5389 if (Captures.empty()) {
5390 this->Captures = nullptr;
5391 return;
5392 }
5393
5394 this->Captures = Captures.copy(Context).data();
5395}
5396
5397bool BlockDecl::capturesVariable(const VarDecl *variable) const {
5398 for (const auto &I : captures())
5399 // Only auto vars can be captured, so no redeclaration worries.
5400 if (I.getVariable() == variable)
5401 return true;
5402
5403 return false;
5404}
5405
5407 return SourceRange(getLocation(), Body ? Body->getEndLoc() : getLocation());
5408}
5409
5410//===----------------------------------------------------------------------===//
5411// Other Decl Allocation/Deallocation Method Implementations
5412//===----------------------------------------------------------------------===//
5413
5414void TranslationUnitDecl::anchor() {}
5415
5417 return new (C, (DeclContext *)nullptr) TranslationUnitDecl(C);
5418}
5419
5421 AnonymousNamespace = D;
5422
5423 if (ASTMutationListener *Listener = Ctx.getASTMutationListener())
5424 Listener->AddedAnonymousNamespace(this, D);
5425}
5426
5427void PragmaCommentDecl::anchor() {}
5428
5429PragmaCommentDecl *PragmaCommentDecl::Create(const ASTContext &C,
5431 SourceLocation CommentLoc,
5432 PragmaMSCommentKind CommentKind,
5433 StringRef Arg) {
5434 PragmaCommentDecl *PCD =
5435 new (C, DC, additionalSizeToAlloc<char>(Arg.size() + 1))
5436 PragmaCommentDecl(DC, CommentLoc, CommentKind);
5437 llvm::copy(Arg, PCD->getTrailingObjects());
5438 PCD->getTrailingObjects()[Arg.size()] = '\0';
5439 return PCD;
5440}
5441
5443 GlobalDeclID ID,
5444 unsigned ArgSize) {
5445 return new (C, ID, additionalSizeToAlloc<char>(ArgSize + 1))
5446 PragmaCommentDecl(nullptr, SourceLocation(), PCK_Unknown);
5447}
5448
5449void PragmaDetectMismatchDecl::anchor() {}
5450
5453 SourceLocation Loc, StringRef Name,
5454 StringRef Value) {
5455 size_t ValueStart = Name.size() + 1;
5456 PragmaDetectMismatchDecl *PDMD =
5457 new (C, DC, additionalSizeToAlloc<char>(ValueStart + Value.size() + 1))
5458 PragmaDetectMismatchDecl(DC, Loc, ValueStart);
5459 llvm::copy(Name, PDMD->getTrailingObjects());
5460 PDMD->getTrailingObjects()[Name.size()] = '\0';
5461 llvm::copy(Value, PDMD->getTrailingObjects() + ValueStart);
5462 PDMD->getTrailingObjects()[ValueStart + Value.size()] = '\0';
5463 return PDMD;
5464}
5465
5468 unsigned NameValueSize) {
5469 return new (C, ID, additionalSizeToAlloc<char>(NameValueSize + 1))
5470 PragmaDetectMismatchDecl(nullptr, SourceLocation(), 0);
5471}
5472
5473void ExternCContextDecl::anchor() {}
5474
5475ExternCContextDecl *ExternCContextDecl::Create(const ASTContext &C,
5476 TranslationUnitDecl *DC) {
5477 return new (C, DC) ExternCContextDecl(DC);
5478}
5479
5480void LabelDecl::anchor() {}
5481
5483 SourceLocation IdentL, IdentifierInfo *II) {
5484 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, IdentL);
5485}
5486
5488 SourceLocation IdentL, IdentifierInfo *II,
5489 SourceLocation GnuLabelL) {
5490 assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
5491 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, GnuLabelL);
5492}
5493
5495 return new (C, ID) LabelDecl(nullptr, SourceLocation(), nullptr, nullptr,
5496 SourceLocation());
5497}
5498
5499void LabelDecl::setMSAsmLabel(StringRef Name) {
5500char *Buffer = new (getASTContext(), 1) char[Name.size() + 1];
5501llvm::copy(Name, Buffer);
5502Buffer[Name.size()] = '\0';
5503MSAsmName = Buffer;
5504}
5505
5506void ValueDecl::anchor() {}
5507
5508bool ValueDecl::isWeak() const {
5509 auto *MostRecent = getMostRecentDecl();
5510 return MostRecent->hasAttr<WeakAttr>() ||
5511 MostRecent->hasAttr<WeakRefAttr>() || isWeakImported();
5512}
5513
5515 if (auto *Var = llvm::dyn_cast<VarDecl>(this))
5516 return Var->isInitCapture();
5517 return false;
5518}
5519
5521 if (const auto *NTTP = dyn_cast<NonTypeTemplateParmDecl>(this))
5522 return NTTP->isParameterPack();
5523
5524 return isa_and_nonnull<PackExpansionType>(getType().getTypePtrOrNull());
5525}
5526
5527void ImplicitParamDecl::anchor() {}
5528
5530 SourceLocation IdLoc,
5532 ImplicitParamKind ParamKind) {
5533 return new (C, DC) ImplicitParamDecl(C, DC, IdLoc, Id, Type, ParamKind);
5534}
5535
5537 ImplicitParamKind ParamKind) {
5538 return new (C, nullptr) ImplicitParamDecl(C, Type, ParamKind);
5539}
5540
5545
5548 const DeclarationNameInfo &NameInfo, QualType T,
5549 TypeSourceInfo *TInfo, StorageClass SC, bool UsesFPIntrin,
5551 ConstexprSpecKind ConstexprKind,
5552 const AssociatedConstraint &TrailingRequiresClause) {
5553 FunctionDecl *New = new (C, DC) FunctionDecl(
5554 Function, C, DC, StartLoc, NameInfo, T, TInfo, SC, UsesFPIntrin,
5555 isInlineSpecified, ConstexprKind, TrailingRequiresClause);
5556 New->setHasWrittenPrototype(hasWrittenPrototype);
5557 return New;
5558}
5559
5561 return new (C, ID) FunctionDecl(
5563 nullptr, SC_None, false, false, ConstexprSpecKind::Unspecified,
5564 /*TrailingRequiresClause=*/{});
5565}
5566
5568 return hasAttr<CUDAGlobalAttr>() ||
5569 DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>());
5570}
5571
5573 return new (C, DC) BlockDecl(DC, L);
5574}
5575
5579
5580OutlinedFunctionDecl::OutlinedFunctionDecl(DeclContext *DC, unsigned NumParams)
5581 : Decl(OutlinedFunction, DC, SourceLocation()),
5582 DeclContext(OutlinedFunction), NumParams(NumParams),
5583 BodyAndNothrow(nullptr, false) {}
5584
5586 DeclContext *DC,
5587 unsigned NumParams) {
5588 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5589 OutlinedFunctionDecl(DC, NumParams);
5590}
5591
5594 unsigned NumParams) {
5595 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5596 OutlinedFunctionDecl(nullptr, NumParams);
5597}
5598
5600 return BodyAndNothrow.getPointer();
5601}
5602void OutlinedFunctionDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5603
5604bool OutlinedFunctionDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5606 BodyAndNothrow.setInt(Nothrow);
5607}
5608
5609CapturedDecl::CapturedDecl(DeclContext *DC, unsigned NumParams)
5610 : Decl(Captured, DC, SourceLocation()), DeclContext(Captured),
5611 NumParams(NumParams), ContextParam(0), BodyAndNothrow(nullptr, false) {}
5612
5614 unsigned NumParams) {
5615 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5616 CapturedDecl(DC, NumParams);
5617}
5618
5620 unsigned NumParams) {
5621 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5622 CapturedDecl(nullptr, NumParams);
5623}
5624
5625Stmt *CapturedDecl::getBody() const { return BodyAndNothrow.getPointer(); }
5626void CapturedDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5627
5628bool CapturedDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5629void CapturedDecl::setNothrow(bool Nothrow) { BodyAndNothrow.setInt(Nothrow); }
5630
5633 QualType T, Expr *E, const llvm::APSInt &V)
5634 : ValueDecl(EnumConstant, DC, L, Id, T), Init((Stmt *)E) {
5635 setInitVal(C, V);
5636}
5637
5641 Expr *E, const llvm::APSInt &V) {
5642 return new (C, CD) EnumConstantDecl(C, CD, L, Id, T, E, V);
5643}
5644
5646 GlobalDeclID ID) {
5647 return new (C, ID) EnumConstantDecl(C, nullptr, SourceLocation(), nullptr,
5648 QualType(), nullptr, llvm::APSInt());
5649}
5650
5651void IndirectFieldDecl::anchor() {}
5652
5653IndirectFieldDecl::IndirectFieldDecl(ASTContext &C, DeclContext *DC,
5655 QualType T,
5657 : ValueDecl(IndirectField, DC, L, N, T), Chaining(CH.data()),
5658 ChainingSize(CH.size()) {
5659 // In C++, indirect field declarations conflict with tag declarations in the
5660 // same scope, so add them to IDNS_Tag so that tag redeclaration finds them.
5661 if (C.getLangOpts().CPlusPlus)
5663}
5664
5667 const IdentifierInfo *Id,
5668 QualType T,
5670 return new (C, DC) IndirectFieldDecl(C, DC, L, Id, T, CH);
5671}
5672
5674 GlobalDeclID ID) {
5675 return new (C, ID) IndirectFieldDecl(C, nullptr, SourceLocation(),
5676 DeclarationName(), QualType(), {});
5677}
5678
5681 if (Init)
5682 End = Init->getEndLoc();
5683 return SourceRange(getLocation(), End);
5684}
5685
5686void TypeDecl::anchor() {}
5687
5689 SourceLocation StartLoc, SourceLocation IdLoc,
5690 const IdentifierInfo *Id,
5691 TypeSourceInfo *TInfo) {
5692 return new (C, DC) TypedefDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5693}
5694
5695void TypedefNameDecl::anchor() {}
5696
5698 if (auto *TT = getTypeSourceInfo()->getType()->getAs<TagType>()) {
5699 auto *OwningTypedef = TT->getDecl()->getTypedefNameForAnonDecl();
5700 auto *ThisTypedef = this;
5701 if (AnyRedecl && OwningTypedef) {
5702 OwningTypedef = OwningTypedef->getCanonicalDecl();
5703 ThisTypedef = ThisTypedef->getCanonicalDecl();
5704 }
5705 if (OwningTypedef == ThisTypedef)
5706 return TT->getDecl()->getDefinitionOrSelf();
5707 }
5708
5709 return nullptr;
5710}
5711
5712bool TypedefNameDecl::isTransparentTagSlow() const {
5713 auto determineIsTransparent = [&]() {
5714 if (auto *TT = getUnderlyingType()->getAs<TagType>()) {
5715 if (auto *TD = TT->getDecl()) {
5716 if (TD->getName() != getName())
5717 return false;
5718 SourceLocation TTLoc = getLocation();
5719 SourceLocation TDLoc = TD->getLocation();
5720 if (!TTLoc.isMacroID() || !TDLoc.isMacroID())
5721 return false;
5723 return SM.getSpellingLoc(TTLoc) == SM.getSpellingLoc(TDLoc);
5724 }
5725 }
5726 return false;
5727 };
5728
5729 bool isTransparent = determineIsTransparent();
5730 MaybeModedTInfo.setInt((isTransparent << 1) | 1);
5731 return isTransparent;
5732}
5733
5735 return new (C, ID) TypedefDecl(C, nullptr, SourceLocation(), SourceLocation(),
5736 nullptr, nullptr);
5737}
5738
5740 SourceLocation StartLoc,
5741 SourceLocation IdLoc,
5742 const IdentifierInfo *Id,
5743 TypeSourceInfo *TInfo) {
5744 return new (C, DC) TypeAliasDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5745}
5746
5748 GlobalDeclID ID) {
5749 return new (C, ID) TypeAliasDecl(C, nullptr, SourceLocation(),
5750 SourceLocation(), nullptr, nullptr);
5751}
5752
5754 SourceLocation RangeEnd = getLocation();
5755 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
5756 if (typeIsPostfix(TInfo->getType()))
5757 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5758 }
5759 return SourceRange(getBeginLoc(), RangeEnd);
5760}
5761
5763 SourceLocation RangeEnd = getBeginLoc();
5764 if (TypeSourceInfo *TInfo = getTypeSourceInfo())
5765 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5766 return SourceRange(getBeginLoc(), RangeEnd);
5767}
5768
5769void FileScopeAsmDecl::anchor() {}
5770
5772 Expr *Str, SourceLocation AsmLoc,
5773 SourceLocation RParenLoc) {
5774 return new (C, DC) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);
5775}
5776
5778 GlobalDeclID ID) {
5779 return new (C, ID) FileScopeAsmDecl(nullptr, nullptr, SourceLocation(),
5780 SourceLocation());
5781}
5782
5786
5787void TopLevelStmtDecl::anchor() {}
5788
5789TopLevelStmtDecl *TopLevelStmtDecl::Create(ASTContext &C, Stmt *Statement) {
5790 assert(C.getLangOpts().IncrementalExtensions &&
5791 "Must be used only in incremental mode");
5792
5793 SourceLocation Loc = Statement ? Statement->getBeginLoc() : SourceLocation();
5794 DeclContext *DC = C.getTranslationUnitDecl();
5795
5796 return new (C, DC) TopLevelStmtDecl(DC, Loc, Statement);
5797}
5798
5800 GlobalDeclID ID) {
5801 return new (C, ID)
5802 TopLevelStmtDecl(/*DC=*/nullptr, SourceLocation(), /*S=*/nullptr);
5803}
5804
5806 return SourceRange(getLocation(), Statement->getEndLoc());
5807}
5808
5810 assert(S);
5811 Statement = S;
5812 setLocation(Statement->getBeginLoc());
5813}
5814
5815void EmptyDecl::anchor() {}
5816
5818 return new (C, DC) EmptyDecl(DC, L);
5819}
5820
5822 return new (C, ID) EmptyDecl(nullptr, SourceLocation());
5823}
5824
5825HLSLBufferDecl::HLSLBufferDecl(DeclContext *DC, bool CBuffer,
5826 SourceLocation KwLoc, IdentifierInfo *ID,
5827 SourceLocation IDLoc, SourceLocation LBrace)
5828 : NamedDecl(Decl::Kind::HLSLBuffer, DC, IDLoc, DeclarationName(ID)),
5829 DeclContext(Decl::Kind::HLSLBuffer), LBraceLoc(LBrace), KwLoc(KwLoc),
5830 IsCBuffer(CBuffer), HasValidPackoffset(false), LayoutStruct(nullptr) {}
5831
5833 DeclContext *LexicalParent, bool CBuffer,
5834 SourceLocation KwLoc, IdentifierInfo *ID,
5835 SourceLocation IDLoc,
5836 SourceLocation LBrace) {
5837 // For hlsl like this
5838 // cbuffer A {
5839 // cbuffer B {
5840 // }
5841 // }
5842 // compiler should treat it as
5843 // cbuffer A {
5844 // }
5845 // cbuffer B {
5846 // }
5847 // FIXME: support nested buffers if required for back-compat.
5848 DeclContext *DC = LexicalParent;
5849 HLSLBufferDecl *Result =
5850 new (C, DC) HLSLBufferDecl(DC, CBuffer, KwLoc, ID, IDLoc, LBrace);
5851 return Result;
5852}
5853
5856 ArrayRef<Decl *> DefaultCBufferDecls) {
5857 DeclContext *DC = LexicalParent;
5858 IdentifierInfo *II = &C.Idents.get("$Globals", tok::TokenKind::identifier);
5859 HLSLBufferDecl *Result = new (C, DC) HLSLBufferDecl(
5860 DC, true, SourceLocation(), II, SourceLocation(), SourceLocation());
5861 Result->setImplicit(true);
5862 Result->setDefaultBufferDecls(DefaultCBufferDecls);
5863 return Result;
5864}
5865
5867 GlobalDeclID ID) {
5868 return new (C, ID) HLSLBufferDecl(nullptr, false, SourceLocation(), nullptr,
5870}
5871
5873 assert(LayoutStruct == nullptr && "layout struct has already been set");
5874 LayoutStruct = LS;
5875 addDecl(LS);
5876}
5877
5878void HLSLBufferDecl::setDefaultBufferDecls(ArrayRef<Decl *> Decls) {
5879 assert(!Decls.empty());
5880 assert(DefaultBufferDecls.empty() && "default decls are already set");
5881 assert(isImplicit() &&
5882 "default decls can only be added to the implicit/default constant "
5883 "buffer $Globals");
5884
5885 // allocate array for default decls with ASTContext allocator
5886 Decl **DeclsArray = new (getASTContext()) Decl *[Decls.size()];
5887 llvm::copy(Decls, DeclsArray);
5888 DefaultBufferDecls = ArrayRef<Decl *>(DeclsArray, Decls.size());
5889}
5890
5893 return buffer_decl_iterator(llvm::iterator_range(DefaultBufferDecls.begin(),
5894 DefaultBufferDecls.end()),
5896}
5897
5899 return buffer_decl_iterator(
5900 llvm::iterator_range(DefaultBufferDecls.end(), DefaultBufferDecls.end()),
5902}
5903
5905 return DefaultBufferDecls.empty() && decls_empty();
5906}
5907
5908//===----------------------------------------------------------------------===//
5909// HLSLRootSignatureDecl Implementation
5910//===----------------------------------------------------------------------===//
5911
5912HLSLRootSignatureDecl::HLSLRootSignatureDecl(
5914 llvm::dxbc::RootSignatureVersion Version, unsigned NumElems)
5915 : NamedDecl(Decl::Kind::HLSLRootSignature, DC, Loc, DeclarationName(ID)),
5916 Version(Version), NumElems(NumElems) {}
5917
5918HLSLRootSignatureDecl *HLSLRootSignatureDecl::Create(
5920 llvm::dxbc::RootSignatureVersion Version,
5922 HLSLRootSignatureDecl *RSDecl =
5923 new (C, DC,
5924 additionalSizeToAlloc<llvm::hlsl::rootsig::RootElement>(
5925 RootElements.size()))
5926 HLSLRootSignatureDecl(DC, Loc, ID, Version, RootElements.size());
5927 auto *StoredElems = RSDecl->getElems();
5928 llvm::uninitialized_copy(RootElements, StoredElems);
5929 return RSDecl;
5930}
5931
5934 HLSLRootSignatureDecl *Result = new (C, ID)
5935 HLSLRootSignatureDecl(nullptr, SourceLocation(), nullptr,
5936 /*Version*/ llvm::dxbc::RootSignatureVersion::V1_1,
5937 /*NumElems=*/0);
5938 return Result;
5939}
5940
5941//===----------------------------------------------------------------------===//
5942// ImportDecl Implementation
5943//===----------------------------------------------------------------------===//
5944
5945/// Retrieve the number of module identifiers needed to name the given
5946/// module.
5947static unsigned getNumModuleIdentifiers(Module *Mod) {
5948 unsigned Result = 1;
5949 while (Mod->Parent) {
5950 Mod = Mod->Parent;
5951 ++Result;
5952 }
5953 return Result;
5954}
5955
5956ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
5957 Module *Imported,
5958 ArrayRef<SourceLocation> IdentifierLocs)
5959 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
5960 NextLocalImportAndComplete(nullptr, true) {
5961 assert(getNumModuleIdentifiers(Imported) == IdentifierLocs.size());
5962 auto *StoredLocs = getTrailingObjects();
5963 llvm::uninitialized_copy(IdentifierLocs, StoredLocs);
5964}
5965
5966ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
5967 Module *Imported, SourceLocation EndLoc)
5968 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
5969 NextLocalImportAndComplete(nullptr, false) {
5970 *getTrailingObjects() = EndLoc;
5971}
5972
5974 SourceLocation StartLoc, Module *Imported,
5975 ArrayRef<SourceLocation> IdentifierLocs) {
5976 return new (C, DC,
5977 additionalSizeToAlloc<SourceLocation>(IdentifierLocs.size()))
5978 ImportDecl(DC, StartLoc, Imported, IdentifierLocs);
5979}
5980
5982 SourceLocation StartLoc,
5983 Module *Imported,
5984 SourceLocation EndLoc) {
5985 ImportDecl *Import = new (C, DC, additionalSizeToAlloc<SourceLocation>(1))
5986 ImportDecl(DC, StartLoc, Imported, EndLoc);
5987 Import->setImplicit();
5988 return Import;
5989}
5990
5992 unsigned NumLocations) {
5993 return new (C, ID, additionalSizeToAlloc<SourceLocation>(NumLocations))
5994 ImportDecl(EmptyShell());
5995}
5996
5998 if (!isImportComplete())
5999 return {};
6000
6001 return getTrailingObjects(getNumModuleIdentifiers(getImportedModule()));
6002}
6003
6005 if (!isImportComplete())
6006 return SourceRange(getLocation(), *getTrailingObjects());
6007
6008 return SourceRange(getLocation(), getIdentifierLocs().back());
6009}
6010
6011//===----------------------------------------------------------------------===//
6012// ExportDecl Implementation
6013//===----------------------------------------------------------------------===//
6014
6015void ExportDecl::anchor() {}
6016
6018 SourceLocation ExportLoc) {
6019 return new (C, DC) ExportDecl(DC, ExportLoc);
6020}
6021
6023 return new (C, ID) ExportDecl(nullptr, SourceLocation());
6024}
6025
6027 bool IncludeLocallyStreaming) {
6028 if (IncludeLocallyStreaming)
6029 if (FD->hasAttr<ArmLocallyStreamingAttr>())
6030 return true;
6031
6032 assert(!FD->getType().isNull() && "Expected a valid FunctionDecl");
6033 if (const auto *FPT = FD->getType()->getAs<FunctionProtoType>())
6034 if (FPT->getAArch64SMEAttributes() & FunctionType::SME_PStateSMEnabledMask)
6035 return true;
6036
6037 return false;
6038}
6039
6041 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6042 return (T && FunctionType::getArmZAState(T->getAArch64SMEAttributes()) !=
6044 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZA());
6045}
6046
6048 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6049 return (T && FunctionType::getArmZT0State(T->getAArch64SMEAttributes()) !=
6051 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZT0());
6052}
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:1850
static bool isDeclExternC(const T &D)
Definition Decl.cpp:2236
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:3915
static bool isExportedFromModuleInterfaceUnit(const NamedDecl *D)
Definition Decl.cpp:1190
static bool isRedeclarable(Decl::Kind K)
Definition Decl.cpp:1854
static bool redeclForcesDefMSVC(const FunctionDecl *Redecl)
Definition Decl.cpp:3903
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:2209
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:5947
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:2698
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:2063
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:1231
static SourceLocation getTemplateOrInnerLocStart(const DeclT *decl)
Definition Decl.cpp:1989
static bool isNamed(const NamedDecl *ND, const char(&Str)[Len])
Definition Decl.cpp:3302
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)
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:463
bool needsCleanup() const
Returns whether the object performed allocations.
Definition APValue.cpp:437
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition ASTContext.h:220
SourceManager & getSourceManager()
Definition ASTContext.h:837
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:856
const LangOptions & getLangOpts() const
Definition ASTContext.h:930
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:895
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:5363
void setParams(ArrayRef< ParmVarDecl * > NewParamInfo)
Definition Decl.cpp:5373
void setDoesNotEscape(bool B=true)
Definition Decl.h:4820
void setCapturesCXXThis(bool B=true)
Definition Decl.h:4801
void setCanAvoidCopyToHeap(bool B=true)
Definition Decl.h:4825
void setIsConversionFromLambda(bool val=true)
Definition Decl.h:4815
void setBlockMissingReturnType(bool val=true)
Definition Decl.h:4807
ArrayRef< Capture > captures() const
Definition Decl.h:4795
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5406
static BlockDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5576
void setIsVariadic(bool value)
Definition Decl.h:4744
bool capturesVariable(const VarDecl *var) const
Definition Decl.cpp:5397
void setCaptures(ASTContext &Context, ArrayRef< Capture > Captures, bool CapturesCXXThis)
Definition Decl.cpp:5384
static BlockDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5572
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:2020
void setBody(Stmt *B)
Definition Decl.cpp:5626
static CapturedDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5619
bool isNothrow() const
Definition Decl.cpp:5628
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5629
static CapturedDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5613
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:5625
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:3830
Represents a sugar type with __counted_by or __sized_by annotations, including their _or_null variant...
Definition TypeBase.h:3436
A POD class for pairing a NamedDecl* with an access specifier.
decl_iterator - Iterates through the declarations stored within this context.
Definition DeclBase.h:2330
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition DeclBase.h:1449
DeclContext * getParent()
getParent - Returns the containing DeclContext.
Definition DeclBase.h:2109
bool Equals(const DeclContext *DC) const
Determine whether this declaration context is equivalent to the declaration context DC.
Definition DeclBase.h:2238
FunctionDeclBitfields FunctionDeclBits
Definition DeclBase.h:2044
bool isFileContext() const
Definition DeclBase.h:2180
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:2040
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:2198
bool isTranslationUnit() const
Definition DeclBase.h:2185
bool isRecord() const
Definition DeclBase.h:2189
DeclContext * getRedeclContext()
getRedeclContext - Retrieve the context in which an entity conflicts with other entities of the same ...
RecordDeclBitfields RecordDeclBits
Definition DeclBase.h:2042
Decl * FirstDecl
FirstDecl - The first declaration stored within this declaration context.
Definition DeclBase.h:2079
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:2369
decl_iterator decls_end() const
Definition DeclBase.h:2375
bool hasExternalLexicalStorage() const
Whether this DeclContext has external storage containing additional declarations that are lexically i...
Definition DeclBase.h:2688
Decl * LastDecl
LastDecl - The last declaration stored within this declaration context.
Definition DeclBase.h:2085
bool decls_empty() const
bool isInlineNamespace() const
bool isFunctionOrMethod() const
Definition DeclBase.h:2161
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:2102
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:1061
bool isInStdNamespace() const
Definition DeclBase.cpp:449
SourceLocation getEndLoc() const LLVM_READONLY
Definition DeclBase.h:435
FriendObjectKind getFriendObjectKind() const
Determines whether this declaration is the object of a friend declaration and, if so,...
Definition DeclBase.h:1226
T * getAttr() const
Definition DeclBase.h:573
ASTContext & getASTContext() const LLVM_READONLY
Definition DeclBase.cpp:546
void addAttr(Attr *A)
bool isImplicit() const
isImplicit - Indicates whether the declaration was implicitly generated by the implementation.
Definition DeclBase.h:593
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:870
ModuleOwnershipKind getModuleOwnershipKind() const
Get the kind of module ownership for this declaration.
Definition DeclBase.h:876
ASTMutationListener * getASTMutationListener() const
Definition DeclBase.cpp:556
bool hasCachedLinkage() const
Definition DeclBase.h:421
Kind
Lists the kind of concrete classes of Decl.
Definition DeclBase.h:89
@ FOK_None
Not a friend object.
Definition DeclBase.h:1217
bool isCanonicalDecl() const
Whether this particular Decl is a canonical one.
Definition DeclBase.h:984
Module * getOwningModule() const
Get the module that owns this declaration (for visibility purposes).
Definition DeclBase.h:842
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:793
Linkage getCachedLinkage() const
Definition DeclBase.h:413
bool isTemplateParameter() const
isTemplateParameter - Determines whether this declaration is a template parameter.
Definition DeclBase.h:2793
bool isInvalidDecl() const
Definition DeclBase.h:588
bool hasDefiningAttr() const
Return true if this declaration has an attribute which acts as definition of the entity,...
Definition DeclBase.cpp:633
llvm::iterator_range< specific_attr_iterator< T > > specific_attrs() const
Definition DeclBase.h:559
SourceLocation getLocation() const
Definition DeclBase.h:439
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:1049
void setLocation(SourceLocation L)
Definition DeclBase.h:440
friend class LinkageComputer
Definition DeclBase.h:329
DeclContext * getDeclContext()
Definition DeclBase.h:448
bool isInAnonymousNamespace() const
Definition DeclBase.cpp:439
void setCachedLinkage(Linkage L) const
Definition DeclBase.h:417
friend class RecordDecl
Definition DeclBase.h:330
Module * getOwningModuleForLinkage() const
Get the module that owns this declaration for linkage purposes.
Definition Decl.cpp:1636
DeclContext * getLexicalDeclContext()
getLexicalDeclContext - The declaration context where this Decl was lexically declared (LexicalDC).
Definition DeclBase.h:918
bool hasAttr() const
Definition DeclBase.h:577
friend class DeclContext
Definition DeclBase.h:252
virtual Decl * getCanonicalDecl()
Retrieves the "canonical" declaration of the given declaration.
Definition DeclBase.h:978
@ 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:234
@ ModulePrivate
This declaration has an owning module, but is only visible to lookups that occur within that module.
Definition DeclBase.h:240
@ 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:442
const LangOptions & getLangOpts() const LLVM_READONLY
Helper to get the language options from the ASTContext.
Definition DeclBase.cpp:552
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:2001
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:2057
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2097
SourceLocation getTypeSpecStartLoc() const
Definition Decl.cpp:1995
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:2007
void setTrailingRequiresClause(const AssociatedConstraint &AC)
Definition Decl.cpp:2026
TypeSourceInfo * getTypeSourceInfo() const
Definition Decl.h:809
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:2041
Provides information about a dependent function-template specialization declaration.
static DependentFunctionTemplateSpecializationInfo * Create(ASTContext &Context, const UnresolvedSetImpl &Candidates, const TemplateArgumentListInfo *TemplateArgs)
Definition Decl.cpp:4391
static EmptyDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5817
static EmptyDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5821
EnumConstantDecl(const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V)
Definition Decl.cpp:5631
static EnumConstantDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5645
void setInitVal(const ASTContext &C, const llvm::APSInt &V)
Definition Decl.h:3448
static EnumConstantDecl * Create(ASTContext &C, EnumDecl *DC, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V)
Definition Decl.cpp:5638
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5679
Represents an enum.
Definition Decl.h:4007
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this enumeration is an instantiation of a member enumeration of a class template specialization,...
Definition Decl.h:4279
unsigned getNumNegativeBits() const
Returns the width in bits required to store all the negative enumerators of this enum.
Definition Decl.h:4217
unsigned getODRHash()
Definition Decl.cpp:5101
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:5062
static EnumDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl, bool IsScoped, bool IsScopedUsingClassTag, bool IsFixed)
Definition Decl.cpp:5008
TypeSourceInfo * getIntegerTypeSourceInfo() const
Return the type source info for the underlying integer type, if no type source info exists,...
Definition Decl.h:4196
static EnumDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5017
bool isClosedFlag() const
Returns true if this enum is annotated with flag_enum and isn't annotated with enum_extensibility(ope...
Definition Decl.cpp:5047
SourceRange getIntegerTypeRange() const LLVM_READONLY
Retrieve the source range that covers the underlying type if specified.
Definition Decl.cpp:5022
SourceRange getSourceRange() const override LLVM_READONLY
Overrides to provide correct range when there's an enum-base specifier with forward declarations.
Definition Decl.cpp:5112
QualType getIntegerType() const
Return the integer type this enum decl corresponds to.
Definition Decl.h:4180
EnumDecl * getInstantiatedFromMemberEnum() const
Returns the enumeration (declared within the template) from which this enumeration type was instantia...
Definition Decl.cpp:5088
unsigned getNumPositiveBits() const
Returns the width in bits required to store all the non-negative enumerators of this enum.
Definition Decl.h:4206
TemplateSpecializationKind getTemplateSpecializationKind() const
If this enumeration is a member of a specialization of a templated class, determine what kind of temp...
Definition Decl.cpp:5055
bool isClosed() const
Returns true if this enum is either annotated with enum_extensibility(closed) or isn't annotated with...
Definition Decl.cpp:5041
EnumDecl * getTemplateInstantiationPattern() const
Retrieve the enum definition from which this enumeration could be instantiated, if it is an instantia...
Definition Decl.cpp:5073
bool isClosedNonFlag() const
Returns true if this enum is annotated with neither flag_enum nor enum_extensibility(open).
Definition Decl.cpp:5051
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:5123
static ExportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation ExportLoc)
Definition Decl.cpp:6017
static ExportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:6022
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:3666
QualType getType() const
Definition Expr.h:144
static ExternCContextDecl * Create(const ASTContext &C, TranslationUnitDecl *TU)
Definition Decl.cpp:5475
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:3160
Expr * getInClassInitializer() const
Get the C++11 default member initializer for this member, or null if one has not been set.
Definition Decl.cpp:4721
bool isBitField() const
Determines whether this field is a bitfield.
Definition Decl.h:3263
bool hasInClassInitializer() const
Determine whether this member has a C++11 default member initializer.
Definition Decl.h:3340
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:3220
LazyDeclStmtPtr Init
Definition Decl.h:3210
unsigned getBitWidthValue() const
Computes the bit width of this field, if this is a bit field.
Definition Decl.cpp:4748
bool isAnonymousStructOrUnion() const
Determines whether this field is a representative for an anonymous struct or union.
Definition Decl.cpp:4711
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4822
bool hasConstantIntegerBitWidth() const
Determines whether the bit width of this field is a constant integer.
Definition Decl.cpp:4743
static FieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:4705
void setInClassInitializer(Expr *NewInit)
Set the C++11 in-class initializer for this member.
Definition Decl.cpp:4731
const RecordDecl * getParent() const
Returns the parent of this field declaration, which is the struct in which this field is defined.
Definition Decl.h:3396
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:4762
InitAndBitWidthStorage * InitAndBitWidth
Definition Decl.h:3214
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:4696
FieldDecl * getCanonicalDecl() override
Retrieves the canonical declaration of this field.
Definition Decl.h:3407
static bool classofKind(Kind K)
Definition Decl.h:3412
bool isUnnamedBitField() const
Determines whether this is an unnamed bitfield.
Definition Decl.h:3266
bool isZeroLengthBitField() const
Is this a zero-length bit-field?
Definition Decl.cpp:4757
Expr * getBitWidth() const
Returns the expression that represents the bit width, if this field is a bit field.
Definition Decl.h:3276
void printName(raw_ostream &OS, const PrintingPolicy &Policy) const override
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:4841
const FieldDecl * findCountedByField() const
Find the FieldDecl specified in a FAM's "counted_by" attribute.
Definition Decl.cpp:4851
bool isPotentiallyOverlapping() const
Determine if this field is of potentially-overlapping class type, that is, subobject with the [[no_un...
Definition Decl.cpp:4800
void setCapturedVLAType(const VariableArrayType *VLAType)
Set the captured variable length array type for this field.
Definition Decl.cpp:4831
const VariableArrayType * CapturedVLAType
Definition Decl.h:3216
std::string getAsmString() const
Definition Decl.cpp:5783
const Expr * getAsmStringExpr() const
Definition Decl.h:4616
static FileScopeAsmDecl * Create(ASTContext &C, DeclContext *DC, Expr *Str, SourceLocation AsmLoc, SourceLocation RParenLoc)
Definition Decl.cpp:5771
static FileScopeAsmDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5777
Stashed information about a defaulted/deleted function body.
Definition Decl.h:2028
static DefaultedOrDeletedFunctionInfo * Create(ASTContext &Context, ArrayRef< DeclAccessPair > Lookups, StringLiteral *DeletedMessage=nullptr)
Definition Decl.cpp:3136
void setDeletedMessage(StringLiteral *Message)
Definition Decl.cpp:3178
Represents a function declaration or definition.
Definition Decl.h:2000
unsigned getMemoryFunctionKind() const
Identify a memory copying or setting function.
Definition Decl.cpp:4549
static constexpr unsigned RequiredTypeAwareDeleteParameterCount
Count of mandatory parameters for type aware operator delete.
Definition Decl.h:2642
bool isTargetClonesMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target-clones functional...
Definition Decl.cpp:3720
bool isMultiVersion() const
True if this function is considered a multiversioned function.
Definition Decl.h:2689
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:2189
const ParmVarDecl * getParamDecl(unsigned i) const
Definition Decl.h:2797
bool hasTrivialBody() const
Returns whether the function has a trivial body that does not require any specific codegen.
Definition Decl.cpp:3206
DefaultedOrDeletedFunctionInfo * getDefaultedOrDeletedInfo() const
Definition Decl.cpp:3190
unsigned getMinRequiredArguments() const
Returns the minimum number of arguments needed to call this function.
Definition Decl.cpp:3843
bool isFunctionTemplateSpecialization() const
Determine whether this function is a function template specialization.
Definition Decl.cpp:4201
void setPreviousDeclaration(FunctionDecl *PrevDecl)
Definition Decl.cpp:3729
void setDescribedFunctionTemplate(FunctionTemplateDecl *Template)
Definition Decl.cpp:4194
FunctionTemplateDecl * getDescribedFunctionTemplate() const
Retrieves the function template that is described by this function declaration.
Definition Decl.cpp:4189
void setIsPureVirtual(bool P=true)
Definition Decl.cpp:3294
bool isImmediateFunction() const
Definition Decl.cpp:3336
void setDefaultedOrDeletedInfo(DefaultedOrDeletedFunctionInfo *Info)
Definition Decl.cpp:3156
SourceLocation getEllipsisLoc() const
Returns the location of the ellipsis of a variadic function.
Definition Decl.h:2223
SourceRange getReturnTypeSourceRange() const
Attempt to compute an informative source range covering the function return type.
Definition Decl.cpp:4020
bool isDestroyingOperatorDelete() const
Determine whether this is a destroying operator delete.
Definition Decl.cpp:3547
static FunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5560
unsigned getBuiltinID(bool ConsiderWrapperFunctions=false) const
Returns a value indicating whether this function corresponds to a builtin function.
Definition Decl.cpp:3758
SourceLocation getPointOfInstantiation() const
Retrieve the (first) point of instantiation of a function template specialization or a member of a cl...
Definition Decl.cpp:4510
bool isMemberLikeConstrainedFriend() const
Determine whether a function is a friend function that cannot be redeclared outside of its class,...
Definition Decl.cpp:3662
bool hasCXXExplicitFunctionObjectParameter() const
Definition Decl.cpp:3861
bool isInlined() const
Determine whether this function should be inlined, because it is either marked "inline" or "constexpr...
Definition Decl.h:2921
bool UsesFPIntrin() const
Determine whether the function was declared in source context that requires constrained FP intrinsics...
Definition Decl.h:2909
bool isNoReturn() const
Determines whether this function is known to be 'noreturn', through an attribute on its declaration o...
Definition Decl.cpp:3647
ArrayRef< ParmVarDecl * > parameters() const
Definition Decl.h:2774
bool isCPUSpecificMultiVersion() const
True if this function is a multiversioned processor specific function as a part of the cpu_specific/c...
Definition Decl.cpp:3702
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:4260
bool isMSExternInline() const
The combination of the extern and inline keywords under MSVC forces the function to be required.
Definition Decl.cpp:3887
unsigned getMinRequiredExplicitArguments() const
Returns the minimum number of non-object arguments needed to call this function.
Definition Decl.cpp:3870
bool BodyContainsImmediateEscalatingExpressions() const
Definition Decl.h:2490
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:3610
FunctionTemplateDecl * getPrimaryTemplate() const
Retrieve the primary template that this function template specialization either specializes or was in...
Definition Decl.cpp:4309
bool hasWrittenPrototype() const
Whether this function has a written prototype.
Definition Decl.h:2448
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this function is an instantiation of a member function of a class template specialization,...
Definition Decl.cpp:4168
FunctionTemplateSpecializationInfo * getTemplateSpecializationInfo() const
If this function is actually a function template specialization, retrieve information about this func...
Definition Decl.cpp:4319
FunctionDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:3743
FunctionTypeLoc getFunctionTypeLoc() const
Find the source location information for how the type of this function was written.
Definition Decl.cpp:3997
bool isVariadic() const
Whether this function is variadic.
Definition Decl.cpp:3129
bool doesThisDeclarationHaveABody() const
Returns whether this specific declaration of the function has a body.
Definition Decl.h:2326
bool isConstexprSpecified() const
Definition Decl.h:2479
DependentFunctionTemplateSpecializationInfo * getDependentSpecializationInfo() const
Definition Decl.cpp:4385
const TemplateArgumentList * getTemplateSpecializationArgs() const
Retrieve the template arguments used to produce this function template specialization from the primar...
Definition Decl.cpp:4325
SourceRange getExceptionSpecSourceRange() const
Attempt to compute an informative source range covering the function exception specification,...
Definition Decl.cpp:4052
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:2253
bool isMSVCRTEntryPoint() const
Determines whether this function is a MSVCRT user defined entry point.
Definition Decl.cpp:3371
unsigned getODRHash()
Returns ODRHash of the function.
Definition Decl.cpp:4675
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Determine the kind of template specialization this function represents for the purpose of template in...
Definition Decl.cpp:4437
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:3075
bool isTemplateInstantiation() const
Determines if the given function was instantiated from a function template.
Definition Decl.cpp:4253
unsigned getNumNonObjectParams() const
Definition Decl.cpp:3865
TemplatedKind
The kind of templated function a FunctionDecl can be.
Definition Decl.h:2005
@ TK_FunctionTemplateSpecialization
Definition Decl.h:2016
@ TK_DependentFunctionTemplateSpecialization
Definition Decl.h:2019
UsualDeleteParams getUsualDeleteParams() const
Definition Decl.cpp:3563
StorageClass getStorageClass() const
Returns the storage class as written in the source.
Definition Decl.h:2888
bool isOutOfLine() const override
Determine whether this is or was instantiated from an out-of-line definition of a member function.
Definition Decl.cpp:4522
bool isInlineBuiltinDeclaration() const
Determine if this function provides an inline implementation of a builtin.
Definition Decl.cpp:3522
bool FriendConstraintRefersToEnclosingTemplate() const
Definition Decl.h:2707
TemplatedKind getTemplatedKind() const
What kind of templated function this is.
Definition Decl.cpp:4140
void setInstantiatedFromDecl(FunctionDecl *FD)
Specify that this function declaration was instantiated from a FunctionDecl FD.
Definition Decl.cpp:4207
bool isDeletedAsWritten() const
Definition Decl.h:2544
bool isReservedGlobalPlacementOperator() const
Determines whether this operator new or delete is one of the reserved global placement operators: voi...
Definition Decl.cpp:3399
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:4374
bool isInExternCContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:3618
static constexpr unsigned RequiredTypeAwareNewParameterCount
Count of mandatory parameters for type aware operator new.
Definition Decl.h:2638
bool isImplicitlyInstantiable() const
Determines whether this function is a function template specialization or a member of a class templat...
Definition Decl.cpp:4218
bool isExternC() const
Determines whether this function is a function with external, C linkage.
Definition Decl.cpp:3614
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:2300
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:2276
LazyDeclStmtPtr Body
The body of the function.
Definition Decl.h:2066
bool isImmediateEscalating() const
Definition Decl.cpp:3307
void setIsDestroyingOperatorDelete(bool IsDestroyingDelete)
Definition Decl.cpp:3551
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:3422
DefaultedOrDeletedFunctionInfo * DefaultedOrDeletedInfo
Information about a future defaulted function definition.
Definition Decl.h:2068
bool isTypeAwareOperatorNewOrDelete() const
Determine whether this is a type aware operator new or delete.
Definition Decl.cpp:3555
bool isInExternCXXContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:3624
bool isMain() const
Determines whether this function is "main", which is the entry point into an executable program.
Definition Decl.cpp:3364
void setImplicitlyInline(bool I=true)
Flag that this function is implicitly inline.
Definition Decl.h:2916
bool isTargetVersionMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target-version functiona...
Definition Decl.cpp:3724
void setIsTypeAwareOperatorNewOrDelete(bool IsTypeAwareOperator=true)
Definition Decl.cpp:3559
bool isThisDeclarationInstantiatedFromAFriendDefinition() const
Determine whether this specific declaration of the function is a friend declaration that was instanti...
Definition Decl.cpp:3219
bool isCPUDispatchMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the cpu_specific/cpu_dispatc...
Definition Decl.cpp:3698
bool isDefaulted() const
Whether this function is defaulted.
Definition Decl.h:2385
bool isReferenceableKernel() const
Definition Decl.cpp:5567
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4545
FunctionDecl * getInstantiatedFromDecl() const
Definition Decl.cpp:4213
void setTemplateSpecializationKind(TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4482
const IdentifierInfo * getLiteralIdentifier() const
getLiteralIdentifier - The literal suffix identifier this function represents, if any.
Definition Decl.cpp:4134
OverloadedOperatorKind getOverloadedOperator() const
getOverloadedOperator - Which C++ overloaded operator this function represents, if any.
Definition Decl.cpp:4126
TemplateSpecializationKind getTemplateSpecializationKind() const
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4413
bool doesDeclarationForceExternallyVisibleDefinition() const
For a function declaration in C or C++, determine whether this declaration causes the definition to b...
Definition Decl.cpp:3937
bool isConsteval() const
Definition Decl.h:2482
bool isTargetMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the target functionality.
Definition Decl.cpp:3706
bool isAnalyzerNoReturn() const
Determines whether this function is known to be 'noreturn' for analyzer, through an analyzer_noreturn...
Definition Decl.cpp:3658
void setBody(Stmt *B)
Definition Decl.cpp:3287
bool isGlobal() const
Determines whether this is a global function.
Definition Decl.cpp:3628
bool hasOneParamOrDefaultArgs() const
Determine whether this function has a single parameter, or multiple parameters where all but the firs...
Definition Decl.cpp:3875
void setDeletedAsWritten(bool D=true, StringLiteral *Message=nullptr)
Definition Decl.cpp:3165
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:3711
FunctionDecl * getInstantiatedFromMemberFunction() const
If this function is an instantiation of a member function of a class template specialization,...
Definition Decl.cpp:4161
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:4074
unsigned getNumParams() const
Return the number of parameters this function must have based on its FunctionType.
Definition Decl.cpp:3822
DeclarationNameInfo getNameInfo() const
Definition Decl.h:2211
Redeclarable< FunctionDecl > redeclarable_base
Definition Decl.h:2160
bool hasBody(const FunctionDecl *&Definition) const
Returns true if the function has a body.
Definition Decl.cpp:3195
SourceRange getParametersSourceRange() const
Attempt to compute an informative source range covering the function parameters, including the ellips...
Definition Decl.cpp:4036
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:2899
MultiVersionKind getMultiVersionKind() const
Gets the kind of multiversioning attribute this declaration has.
Definition Decl.cpp:3684
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:3121
bool willHaveBody() const
True if this function will eventually have a body, once it's fully parsed.
Definition Decl.h:2685
const ASTTemplateArgumentListInfo * getTemplateSpecializationArgsAsWritten() const
Retrieve the template argument list as written in the sources, if any.
Definition Decl.cpp:4335
Represents a prototype with parameter type info, e.g.
Definition TypeBase.h:5254
param_type_iterator param_type_begin() const
Definition TypeBase.h:5698
unsigned getNumParams() const
Definition TypeBase.h:5532
bool isVariadic() const
Whether this function prototype is variadic.
Definition TypeBase.h:5658
param_type_iterator param_type_end() const
Definition TypeBase.h:5702
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:1615
SourceRange getExceptionSpecRange() const
Definition TypeLoc.h:1667
TypeLoc getReturnLoc() const
Definition TypeLoc.h:1696
FunctionType - C99 6.7.5.3 - Function Declarators.
Definition TypeBase.h:4450
static ArmStateValue getArmZT0State(unsigned AttrBits)
Definition TypeBase.h:4759
static ArmStateValue getArmZAState(unsigned AttrBits)
Definition TypeBase.h:4755
static std::string ExtractStringFromGCCAsmStmtComponent(const Expr *E)
Definition Stmt.cpp:516
HLSLBufferDecl - Represent a cbuffer or tbuffer declaration.
Definition Decl.h:5190
buffer_decl_iterator buffer_decls_begin() const
Definition Decl.cpp:5892
static HLSLBufferDecl * Create(ASTContext &C, DeclContext *LexicalParent, bool CBuffer, SourceLocation KwLoc, IdentifierInfo *ID, SourceLocation IDLoc, SourceLocation LBrace)
Definition Decl.cpp:5832
void addLayoutStruct(CXXRecordDecl *LS)
Definition Decl.cpp:5872
bool buffer_decls_empty()
Definition Decl.cpp:5904
llvm::concat_iterator< Decl *const, SmallVector< Decl * >::const_iterator, decl_iterator > buffer_decl_iterator
Definition Decl.h:5260
static HLSLBufferDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5866
buffer_decl_iterator buffer_decls_end() const
Definition Decl.cpp:5898
static HLSLBufferDecl * CreateDefaultCBuffer(ASTContext &C, DeclContext *LexicalParent, ArrayRef< Decl * > DefaultCBufferDecls)
Definition Decl.cpp:5855
static HLSLRootSignatureDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation Loc, IdentifierInfo *ID, llvm::dxbc::RootSignatureVersion Version, ArrayRef< llvm::hlsl::rootsig::RootElement > RootElements)
Definition Decl.cpp:5918
static HLSLRootSignatureDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5933
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:1762
static ImplicitParamDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation IdLoc, IdentifierInfo *Id, QualType T, ImplicitParamKind ParamKind)
Create implicit parameter.
Definition Decl.cpp:5529
static ImplicitParamDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5541
static ImportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, Module *Imported, ArrayRef< SourceLocation > IdentifierLocs)
Create a new module import declaration.
Definition Decl.cpp:5973
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:6004
static ImportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumLocations)
Create a new, deserialized module import declaration.
Definition Decl.cpp:5991
friend class ASTContext
Definition Decl.h:5050
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:5997
Module * getImportedModule() const
Retrieve the module that was imported by the import declaration.
Definition Decl.h:5107
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:5981
static bool classofKind(Kind K)
Definition Decl.h:3509
static IndirectFieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5673
static IndirectFieldDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L, const IdentifierInfo *Id, QualType T, MutableArrayRef< NamedDecl * > CH)
Definition Decl.cpp:5665
void setMSAsmLabel(StringRef Name)
Definition Decl.cpp:5499
static LabelDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation IdentL, IdentifierInfo *II)
Definition Decl.cpp:5482
static LabelDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5494
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:5001
LinkageInfo computeLVForDecl(const NamedDecl *D, LVComputationKind computation, bool IgnoreVarTypeLinkage=false)
Definition Decl.cpp:1459
LinkageInfo getLVForDecl(const NamedDecl *D, LVComputationKind computation)
getLVForDecl - Get the linkage and visibility for the given declaration.
Definition Decl.cpp:1577
LinkageInfo getDeclLinkageAndVisibility(const NamedDecl *D)
Definition Decl.cpp:1626
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:144
Module * Parent
The parent of this module.
Definition Module.h:193
ModuleKind Kind
The kind of this module.
Definition Module.h:189
@ ModuleImplementationUnit
This is a C++20 module implementation unit.
Definition Module.h:167
@ ModuleMapModule
This is a module that was defined by a module map and built out of header files.
Definition Module.h:158
@ ImplicitGlobalModuleFragment
This is an implicit fragment of the global module which contains only language linkage declarations (...
Definition Module.h:185
@ ModulePartitionInterface
This is a C++20 module partition interface.
Definition Module.h:170
@ ModuleInterfaceUnit
This is a C++20 module interface unit.
Definition Module.h:164
@ ModuleHeaderUnit
This is a C++20 header unit.
Definition Module.h:161
@ ModulePartitionImplementation
This is a C++20 module partition implementation.
Definition Module.h:173
@ PrivateModuleFragment
This is the private module fragment within some C++ module.
Definition Module.h:180
@ ExplicitGlobalModuleFragment
This is the explicit Global Module Fragment of a modular TU.
Definition Module.h:177
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:1226
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:1680
std::optional< Visibility > getExplicitVisibility(ExplicitVisibilityKind kind) const
If visibility was explicitly specified for this declaration, return that visibility.
Definition Decl.cpp:1313
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:1841
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:1865
ObjCStringFormatFamily getObjCFStringFormattingFamily() const
Definition Decl.cpp:1169
Linkage getFormalLinkage() const
Get the linkage from a semantic point of view.
Definition Decl.cpp:1206
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:1687
virtual void printName(raw_ostream &OS, const PrintingPolicy &Policy) const
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:1672
bool isCXXInstanceMember() const
Determine whether the given declaration is an instance member of a C++ class.
Definition Decl.cpp:1969
bool hasLinkage() const
Determine whether this declaration has linkage.
Definition Decl.cpp:1937
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:1714
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:4875
static OutlinedFunctionDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5585
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5605
static OutlinedFunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5593
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:5599
Represents a parameter to a function.
Definition Decl.h:1790
void setDefaultArg(Expr *defarg)
Definition Decl.cpp:3018
static ParmVarDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:2970
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:1796
bool hasUnparsedDefaultArg() const
Determines whether this parameter has a default argument that has not yet been parsed.
Definition Decl.h:1919
SourceRange getDefaultArgRange() const
Retrieve the source range that covers the entire default argument.
Definition Decl.cpp:3023
void setUninstantiatedDefaultArg(Expr *arg)
Definition Decl.cpp:3043
bool hasUninstantiatedDefaultArg() const
Definition Decl.h:1923
bool isDestroyedInCallee() const
Determines whether this parameter is destroyed in the callee function.
Definition Decl.cpp:2991
bool hasInheritedDefaultArg() const
Definition Decl.h:1935
bool isExplicitObjectParameter() const
Definition Decl.h:1878
QualType getOriginalType() const
Definition Decl.cpp:2962
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:2953
Expr * getDefaultArg()
Definition Decl.cpp:3006
Expr * getUninstantiatedDefaultArg()
Definition Decl.cpp:3048
bool hasDefaultArg() const
Determines whether this parameter has a default argument, either parsed or not.
Definition Decl.cpp:3054
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2976
static PragmaCommentDecl * Create(const ASTContext &C, TranslationUnitDecl *DC, SourceLocation CommentLoc, PragmaMSCommentKind CommentKind, StringRef Arg)
Definition Decl.cpp:5429
static PragmaCommentDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned ArgSize)
Definition Decl.cpp:5442
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:5452
static PragmaDetectMismatchDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NameValueSize)
Definition Decl.cpp:5467
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:8278
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:1545
unsigned getCVRQualifiers() const
Retrieve the set of CVR (const-volatile-restrict) qualifiers applied to this type.
Definition TypeBase.h:8324
Represents a struct/union/class.
Definition Decl.h:4321
bool hasLoadedFieldsFromExternalStorage() const
Definition Decl.h:4390
unsigned getODRHash()
Get precomputed ODRHash or add a new one.
Definition Decl.cpp:5345
bool isLambda() const
Determine whether this record is a class describing a lambda function object.
Definition Decl.cpp:5180
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:5246
void setAnonymousStructOrUnion(bool Anon)
Definition Decl.h:4377
RecordDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl)
Definition Decl.cpp:5142
const FieldDecl * findFirstNamedDataMember() const
Finds the first data member which has a name.
Definition Decl.cpp:5331
field_iterator noload_field_begin() const
Definition Decl.cpp:5219
void setArgPassingRestrictions(RecordArgPassingKind Kind)
Definition Decl.h:4467
void setNonTrivialToPrimitiveCopy(bool V)
Definition Decl.h:4411
bool isCapturedRecord() const
Determine whether this record is a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5186
void setHasNonTrivialToPrimitiveCopyCUnion(bool V)
Definition Decl.h:4443
field_range fields() const
Definition Decl.h:4524
void setHasNonTrivialToPrimitiveDestructCUnion(bool V)
Definition Decl.h:4435
void setHasFlexibleArrayMember(bool V)
Definition Decl.h:4358
void setParamDestroyedInCallee(bool V)
Definition Decl.h:4475
void setNonTrivialToPrimitiveDestroy(bool V)
Definition Decl.h:4419
void setHasObjectMember(bool val)
Definition Decl.h:4382
static RecordDecl * Create(const ASTContext &C, TagKind TK, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl=nullptr)
Definition Decl.cpp:5166
void setHasVolatileMember(bool val)
Definition Decl.h:4386
void setHasNonTrivialToPrimitiveDefaultInitializeCUnion(bool V)
Definition Decl.h:4427
void reorderDecls(const SmallVectorImpl< Decl * > &Decls)
Definition Decl.cpp:5250
void setIsRandomized(bool V)
Definition Decl.h:4481
static RecordDecl * CreateDeserialized(const ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5173
bool mayInsertExtraPadding(bool EmitRemark=false) const
Whether we are allowed to insert extra padding between fields.
Definition Decl.cpp:5287
static bool classof(const Decl *D)
Definition Decl.h:4561
bool isOrContainsUnion() const
Returns whether this record is a union, or contains (at any nesting level) a union member.
Definition Decl.cpp:5194
virtual void completeDefinition()
Note that the definition of this type is now complete.
Definition Decl.cpp:5225
RecordDecl * getDefinition() const
Returns the RecordDecl that actually defines this struct/union/class.
Definition Decl.h:4505
void setCapturedRecord()
Mark the record as a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5190
specific_decl_iterator< FieldDecl > field_iterator
Definition Decl.h:4521
void setHasUninitializedExplicitInitFields(bool V)
Definition Decl.h:4451
void setNonTrivialToPrimitiveDefaultInitialize(bool V)
Definition Decl.h:4403
RecordDecl * getDefinitionOrSelf() const
Definition Decl.h:4509
friend class DeclContext
Definition Decl.h:4325
void setHasLoadedFieldsFromExternalStorage(bool val) const
Definition Decl.h:4394
field_iterator field_begin() const
Definition Decl.cpp:5209
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.
A trivial tuple used to represent a source range.
bool isInvalid() const
SourceLocation getEnd() const
Stmt - This represents one statement.
Definition Stmt.h:85
SourceLocation getEndLoc() const LLVM_READONLY
Definition Stmt.cpp:362
SourceRange getSourceRange() const LLVM_READONLY
SourceLocation tokens are not useful in isolation - they are low level value objects created/interpre...
Definition Stmt.cpp:338
StringLiteral - This represents a string literal expression, e.g.
Definition Expr.h:1799
Represents the declaration of a struct/union/class/enum.
Definition Decl.h:3717
void setTagKind(TagKind TK)
Definition Decl.h:3915
void setCompleteDefinitionRequired(bool V=true)
True if this complete decl is required to be complete for some existing use.
Definition Decl.h:3827
SourceRange getBraceRange() const
Definition Decl.h:3788
TagTypeKind TagKind
Definition Decl.h:3722
bool isBeingDefined() const
Return true if this decl is currently being defined.
Definition Decl.h:3832
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:4925
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:3842
bool isCompleteDefinition() const
Return true if this decl has its body fully specified.
Definition Decl.h:3812
redeclarable_base::redecl_iterator redecl_iterator
Definition Decl.h:3779
void startDefinition()
Starts the definition of this tag declaration.
Definition Decl.cpp:4902
TagDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:4895
void setTypedefNameForAnonDecl(TypedefNameDecl *TDD)
Definition Decl.cpp:4897
SourceLocation getOuterLocStart() const
Return SourceLocation representing start of source range taking into account any outer template decla...
Definition Decl.cpp:4885
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4889
bool isUnion() const
Definition Decl.h:3922
void setBeingDefined(bool V=true)
True if this decl is currently being defined.
Definition Decl.h:3772
void setQualifierInfo(NestedNameSpecifierLoc QualifierLoc)
Definition Decl.cpp:4939
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:4976
void completeDefinition()
Completes the definition of this tag declaration.
Definition Decl.cpp:4913
void printName(raw_ostream &OS, const PrintingPolicy &Policy) const override
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:4959
Redeclarable< TagDecl > redeclarable_base
Definition Decl.h:3752
void setFreeStanding(bool isFreeStanding=true)
True if this tag is free standing, e.g. "struct foo;".
Definition Decl.h:3850
redeclarable_base::redecl_range redecl_range
Definition Decl.h:3778
bool isDependentType() const
Whether this declaration declares a type that is dependent, i.e., a type that somehow depends on temp...
Definition Decl.h:3857
TagDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl, SourceLocation StartL)
Definition Decl.cpp:4868
void setCompleteDefinition(bool V=true)
True if this decl has its body fully specified.
Definition Decl.h:3815
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:5799
static TopLevelStmtDecl * Create(ASTContext &C, Stmt *Statement)
Definition Decl.cpp:5789
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5805
void setStmt(Stmt *S)
Definition Decl.cpp:5809
The top declaration context.
Definition Decl.h:105
static TranslationUnitDecl * Create(ASTContext &C)
Definition Decl.cpp:5416
ASTContext & getASTContext() const
Definition Decl.h:141
void setAnonymousNamespace(NamespaceDecl *D)
Definition Decl.cpp:5420
static TypeAliasDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5747
static TypeAliasDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5739
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5762
friend class ASTContext
Definition Decl.h:3514
TypeDecl(Kind DK, DeclContext *DC, SourceLocation L, const IdentifierInfo *Id, SourceLocation StartL=SourceLocation())
Definition Decl.h:3529
SourceLocation getBeginLoc() const LLVM_READONLY
Definition Decl.h:3547
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:8249
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:8260
The base class of the type hierarchy.
Definition TypeBase.h:1833
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:3170
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:8915
const T * castAs() const
Member-template castAs<specific type>.
Definition TypeBase.h:9158
bool isReferenceType() const
Definition TypeBase.h:8539
bool isEnumeralType() const
Definition TypeBase.h:8646
bool isAlignValT() const
Definition Type.cpp:3179
QualType getPointeeType() const
If this is a pointer, ObjC object pointer, or block pointer, this returns the respective pointee.
Definition Type.cpp:752
DeducedType * getContainedDeducedType() const
Get the DeducedType whose type will be deduced for a variable with an initializer of this type.
Definition Type.cpp:2056
const T * getAsCanonical() const
If this type is canonically the specified type, return its canonical type cast to that specified type...
Definition TypeBase.h:2921
Linkage getLinkage() const
Determine the linkage of this type.
Definition Type.cpp:4891
const T * getAs() const
Member-template getAs<specific type>'.
Definition TypeBase.h:9091
static TypedefDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5688
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5753
static TypedefDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5734
Base class for declarations which introduce a typedef-name.
Definition Decl.h:3562
TypeSourceInfo * getTypeSourceInfo() const
Definition Decl.h:3612
QualType getUnderlyingType() const
Definition Decl.h:3617
TagDecl * getAnonDeclWithTypedefName(bool AnyRedecl=false) const
Retrieves the tag declaration for which this is the typedef name for linkage purposes,...
Definition Decl.cpp:5697
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:5520
bool isWeak() const
Determine whether this symbol is weakly-imported, or declared with the weak or weak-ref attr.
Definition Decl.cpp:5508
bool isInitCapture() const
Whether this variable is the implicit variable for a lambda init-capture.
Definition Decl.cpp:5514
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:2817
static VarDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass S)
Definition Decl.cpp:2158
Stmt ** getInitAddress()
Retrieve the address of the initializer expression.
Definition Decl.cpp:2429
DefinitionKind isThisDeclarationADefinition() const
Definition Decl.h:1308
bool isConstexpr() const
Whether this variable is (C++11) constexpr.
Definition Decl.h:1569
void setInstantiationOfStaticDataMember(VarDecl *VD, TemplateSpecializationKind TSK)
Specify that this variable is an instantiation of the static data member VD.
Definition Decl.cpp:2942
TLSKind getTLSKind() const
Definition Decl.cpp:2175
@ DAK_Uninstantiated
Definition Decl.h:1003
bool hasInit() const
Definition Decl.cpp:2405
bool hasICEInitializer(const ASTContext &Context) const
Determine whether the initializer of this variable is an integer constant expression.
Definition Decl.cpp:2643
ParmVarDeclBitfields ParmVarDeclBits
Definition Decl.h:1124
VarDecl * getMostRecentDecl()
Returns the most recent (re)declaration of this declaration.
DefinitionKind hasDefinition() const
Definition Decl.h:1314
static const char * getStorageClassSpecifierString(StorageClass SC)
Return the string used to specify the storage class SC.
Definition Decl.cpp:2128
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2197
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:2468
VarDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:2264
bool hasFlexibleArrayInit(const ASTContext &Ctx) const
Whether this variable has a flexible array member initialized with one or more elements.
Definition Decl.cpp:2869
bool isNoDestroy(const ASTContext &) const
Is destruction of this variable entirely suppressed?
Definition Decl.cpp:2843
bool isInitCapture() const
Whether this variable is the implicit variable for a lambda init-capture.
Definition Decl.h:1578
void setStorageClass(StorageClass SC)
Definition Decl.cpp:2170
bool hasInitWithSideEffects() const
Checks whether this declaration has an initializer with side effects.
Definition Decl.cpp:2451
APValue * evaluateValue() const
Attempt to evaluate the value of the initializer attached to this declaration, and produce notes expl...
Definition Decl.cpp:2582
bool isStaticDataMember() const
Determines whether this is a static data member.
Definition Decl.h:1283
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:2164
VarDecl * getTemplateInstantiationPattern() const
Retrieve the variable declaration from which this variable could be instantiated, if it is an instant...
Definition Decl.cpp:2721
bool hasGlobalStorage() const
Returns true for all variables that do not have local storage.
Definition Decl.h:1226
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:2884
bool hasConstantInitialization() const
Determine whether this variable has constant initialization.
Definition Decl.cpp:2655
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:2248
unsigned AllBits
Definition Decl.h:1122
EvaluatedStmt * getEvaluatedStmt() const
Definition Decl.cpp:2578
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:2493
EvaluatedStmt * ensureEvaluatedStmt() const
Convert the initializer for this declaration to the elaborated EvaluatedStmt form,...
Definition Decl.cpp:2564
VarDecl * getInstantiatedFromStaticDataMember() const
If this variable is an instantiated static data member of a class template specialization,...
Definition Decl.cpp:2779
bool isFileVarDecl() const
Returns true for file scoped variable declaration.
Definition Decl.h:1342
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:2914
QualType::DestructionKind needsDestruction(const ASTContext &Ctx) const
Would the destruction of this variable have any effect, and if so, what kind?
Definition Decl.cpp:2858
bool checkForConstantInitialization(SmallVectorImpl< PartialDiagnosticAt > &Notes) const
Evaluate the initializer of this variable to determine whether it's a constant initializer.
Definition Decl.cpp:2671
bool isInline() const
Whether this variable is (C++1z) inline.
Definition Decl.h:1551
const Expr * getInit() const
Definition Decl.h:1368
bool isNonEscapingByref() const
Indicates the capture is a __block variable that is never captured by an escaping block.
Definition Decl.cpp:2709
bool isInExternCContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:2256
NonParmVarDeclBitfields NonParmVarDeclBits
Definition Decl.h:1125
bool hasExternalStorage() const
Returns true if a variable has extern or private_extern storage.
Definition Decl.h:1217
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:2635
VarDecl * getInitializingDeclaration()
Get the initializing declaration of this variable, if any.
Definition Decl.cpp:2436
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:2484
VarDecl * getActingDefinition()
Get the tentative definition that acts as the real definition in a TU.
Definition Decl.cpp:2352
@ TentativeDefinition
This declaration is a tentative definition.
Definition Decl.h:1298
@ DeclarationOnly
This declaration is only a declaration.
Definition Decl.h:1295
@ Definition
This declaration is definitely a definition.
Definition Decl.h:1301
void setDescribedVarTemplate(VarTemplateDecl *Template)
Definition Decl.cpp:2822
bool isExternC() const
Determines whether this variable is a variable with external, C linkage.
Definition Decl.cpp:2252
VarDecl(Kind DK, ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass SC)
Definition Decl.cpp:2141
StorageDuration getStorageDuration() const
Get the storage duration of this variable, per C++ [basic.stc].
Definition Decl.h:1229
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:2705
bool isThisDeclarationADemotedDefinition() const
If this definition should pretend to be a declaration.
Definition Decl.h:1476
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:2535
bool isInExternCXXContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:2260
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:2807
bool hasDependentAlignment() const
Determines if this variable's alignment is dependent.
Definition Decl.cpp:2713
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Get the template specialization kind of this variable for the purposes of template instantiation.
Definition Decl.cpp:2797
VarDecl * getDefinition()
Definition Decl.h:1330
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:2786
const Expr * getAnyInitializer() const
Get the initializer for this variable, no matter which declaration it is attached to.
Definition Decl.h:1358
bool isKnownToBeDefined() const
Definition Decl.cpp:2826
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this variable is an instantiation of a static data member of a class template specialization,...
Definition Decl.cpp:2905
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:3966
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
const FunctionProtoType * T
@ 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:6047
TagTypeKind
The kind of a tag type.
Definition TypeBase.h:5878
@ Struct
The "struct" keyword.
Definition TypeBase.h:5880
@ Enum
The "enum" keyword.
Definition TypeBase.h:5892
@ VarTemplate
The name was classified as a variable template name.
Definition Sema.h:583
bool isTypeAwareAllocation(TypeAwareAllocationMode Mode)
Definition ExprCXX.h:2253
@ CanPassInRegs
The argument of this type can be passed directly in registers.
Definition Decl.h:4300
bool isLegalForVariable(StorageClass SC)
Checks whether the given storage class is legal for variables.
Definition Specifiers.h:266
MultiVersionKind
Definition Decl.h:1979
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:5867
bool IsArmStreamingFunction(const FunctionDecl *FD, bool IncludeLocallyStreaming)
Returns whether the given FunctionDecl has an __arm[_locally]_streaming attribute.
Definition Decl.cpp:6026
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:1726
@ Other
Other implicit parameter.
Definition Decl.h:1746
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:6040
#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 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.
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:2108
The parameters to pass to a usual operator delete.
Definition ExprCXX.h:2344
TypeAwareAllocationMode TypeAwareDelete
Definition ExprCXX.h:2345
AlignedAllocationMode Alignment
Definition ExprCXX.h:2348