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 = llvm::dyn_cast<RecordDecl>(DC)) {
1796 // As part of a scope we want to print anonymous names as:
1797 // ..::(anonymous struct)::..
1798 //
1799 // I.e., suppress tag locations, suppress leading keyword, *don't*
1800 // suppress tag in name
1801 Copy.SuppressTagKeyword = true;
1802 Copy.SuppressTagKeywordInAnonNames = false;
1803 Copy.AnonymousTagLocations = false;
1804 RD->printName(OS, Copy);
1805 } else if (const auto *FD = dyn_cast<FunctionDecl>(DC)) {
1806 const FunctionProtoType *FT = nullptr;
1807 if (FD->hasWrittenPrototype())
1808 FT = dyn_cast<FunctionProtoType>(FD->getType()->castAs<FunctionType>());
1809
1810 OS << *FD << '(';
1811 if (FT) {
1812 unsigned NumParams = FD->getNumParams();
1813 for (unsigned i = 0; i < NumParams; ++i) {
1814 if (i)
1815 OS << ", ";
1816 OS << FD->getParamDecl(i)->getType().stream(P);
1817 }
1818
1819 if (FT->isVariadic()) {
1820 if (NumParams > 0)
1821 OS << ", ";
1822 OS << "...";
1823 }
1824 }
1825 OS << ')';
1826 } else if (const auto *ED = dyn_cast<EnumDecl>(DC)) {
1827 // C++ [dcl.enum]p10: Each enum-name and each unscoped
1828 // enumerator is declared in the scope that immediately contains
1829 // the enum-specifier. Each scoped enumerator is declared in the
1830 // scope of the enumeration.
1831 // For the case of unscoped enumerator, do not include in the qualified
1832 // name any information about its enum enclosing scope, as its visibility
1833 // is global.
1834 if (ED->isScoped())
1835 OS << *ED;
1836 else
1837 continue;
1838 } else {
1839 OS << *cast<NamedDecl>(DC);
1840 }
1841 OS << "::";
1842 }
1843}
1844
1846 const PrintingPolicy &Policy,
1847 bool Qualified) const {
1848 if (Qualified)
1849 printQualifiedName(OS, Policy);
1850 else
1851 printName(OS, Policy);
1852}
1853
1854template<typename T> static bool isRedeclarableImpl(Redeclarable<T> *) {
1855 return true;
1856}
1857static bool isRedeclarableImpl(...) { return false; }
1859 switch (K) {
1860#define DECL(Type, Base) \
1861 case Decl::Type: \
1862 return isRedeclarableImpl((Type##Decl *)nullptr);
1863#define ABSTRACT_DECL(DECL)
1864#include "clang/AST/DeclNodes.inc"
1865 }
1866 llvm_unreachable("unknown decl kind");
1867}
1868
1870 bool IsKnownNewer) const {
1871 assert(getDeclName() == OldD->getDeclName() && "Declaration name mismatch");
1872
1873 // Never replace one imported declaration with another; we need both results
1874 // when re-exporting.
1875 if (OldD->isFromASTFile() && isFromASTFile())
1876 return false;
1877
1878 // A kind mismatch implies that the declaration is not replaced.
1879 if (OldD->getKind() != getKind())
1880 return false;
1881
1882 // For method declarations, we never replace. (Why?)
1883 if (isa<ObjCMethodDecl>(this))
1884 return false;
1885
1886 // For parameters, pick the newer one. This is either an error or (in
1887 // Objective-C) permitted as an extension.
1888 if (isa<ParmVarDecl>(this))
1889 return true;
1890
1891 // Inline namespaces can give us two declarations with the same
1892 // name and kind in the same scope but different contexts; we should
1893 // keep both declarations in this case.
1894 if (!this->getDeclContext()->getRedeclContext()->Equals(
1895 OldD->getDeclContext()->getRedeclContext()))
1896 return false;
1897
1898 // Using declarations can be replaced if they import the same name from the
1899 // same context.
1900 if (const auto *UD = dyn_cast<UsingDecl>(this))
1901 return UD->getQualifier().getCanonical() ==
1902
1903 cast<UsingDecl>(OldD)->getQualifier().getCanonical();
1904 if (const auto *UUVD = dyn_cast<UnresolvedUsingValueDecl>(this))
1905 return UUVD->getQualifier().getCanonical() ==
1906 cast<UnresolvedUsingValueDecl>(OldD)->getQualifier().getCanonical();
1907
1908 if (isRedeclarable(getKind())) {
1909 if (getCanonicalDecl() != OldD->getCanonicalDecl())
1910 return false;
1911
1912 if (IsKnownNewer)
1913 return true;
1914
1915 // Check whether this is actually newer than OldD. We want to keep the
1916 // newer declaration. This loop will usually only iterate once, because
1917 // OldD is usually the previous declaration.
1918 for (const auto *D : redecls()) {
1919 if (D == OldD)
1920 break;
1921
1922 // If we reach the canonical declaration, then OldD is not actually older
1923 // than this one.
1924 //
1925 // FIXME: In this case, we should not add this decl to the lookup table.
1926 if (D->isCanonicalDecl())
1927 return false;
1928 }
1929
1930 // It's a newer declaration of the same kind of declaration in the same
1931 // scope: we want this decl instead of the existing one.
1932 return true;
1933 }
1934
1935 // In all other cases, we need to keep both declarations in case they have
1936 // different visibility. Any attempt to use the name will result in an
1937 // ambiguity if more than one is visible.
1938 return false;
1939}
1940
1942 switch (getFormalLinkage()) {
1943 case Linkage::Invalid:
1944 llvm_unreachable("Linkage hasn't been computed!");
1945 case Linkage::None:
1946 return false;
1947 case Linkage::Internal:
1948 return true;
1951 llvm_unreachable("Non-formal linkage is not allowed here!");
1952 case Linkage::Module:
1953 case Linkage::External:
1954 return true;
1955 }
1956 llvm_unreachable("Unhandled Linkage enum");
1957}
1958
1959NamedDecl *NamedDecl::getUnderlyingDeclImpl() {
1960 NamedDecl *ND = this;
1961 if (auto *UD = dyn_cast<UsingShadowDecl>(ND))
1962 ND = UD->getTargetDecl();
1963
1964 if (auto *AD = dyn_cast<ObjCCompatibleAliasDecl>(ND))
1965 return AD->getClassInterface();
1966
1967 if (auto *AD = dyn_cast<NamespaceAliasDecl>(ND))
1968 return AD->getNamespace();
1969
1970 return ND;
1971}
1972
1974 if (!isCXXClassMember())
1975 return false;
1976
1977 const NamedDecl *D = this;
1978 if (isa<UsingShadowDecl>(D))
1979 D = cast<UsingShadowDecl>(D)->getTargetDecl();
1980
1982 return true;
1983 if (const auto *MD = dyn_cast_if_present<CXXMethodDecl>(D->getAsFunction()))
1984 return MD->isInstance();
1985 return false;
1986}
1987
1988//===----------------------------------------------------------------------===//
1989// DeclaratorDecl Implementation
1990//===----------------------------------------------------------------------===//
1991
1992template <typename DeclT>
1994 if (decl->getNumTemplateParameterLists() > 0)
1995 return decl->getTemplateParameterList(0)->getTemplateLoc();
1996 return decl->getInnerLocStart();
1997}
1998
2001 if (TSI) return TSI->getTypeLoc().getBeginLoc();
2002 return SourceLocation();
2003}
2004
2007 if (TSI) return TSI->getTypeLoc().getEndLoc();
2008 return SourceLocation();
2009}
2010
2012 if (QualifierLoc) {
2013 // Make sure the extended decl info is allocated.
2014 if (!hasExtInfo()) {
2015 // Save (non-extended) type source info pointer.
2016 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2017 // Allocate external info struct.
2018 DeclInfo = new (getASTContext()) ExtInfo;
2019 // Restore savedTInfo into (extended) decl info.
2020 getExtInfo()->TInfo = savedTInfo;
2021 }
2022 // Set qualifier info.
2023 getExtInfo()->QualifierLoc = QualifierLoc;
2024 } else if (hasExtInfo()) {
2025 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
2026 getExtInfo()->QualifierLoc = QualifierLoc;
2027 }
2028}
2029
2031 assert(AC);
2032 // Make sure the extended decl info is allocated.
2033 if (!hasExtInfo()) {
2034 // Save (non-extended) type source info pointer.
2035 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2036 // Allocate external info struct.
2037 DeclInfo = new (getASTContext()) ExtInfo;
2038 // Restore savedTInfo into (extended) decl info.
2039 getExtInfo()->TInfo = savedTInfo;
2040 }
2041 // Set requires clause info.
2042 getExtInfo()->TrailingRequiresClause = AC;
2043}
2044
2047 assert(!TPLists.empty());
2048 // Make sure the extended decl info is allocated.
2049 if (!hasExtInfo()) {
2050 // Save (non-extended) type source info pointer.
2051 auto *savedTInfo = cast<TypeSourceInfo *>(DeclInfo);
2052 // Allocate external info struct.
2053 DeclInfo = new (getASTContext()) ExtInfo;
2054 // Restore savedTInfo into (extended) decl info.
2055 getExtInfo()->TInfo = savedTInfo;
2056 }
2057 // Set the template parameter lists info.
2058 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
2059}
2060
2064
2065// Helper function: returns true if QT is or contains a type
2066// having a postfix component.
2067static bool typeIsPostfix(QualType QT) {
2068 while (true) {
2069 const Type* T = QT.getTypePtr();
2070 switch (T->getTypeClass()) {
2071 default:
2072 return false;
2073 case Type::Pointer:
2074 QT = cast<PointerType>(T)->getPointeeType();
2075 break;
2076 case Type::BlockPointer:
2077 QT = cast<BlockPointerType>(T)->getPointeeType();
2078 break;
2079 case Type::MemberPointer:
2080 QT = cast<MemberPointerType>(T)->getPointeeType();
2081 break;
2082 case Type::LValueReference:
2083 case Type::RValueReference:
2084 QT = cast<ReferenceType>(T)->getPointeeType();
2085 break;
2086 case Type::PackExpansion:
2087 QT = cast<PackExpansionType>(T)->getPattern();
2088 break;
2089 case Type::Paren:
2090 case Type::ConstantArray:
2091 case Type::DependentSizedArray:
2092 case Type::IncompleteArray:
2093 case Type::VariableArray:
2094 case Type::FunctionProto:
2095 case Type::FunctionNoProto:
2096 return true;
2097 }
2098 }
2099}
2100
2102 SourceLocation RangeEnd = getLocation();
2103 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
2104 // If the declaration has no name or the type extends past the name take the
2105 // end location of the type.
2106 if (!getDeclName() || typeIsPostfix(TInfo->getType()))
2107 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
2108 }
2109 return SourceRange(getOuterLocStart(), RangeEnd);
2110}
2111
2114 // Free previous template parameters (if any).
2115 if (NumTemplParamLists > 0) {
2116 Context.Deallocate(TemplParamLists);
2117 TemplParamLists = nullptr;
2119 }
2120 // Set info on matched template parameter lists (if any).
2121 if (!TPLists.empty()) {
2122 TemplParamLists = new (Context) TemplateParameterList *[TPLists.size()];
2123 NumTemplParamLists = TPLists.size();
2124 llvm::copy(TPLists, TemplParamLists);
2125 }
2126}
2127
2128//===----------------------------------------------------------------------===//
2129// VarDecl Implementation
2130//===----------------------------------------------------------------------===//
2131
2133 switch (SC) {
2134 case SC_None: break;
2135 case SC_Auto: return "auto";
2136 case SC_Extern: return "extern";
2137 case SC_PrivateExtern: return "__private_extern__";
2138 case SC_Register: return "register";
2139 case SC_Static: return "static";
2140 }
2141
2142 llvm_unreachable("Invalid storage class");
2143}
2144
2146 SourceLocation StartLoc, SourceLocation IdLoc,
2147 const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo,
2148 StorageClass SC)
2149 : DeclaratorDecl(DK, DC, IdLoc, Id, T, TInfo, StartLoc),
2151 static_assert(sizeof(VarDeclBitfields) <= sizeof(unsigned),
2152 "VarDeclBitfields too large!");
2153 static_assert(sizeof(ParmVarDeclBitfields) <= sizeof(unsigned),
2154 "ParmVarDeclBitfields too large!");
2155 static_assert(sizeof(NonParmVarDeclBitfields) <= sizeof(unsigned),
2156 "NonParmVarDeclBitfields too large!");
2157 AllBits = 0;
2158 VarDeclBits.SClass = SC;
2159 // Everything else is implicitly initialized to false.
2160}
2161
2163 SourceLocation IdL, const IdentifierInfo *Id,
2165 return new (C, DC) VarDecl(Var, C, DC, StartL, IdL, Id, T, TInfo, S);
2166}
2167
2169 return new (C, ID)
2170 VarDecl(Var, C, nullptr, SourceLocation(), SourceLocation(), nullptr,
2171 QualType(), nullptr, SC_None);
2172}
2173
2175 assert(isLegalForVariable(SC));
2176 VarDeclBits.SClass = SC;
2177}
2178
2180 switch (VarDeclBits.TSCSpec) {
2181 case TSCS_unspecified:
2182 if (!hasAttr<ThreadAttr>() &&
2183 !(getASTContext().getLangOpts().OpenMPUseTLS &&
2184 getASTContext().getTargetInfo().isTLSSupported() &&
2186 return TLS_None;
2187 return ((getASTContext().getLangOpts().isCompatibleWithMSVC(
2190 ? TLS_Dynamic
2191 : TLS_Static;
2192 case TSCS___thread: // Fall through.
2193 case TSCS__Thread_local:
2194 return TLS_Static;
2195 case TSCS_thread_local:
2196 return TLS_Dynamic;
2197 }
2198 llvm_unreachable("Unknown thread storage class specifier!");
2199}
2200
2202 if (const Expr *Init = getInit()) {
2203 SourceLocation InitEnd = Init->getEndLoc();
2204 // If Init is implicit, ignore its source range and fallback on
2205 // DeclaratorDecl::getSourceRange() to handle postfix elements.
2206 if (InitEnd.isValid() && InitEnd != getLocation())
2207 return SourceRange(getOuterLocStart(), InitEnd);
2208 }
2210}
2211
2212template<typename T>
2214 // C++ [dcl.link]p1: All function types, function names with external linkage,
2215 // and variable names with external linkage have a language linkage.
2216 if (!D.hasExternalFormalLinkage())
2217 return NoLanguageLinkage;
2218
2219 // Language linkage is a C++ concept, but saying that everything else in C has
2220 // C language linkage fits the implementation nicely.
2221 if (!D.getASTContext().getLangOpts().CPlusPlus)
2222 return CLanguageLinkage;
2223
2224 // C++ [dcl.link]p4: A C language linkage is ignored in determining the
2225 // language linkage of the names of class members and the function type of
2226 // class member functions.
2227 const DeclContext *DC = D.getDeclContext();
2228 if (DC->isRecord())
2229 return CXXLanguageLinkage;
2230
2231 // If the first decl is in an extern "C" context, any other redeclaration
2232 // will have C language linkage. If the first one is not in an extern "C"
2233 // context, we would have reported an error for any other decl being in one.
2235 return CLanguageLinkage;
2236 return CXXLanguageLinkage;
2237}
2238
2239template<typename T>
2240static bool isDeclExternC(const T &D) {
2241 // Since the context is ignored for class members, they can only have C++
2242 // language linkage or no language linkage.
2243 const DeclContext *DC = D.getDeclContext();
2244 if (DC->isRecord()) {
2245 assert(D.getASTContext().getLangOpts().CPlusPlus);
2246 return false;
2247 }
2248
2249 return D.getLanguageLinkage() == CLanguageLinkage;
2250}
2251
2255
2257 return isDeclExternC(*this);
2258}
2259
2263
2267
2269
2273 return DeclarationOnly;
2274
2275 // C++ [basic.def]p2:
2276 // A declaration is a definition unless [...] it contains the 'extern'
2277 // specifier or a linkage-specification and neither an initializer [...],
2278 // it declares a non-inline static data member in a class declaration [...],
2279 // it declares a static data member outside a class definition and the variable
2280 // was defined within the class with the constexpr specifier [...],
2281 // C++1y [temp.expl.spec]p15:
2282 // An explicit specialization of a static data member or an explicit
2283 // specialization of a static data member template is a definition if the
2284 // declaration includes an initializer; otherwise, it is a declaration.
2285 //
2286 // FIXME: How do you declare (but not define) a partial specialization of
2287 // a static data member template outside the containing class?
2288 if (isStaticDataMember()) {
2289 if (isOutOfLine() &&
2290 !(getCanonicalDecl()->isInline() &&
2292 (hasInit() ||
2293 // If the first declaration is out-of-line, this may be an
2294 // instantiation of an out-of-line partial specialization of a variable
2295 // template for which we have not yet instantiated the initializer.
2301 return Definition;
2302 if (!isOutOfLine() && isInline())
2303 return Definition;
2304 return DeclarationOnly;
2305 }
2306 // C99 6.7p5:
2307 // A definition of an identifier is a declaration for that identifier that
2308 // [...] causes storage to be reserved for that object.
2309 // Note: that applies for all non-file-scope objects.
2310 // C99 6.9.2p1:
2311 // If the declaration of an identifier for an object has file scope and an
2312 // initializer, the declaration is an external definition for the identifier
2313 if (hasInit())
2314 return Definition;
2315
2316 if (hasDefiningAttr())
2317 return Definition;
2318
2319 if (const auto *SAA = getAttr<SelectAnyAttr>())
2320 if (!SAA->isInherited())
2321 return Definition;
2322
2323 // A variable template specialization (other than a static data member
2324 // template or an explicit specialization) is a declaration until we
2325 // instantiate its initializer.
2326 if (auto *VTSD = dyn_cast<VarTemplateSpecializationDecl>(this)) {
2327 if (VTSD->getTemplateSpecializationKind() != TSK_ExplicitSpecialization &&
2329 !VTSD->IsCompleteDefinition)
2330 return DeclarationOnly;
2331 }
2332
2333 if (hasExternalStorage())
2334 return DeclarationOnly;
2335
2336 // [dcl.link] p7:
2337 // A declaration directly contained in a linkage-specification is treated
2338 // as if it contains the extern specifier for the purpose of determining
2339 // the linkage of the declared name and whether it is a definition.
2340 if (isSingleLineLanguageLinkage(*this))
2341 return DeclarationOnly;
2342
2343 // C99 6.9.2p2:
2344 // A declaration of an object that has file scope without an initializer,
2345 // and without a storage class specifier or the scs 'static', constitutes
2346 // a tentative definition.
2347 // No such thing in C++.
2348 if (!C.getLangOpts().CPlusPlus && isFileVarDecl())
2349 return TentativeDefinition;
2350
2351 // What's left is (in C, block-scope) declarations without initializers or
2352 // external storage. These are definitions.
2353 return Definition;
2354}
2355
2359 return nullptr;
2360
2361 VarDecl *LastTentative = nullptr;
2362
2363 // Loop through the declaration chain, starting with the most recent.
2365 Decl = Decl->getPreviousDecl()) {
2366 Kind = Decl->isThisDeclarationADefinition();
2367 if (Kind == Definition)
2368 return nullptr;
2369 // Record the first (most recent) TentativeDefinition that is encountered.
2370 if (Kind == TentativeDefinition && !LastTentative)
2371 LastTentative = Decl;
2372 }
2373
2374 return LastTentative;
2375}
2376
2379 for (auto *I : First->redecls()) {
2380 if (I->isThisDeclarationADefinition(C) == Definition)
2381 return I;
2382 }
2383 return nullptr;
2384}
2385
2388
2389 const VarDecl *First = getFirstDecl();
2390 for (auto *I : First->redecls()) {
2391 Kind = std::max(Kind, I->isThisDeclarationADefinition(C));
2392 if (Kind == Definition)
2393 break;
2394 }
2395
2396 return Kind;
2397}
2398
2399const Expr *VarDecl::getAnyInitializer(const VarDecl *&D) const {
2400 for (auto *I : redecls()) {
2401 if (auto Expr = I->getInit()) {
2402 D = I;
2403 return Expr;
2404 }
2405 }
2406 return nullptr;
2407}
2408
2409bool VarDecl::hasInit() const {
2410 if (auto *P = dyn_cast<ParmVarDecl>(this))
2411 if (P->hasUnparsedDefaultArg() || P->hasUninstantiatedDefaultArg())
2412 return false;
2413
2414 if (auto *Eval = getEvaluatedStmt())
2415 return Eval->Value.isValid();
2416
2417 return !Init.isNull();
2418}
2419
2421 if (!hasInit())
2422 return nullptr;
2423
2424 if (auto *S = dyn_cast<Stmt *>(Init))
2425 return cast<Expr>(S);
2426
2427 auto *Eval = getEvaluatedStmt();
2428
2429 return cast<Expr>(Eval->Value.get(
2430 Eval->Value.isOffset() ? getASTContext().getExternalSource() : nullptr));
2431}
2432
2434 if (auto *ES = Init.dyn_cast<EvaluatedStmt *>())
2435 return ES->Value.getAddressOfPointer(getASTContext().getExternalSource());
2436
2437 return Init.getAddrOfPtr1();
2438}
2439
2441 VarDecl *Def = nullptr;
2442 for (auto *I : redecls()) {
2443 if (I->hasInit())
2444 return I;
2445
2446 if (I->isThisDeclarationADefinition()) {
2447 if (isStaticDataMember())
2448 return I;
2449 Def = I;
2450 }
2451 }
2452 return Def;
2453}
2454
2456 if (!hasInit())
2457 return false;
2458
2460 if (!ES->CheckedForSideEffects) {
2461 const Expr *E = getInit();
2462 ES->HasSideEffects =
2464 // We can get a value-dependent initializer during error recovery.
2465 (E->isValueDependent() || getType()->isDependentType() ||
2466 !evaluateValue());
2467 ES->CheckedForSideEffects = true;
2468 }
2469 return ES->HasSideEffects;
2470}
2471
2473 if (Decl::isOutOfLine())
2474 return true;
2475
2476 if (!isStaticDataMember())
2477 return false;
2478
2479 // If this static data member was instantiated from a static data member of
2480 // a class template, check whether that static data member was defined
2481 // out-of-line.
2483 return VD->isOutOfLine();
2484
2485 return false;
2486}
2487
2489 if (auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init)) {
2490 Eval->~EvaluatedStmt();
2491 getASTContext().Deallocate(Eval);
2492 }
2493
2494 Init = I;
2495}
2496
2498 const LangOptions &Lang = C.getLangOpts();
2499
2500 // OpenCL permits const integral variables to be used in constant
2501 // expressions, like in C++98.
2502 if (!Lang.CPlusPlus && !Lang.OpenCL && !Lang.C23)
2503 return false;
2504
2505 // Function parameters are never usable in constant expressions.
2506 if (isa<ParmVarDecl>(this))
2507 return false;
2508
2509 // The values of weak variables are never usable in constant expressions.
2510 if (isWeak())
2511 return false;
2512
2513 // In C++11, any variable of reference type can be used in a constant
2514 // expression if it is initialized by a constant expression.
2515 if (Lang.CPlusPlus11 && getType()->isReferenceType())
2516 return true;
2517
2518 // Only const objects can be used in constant expressions in C++. C++98 does
2519 // not require the variable to be non-volatile, but we consider this to be a
2520 // defect.
2521 if (!getType().isConstant(C) || getType().isVolatileQualified())
2522 return false;
2523
2524 // In C++, but not in C, const, non-volatile variables of integral or
2525 // enumeration types can be used in constant expressions.
2526 if (getType()->isIntegralOrEnumerationType() && !Lang.C23)
2527 return true;
2528
2529 // C23 6.6p7: An identifier that is:
2530 // ...
2531 // - declared with storage-class specifier constexpr and has an object type,
2532 // is a named constant, ... such a named constant is a constant expression
2533 // with the type and value of the declared object.
2534 // Additionally, in C++11, non-volatile constexpr variables can be used in
2535 // constant expressions.
2536 return (Lang.CPlusPlus11 || Lang.C23) && isConstexpr();
2537}
2538
2540 // C++2a [expr.const]p3:
2541 // A variable is usable in constant expressions after its initializing
2542 // declaration is encountered...
2543 const VarDecl *DefVD = nullptr;
2544 const Expr *Init = getAnyInitializer(DefVD);
2545 if (!Init || Init->isValueDependent() || getType()->isDependentType())
2546 return false;
2547 // ... if it is a constexpr variable, or it is of reference type or of
2548 // const-qualified integral or enumeration type, ...
2549 if (!DefVD->mightBeUsableInConstantExpressions(Context))
2550 return false;
2551 // ... and its initializer is a constant initializer.
2552 if ((Context.getLangOpts().CPlusPlus || getLangOpts().C23) &&
2553 !DefVD->hasConstantInitialization())
2554 return false;
2555 // C++98 [expr.const]p1:
2556 // An integral constant-expression can involve only [...] const variables
2557 // or static data members of integral or enumeration types initialized with
2558 // [integer] constant expressions (dcl.init)
2559 if ((Context.getLangOpts().CPlusPlus || Context.getLangOpts().OpenCL) &&
2560 !Context.getLangOpts().CPlusPlus11 && !DefVD->hasICEInitializer(Context))
2561 return false;
2562 return true;
2563}
2564
2565/// Convert the initializer for this declaration to the elaborated EvaluatedStmt
2566/// form, which contains extra information on the evaluated value of the
2567/// initializer.
2569 auto *Eval = dyn_cast_if_present<EvaluatedStmt *>(Init);
2570 if (!Eval) {
2571 // Note: EvaluatedStmt contains an APValue, which usually holds
2572 // resources not allocated from the ASTContext. We need to do some
2573 // work to avoid leaking those, but we do so in VarDecl::evaluateValue
2574 // where we can detect whether there's anything to clean up or not.
2575 Eval = new (getASTContext()) EvaluatedStmt;
2576 Eval->Value = cast<Stmt *>(Init);
2577 Init = Eval;
2578 }
2579 return Eval;
2580}
2581
2583 return dyn_cast_if_present<EvaluatedStmt *>(Init);
2584}
2585
2588 return evaluateValueImpl(Notes, hasConstantInitialization());
2589}
2590
2591APValue *VarDecl::evaluateValueImpl(SmallVectorImpl<PartialDiagnosticAt> &Notes,
2592 bool IsConstantInitialization) const {
2594
2595 const auto *Init = getInit();
2596 assert(!Init->isValueDependent());
2597
2598 // We only produce notes indicating why an initializer is non-constant the
2599 // first time it is evaluated. FIXME: The notes won't always be emitted the
2600 // first time we try evaluation, so might not be produced at all.
2601 if (Eval->WasEvaluated)
2602 return Eval->Evaluated.isAbsent() ? nullptr : &Eval->Evaluated;
2603
2604 if (Eval->IsEvaluating) {
2605 // FIXME: Produce a diagnostic for self-initialization.
2606 return nullptr;
2607 }
2608
2609 Eval->IsEvaluating = true;
2610
2611 ASTContext &Ctx = getASTContext();
2612 bool Result = Init->EvaluateAsInitializer(Eval->Evaluated, Ctx, this, Notes,
2613 IsConstantInitialization);
2614
2615 // In C++, or in C23 if we're initialising a 'constexpr' variable, this isn't
2616 // a constant initializer if we produced notes. In that case, we can't keep
2617 // the result, because it may only be correct under the assumption that the
2618 // initializer is a constant context.
2619 if (IsConstantInitialization &&
2620 (Ctx.getLangOpts().CPlusPlus ||
2621 (isConstexpr() && Ctx.getLangOpts().C23)) &&
2622 !Notes.empty())
2623 Result = false;
2624
2625 // Ensure the computed APValue is cleaned up later if evaluation succeeded,
2626 // or that it's empty (so that there's nothing to clean up) if evaluation
2627 // failed.
2628 if (!Result)
2629 Eval->Evaluated = APValue();
2630 else if (Eval->Evaluated.needsCleanup())
2631 Ctx.addDestruction(&Eval->Evaluated);
2632
2633 Eval->IsEvaluating = false;
2634 Eval->WasEvaluated = true;
2635
2636 return Result ? &Eval->Evaluated : nullptr;
2637}
2638
2640 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2641 if (Eval->WasEvaluated)
2642 return &Eval->Evaluated;
2643
2644 return nullptr;
2645}
2646
2647bool VarDecl::hasICEInitializer(const ASTContext &Context) const {
2648 const Expr *Init = getInit();
2649 assert(Init && "no initializer");
2650
2652 if (!Eval->CheckedForICEInit) {
2653 Eval->CheckedForICEInit = true;
2654 Eval->HasICEInit = Init->isIntegerConstantExpr(Context);
2655 }
2656 return Eval->HasICEInit;
2657}
2658
2660 // In C, all globals and constexpr variables should have constant
2661 // initialization. For constexpr variables in C check that initializer is a
2662 // constant initializer because they can be used in constant expressions.
2664 !isConstexpr())
2665 return true;
2666
2667 // In C++, it depends on whether the evaluation at the point of definition
2668 // was evaluatable as a constant initializer.
2669 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2670 return Eval->HasConstantInitialization;
2671
2672 return false;
2673}
2674
2678 // If we ask for the value before we know whether we have a constant
2679 // initializer, we can compute the wrong value (for example, due to
2680 // std::is_constant_evaluated()).
2681 assert(!Eval->WasEvaluated &&
2682 "already evaluated var value before checking for constant init");
2683 assert((getASTContext().getLangOpts().CPlusPlus ||
2685 "only meaningful in C++/C23");
2686
2687 assert(!getInit()->isValueDependent());
2688
2689 // Evaluate the initializer to check whether it's a constant expression.
2691 evaluateValueImpl(Notes, true) && Notes.empty();
2692
2693 // If evaluation as a constant initializer failed, allow re-evaluation as a
2694 // non-constant initializer if we later find we want the value.
2695 if (!Eval->HasConstantInitialization)
2696 Eval->WasEvaluated = false;
2697
2698 return Eval->HasConstantInitialization;
2699}
2700
2701template<typename DeclT>
2702static DeclT *getDefinitionOrSelf(DeclT *D) {
2703 assert(D);
2704 if (auto *Def = D->getDefinition())
2705 return Def;
2706 return D;
2707}
2708
2710 return hasAttr<BlocksAttr>() && NonParmVarDeclBits.EscapingByref;
2711}
2712
2714 return hasAttr<BlocksAttr>() && !NonParmVarDeclBits.EscapingByref;
2715}
2716
2718 QualType T = getType();
2719 return T->isDependentType() || T->isUndeducedType() ||
2720 llvm::any_of(specific_attrs<AlignedAttr>(), [](const AlignedAttr *AA) {
2721 return AA->isAlignmentDependent();
2722 });
2723}
2724
2726 const VarDecl *VD = this;
2727
2728 // If this is an instantiated member, walk back to the template from which
2729 // it was instantiated.
2731 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
2733 while (auto *NewVD = VD->getInstantiatedFromStaticDataMember())
2734 VD = NewVD;
2735 }
2736 }
2737
2738 // If it's an instantiated variable template specialization, find the
2739 // template or partial specialization from which it was instantiated.
2740 if (auto *VDTemplSpec = dyn_cast<VarTemplateSpecializationDecl>(VD)) {
2741 if (isTemplateInstantiation(VDTemplSpec->getTemplateSpecializationKind())) {
2742 auto From = VDTemplSpec->getInstantiatedFrom();
2743 if (auto *VTD = From.dyn_cast<VarTemplateDecl *>()) {
2744 while (!VTD->isMemberSpecialization()) {
2745 auto *NewVTD = VTD->getInstantiatedFromMemberTemplate();
2746 if (!NewVTD)
2747 break;
2748 VTD = NewVTD;
2749 }
2750 return getDefinitionOrSelf(VTD->getTemplatedDecl());
2751 }
2752 if (auto *VTPSD =
2753 From.dyn_cast<VarTemplatePartialSpecializationDecl *>()) {
2754 while (!VTPSD->isMemberSpecialization()) {
2755 auto *NewVTPSD = VTPSD->getInstantiatedFromMember();
2756 if (!NewVTPSD)
2757 break;
2758 VTPSD = NewVTPSD;
2759 }
2760 return getDefinitionOrSelf<VarDecl>(VTPSD);
2761 }
2762 }
2763 }
2764
2765 // If this is the pattern of a variable template, find where it was
2766 // instantiated from. FIXME: Is this necessary?
2768 while (!VarTemplate->isMemberSpecialization()) {
2769 auto *NewVT = VarTemplate->getInstantiatedFromMemberTemplate();
2770 if (!NewVT)
2771 break;
2772 VarTemplate = NewVT;
2773 }
2774
2775 return getDefinitionOrSelf(VarTemplate->getTemplatedDecl());
2776 }
2777
2778 if (VD == this)
2779 return nullptr;
2780 return getDefinitionOrSelf(const_cast<VarDecl*>(VD));
2781}
2782
2785 return cast<VarDecl>(MSI->getInstantiatedFrom());
2786
2787 return nullptr;
2788}
2789
2791 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2792 return Spec->getSpecializationKind();
2793
2795 return MSI->getTemplateSpecializationKind();
2796
2797 return TSK_Undeclared;
2798}
2799
2803 return MSI->getTemplateSpecializationKind();
2804
2805 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2806 return Spec->getSpecializationKind();
2807
2808 return TSK_Undeclared;
2809}
2810
2812 if (const auto *Spec = dyn_cast<VarTemplateSpecializationDecl>(this))
2813 return Spec->getPointOfInstantiation();
2814
2816 return MSI->getPointOfInstantiation();
2817
2818 return SourceLocation();
2819}
2820
2822 return dyn_cast_if_present<VarTemplateDecl *>(
2823 getASTContext().getTemplateOrSpecializationInfo(this));
2824}
2825
2829
2831 const auto &LangOpts = getASTContext().getLangOpts();
2832 // In CUDA mode without relocatable device code, variables of form 'extern
2833 // __shared__ Foo foo[]' are pointers to the base of the GPU core's shared
2834 // memory pool. These are never undefined variables, even if they appear
2835 // inside of an anon namespace or static function.
2836 //
2837 // With CUDA relocatable device code enabled, these variables don't get
2838 // special handling; they're treated like regular extern variables.
2839 if (LangOpts.CUDA && !LangOpts.GPURelocatableDeviceCode &&
2842 return true;
2843
2844 return hasDefinition();
2845}
2846
2847bool VarDecl::isNoDestroy(const ASTContext &Ctx) const {
2848 if (!hasGlobalStorage())
2849 return false;
2851 return true;
2853 return false;
2854
2856 RSDKind K = Ctx.getLangOpts().getRegisterStaticDestructors();
2857 return K == RSDKind::None ||
2858 (K == RSDKind::ThreadLocal && getTLSKind() == TLS_None);
2859}
2860
2863 if (EvaluatedStmt *Eval = getEvaluatedStmt())
2864 if (Eval->HasConstantDestruction)
2865 return QualType::DK_none;
2866
2867 if (isNoDestroy(Ctx))
2868 return QualType::DK_none;
2869
2870 return getType().isDestructedType();
2871}
2872
2874 assert(hasInit() && "Expect initializer to check for flexible array init");
2875 auto *D = getType()->getAsRecordDecl();
2876 if (!D || !D->hasFlexibleArrayMember())
2877 return false;
2878 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2879 if (!List)
2880 return false;
2881 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2882 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2883 if (!InitTy)
2884 return false;
2885 return !InitTy->isZeroSize();
2886}
2887
2889 assert(hasInit() && "Expect initializer to check for flexible array init");
2890 auto *RD = getType()->getAsRecordDecl();
2891 if (!RD || !RD->hasFlexibleArrayMember())
2892 return CharUnits::Zero();
2893 auto *List = dyn_cast<InitListExpr>(getInit()->IgnoreParens());
2894 if (!List || List->getNumInits() == 0)
2895 return CharUnits::Zero();
2896 const Expr *FlexibleInit = List->getInit(List->getNumInits() - 1);
2897 auto InitTy = Ctx.getAsConstantArrayType(FlexibleInit->getType());
2898 if (!InitTy)
2899 return CharUnits::Zero();
2900 CharUnits FlexibleArraySize = Ctx.getTypeSizeInChars(InitTy);
2901 const ASTRecordLayout &RL = Ctx.getASTRecordLayout(RD);
2902 CharUnits FlexibleArrayOffset =
2904 if (FlexibleArrayOffset + FlexibleArraySize < RL.getSize())
2905 return CharUnits::Zero();
2906 return FlexibleArrayOffset + FlexibleArraySize - RL.getSize();
2907}
2908
2910 if (isStaticDataMember())
2911 // FIXME: Remove ?
2912 // return getASTContext().getInstantiatedFromStaticDataMember(this);
2913 return dyn_cast_if_present<MemberSpecializationInfo *>(
2914 getASTContext().getTemplateOrSpecializationInfo(this));
2915 return nullptr;
2916}
2917
2919 SourceLocation PointOfInstantiation) {
2920 assert((isa<VarTemplateSpecializationDecl>(this) ||
2922 "not a variable or static data member template specialization");
2923
2925 dyn_cast<VarTemplateSpecializationDecl>(this)) {
2926 Spec->setSpecializationKind(TSK);
2927 if (TSK != TSK_ExplicitSpecialization &&
2928 PointOfInstantiation.isValid() &&
2929 Spec->getPointOfInstantiation().isInvalid()) {
2930 Spec->setPointOfInstantiation(PointOfInstantiation);
2932 L->InstantiationRequested(this);
2933 }
2935 MSI->setTemplateSpecializationKind(TSK);
2936 if (TSK != TSK_ExplicitSpecialization && PointOfInstantiation.isValid() &&
2937 MSI->getPointOfInstantiation().isInvalid()) {
2938 MSI->setPointOfInstantiation(PointOfInstantiation);
2940 L->InstantiationRequested(this);
2941 }
2942 }
2943}
2944
2945void
2948 assert(getASTContext().getTemplateOrSpecializationInfo(this).isNull() &&
2949 "Previous template or instantiation?");
2951}
2952
2953//===----------------------------------------------------------------------===//
2954// ParmVarDecl Implementation
2955//===----------------------------------------------------------------------===//
2956
2958 SourceLocation StartLoc, SourceLocation IdLoc,
2959 const IdentifierInfo *Id, QualType T,
2960 TypeSourceInfo *TInfo, StorageClass S,
2961 Expr *DefArg) {
2962 return new (C, DC) ParmVarDecl(ParmVar, C, DC, StartLoc, IdLoc, Id, T, TInfo,
2963 S, DefArg);
2964}
2965
2968 QualType T = TSI ? TSI->getType() : getType();
2969 if (const auto *DT = dyn_cast<DecayedType>(T))
2970 return DT->getOriginalType();
2971 return T;
2972}
2973
2975 return new (C, ID)
2976 ParmVarDecl(ParmVar, C, nullptr, SourceLocation(), SourceLocation(),
2977 nullptr, QualType(), nullptr, SC_None, nullptr);
2978}
2979
2981 if (!hasInheritedDefaultArg()) {
2982 SourceRange ArgRange = getDefaultArgRange();
2983 if (ArgRange.isValid())
2984 return SourceRange(getOuterLocStart(), ArgRange.getEnd());
2985 }
2986
2987 // DeclaratorDecl considers the range of postfix types as overlapping with the
2988 // declaration name, but this is not the case with parameters in ObjC methods.
2991
2993}
2994
2996 // ns_consumed only affects code generation in ARC
2998 return getASTContext().getLangOpts().ObjCAutoRefCount;
2999
3000 // FIXME: isParamDestroyedInCallee() should probably imply
3001 // isDestructedType()
3002 const auto *RT = getType()->getAsCanonical<RecordType>();
3003 if (RT && RT->getDecl()->getDefinitionOrSelf()->isParamDestroyedInCallee() &&
3004 getType().isDestructedType())
3005 return true;
3006
3007 return false;
3008}
3009
3011 assert(!hasUnparsedDefaultArg() && "Default argument is not yet parsed!");
3012 assert(!hasUninstantiatedDefaultArg() &&
3013 "Default argument is not yet instantiated!");
3014
3015 Expr *Arg = getInit();
3016 if (auto *E = dyn_cast_if_present<FullExpr>(Arg))
3017 return E->getSubExpr();
3018
3019 return Arg;
3020}
3021
3023 ParmVarDeclBits.DefaultArgKind = DAK_Normal;
3024 Init = defarg;
3025}
3026
3028 switch (ParmVarDeclBits.DefaultArgKind) {
3029 case DAK_None:
3030 case DAK_Unparsed:
3031 // Nothing we can do here.
3032 return SourceRange();
3033
3034 case DAK_Uninstantiated:
3036
3037 case DAK_Normal:
3038 if (const Expr *E = getInit())
3039 return E->getSourceRange();
3040
3041 // Missing an actual expression, may be invalid.
3042 return SourceRange();
3043 }
3044 llvm_unreachable("Invalid default argument kind.");
3045}
3046
3048 ParmVarDeclBits.DefaultArgKind = DAK_Uninstantiated;
3049 Init = arg;
3050}
3051
3053 assert(hasUninstantiatedDefaultArg() &&
3054 "Wrong kind of initialization expression!");
3055 return cast_if_present<Expr>(cast<Stmt *>(Init));
3056}
3057
3059 // FIXME: We should just return false for DAK_None here once callers are
3060 // prepared for the case that we encountered an invalid default argument and
3061 // were unable to even build an invalid expression.
3063 !Init.isNull();
3064}
3065
3066void ParmVarDecl::setParameterIndexLarge(unsigned parameterIndex) {
3067 getASTContext().setParameterIndex(this, parameterIndex);
3068 ParmVarDeclBits.ParameterIndex = ParameterIndexSentinel;
3069}
3070
3071unsigned ParmVarDecl::getParameterIndexLarge() const {
3072 return getASTContext().getParameterIndex(this);
3073}
3074
3075//===----------------------------------------------------------------------===//
3076// FunctionDecl Implementation
3077//===----------------------------------------------------------------------===//
3078
3080 SourceLocation StartLoc,
3081 const DeclarationNameInfo &NameInfo, QualType T,
3082 TypeSourceInfo *TInfo, StorageClass S,
3084 ConstexprSpecKind ConstexprKind,
3085 const AssociatedConstraint &TrailingRequiresClause)
3086 : DeclaratorDecl(DK, DC, NameInfo.getLoc(), NameInfo.getName(), T, TInfo,
3087 StartLoc),
3088 DeclContext(DK), redeclarable_base(C), Body(), ODRHash(0),
3089 EndRangeLoc(NameInfo.getEndLoc()), DNLoc(NameInfo.getInfo()) {
3090 assert(T.isNull() || T->isFunctionType());
3091 FunctionDeclBits.SClass = S;
3093 FunctionDeclBits.IsInlineSpecified = isInlineSpecified;
3094 FunctionDeclBits.IsVirtualAsWritten = false;
3095 FunctionDeclBits.IsPureVirtual = false;
3096 FunctionDeclBits.HasInheritedPrototype = false;
3097 FunctionDeclBits.HasWrittenPrototype = true;
3098 FunctionDeclBits.IsDeleted = false;
3099 FunctionDeclBits.IsTrivial = false;
3100 FunctionDeclBits.IsTrivialForCall = false;
3101 FunctionDeclBits.IsDefaulted = false;
3102 FunctionDeclBits.IsExplicitlyDefaulted = false;
3103 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3104 FunctionDeclBits.IsIneligibleOrNotSelected = false;
3105 FunctionDeclBits.HasImplicitReturnZero = false;
3106 FunctionDeclBits.IsLateTemplateParsed = false;
3107 FunctionDeclBits.IsInstantiatedFromMemberTemplate = false;
3108 FunctionDeclBits.ConstexprKind = static_cast<uint64_t>(ConstexprKind);
3109 FunctionDeclBits.BodyContainsImmediateEscalatingExpression = false;
3110 FunctionDeclBits.InstantiationIsPending = false;
3111 FunctionDeclBits.UsesSEHTry = false;
3112 FunctionDeclBits.UsesFPIntrin = UsesFPIntrin;
3113 FunctionDeclBits.HasSkippedBody = false;
3114 FunctionDeclBits.WillHaveBody = false;
3115 FunctionDeclBits.IsMultiVersion = false;
3116 FunctionDeclBits.DeductionCandidateKind =
3117 static_cast<unsigned char>(DeductionCandidate::Normal);
3118 FunctionDeclBits.HasODRHash = false;
3119 FunctionDeclBits.FriendConstraintRefersToEnclosingTemplate = false;
3120
3121 if (TrailingRequiresClause)
3122 setTrailingRequiresClause(TrailingRequiresClause);
3123}
3124
3126 raw_ostream &OS, const PrintingPolicy &Policy, bool Qualified) const {
3129 if (TemplateArgs)
3130 printTemplateArgumentList(OS, TemplateArgs->asArray(), Policy);
3131}
3132
3134 if (const auto *FT = getType()->getAs<FunctionProtoType>())
3135 return FT->isVariadic();
3136 return false;
3137}
3138
3141 ASTContext &Context, ArrayRef<DeclAccessPair> Lookups,
3142 StringLiteral *DeletedMessage) {
3143 static constexpr size_t Alignment =
3144 std::max({alignof(DefaultedOrDeletedFunctionInfo),
3145 alignof(DeclAccessPair), alignof(StringLiteral *)});
3146 size_t Size = totalSizeToAlloc<DeclAccessPair, StringLiteral *>(
3147 Lookups.size(), DeletedMessage != nullptr);
3148
3150 new (Context.Allocate(Size, Alignment)) DefaultedOrDeletedFunctionInfo;
3151 Info->NumLookups = Lookups.size();
3152 Info->HasDeletedMessage = DeletedMessage != nullptr;
3153
3154 llvm::uninitialized_copy(Lookups, Info->getTrailingObjects<DeclAccessPair>());
3155 if (DeletedMessage)
3156 *Info->getTrailingObjects<StringLiteral *>() = DeletedMessage;
3157 return Info;
3158}
3159
3162 assert(!FunctionDeclBits.HasDefaultedOrDeletedInfo && "already have this");
3163 assert(!Body && "can't replace function body with defaulted function info");
3164
3165 FunctionDeclBits.HasDefaultedOrDeletedInfo = true;
3167}
3168
3170 FunctionDeclBits.IsDeleted = D;
3171
3172 if (Message) {
3173 assert(isDeletedAsWritten() && "Function must be deleted");
3174 if (FunctionDeclBits.HasDefaultedOrDeletedInfo)
3175 DefaultedOrDeletedInfo->setDeletedMessage(Message);
3176 else
3178 getASTContext(), /*Lookups=*/{}, Message));
3179 }
3180}
3181
3183 StringLiteral *Message) {
3184 // We should never get here with the DefaultedOrDeletedInfo populated, but
3185 // no space allocated for the deleted message, since that would require
3186 // recreating this, but setDefaultedOrDeletedInfo() disallows overwriting
3187 // an already existing DefaultedOrDeletedFunctionInfo.
3188 assert(HasDeletedMessage &&
3189 "No space to store a delete message in this DefaultedOrDeletedInfo");
3190 *getTrailingObjects<StringLiteral *>() = Message;
3191}
3192
3195 return FunctionDeclBits.HasDefaultedOrDeletedInfo ? DefaultedOrDeletedInfo
3196 : nullptr;
3197}
3198
3200 for (const auto *I : redecls()) {
3201 if (I->doesThisDeclarationHaveABody()) {
3202 Definition = I;
3203 return true;
3204 }
3205 }
3206
3207 return false;
3208}
3209
3211 const Stmt *S = getBody();
3212 if (!S) {
3213 // Since we don't have a body for this function, we don't know if it's
3214 // trivial or not.
3215 return false;
3216 }
3217
3218 if (isa<CompoundStmt>(S) && cast<CompoundStmt>(S)->body_empty())
3219 return true;
3220 return false;
3221}
3222
3224 if (!getFriendObjectKind())
3225 return false;
3226
3227 // Check for a friend function instantiated from a friend function
3228 // definition in a templated class.
3229 if (const FunctionDecl *InstantiatedFrom =
3231 return InstantiatedFrom->getFriendObjectKind() &&
3232 InstantiatedFrom->isThisDeclarationADefinition();
3233
3234 // Check for a friend function template instantiated from a friend
3235 // function template definition in a templated class.
3237 if (const FunctionTemplateDecl *InstantiatedFrom =
3238 Template->getInstantiatedFromMemberTemplate())
3239 return InstantiatedFrom->getFriendObjectKind() &&
3240 InstantiatedFrom->isThisDeclarationADefinition();
3241 }
3242
3243 return false;
3244}
3245
3247 bool CheckForPendingFriendDefinition) const {
3248 for (const FunctionDecl *FD : redecls()) {
3249 if (FD->isThisDeclarationADefinition()) {
3250 Definition = FD;
3251 return true;
3252 }
3253
3254 // If this is a friend function defined in a class template, it does not
3255 // have a body until it is used, nevertheless it is a definition, see
3256 // [temp.inst]p2:
3257 //
3258 // ... for the purpose of determining whether an instantiated redeclaration
3259 // is valid according to [basic.def.odr] and [class.mem], a declaration that
3260 // corresponds to a definition in the template is considered to be a
3261 // definition.
3262 //
3263 // The following code must produce redefinition error:
3264 //
3265 // template<typename T> struct C20 { friend void func_20() {} };
3266 // C20<int> c20i;
3267 // void func_20() {}
3268 //
3269 if (CheckForPendingFriendDefinition &&
3270 FD->isThisDeclarationInstantiatedFromAFriendDefinition()) {
3271 Definition = FD;
3272 return true;
3273 }
3274 }
3275
3276 return false;
3277}
3278
3280 if (!hasBody(Definition))
3281 return nullptr;
3282
3283 assert(!Definition->FunctionDeclBits.HasDefaultedOrDeletedInfo &&
3284 "definition should not have a body");
3285 if (Definition->Body)
3286 return Definition->Body.get(getASTContext().getExternalSource());
3287
3288 return nullptr;
3289}
3290
3292 FunctionDeclBits.HasDefaultedOrDeletedInfo = false;
3293 Body = LazyDeclStmtPtr(B);
3294 if (B)
3295 EndRangeLoc = B->getEndLoc();
3296}
3297
3299 FunctionDeclBits.IsPureVirtual = P;
3300 if (P)
3301 if (auto *Parent = dyn_cast<CXXRecordDecl>(getDeclContext()))
3302 Parent->markedVirtualFunctionPure();
3303}
3304
3305template<std::size_t Len>
3306static bool isNamed(const NamedDecl *ND, const char (&Str)[Len]) {
3307 const IdentifierInfo *II = ND->getIdentifier();
3308 return II && II->isStr(Str);
3309}
3310
3312 // C++23 [expr.const]/p17
3313 // An immediate-escalating function is
3314 // - the call operator of a lambda that is not declared with the consteval
3315 // specifier,
3316 if (isLambdaCallOperator(this) && !isConsteval())
3317 return true;
3318 // - a defaulted special member function that is not declared with the
3319 // consteval specifier,
3320 if (isDefaulted() && !isConsteval())
3321 return true;
3322
3323 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3324 CD && CD->isInheritingConstructor())
3325 return CD->getInheritedConstructor().getConstructor();
3326
3327 // Destructors are not immediate escalating.
3328 if (isa<CXXDestructorDecl>(this))
3329 return false;
3330
3331 // - a function that results from the instantiation of a templated entity
3332 // defined with the constexpr specifier.
3334 if (TK != TK_NonTemplate && TK != TK_DependentNonTemplate &&
3336 return true;
3337 return false;
3338}
3339
3341 // C++23 [expr.const]/p18
3342 // An immediate function is a function or constructor that is
3343 // - declared with the consteval specifier
3344 if (isConsteval())
3345 return true;
3346 // - an immediate-escalating function F whose function body contains an
3347 // immediate-escalating expression
3349 return true;
3350
3351 if (auto *CD = dyn_cast<CXXConstructorDecl>(this);
3352 CD && CD->isInheritingConstructor())
3353 return CD->getInheritedConstructor()
3354 .getConstructor()
3355 ->isImmediateFunction();
3356
3358 P && P->isImmediateFunction())
3359 return true;
3360
3361 if (const auto *MD = dyn_cast<CXXMethodDecl>(this);
3362 MD && MD->isLambdaStaticInvoker())
3363 return MD->getParent()->getLambdaCallOperator()->isImmediateFunction();
3364
3365 return false;
3366}
3367
3369 return isNamed(this, "main") && !getLangOpts().Freestanding &&
3370 !getLangOpts().HLSL &&
3372 isExternC());
3373}
3374
3376 const TranslationUnitDecl *TUnit =
3377 dyn_cast<TranslationUnitDecl>(getDeclContext()->getRedeclContext());
3378 if (!TUnit)
3379 return false;
3380
3381 // Even though we aren't really targeting MSVCRT if we are freestanding,
3382 // semantic analysis for these functions remains the same.
3383
3384 // MSVCRT entry points only exist on MSVCRT targets.
3385 if (!TUnit->getASTContext().getTargetInfo().getTriple().isOSMSVCRT() &&
3386 !TUnit->getASTContext().getTargetInfo().getTriple().isUEFI())
3387 return false;
3388
3389 // Nameless functions like constructors cannot be entry points.
3390 if (!getIdentifier())
3391 return false;
3392
3393 return llvm::StringSwitch<bool>(getName())
3394 .Cases({"main", // an ANSI console app
3395 "wmain", // a Unicode console App
3396 "WinMain", // an ANSI GUI app
3397 "wWinMain", // a Unicode GUI app
3398 "DllMain"}, // a DLL
3399 true)
3400 .Default(false);
3401}
3402
3404 if (!getDeclName().isAnyOperatorNewOrDelete())
3405 return false;
3406
3408 return false;
3409
3411 return false;
3412
3413 const auto *proto = getType()->castAs<FunctionProtoType>();
3414 if (proto->getNumParams() != 2 || proto->isVariadic())
3415 return false;
3416
3417 const ASTContext &Context =
3419 ->getASTContext();
3420
3421 // The result type and first argument type are constant across all
3422 // these operators. The second argument must be exactly void*.
3423 return (proto->getParamType(1).getCanonicalType() == Context.VoidPtrTy);
3424}
3425
3427 UnsignedOrNone *AlignmentParam, bool *IsNothrow) const {
3428 if (!getDeclName().isAnyOperatorNewOrDelete())
3429 return false;
3430
3432 return false;
3433
3434 // This can only fail for an invalid 'operator new' declaration.
3436 return false;
3437
3438 if (isVariadic())
3439 return false;
3440
3442 bool IsDelete = getDeclName().isAnyOperatorDelete();
3443 unsigned RequiredParameterCount =
3446 if (AlignmentParam)
3447 *AlignmentParam =
3448 /* type identity */ 1U + /* address */ IsDelete + /* size */ 1U;
3449 if (RequiredParameterCount == getNumParams())
3450 return true;
3451 if (getNumParams() > RequiredParameterCount + 1)
3452 return false;
3453 if (!getParamDecl(RequiredParameterCount)->getType()->isNothrowT())
3454 return false;
3455
3456 if (IsNothrow)
3457 *IsNothrow = true;
3458 return true;
3459 }
3460
3461 const auto *FPT = getType()->castAs<FunctionProtoType>();
3462 if (FPT->getNumParams() == 0 || FPT->getNumParams() > 4)
3463 return false;
3464
3465 // If this is a single-parameter function, it must be a replaceable global
3466 // allocation or deallocation function.
3467 if (FPT->getNumParams() == 1)
3468 return true;
3469
3470 unsigned Params = 1;
3471 QualType Ty = FPT->getParamType(Params);
3472 const ASTContext &Ctx = getASTContext();
3473
3474 auto Consume = [&] {
3475 ++Params;
3476 Ty = Params < FPT->getNumParams() ? FPT->getParamType(Params) : QualType();
3477 };
3478
3479 // In C++14, the next parameter can be a 'std::size_t' for sized delete.
3480 bool IsSizedDelete = false;
3481 if (Ctx.getLangOpts().SizedDeallocation &&
3482 getDeclName().isAnyOperatorDelete() &&
3483 Ctx.hasSameType(Ty, Ctx.getSizeType())) {
3484 IsSizedDelete = true;
3485 Consume();
3486 }
3487
3488 // In C++17, the next parameter can be a 'std::align_val_t' for aligned
3489 // new/delete.
3490 if (Ctx.getLangOpts().AlignedAllocation && !Ty.isNull() && Ty->isAlignValT()) {
3491 Consume();
3492 if (AlignmentParam)
3493 *AlignmentParam = Params;
3494 }
3495
3496 // If this is not a sized delete, the next parameter can be a
3497 // 'const std::nothrow_t&'.
3498 if (!IsSizedDelete && !Ty.isNull() && Ty->isReferenceType()) {
3499 Ty = Ty->getPointeeType();
3501 return false;
3502 if (Ty->isNothrowT()) {
3503 if (IsNothrow)
3504 *IsNothrow = true;
3505 Consume();
3506 }
3507 }
3508
3509 // Finally, recognize the not yet standard versions of new that take a
3510 // hot/cold allocation hint (__hot_cold_t). These are currently supported by
3511 // tcmalloc (see
3512 // https://github.com/google/tcmalloc/blob/220043886d4e2efff7a5702d5172cb8065253664/tcmalloc/malloc_extension.h#L53).
3513 if (!IsSizedDelete && !Ty.isNull() && Ty->isEnumeralType()) {
3514 QualType T = Ty;
3515 while (const auto *TD = T->getAs<TypedefType>())
3516 T = TD->getDecl()->getUnderlyingType();
3517 const IdentifierInfo *II =
3518 T->castAsCanonical<EnumType>()->getDecl()->getIdentifier();
3519 if (II && II->isStr("__hot_cold_t"))
3520 Consume();
3521 }
3522
3523 return Params == FPT->getNumParams();
3524}
3525
3527 if (!getBuiltinID())
3528 return false;
3529
3530 const FunctionDecl *Definition;
3531 if (!hasBody(Definition))
3532 return false;
3533
3534 if (!Definition->isInlineSpecified() ||
3535 !Definition->hasAttr<AlwaysInlineAttr>())
3536 return false;
3537
3538 ASTContext &Context = getASTContext();
3539 switch (Context.GetGVALinkageForFunction(Definition)) {
3540 case GVA_Internal:
3541 case GVA_DiscardableODR:
3542 case GVA_StrongODR:
3543 return false;
3545 case GVA_StrongExternal:
3546 return true;
3547 }
3548 llvm_unreachable("Unknown GVALinkage");
3549}
3550
3554
3555void FunctionDecl::setIsDestroyingOperatorDelete(bool IsDestroyingDelete) {
3556 getASTContext().setIsDestroyingOperatorDelete(this, IsDestroyingDelete);
3557}
3558
3562
3566
3568 UsualDeleteParams Params;
3569
3570 // This function should only be called for operator delete declarations.
3571 assert(getDeclName().isAnyOperatorDelete());
3572 if (!getDeclName().isAnyOperatorDelete())
3573 return Params;
3574
3576 auto AI = FPT->param_type_begin(), AE = FPT->param_type_end();
3577
3580 assert(AI != AE);
3581 ++AI;
3582 }
3583
3584 // The first argument after the type-identity parameter (if any) is
3585 // always a void* (or C* for a destroying operator delete for class
3586 // type C).
3587 ++AI;
3588
3589 // The next parameter may be a std::destroying_delete_t.
3591 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3592 Params.DestroyingDelete = true;
3593 assert(AI != AE);
3594 ++AI;
3595 }
3596
3597 // Figure out what other parameters we should be implicitly passing.
3598 if (AI != AE && (*AI)->isIntegerType()) {
3599 Params.Size = true;
3600 ++AI;
3601 } else
3602 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3603
3604 if (AI != AE && (*AI)->isAlignValT()) {
3606 ++AI;
3607 } else
3608 assert(!isTypeAwareAllocation(Params.TypeAwareDelete));
3609
3610 assert(AI == AE && "unexpected usual deallocation function parameter");
3611 return Params;
3612}
3613
3617
3619 return isDeclExternC(*this);
3620}
3621
3623 if (DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>()))
3624 return true;
3626}
3627
3631
3633 if (const auto *Method = dyn_cast<CXXMethodDecl>(this))
3634 return Method->isStatic();
3635
3637 return false;
3638
3639 for (const DeclContext *DC = getDeclContext();
3640 DC->isNamespace();
3641 DC = DC->getParent()) {
3642 if (const auto *Namespace = cast<NamespaceDecl>(DC)) {
3643 if (!Namespace->getDeclName())
3644 return false;
3645 }
3646 }
3647
3648 return true;
3649}
3650
3654 return true;
3655
3656 if (auto *FnTy = getType()->getAs<FunctionType>())
3657 return FnTy->getNoReturnAttr();
3658
3659 return false;
3660}
3661
3665
3667 // C++20 [temp.friend]p9:
3668 // A non-template friend declaration with a requires-clause [or]
3669 // a friend function template with a constraint that depends on a template
3670 // parameter from an enclosing template [...] does not declare the same
3671 // function or function template as a declaration in any other scope.
3672
3673 // If this isn't a friend then it's not a member-like constrained friend.
3674 if (!getFriendObjectKind()) {
3675 return false;
3676 }
3677
3679 // If these friends don't have constraints, they aren't constrained, and
3680 // thus don't fall under temp.friend p9. Else the simple presence of a
3681 // constraint makes them unique.
3683 }
3684
3686}
3687
3701
3705
3709
3714
3716 if (!isMultiVersion())
3717 return false;
3718 if (hasAttr<TargetAttr>())
3719 return getAttr<TargetAttr>()->isDefaultVersion();
3720 return hasAttr<TargetVersionAttr>() &&
3721 getAttr<TargetVersionAttr>()->isDefaultVersion();
3722}
3723
3727
3731
3732void
3735
3737 FunctionTemplateDecl *PrevFunTmpl
3738 = PrevDecl? PrevDecl->getDescribedFunctionTemplate() : nullptr;
3739 assert((!PrevDecl || PrevFunTmpl) && "Function/function template mismatch");
3740 FunTmpl->setPreviousDecl(PrevFunTmpl);
3741 }
3742
3743 if (PrevDecl && PrevDecl->isInlined())
3744 setImplicitlyInline(true);
3745}
3746
3748
3749/// Returns a value indicating whether this function corresponds to a builtin
3750/// function.
3751///
3752/// The function corresponds to a built-in function if it is declared at
3753/// translation scope or within an extern "C" block and its name matches with
3754/// the name of a builtin. The returned value will be 0 for functions that do
3755/// not correspond to a builtin, a value of type \c Builtin::ID if in the
3756/// target-independent range \c [1,Builtin::First), or a target-specific builtin
3757/// value.
3758///
3759/// \param ConsiderWrapperFunctions If true, we should consider wrapper
3760/// functions as their wrapped builtins. This shouldn't be done in general, but
3761/// it's useful in Sema to diagnose calls to wrappers based on their semantics.
3762unsigned FunctionDecl::getBuiltinID(bool ConsiderWrapperFunctions) const {
3763 unsigned BuiltinID = 0;
3764
3765 if (const auto *ABAA = getAttr<ArmBuiltinAliasAttr>()) {
3766 BuiltinID = ABAA->getBuiltinName()->getBuiltinID();
3767 } else if (const auto *BAA = getAttr<BuiltinAliasAttr>()) {
3768 BuiltinID = BAA->getBuiltinName()->getBuiltinID();
3769 } else if (const auto *A = getAttr<BuiltinAttr>()) {
3770 BuiltinID = A->getID();
3771 }
3772
3773 if (!BuiltinID)
3774 return 0;
3775
3776 // If the function is marked "overloadable", it has a different mangled name
3777 // and is not the C library function.
3778 if (!ConsiderWrapperFunctions && hasAttr<OverloadableAttr>() &&
3780 return 0;
3781
3783 BuiltinID == Builtin::BI__builtin_counted_by_ref)
3784 return 0;
3785
3786 const ASTContext &Context = getASTContext();
3787 if (!Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3788 return BuiltinID;
3789
3790 // This function has the name of a known C library
3791 // function. Determine whether it actually refers to the C library
3792 // function or whether it just has the same name.
3793
3794 // If this is a static function, it's not a builtin.
3795 if (!ConsiderWrapperFunctions && getStorageClass() == SC_Static)
3796 return 0;
3797
3798 // OpenCL v1.2 s6.9.f - The library functions defined in
3799 // the C99 standard headers are not available.
3800 if (Context.getLangOpts().OpenCL &&
3801 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID))
3802 return 0;
3803
3804 // CUDA does not have device-side standard library. printf and malloc are the
3805 // only special cases that are supported by device-side runtime.
3806 if (Context.getLangOpts().CUDA && hasAttr<CUDADeviceAttr>() &&
3808 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3809 return 0;
3810
3811 // As AMDGCN implementation of OpenMP does not have a device-side standard
3812 // library, none of the predefined library functions except printf and malloc
3813 // should be treated as a builtin i.e. 0 should be returned for them.
3814 if (Context.getTargetInfo().getTriple().isAMDGCN() &&
3815 Context.getLangOpts().OpenMPIsTargetDevice &&
3816 Context.BuiltinInfo.isPredefinedLibFunction(BuiltinID) &&
3817 !(BuiltinID == Builtin::BIprintf || BuiltinID == Builtin::BImalloc))
3818 return 0;
3819
3820 return BuiltinID;
3821}
3822
3823/// getNumParams - Return the number of parameters this function must have
3824/// based on its FunctionType. This is the length of the ParamInfo array
3825/// after it has been created.
3827 const auto *FPT = getType()->getAs<FunctionProtoType>();
3828 return FPT ? FPT->getNumParams() : 0;
3829}
3830
3831void FunctionDecl::setParams(ASTContext &C,
3832 ArrayRef<ParmVarDecl *> NewParamInfo) {
3833 assert(!ParamInfo && "Already has param info!");
3834 assert(NewParamInfo.size() == getNumParams() && "Parameter count mismatch!");
3835
3836 // Zero params -> null pointer.
3837 if (!NewParamInfo.empty()) {
3838 ParamInfo = new (C) ParmVarDecl*[NewParamInfo.size()];
3839 llvm::copy(NewParamInfo, ParamInfo);
3840 }
3841}
3842
3843/// getMinRequiredArguments - Returns the minimum number of arguments
3844/// needed to call this function. This may be fewer than the number of
3845/// function parameters, if some of the parameters have default
3846/// arguments (in C++) or are parameter packs (C++11).
3849 return getNumParams();
3850
3851 // Note that it is possible for a parameter with no default argument to
3852 // follow a parameter with a default argument.
3853 unsigned NumRequiredArgs = 0;
3854 unsigned MinParamsSoFar = 0;
3855 for (auto *Param : parameters()) {
3856 if (!Param->isParameterPack()) {
3857 ++MinParamsSoFar;
3858 if (!Param->hasDefaultArg())
3859 NumRequiredArgs = MinParamsSoFar;
3860 }
3861 }
3862 return NumRequiredArgs;
3863}
3864
3868
3870 return getNumParams() -
3871 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3872}
3873
3875 return getMinRequiredArguments() -
3876 static_cast<unsigned>(hasCXXExplicitFunctionObjectParameter());
3877}
3878
3880 return getNumParams() == 1 ||
3881 (getNumParams() > 1 &&
3882 llvm::all_of(llvm::drop_begin(parameters()),
3883 [](ParmVarDecl *P) { return P->hasDefaultArg(); }));
3884}
3885
3886/// The combination of the extern and inline keywords under MSVC forces
3887/// the function to be required.
3888///
3889/// Note: This function assumes that we will only get called when isInlined()
3890/// would return true for this FunctionDecl.
3892 assert(isInlined() && "expected to get called on an inlined function!");
3893
3894 const ASTContext &Context = getASTContext();
3895 if (!Context.getTargetInfo().getCXXABI().isMicrosoft() &&
3897 return false;
3898
3899 for (const FunctionDecl *FD = getMostRecentDecl(); FD;
3900 FD = FD->getPreviousDecl())
3901 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3902 return true;
3903
3904 return false;
3905}
3906
3907static bool redeclForcesDefMSVC(const FunctionDecl *Redecl) {
3908 if (Redecl->getStorageClass() != SC_Extern)
3909 return false;
3910
3911 for (const FunctionDecl *FD = Redecl->getPreviousDecl(); FD;
3912 FD = FD->getPreviousDecl())
3913 if (!FD->isImplicit() && FD->getStorageClass() == SC_Extern)
3914 return false;
3915
3916 return true;
3917}
3918
3919static bool RedeclForcesDefC99(const FunctionDecl *Redecl) {
3920 // Only consider file-scope declarations in this test.
3921 if (!Redecl->getLexicalDeclContext()->isTranslationUnit())
3922 return false;
3923
3924 // Only consider explicit declarations; the presence of a builtin for a
3925 // libcall shouldn't affect whether a definition is externally visible.
3926 if (Redecl->isImplicit())
3927 return false;
3928
3929 if (!Redecl->isInlineSpecified() || Redecl->getStorageClass() == SC_Extern)
3930 return true; // Not an inline definition
3931
3932 return false;
3933}
3934
3935/// For a function declaration in C or C++, determine whether this
3936/// declaration causes the definition to be externally visible.
3937///
3938/// For instance, this determines if adding the current declaration to the set
3939/// of redeclarations of the given functions causes
3940/// isInlineDefinitionExternallyVisible to change from false to true.
3942 assert(!doesThisDeclarationHaveABody() &&
3943 "Must have a declaration without a body.");
3944
3945 const ASTContext &Context = getASTContext();
3946
3947 if (Context.getLangOpts().MSVCCompat) {
3948 const FunctionDecl *Definition;
3949 if (hasBody(Definition) && Definition->isInlined() &&
3950 redeclForcesDefMSVC(this))
3951 return true;
3952 }
3953
3954 if (Context.getLangOpts().CPlusPlus)
3955 return false;
3956
3957 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
3958 // With GNU inlining, a declaration with 'inline' but not 'extern', forces
3959 // an externally visible definition.
3960 //
3961 // FIXME: What happens if gnu_inline gets added on after the first
3962 // declaration?
3964 return false;
3965
3966 const FunctionDecl *Prev = this;
3967 bool FoundBody = false;
3968 while ((Prev = Prev->getPreviousDecl())) {
3969 FoundBody |= Prev->doesThisDeclarationHaveABody();
3970
3971 if (Prev->doesThisDeclarationHaveABody()) {
3972 // If it's not the case that both 'inline' and 'extern' are
3973 // specified on the definition, then it is always externally visible.
3974 if (!Prev->isInlineSpecified() ||
3975 Prev->getStorageClass() != SC_Extern)
3976 return false;
3977 } else if (Prev->isInlineSpecified() &&
3978 Prev->getStorageClass() != SC_Extern) {
3979 return false;
3980 }
3981 }
3982 return FoundBody;
3983 }
3984
3985 // C99 6.7.4p6:
3986 // [...] If all of the file scope declarations for a function in a
3987 // translation unit include the inline function specifier without extern,
3988 // then the definition in that translation unit is an inline definition.
3990 return false;
3991 const FunctionDecl *Prev = this;
3992 bool FoundBody = false;
3993 while ((Prev = Prev->getPreviousDecl())) {
3994 FoundBody |= Prev->doesThisDeclarationHaveABody();
3995 if (RedeclForcesDefC99(Prev))
3996 return false;
3997 }
3998 return FoundBody;
3999}
4000
4002 const TypeSourceInfo *TSI = getTypeSourceInfo();
4003
4004 if (!TSI)
4005 return FunctionTypeLoc();
4006
4007 TypeLoc TL = TSI->getTypeLoc();
4008 FunctionTypeLoc FTL;
4009
4010 while (!(FTL = TL.getAs<FunctionTypeLoc>())) {
4011 if (const auto PTL = TL.getAs<ParenTypeLoc>())
4012 TL = PTL.getInnerLoc();
4013 else if (const auto ATL = TL.getAs<AttributedTypeLoc>())
4014 TL = ATL.getEquivalentTypeLoc();
4015 else if (const auto MQTL = TL.getAs<MacroQualifiedTypeLoc>())
4016 TL = MQTL.getInnerLoc();
4017 else
4018 break;
4019 }
4020
4021 return FTL;
4022}
4023
4026 if (!FTL)
4027 return SourceRange();
4028
4029 // Skip self-referential return types.
4031 SourceRange RTRange = FTL.getReturnLoc().getSourceRange();
4032 SourceLocation Boundary = getNameInfo().getBeginLoc();
4033 if (RTRange.isInvalid() || Boundary.isInvalid() ||
4034 !SM.isBeforeInTranslationUnit(RTRange.getEnd(), Boundary))
4035 return SourceRange();
4036
4037 return RTRange;
4038}
4039
4041 unsigned NP = getNumParams();
4042 SourceLocation EllipsisLoc = getEllipsisLoc();
4043
4044 if (NP == 0 && EllipsisLoc.isInvalid())
4045 return SourceRange();
4046
4047 SourceLocation Begin =
4048 NP > 0 ? ParamInfo[0]->getSourceRange().getBegin() : EllipsisLoc;
4049 SourceLocation End = EllipsisLoc.isValid()
4050 ? EllipsisLoc
4051 : ParamInfo[NP - 1]->getSourceRange().getEnd();
4052
4053 return SourceRange(Begin, End);
4054}
4055
4060
4061/// For an inline function definition in C, or for a gnu_inline function
4062/// in C++, determine whether the definition will be externally visible.
4063///
4064/// Inline function definitions are always available for inlining optimizations.
4065/// However, depending on the language dialect, declaration specifiers, and
4066/// attributes, the definition of an inline function may or may not be
4067/// "externally" visible to other translation units in the program.
4068///
4069/// In C99, inline definitions are not externally visible by default. However,
4070/// if even one of the global-scope declarations is marked "extern inline", the
4071/// inline definition becomes externally visible (C99 6.7.4p6).
4072///
4073/// In GNU89 mode, or if the gnu_inline attribute is attached to the function
4074/// definition, we use the GNU semantics for inline, which are nearly the
4075/// opposite of C99 semantics. In particular, "inline" by itself will create
4076/// an externally visible symbol, but "extern inline" will not create an
4077/// externally visible symbol.
4080 hasAttr<AliasAttr>()) &&
4081 "Must be a function definition");
4082 assert(isInlined() && "Function must be inline");
4083 ASTContext &Context = getASTContext();
4084
4085 if (Context.getLangOpts().GNUInline || hasAttr<GNUInlineAttr>()) {
4086 // Note: If you change the logic here, please change
4087 // doesDeclarationForceExternallyVisibleDefinition as well.
4088 //
4089 // If it's not the case that both 'inline' and 'extern' are
4090 // specified on the definition, then this inline definition is
4091 // externally visible.
4092 if (Context.getLangOpts().CPlusPlus)
4093 return false;
4095 return true;
4096
4097 // If any declaration is 'inline' but not 'extern', then this definition
4098 // is externally visible.
4099 for (auto *Redecl : redecls()) {
4100 if (Redecl->isInlineSpecified() &&
4101 Redecl->getStorageClass() != SC_Extern)
4102 return true;
4103 }
4104
4105 return false;
4106 }
4107
4108 // The rest of this function is C-only.
4109 assert(!Context.getLangOpts().CPlusPlus &&
4110 "should not use C inline rules in C++");
4111
4112 // C99 6.7.4p6:
4113 // [...] If all of the file scope declarations for a function in a
4114 // translation unit include the inline function specifier without extern,
4115 // then the definition in that translation unit is an inline definition.
4116 for (auto *Redecl : redecls()) {
4117 if (RedeclForcesDefC99(Redecl))
4118 return true;
4119 }
4120
4121 // C99 6.7.4p6:
4122 // An inline definition does not provide an external definition for the
4123 // function, and does not forbid an external definition in another
4124 // translation unit.
4125 return false;
4126}
4127
4128/// getOverloadedOperator - Which C++ overloaded operator this
4129/// function represents, if any.
4135
4136/// getLiteralIdentifier - The literal suffix identifier this function
4137/// represents, if any.
4141 return nullptr;
4142}
4143
4145 if (TemplateOrSpecialization.isNull())
4146 return TK_NonTemplate;
4147 if (const auto *ND = dyn_cast<NamedDecl *>(TemplateOrSpecialization)) {
4148 if (isa<FunctionDecl>(ND))
4150 assert(isa<FunctionTemplateDecl>(ND) &&
4151 "No other valid types in NamedDecl");
4152 return TK_FunctionTemplate;
4153 }
4154 if (isa<MemberSpecializationInfo *>(TemplateOrSpecialization))
4156 if (isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization))
4159 TemplateOrSpecialization))
4161
4162 llvm_unreachable("Did we miss a TemplateOrSpecialization type?");
4163}
4164
4167 return cast<FunctionDecl>(Info->getInstantiatedFrom());
4168
4169 return nullptr;
4170}
4171
4173 if (auto *MSI = dyn_cast_if_present<MemberSpecializationInfo *>(
4174 TemplateOrSpecialization))
4175 return MSI;
4176 if (auto *FTSI = dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4177 TemplateOrSpecialization))
4178 return FTSI->getMemberSpecializationInfo();
4179 return nullptr;
4180}
4181
4182void
4183FunctionDecl::setInstantiationOfMemberFunction(ASTContext &C,
4184 FunctionDecl *FD,
4186 assert(TemplateOrSpecialization.isNull() &&
4187 "Member function is already a specialization");
4189 = new (C) MemberSpecializationInfo(FD, TSK);
4190 TemplateOrSpecialization = Info;
4191}
4192
4194 return dyn_cast_if_present<FunctionTemplateDecl>(
4195 dyn_cast_if_present<NamedDecl *>(TemplateOrSpecialization));
4196}
4197
4200 assert(TemplateOrSpecialization.isNull() &&
4201 "Member function is already a specialization");
4202 TemplateOrSpecialization = Template;
4203}
4204
4206 return isa<FunctionTemplateSpecializationInfo *>(TemplateOrSpecialization) ||
4208 TemplateOrSpecialization);
4209}
4210
4212 assert(TemplateOrSpecialization.isNull() &&
4213 "Function is already a specialization");
4214 TemplateOrSpecialization = FD;
4215}
4216
4218 return dyn_cast_if_present<FunctionDecl>(
4219 TemplateOrSpecialization.dyn_cast<NamedDecl *>());
4220}
4221
4223 // If the function is invalid, it can't be implicitly instantiated.
4224 if (isInvalidDecl())
4225 return false;
4226
4228 case TSK_Undeclared:
4231 return false;
4232
4234 return true;
4235
4237 // Handled below.
4238 break;
4239 }
4240
4241 // Find the actual template from which we will instantiate.
4242 const FunctionDecl *PatternDecl = getTemplateInstantiationPattern();
4243 bool HasPattern = false;
4244 if (PatternDecl)
4245 HasPattern = PatternDecl->hasBody(PatternDecl);
4246
4247 // C++0x [temp.explicit]p9:
4248 // Except for inline functions, other explicit instantiation declarations
4249 // have the effect of suppressing the implicit instantiation of the entity
4250 // to which they refer.
4251 if (!HasPattern || !PatternDecl)
4252 return true;
4253
4254 return PatternDecl->isInlined();
4255}
4256
4258 // FIXME: Remove this, it's not clear what it means. (Which template
4259 // specialization kind?)
4261}
4262
4265 // If this is a generic lambda call operator specialization, its
4266 // instantiation pattern is always its primary template's pattern
4267 // even if its primary template was instantiated from another
4268 // member template (which happens with nested generic lambdas).
4269 // Since a lambda's call operator's body is transformed eagerly,
4270 // we don't have to go hunting for a prototype definition template
4271 // (i.e. instantiated-from-member-template) to use as an instantiation
4272 // pattern.
4273
4275 dyn_cast<CXXMethodDecl>(this))) {
4276 assert(getPrimaryTemplate() && "not a generic lambda call operator?");
4277 return getDefinitionOrSelf(getPrimaryTemplate()->getTemplatedDecl());
4278 }
4279
4280 // Check for a declaration of this function that was instantiated from a
4281 // friend definition.
4282 const FunctionDecl *FD = nullptr;
4283 if (!isDefined(FD, /*CheckForPendingFriendDefinition=*/true))
4284 FD = this;
4285
4287 if (ForDefinition &&
4289 return nullptr;
4291 }
4292
4293 if (ForDefinition &&
4295 return nullptr;
4296
4297 if (FunctionTemplateDecl *Primary = getPrimaryTemplate()) {
4298 // If we hit a point where the user provided a specialization of this
4299 // template, we're done looking.
4300 while (!ForDefinition || !Primary->isMemberSpecialization()) {
4301 auto *NewPrimary = Primary->getInstantiatedFromMemberTemplate();
4302 if (!NewPrimary)
4303 break;
4304 Primary = NewPrimary;
4305 }
4306
4307 return getDefinitionOrSelf(Primary->getTemplatedDecl());
4308 }
4309
4310 return nullptr;
4311}
4312
4315 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4316 TemplateOrSpecialization)) {
4317 return Info->getTemplate();
4318 }
4319 return nullptr;
4320}
4321
4324 return dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4325 TemplateOrSpecialization);
4326}
4327
4331 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4332 TemplateOrSpecialization)) {
4333 return Info->TemplateArguments;
4334 }
4335 return nullptr;
4336}
4337
4341 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4342 TemplateOrSpecialization)) {
4343 return Info->TemplateArgumentsAsWritten;
4344 }
4346 dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4347 TemplateOrSpecialization)) {
4348 return Info->TemplateArgumentsAsWritten;
4349 }
4350 return nullptr;
4351}
4352
4353void FunctionDecl::setFunctionTemplateSpecialization(
4355 TemplateArgumentList *TemplateArgs, void *InsertPos,
4357 const TemplateArgumentListInfo *TemplateArgsAsWritten,
4358 SourceLocation PointOfInstantiation) {
4359 assert((TemplateOrSpecialization.isNull() ||
4360 isa<MemberSpecializationInfo *>(TemplateOrSpecialization)) &&
4361 "Member function is already a specialization");
4362 assert(TSK != TSK_Undeclared &&
4363 "Must specify the type of function template specialization");
4364 assert((TemplateOrSpecialization.isNull() ||
4367 "Member specialization must be an explicit specialization");
4370 C, this, Template, TSK, TemplateArgs, TemplateArgsAsWritten,
4371 PointOfInstantiation,
4372 dyn_cast_if_present<MemberSpecializationInfo *>(
4373 TemplateOrSpecialization));
4374 TemplateOrSpecialization = Info;
4375 Template->addSpecialization(Info, InsertPos);
4376}
4377
4379 ASTContext &Context, const UnresolvedSetImpl &Templates,
4380 const TemplateArgumentListInfo *TemplateArgs) {
4381 assert(TemplateOrSpecialization.isNull());
4384 TemplateArgs);
4385 TemplateOrSpecialization = Info;
4386}
4387
4390 return dyn_cast_if_present<DependentFunctionTemplateSpecializationInfo *>(
4391 TemplateOrSpecialization);
4392}
4393
4396 ASTContext &Context, const UnresolvedSetImpl &Candidates,
4397 const TemplateArgumentListInfo *TArgs) {
4398 const auto *TArgsWritten =
4399 TArgs ? ASTTemplateArgumentListInfo::Create(Context, *TArgs) : nullptr;
4400 return new (Context.Allocate(
4401 totalSizeToAlloc<FunctionTemplateDecl *>(Candidates.size())))
4402 DependentFunctionTemplateSpecializationInfo(Candidates, TArgsWritten);
4403}
4404
4405DependentFunctionTemplateSpecializationInfo::
4406 DependentFunctionTemplateSpecializationInfo(
4407 const UnresolvedSetImpl &Candidates,
4408 const ASTTemplateArgumentListInfo *TemplateArgsWritten)
4409 : NumCandidates(Candidates.size()),
4410 TemplateArgumentsAsWritten(TemplateArgsWritten) {
4411 std::transform(Candidates.begin(), Candidates.end(), getTrailingObjects(),
4412 [](NamedDecl *ND) {
4414 });
4415}
4416
4418 // For a function template specialization, query the specialization
4419 // information object.
4421 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4422 TemplateOrSpecialization))
4423 return FTSInfo->getTemplateSpecializationKind();
4424
4425 if (MemberSpecializationInfo *MSInfo =
4426 dyn_cast_if_present<MemberSpecializationInfo *>(
4427 TemplateOrSpecialization))
4428 return MSInfo->getTemplateSpecializationKind();
4429
4430 // A dependent function template specialization is an explicit specialization,
4431 // except when it's a friend declaration.
4433 TemplateOrSpecialization) &&
4436
4437 return TSK_Undeclared;
4438}
4439
4442 // This is the same as getTemplateSpecializationKind(), except that for a
4443 // function that is both a function template specialization and a member
4444 // specialization, we prefer the member specialization information. Eg:
4445 //
4446 // template<typename T> struct A {
4447 // template<typename U> void f() {}
4448 // template<> void f<int>() {}
4449 // };
4450 //
4451 // Within the templated CXXRecordDecl, A<T>::f<int> is a dependent function
4452 // template specialization; both getTemplateSpecializationKind() and
4453 // getTemplateSpecializationKindForInstantiation() will return
4454 // TSK_ExplicitSpecialization.
4455 //
4456 // For A<int>::f<int>():
4457 // * getTemplateSpecializationKind() will return TSK_ExplicitSpecialization
4458 // * getTemplateSpecializationKindForInstantiation() will return
4459 // TSK_ImplicitInstantiation
4460 //
4461 // This reflects the facts that A<int>::f<int> is an explicit specialization
4462 // of A<int>::f, and that A<int>::f<int> should be implicitly instantiated
4463 // from A::f<int> if a definition is needed.
4465 dyn_cast_if_present<FunctionTemplateSpecializationInfo *>(
4466 TemplateOrSpecialization)) {
4467 if (auto *MSInfo = FTSInfo->getMemberSpecializationInfo())
4468 return MSInfo->getTemplateSpecializationKind();
4469 return FTSInfo->getTemplateSpecializationKind();
4470 }
4471
4472 if (MemberSpecializationInfo *MSInfo =
4473 dyn_cast_if_present<MemberSpecializationInfo *>(
4474 TemplateOrSpecialization))
4475 return MSInfo->getTemplateSpecializationKind();
4476
4478 TemplateOrSpecialization) &&
4481
4482 return TSK_Undeclared;
4483}
4484
4485void
4487 SourceLocation PointOfInstantiation) {
4489 dyn_cast<FunctionTemplateSpecializationInfo *>(
4490 TemplateOrSpecialization)) {
4491 FTSInfo->setTemplateSpecializationKind(TSK);
4492 if (TSK != TSK_ExplicitSpecialization &&
4493 PointOfInstantiation.isValid() &&
4494 FTSInfo->getPointOfInstantiation().isInvalid()) {
4495 FTSInfo->setPointOfInstantiation(PointOfInstantiation);
4497 L->InstantiationRequested(this);
4498 }
4499 } else if (MemberSpecializationInfo *MSInfo =
4500 dyn_cast<MemberSpecializationInfo *>(
4501 TemplateOrSpecialization)) {
4502 MSInfo->setTemplateSpecializationKind(TSK);
4503 if (TSK != TSK_ExplicitSpecialization &&
4504 PointOfInstantiation.isValid() &&
4505 MSInfo->getPointOfInstantiation().isInvalid()) {
4506 MSInfo->setPointOfInstantiation(PointOfInstantiation);
4508 L->InstantiationRequested(this);
4509 }
4510 } else
4511 llvm_unreachable("Function cannot have a template specialization kind");
4512}
4513
4516 = TemplateOrSpecialization.dyn_cast<
4518 return FTSInfo->getPointOfInstantiation();
4519 if (MemberSpecializationInfo *MSInfo =
4520 TemplateOrSpecialization.dyn_cast<MemberSpecializationInfo *>())
4521 return MSInfo->getPointOfInstantiation();
4522
4523 return SourceLocation();
4524}
4525
4527 if (Decl::isOutOfLine())
4528 return true;
4529
4530 // If this function was instantiated from a member function of a
4531 // class template, check whether that member function was defined out-of-line.
4533 const FunctionDecl *Definition;
4534 if (FD->hasBody(Definition))
4535 return Definition->isOutOfLine();
4536 }
4537
4538 // If this function was instantiated from a function template,
4539 // check whether that function template was defined out-of-line.
4540 if (FunctionTemplateDecl *FunTmpl = getPrimaryTemplate()) {
4541 const FunctionDecl *Definition;
4542 if (FunTmpl->getTemplatedDecl()->hasBody(Definition))
4543 return Definition->isOutOfLine();
4544 }
4545
4546 return false;
4547}
4548
4550 return SourceRange(getOuterLocStart(), EndRangeLoc);
4551}
4552
4554 IdentifierInfo *FnInfo = getIdentifier();
4555
4556 if (!FnInfo)
4557 return 0;
4558
4559 // Builtin handling.
4560 switch (getBuiltinID()) {
4561 case Builtin::BI__builtin_memset:
4562 case Builtin::BI__builtin___memset_chk:
4563 case Builtin::BImemset:
4564 return Builtin::BImemset;
4565
4566 case Builtin::BI__builtin_memcpy:
4567 case Builtin::BI__builtin___memcpy_chk:
4568 case Builtin::BImemcpy:
4569 return Builtin::BImemcpy;
4570
4571 case Builtin::BI__builtin_mempcpy:
4572 case Builtin::BI__builtin___mempcpy_chk:
4573 case Builtin::BImempcpy:
4574 return Builtin::BImempcpy;
4575
4576 case Builtin::BI__builtin_trivially_relocate:
4577 case Builtin::BI__builtin_memmove:
4578 case Builtin::BI__builtin___memmove_chk:
4579 case Builtin::BImemmove:
4580 return Builtin::BImemmove;
4581
4582 case Builtin::BIstrlcpy:
4583 case Builtin::BI__builtin___strlcpy_chk:
4584 return Builtin::BIstrlcpy;
4585
4586 case Builtin::BIstrlcat:
4587 case Builtin::BI__builtin___strlcat_chk:
4588 return Builtin::BIstrlcat;
4589
4590 case Builtin::BI__builtin_memcmp:
4591 case Builtin::BImemcmp:
4592 return Builtin::BImemcmp;
4593
4594 case Builtin::BI__builtin_bcmp:
4595 case Builtin::BIbcmp:
4596 return Builtin::BIbcmp;
4597
4598 case Builtin::BI__builtin_strncpy:
4599 case Builtin::BI__builtin___strncpy_chk:
4600 case Builtin::BIstrncpy:
4601 return Builtin::BIstrncpy;
4602
4603 case Builtin::BI__builtin_strncmp:
4604 case Builtin::BIstrncmp:
4605 return Builtin::BIstrncmp;
4606
4607 case Builtin::BI__builtin_strncasecmp:
4608 case Builtin::BIstrncasecmp:
4609 return Builtin::BIstrncasecmp;
4610
4611 case Builtin::BI__builtin_strncat:
4612 case Builtin::BI__builtin___strncat_chk:
4613 case Builtin::BIstrncat:
4614 return Builtin::BIstrncat;
4615
4616 case Builtin::BI__builtin_strndup:
4617 case Builtin::BIstrndup:
4618 return Builtin::BIstrndup;
4619
4620 case Builtin::BI__builtin_strlen:
4621 case Builtin::BIstrlen:
4622 return Builtin::BIstrlen;
4623
4624 case Builtin::BI__builtin_bzero:
4625 case Builtin::BIbzero:
4626 return Builtin::BIbzero;
4627
4628 case Builtin::BI__builtin_bcopy:
4629 case Builtin::BIbcopy:
4630 return Builtin::BIbcopy;
4631
4632 case Builtin::BIfree:
4633 return Builtin::BIfree;
4634
4635 default:
4636 if (isExternC()) {
4637 if (FnInfo->isStr("memset"))
4638 return Builtin::BImemset;
4639 if (FnInfo->isStr("memcpy"))
4640 return Builtin::BImemcpy;
4641 if (FnInfo->isStr("mempcpy"))
4642 return Builtin::BImempcpy;
4643 if (FnInfo->isStr("memmove"))
4644 return Builtin::BImemmove;
4645 if (FnInfo->isStr("memcmp"))
4646 return Builtin::BImemcmp;
4647 if (FnInfo->isStr("bcmp"))
4648 return Builtin::BIbcmp;
4649 if (FnInfo->isStr("strncpy"))
4650 return Builtin::BIstrncpy;
4651 if (FnInfo->isStr("strncmp"))
4652 return Builtin::BIstrncmp;
4653 if (FnInfo->isStr("strncasecmp"))
4654 return Builtin::BIstrncasecmp;
4655 if (FnInfo->isStr("strncat"))
4656 return Builtin::BIstrncat;
4657 if (FnInfo->isStr("strndup"))
4658 return Builtin::BIstrndup;
4659 if (FnInfo->isStr("strlen"))
4660 return Builtin::BIstrlen;
4661 if (FnInfo->isStr("bzero"))
4662 return Builtin::BIbzero;
4663 if (FnInfo->isStr("bcopy"))
4664 return Builtin::BIbcopy;
4665 } else if (isInStdNamespace()) {
4666 if (FnInfo->isStr("free"))
4667 return Builtin::BIfree;
4668 }
4669 break;
4670 }
4671 return 0;
4672}
4673
4675 assert(hasODRHash());
4676 return ODRHash;
4677}
4678
4680 if (hasODRHash())
4681 return ODRHash;
4682
4683 if (auto *FT = getInstantiatedFromMemberFunction()) {
4684 setHasODRHash(true);
4685 ODRHash = FT->getODRHash();
4686 return ODRHash;
4687 }
4688
4689 class ODRHash Hash;
4690 Hash.AddFunctionDecl(this);
4691 setHasODRHash(true);
4692 ODRHash = Hash.CalculateHash();
4693 return ODRHash;
4694}
4695
4696//===----------------------------------------------------------------------===//
4697// FieldDecl Implementation
4698//===----------------------------------------------------------------------===//
4699
4701 SourceLocation StartLoc, SourceLocation IdLoc,
4702 const IdentifierInfo *Id, QualType T,
4703 TypeSourceInfo *TInfo, Expr *BW, bool Mutable,
4704 InClassInitStyle InitStyle) {
4705 return new (C, DC) FieldDecl(Decl::Field, DC, StartLoc, IdLoc, Id, T, TInfo,
4706 BW, Mutable, InitStyle);
4707}
4708
4710 return new (C, ID) FieldDecl(Field, nullptr, SourceLocation(),
4711 SourceLocation(), nullptr, QualType(), nullptr,
4712 nullptr, false, ICIS_NoInit);
4713}
4714
4716 if (!isImplicit() || getDeclName())
4717 return false;
4718
4719 if (const auto *Record = getType()->getAsCanonical<RecordType>())
4720 return Record->getDecl()->isAnonymousStructOrUnion();
4721
4722 return false;
4723}
4724
4726 if (!hasInClassInitializer())
4727 return nullptr;
4728
4729 LazyDeclStmtPtr InitPtr = BitField ? InitAndBitWidth->Init : Init;
4730 return cast_if_present<Expr>(
4731 InitPtr.isOffset() ? InitPtr.get(getASTContext().getExternalSource())
4732 : InitPtr.get(nullptr));
4733}
4734
4736 setLazyInClassInitializer(LazyDeclStmtPtr(NewInit));
4737}
4738
4739void FieldDecl::setLazyInClassInitializer(LazyDeclStmtPtr NewInit) {
4741 if (BitField)
4742 InitAndBitWidth->Init = NewInit;
4743 else
4744 Init = NewInit;
4745}
4746
4748 const auto *CE = dyn_cast_if_present<ConstantExpr>(getBitWidth());
4749 return CE && CE->getAPValueResult().isInt();
4750}
4751
4753 assert(isBitField() && "not a bitfield");
4756 ->getAPValueResult()
4757 .getInt()
4758 .getZExtValue();
4759}
4760
4763 getBitWidthValue() == 0;
4764}
4765
4766bool FieldDecl::isZeroSize(const ASTContext &Ctx) const {
4768 return true;
4769
4770 // C++2a [intro.object]p7:
4771 // An object has nonzero size if it
4772 // -- is not a potentially-overlapping subobject, or
4774 return false;
4775
4776 // -- is not of class type, or
4777 const auto *RT = getType()->getAsCanonical<RecordType>();
4778 if (!RT)
4779 return false;
4780 const RecordDecl *RD = RT->getDecl()->getDefinition();
4781 if (!RD) {
4782 assert(isInvalidDecl() && "valid field has incomplete type");
4783 return false;
4784 }
4785
4786 // -- [has] virtual member functions or virtual base classes, or
4787 // -- has subobjects of nonzero size or bit-fields of nonzero length
4788 const auto *CXXRD = cast<CXXRecordDecl>(RD);
4789 if (!CXXRD->isEmpty())
4790 return false;
4791
4792 // Otherwise, [...] the circumstances under which the object has zero size
4793 // are implementation-defined.
4794 if (!Ctx.getTargetInfo().getCXXABI().isMicrosoft())
4795 return true;
4796
4797 // MS ABI: has nonzero size if it is a class type with class type fields,
4798 // whether or not they have nonzero size
4799 return !llvm::any_of(CXXRD->fields(), [](const FieldDecl *Field) {
4800 return Field->getType()->isRecordType();
4801 });
4802}
4803
4807
4808void FieldDecl::setCachedFieldIndex() const {
4809 assert(this == getCanonicalDecl() &&
4810 "should be called on the canonical decl");
4811
4812 unsigned Index = 0;
4813 const RecordDecl *RD = getParent()->getDefinition();
4814 assert(RD && "requested index for field of struct with no definition");
4815
4816 for (auto *Field : RD->fields()) {
4817 Field->getCanonicalDecl()->CachedFieldIndex = Index + 1;
4818 assert(Field->getCanonicalDecl()->CachedFieldIndex == Index + 1 &&
4819 "overflow in field numbering");
4820 ++Index;
4821 }
4822
4823 assert(CachedFieldIndex && "failed to find field in parent");
4824}
4825
4827 const Expr *FinalExpr = getInClassInitializer();
4828 if (!FinalExpr)
4829 FinalExpr = getBitWidth();
4830 if (FinalExpr)
4831 return SourceRange(getInnerLocStart(), FinalExpr->getEndLoc());
4833}
4834
4836 assert((getParent()->isLambda() || getParent()->isCapturedRecord()) &&
4837 "capturing type in non-lambda or captured record.");
4838 assert(StorageKind == ISK_NoInit && !BitField &&
4839 "bit-field or field with default member initializer cannot capture "
4840 "VLA type");
4841 StorageKind = ISK_CapturedVLAType;
4842 CapturedVLAType = VLAType;
4843}
4844
4845void FieldDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
4846 // Print unnamed members using name of their type.
4848 this->getType().print(OS, Policy);
4849 return;
4850 }
4851 // Otherwise, do the normal printing.
4852 DeclaratorDecl::printName(OS, Policy);
4853}
4854
4856 const auto *CAT = getType()->getAs<CountAttributedType>();
4857 if (!CAT)
4858 return nullptr;
4859
4860 const auto *CountDRE = cast<DeclRefExpr>(CAT->getCountExpr());
4861 const auto *CountDecl = CountDRE->getDecl();
4862 if (const auto *IFD = dyn_cast<IndirectFieldDecl>(CountDecl))
4863 CountDecl = IFD->getAnonField();
4864
4865 return dyn_cast<FieldDecl>(CountDecl);
4866}
4867
4868//===----------------------------------------------------------------------===//
4869// TagDecl Implementation
4870//===----------------------------------------------------------------------===//
4871
4873 SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl,
4874 SourceLocation StartL)
4875 : TypeDecl(DK, DC, L, Id, StartL), DeclContext(DK), redeclarable_base(C),
4876 TypedefNameDeclOrQualifier((TypedefNameDecl *)nullptr) {
4877 assert((DK != Enum || TK == TagTypeKind::Enum) &&
4878 "EnumDecl not matched with TagTypeKind::Enum");
4879 setPreviousDecl(PrevDecl);
4880 setTagKind(TK);
4881 setCompleteDefinition(false);
4882 setBeingDefined(false);
4884 setFreeStanding(false);
4886 TagDeclBits.IsThisDeclarationADemotedDefinition = false;
4887}
4888
4892
4894 SourceLocation RBraceLoc = BraceRange.getEnd();
4895 SourceLocation E = RBraceLoc.isValid() ? RBraceLoc : getLocation();
4896 return SourceRange(getOuterLocStart(), E);
4897}
4898
4900
4902 TypedefNameDeclOrQualifier = TDD;
4903 assert(isLinkageValid());
4904}
4905
4907 setBeingDefined(true);
4908
4909 if (auto *D = dyn_cast<CXXRecordDecl>(this)) {
4910 struct CXXRecordDecl::DefinitionData *Data =
4911 new (getASTContext()) struct CXXRecordDecl::DefinitionData(D);
4912 for (auto *I : redecls())
4913 cast<CXXRecordDecl>(I)->DefinitionData = Data;
4914 }
4915}
4916
4918 assert((!isa<CXXRecordDecl>(this) ||
4920 "definition completed but not started");
4921
4923 setBeingDefined(false);
4924
4926 L->CompletedTagDefinition(this);
4927}
4928
4931 return const_cast<TagDecl *>(this);
4932
4933 if (const auto *CXXRD = dyn_cast<CXXRecordDecl>(this))
4934 return CXXRD->getDefinition();
4935
4936 for (TagDecl *R :
4938 if (R->isCompleteDefinition() || R->isBeingDefined())
4939 return R;
4940 return nullptr;
4941}
4942
4944 if (QualifierLoc) {
4945 // Make sure the extended qualifier info is allocated.
4946 if (!hasExtInfo())
4947 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
4948 // Set qualifier info.
4949 getExtInfo()->QualifierLoc = QualifierLoc;
4950 } else {
4951 // Here Qualifier == 0, i.e., we are removing the qualifier (if any).
4952 if (hasExtInfo()) {
4953 if (getExtInfo()->NumTemplParamLists == 0) {
4954 getASTContext().Deallocate(getExtInfo());
4955 TypedefNameDeclOrQualifier = (TypedefNameDecl *)nullptr;
4956 }
4957 else
4958 getExtInfo()->QualifierLoc = QualifierLoc;
4959 }
4960 }
4961}
4962
4963void TagDecl::printAnonymousTagDecl(llvm::raw_ostream &OS,
4964 const PrintingPolicy &Policy) const {
4966 assert(Typedef->getIdentifier() && "Typedef without identifier?");
4967 OS << Typedef->getIdentifier()->getName();
4968 return;
4969 }
4970
4971 bool SuppressTagKeywordInName = Policy.SuppressTagKeywordInAnonNames;
4972
4973 // Emit leading keyword. Since we printed a leading keyword make sure we
4974 // don't print the tag as part of the name too.
4975 if (!Policy.SuppressTagKeyword) {
4976 OS << getKindName() << ' ';
4977 SuppressTagKeywordInName = true;
4978 }
4979
4980 // Make an unambiguous representation for anonymous types, e.g.
4981 // (anonymous enum at /usr/include/string.h:120:9)
4982 OS << (Policy.MSVCFormatting ? '`' : '(');
4983
4984 if (isa<CXXRecordDecl>(this) && cast<CXXRecordDecl>(this)->isLambda()) {
4985 OS << "lambda";
4986 SuppressTagKeywordInName = true;
4987 } else if ((isa<RecordDecl>(this) &&
4988 cast<RecordDecl>(this)->isAnonymousStructOrUnion())) {
4989 OS << "anonymous";
4990 } else {
4991 OS << "unnamed";
4992 }
4993
4994 if (!SuppressTagKeywordInName)
4995 OS << ' ' << getKindName();
4996
4997 if (Policy.AnonymousTagLocations) {
4998 PresumedLoc PLoc =
5000 if (PLoc.isValid()) {
5001 OS << " at ";
5002 StringRef File = PLoc.getFilename();
5003 llvm::SmallString<1024> WrittenFile(File);
5004 if (auto *Callbacks = Policy.Callbacks)
5005 WrittenFile = Callbacks->remapPath(File);
5006 // Fix inconsistent path separator created by
5007 // clang::DirectoryLookup::LookupFile when the file path is relative
5008 // path.
5009 llvm::sys::path::Style Style =
5010 llvm::sys::path::is_absolute(WrittenFile)
5011 ? llvm::sys::path::Style::native
5012 : (Policy.MSVCFormatting
5013 ? llvm::sys::path::Style::windows_backslash
5014 : llvm::sys::path::Style::posix);
5015 llvm::sys::path::native(WrittenFile, Style);
5016 OS << WrittenFile << ':' << PLoc.getLine() << ':' << PLoc.getColumn();
5017 }
5018 }
5019
5020 OS << (Policy.MSVCFormatting ? '\'' : ')');
5021}
5022
5023void TagDecl::printName(raw_ostream &OS, const PrintingPolicy &Policy) const {
5025 // If the name is supposed to have an identifier but does not have one, then
5026 // the tag is anonymous and we should print it differently.
5027 if (Name.isIdentifier() && !Name.getAsIdentifierInfo()) {
5028 printAnonymousTagDecl(OS, Policy);
5029
5030 return;
5031 }
5032
5033 // Otherwise, do the normal printing.
5034 Name.print(OS, Policy);
5035}
5036
5039 assert(!TPLists.empty());
5040 // Make sure the extended decl info is allocated.
5041 if (!hasExtInfo())
5042 // Allocate external info struct.
5043 TypedefNameDeclOrQualifier = new (getASTContext()) ExtInfo;
5044 // Set the template parameter lists info.
5045 getExtInfo()->setTemplateParameterListsInfo(Context, TPLists);
5046}
5047
5048//===----------------------------------------------------------------------===//
5049// EnumDecl Implementation
5050//===----------------------------------------------------------------------===//
5051
5052EnumDecl::EnumDecl(ASTContext &C, DeclContext *DC, SourceLocation StartLoc,
5053 SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl,
5054 bool Scoped, bool ScopedUsingClassTag, bool Fixed)
5055 : TagDecl(Enum, TagTypeKind::Enum, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
5056 assert(Scoped || !ScopedUsingClassTag);
5057 IntegerType = nullptr;
5058 setNumPositiveBits(0);
5059 setNumNegativeBits(0);
5060 setScoped(Scoped);
5061 setScopedUsingClassTag(ScopedUsingClassTag);
5062 setFixed(Fixed);
5063 setHasODRHash(false);
5064 ODRHash = 0;
5065}
5066
5067void EnumDecl::anchor() {}
5068
5070 SourceLocation StartLoc, SourceLocation IdLoc,
5071 IdentifierInfo *Id,
5072 EnumDecl *PrevDecl, bool IsScoped,
5073 bool IsScopedUsingClassTag, bool IsFixed) {
5074 return new (C, DC) EnumDecl(C, DC, StartLoc, IdLoc, Id, PrevDecl, IsScoped,
5075 IsScopedUsingClassTag, IsFixed);
5076}
5077
5079 return new (C, ID) EnumDecl(C, nullptr, SourceLocation(), SourceLocation(),
5080 nullptr, nullptr, false, false, false);
5081}
5082
5084 if (const TypeSourceInfo *TI = getIntegerTypeSourceInfo())
5085 return TI->getTypeLoc().getSourceRange();
5086 return SourceRange();
5087}
5088
5090 QualType NewPromotionType,
5091 unsigned NumPositiveBits,
5092 unsigned NumNegativeBits) {
5093 assert(!isCompleteDefinition() && "Cannot redefine enums!");
5094 if (!IntegerType)
5095 IntegerType = NewType.getTypePtr();
5096 PromotionType = NewPromotionType;
5097 setNumPositiveBits(NumPositiveBits);
5098 setNumNegativeBits(NumNegativeBits);
5100}
5101
5103 if (const auto *A = getAttr<EnumExtensibilityAttr>())
5104 return A->getExtensibility() == EnumExtensibilityAttr::Closed;
5105 return true;
5106}
5107
5109 return isClosed() && hasAttr<FlagEnumAttr>();
5110}
5111
5113 return isClosed() && !hasAttr<FlagEnumAttr>();
5114}
5115
5118 return MSI->getTemplateSpecializationKind();
5119
5120 return TSK_Undeclared;
5121}
5122
5124 SourceLocation PointOfInstantiation) {
5126 assert(MSI && "Not an instantiated member enumeration?");
5128 if (TSK != TSK_ExplicitSpecialization &&
5129 PointOfInstantiation.isValid() &&
5131 MSI->setPointOfInstantiation(PointOfInstantiation);
5132}
5133
5136 if (isTemplateInstantiation(MSInfo->getTemplateSpecializationKind())) {
5137 EnumDecl *ED = getInstantiatedFromMemberEnum();
5138 while (auto *NewED = ED->getInstantiatedFromMemberEnum())
5139 ED = NewED;
5140 return ::getDefinitionOrSelf(ED);
5141 }
5142 }
5143
5145 "couldn't find pattern for enum instantiation");
5146 return nullptr;
5147}
5148
5150 if (SpecializationInfo)
5151 return cast<EnumDecl>(SpecializationInfo->getInstantiatedFrom());
5152
5153 return nullptr;
5154}
5155
5156void EnumDecl::setInstantiationOfMemberEnum(ASTContext &C, EnumDecl *ED,
5158 assert(!SpecializationInfo && "Member enum is already a specialization");
5159 SpecializationInfo = new (C) MemberSpecializationInfo(ED, TSK);
5160}
5161
5163 if (hasODRHash())
5164 return ODRHash;
5165
5166 class ODRHash Hash;
5167 Hash.AddEnumDecl(this);
5168 setHasODRHash(true);
5169 ODRHash = Hash.CalculateHash();
5170 return ODRHash;
5171}
5172
5174 auto Res = TagDecl::getSourceRange();
5175 // Set end-point to enum-base, e.g. enum foo : ^bar
5176 if (auto *TSI = getIntegerTypeSourceInfo()) {
5177 // TagDecl doesn't know about the enum base.
5178 if (!getBraceRange().getEnd().isValid())
5179 Res.setEnd(TSI->getTypeLoc().getEndLoc());
5180 }
5181 return Res;
5182}
5183
5184void EnumDecl::getValueRange(llvm::APInt &Max, llvm::APInt &Min) const {
5185 unsigned Bitwidth = getASTContext().getIntWidth(getIntegerType());
5186 unsigned NumNegativeBits = getNumNegativeBits();
5187 unsigned NumPositiveBits = getNumPositiveBits();
5188
5189 if (NumNegativeBits) {
5190 unsigned NumBits = std::max(NumNegativeBits, NumPositiveBits + 1);
5191 Max = llvm::APInt(Bitwidth, 1) << (NumBits - 1);
5192 Min = -Max;
5193 } else {
5194 Max = llvm::APInt(Bitwidth, 1) << NumPositiveBits;
5195 Min = llvm::APInt::getZero(Bitwidth);
5196 }
5197}
5198
5199//===----------------------------------------------------------------------===//
5200// RecordDecl Implementation
5201//===----------------------------------------------------------------------===//
5202
5204 DeclContext *DC, SourceLocation StartLoc,
5205 SourceLocation IdLoc, IdentifierInfo *Id,
5206 RecordDecl *PrevDecl)
5207 : TagDecl(DK, TK, C, DC, IdLoc, Id, PrevDecl, StartLoc) {
5208 assert(classof(static_cast<Decl *>(this)) && "Invalid Kind!");
5211 setHasObjectMember(false);
5212 setHasVolatileMember(false);
5223 setIsRandomized(false);
5224 setODRHash(0);
5225}
5226
5228 SourceLocation StartLoc, SourceLocation IdLoc,
5229 IdentifierInfo *Id, RecordDecl* PrevDecl) {
5230 return new (C, DC)
5231 RecordDecl(Record, TK, C, DC, StartLoc, IdLoc, Id, PrevDecl);
5232}
5233
5235 GlobalDeclID ID) {
5236 return new (C, ID)
5238 SourceLocation(), nullptr, nullptr);
5239}
5240
5242 if (auto RD = dyn_cast<CXXRecordDecl>(this))
5243 return RD->isLambda();
5244 return false;
5245}
5246
5250
5252 addAttr(CapturedRecordAttr::CreateImplicit(getASTContext()));
5253}
5254
5256 if (isUnion())
5257 return true;
5258
5259 if (const RecordDecl *Def = getDefinition()) {
5260 for (const FieldDecl *FD : Def->fields()) {
5261 const RecordType *RT = FD->getType()->getAsCanonical<RecordType>();
5262 if (RT && RT->getDecl()->isOrContainsUnion())
5263 return true;
5264 }
5265 }
5266
5267 return false;
5268}
5269
5272 LoadFieldsFromExternalStorage();
5273 // This is necessary for correctness for C++ with modules.
5274 // FIXME: Come up with a test case that breaks without definition.
5275 if (RecordDecl *D = getDefinition(); D && D != this)
5276 return D->field_begin();
5278}
5279
5283
5284/// completeDefinition - Notes that the definition of this type is now
5285/// complete.
5287 assert(!isCompleteDefinition() && "Cannot redefine record!");
5289
5290 ASTContext &Ctx = getASTContext();
5291
5292 // Layouts are dumped when computed, so if we are dumping for all complete
5293 // types, we need to force usage to get types that wouldn't be used elsewhere.
5294 //
5295 // If the type is dependent, then we can't compute its layout because there
5296 // is no way for us to know the size or alignment of a dependent type. Also
5297 // ignore declarations marked as invalid since 'getASTRecordLayout()' asserts
5298 // on that.
5299 if (Ctx.getLangOpts().DumpRecordLayoutsComplete && !isDependentType() &&
5300 !isInvalidDecl())
5301 (void)Ctx.getASTRecordLayout(this);
5302}
5303
5304/// isMsStruct - Get whether or not this record uses ms_struct layout.
5305/// This which can be turned on with an attribute, pragma, or the
5306/// -mms-bitfields command-line option.
5309 return false;
5311 return true;
5312 auto LayoutCompatibility = C.getLangOpts().getLayoutCompatibility();
5313 if (LayoutCompatibility == LangOptions::LayoutCompatibilityKind::Default)
5314 return C.defaultsToMsStruct();
5315 return LayoutCompatibility == LangOptions::LayoutCompatibilityKind::Microsoft;
5316}
5317
5319 std::tie(FirstDecl, LastDecl) = DeclContext::BuildDeclChain(Decls, false);
5320 LastDecl->NextInContextAndBits.setPointer(nullptr);
5321 setIsRandomized(true);
5322}
5323
5324void RecordDecl::LoadFieldsFromExternalStorage() const {
5326 assert(hasExternalLexicalStorage() && Source && "No external storage?");
5327
5328 // Notify that we have a RecordDecl doing some initialization.
5329 ExternalASTSource::Deserializing TheFields(Source);
5330
5333 Source->FindExternalLexicalDecls(this, [](Decl::Kind K) {
5335 }, Decls);
5336
5337#ifndef NDEBUG
5338 // Check that all decls we got were FieldDecls.
5339 for (unsigned i=0, e=Decls.size(); i != e; ++i)
5340 assert(isa<FieldDecl>(Decls[i]) || isa<IndirectFieldDecl>(Decls[i]));
5341#endif
5342
5343 if (Decls.empty())
5344 return;
5345
5346 auto [ExternalFirst, ExternalLast] =
5347 BuildDeclChain(Decls,
5348 /*FieldsAlreadyLoaded=*/false);
5349 ExternalLast->NextInContextAndBits.setPointer(FirstDecl);
5350 FirstDecl = ExternalFirst;
5351 if (!LastDecl)
5352 LastDecl = ExternalLast;
5353}
5354
5355bool RecordDecl::mayInsertExtraPadding(bool EmitRemark) const {
5356 ASTContext &Context = getASTContext();
5357 const SanitizerMask EnabledAsanMask = Context.getLangOpts().Sanitize.Mask &
5358 (SanitizerKind::Address | SanitizerKind::KernelAddress);
5359 if (!EnabledAsanMask || !Context.getLangOpts().SanitizeAddressFieldPadding)
5360 return false;
5361 const auto &NoSanitizeList = Context.getNoSanitizeList();
5362 const auto *CXXRD = dyn_cast<CXXRecordDecl>(this);
5363 // We may be able to relax some of these requirements.
5364 int ReasonToReject = -1;
5365 if (!CXXRD || CXXRD->isExternCContext())
5366 ReasonToReject = 0; // is not C++.
5367 else if (CXXRD->hasAttr<PackedAttr>())
5368 ReasonToReject = 1; // is packed.
5369 else if (CXXRD->isUnion())
5370 ReasonToReject = 2; // is a union.
5371 else if (CXXRD->isTriviallyCopyable())
5372 ReasonToReject = 3; // is trivially copyable.
5373 else if (CXXRD->hasTrivialDestructor())
5374 ReasonToReject = 4; // has trivial destructor.
5375 else if (CXXRD->isStandardLayout())
5376 ReasonToReject = 5; // is standard layout.
5377 else if (NoSanitizeList.containsLocation(EnabledAsanMask, getLocation(),
5378 "field-padding"))
5379 ReasonToReject = 6; // is in an excluded file.
5381 EnabledAsanMask, getQualifiedNameAsString(), "field-padding"))
5382 ReasonToReject = 7; // The type is excluded.
5383
5384 if (EmitRemark) {
5385 if (ReasonToReject >= 0)
5386 Context.getDiagnostics().Report(
5387 getLocation(),
5388 diag::remark_sanitize_address_insert_extra_padding_rejected)
5389 << getQualifiedNameAsString() << ReasonToReject;
5390 else
5391 Context.getDiagnostics().Report(
5392 getLocation(),
5393 diag::remark_sanitize_address_insert_extra_padding_accepted)
5395 }
5396 return ReasonToReject < 0;
5397}
5398
5400 for (const auto *I : fields()) {
5401 if (I->getIdentifier())
5402 return I;
5403
5404 if (const auto *RD = I->getType()->getAsRecordDecl())
5405 if (const FieldDecl *NamedDataMember = RD->findFirstNamedDataMember())
5406 return NamedDataMember;
5407 }
5408
5409 // We didn't find a named data member.
5410 return nullptr;
5411}
5412
5414 if (hasODRHash())
5415 return RecordDeclBits.ODRHash;
5416
5417 // Only calculate hash on first call of getODRHash per record.
5418 ODRHash Hash;
5419 Hash.AddRecordDecl(this);
5420 // For RecordDecl the ODRHash is stored in the remaining
5421 // bits of RecordDeclBits, adjust the hash to accommodate.
5422 static_assert(sizeof(Hash.CalculateHash()) * CHAR_BIT == 32);
5423 setODRHash(Hash.CalculateHash() >> (32 - NumOdrHashBits));
5424 return RecordDeclBits.ODRHash;
5425}
5426
5427//===----------------------------------------------------------------------===//
5428// BlockDecl Implementation
5429//===----------------------------------------------------------------------===//
5430
5432 : Decl(Block, DC, CaretLoc), DeclContext(Block) {
5433 setIsVariadic(false);
5434 setCapturesCXXThis(false);
5437 setDoesNotEscape(false);
5438 setCanAvoidCopyToHeap(false);
5439}
5440
5442 assert(!ParamInfo && "Already has param info!");
5443
5444 // Zero params -> null pointer.
5445 if (!NewParamInfo.empty()) {
5446 NumParams = NewParamInfo.size();
5447 ParamInfo = new (getASTContext()) ParmVarDecl*[NewParamInfo.size()];
5448 llvm::copy(NewParamInfo, ParamInfo);
5449 }
5450}
5451
5453 bool CapturesCXXThis) {
5454 this->setCapturesCXXThis(CapturesCXXThis);
5455 this->NumCaptures = Captures.size();
5456
5457 if (Captures.empty()) {
5458 this->Captures = nullptr;
5459 return;
5460 }
5461
5462 this->Captures = Captures.copy(Context).data();
5463}
5464
5465bool BlockDecl::capturesVariable(const VarDecl *variable) const {
5466 for (const auto &I : captures())
5467 // Only auto vars can be captured, so no redeclaration worries.
5468 if (I.getVariable() == variable)
5469 return true;
5470
5471 return false;
5472}
5473
5475 return SourceRange(getLocation(), Body ? Body->getEndLoc() : getLocation());
5476}
5477
5478//===----------------------------------------------------------------------===//
5479// Other Decl Allocation/Deallocation Method Implementations
5480//===----------------------------------------------------------------------===//
5481
5482void TranslationUnitDecl::anchor() {}
5483
5485 return new (C, (DeclContext *)nullptr) TranslationUnitDecl(C);
5486}
5487
5489 AnonymousNamespace = D;
5490
5491 if (ASTMutationListener *Listener = Ctx.getASTMutationListener())
5492 Listener->AddedAnonymousNamespace(this, D);
5493}
5494
5495void PragmaCommentDecl::anchor() {}
5496
5497PragmaCommentDecl *PragmaCommentDecl::Create(const ASTContext &C,
5499 SourceLocation CommentLoc,
5500 PragmaMSCommentKind CommentKind,
5501 StringRef Arg) {
5502 PragmaCommentDecl *PCD =
5503 new (C, DC, additionalSizeToAlloc<char>(Arg.size() + 1))
5504 PragmaCommentDecl(DC, CommentLoc, CommentKind);
5505 llvm::copy(Arg, PCD->getTrailingObjects());
5506 PCD->getTrailingObjects()[Arg.size()] = '\0';
5507 return PCD;
5508}
5509
5511 GlobalDeclID ID,
5512 unsigned ArgSize) {
5513 return new (C, ID, additionalSizeToAlloc<char>(ArgSize + 1))
5514 PragmaCommentDecl(nullptr, SourceLocation(), PCK_Unknown);
5515}
5516
5517void PragmaDetectMismatchDecl::anchor() {}
5518
5521 SourceLocation Loc, StringRef Name,
5522 StringRef Value) {
5523 size_t ValueStart = Name.size() + 1;
5524 PragmaDetectMismatchDecl *PDMD =
5525 new (C, DC, additionalSizeToAlloc<char>(ValueStart + Value.size() + 1))
5526 PragmaDetectMismatchDecl(DC, Loc, ValueStart);
5527 llvm::copy(Name, PDMD->getTrailingObjects());
5528 PDMD->getTrailingObjects()[Name.size()] = '\0';
5529 llvm::copy(Value, PDMD->getTrailingObjects() + ValueStart);
5530 PDMD->getTrailingObjects()[ValueStart + Value.size()] = '\0';
5531 return PDMD;
5532}
5533
5536 unsigned NameValueSize) {
5537 return new (C, ID, additionalSizeToAlloc<char>(NameValueSize + 1))
5538 PragmaDetectMismatchDecl(nullptr, SourceLocation(), 0);
5539}
5540
5541void ExternCContextDecl::anchor() {}
5542
5543ExternCContextDecl *ExternCContextDecl::Create(const ASTContext &C,
5544 TranslationUnitDecl *DC) {
5545 return new (C, DC) ExternCContextDecl(DC);
5546}
5547
5548void LabelDecl::anchor() {}
5549
5551 SourceLocation IdentL, IdentifierInfo *II) {
5552 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, IdentL);
5553}
5554
5556 SourceLocation IdentL, IdentifierInfo *II,
5557 SourceLocation GnuLabelL) {
5558 assert(GnuLabelL != IdentL && "Use this only for GNU local labels");
5559 return new (C, DC) LabelDecl(DC, IdentL, II, nullptr, GnuLabelL);
5560}
5561
5563 return new (C, ID) LabelDecl(nullptr, SourceLocation(), nullptr, nullptr,
5564 SourceLocation());
5565}
5566
5567void LabelDecl::setMSAsmLabel(StringRef Name) {
5568char *Buffer = new (getASTContext(), 1) char[Name.size() + 1];
5569llvm::copy(Name, Buffer);
5570Buffer[Name.size()] = '\0';
5571MSAsmName = Buffer;
5572}
5573
5574void ValueDecl::anchor() {}
5575
5576bool ValueDecl::isWeak() const {
5577 auto *MostRecent = getMostRecentDecl();
5578 return MostRecent->hasAttr<WeakAttr>() ||
5579 MostRecent->hasAttr<WeakRefAttr>() || isWeakImported();
5580}
5581
5583 if (auto *Var = llvm::dyn_cast<VarDecl>(this))
5584 return Var->isInitCapture();
5585 return false;
5586}
5587
5589 if (const auto *NTTP = dyn_cast<NonTypeTemplateParmDecl>(this))
5590 return NTTP->isParameterPack();
5591
5592 return isa_and_nonnull<PackExpansionType>(getType().getTypePtrOrNull());
5593}
5594
5595void ImplicitParamDecl::anchor() {}
5596
5598 SourceLocation IdLoc,
5600 ImplicitParamKind ParamKind) {
5601 return new (C, DC) ImplicitParamDecl(C, DC, IdLoc, Id, Type, ParamKind);
5602}
5603
5605 ImplicitParamKind ParamKind) {
5606 return new (C, nullptr) ImplicitParamDecl(C, Type, ParamKind);
5607}
5608
5613
5616 const DeclarationNameInfo &NameInfo, QualType T,
5617 TypeSourceInfo *TInfo, StorageClass SC, bool UsesFPIntrin,
5619 ConstexprSpecKind ConstexprKind,
5620 const AssociatedConstraint &TrailingRequiresClause) {
5621 FunctionDecl *New = new (C, DC) FunctionDecl(
5622 Function, C, DC, StartLoc, NameInfo, T, TInfo, SC, UsesFPIntrin,
5623 isInlineSpecified, ConstexprKind, TrailingRequiresClause);
5624 New->setHasWrittenPrototype(hasWrittenPrototype);
5625 return New;
5626}
5627
5629 return new (C, ID) FunctionDecl(
5631 nullptr, SC_None, false, false, ConstexprSpecKind::Unspecified,
5632 /*TrailingRequiresClause=*/{});
5633}
5634
5636 return hasAttr<CUDAGlobalAttr>() ||
5637 DeviceKernelAttr::isOpenCLSpelling(getAttr<DeviceKernelAttr>());
5638}
5639
5641 return new (C, DC) BlockDecl(DC, L);
5642}
5643
5647
5648OutlinedFunctionDecl::OutlinedFunctionDecl(DeclContext *DC, unsigned NumParams)
5649 : Decl(OutlinedFunction, DC, SourceLocation()),
5650 DeclContext(OutlinedFunction), NumParams(NumParams),
5651 BodyAndNothrow(nullptr, false) {}
5652
5654 DeclContext *DC,
5655 unsigned NumParams) {
5656 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5657 OutlinedFunctionDecl(DC, NumParams);
5658}
5659
5662 unsigned NumParams) {
5663 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5664 OutlinedFunctionDecl(nullptr, NumParams);
5665}
5666
5668 return BodyAndNothrow.getPointer();
5669}
5670void OutlinedFunctionDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5671
5672bool OutlinedFunctionDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5674 BodyAndNothrow.setInt(Nothrow);
5675}
5676
5677CapturedDecl::CapturedDecl(DeclContext *DC, unsigned NumParams)
5678 : Decl(Captured, DC, SourceLocation()), DeclContext(Captured),
5679 NumParams(NumParams), ContextParam(0), BodyAndNothrow(nullptr, false) {}
5680
5682 unsigned NumParams) {
5683 return new (C, DC, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5684 CapturedDecl(DC, NumParams);
5685}
5686
5688 unsigned NumParams) {
5689 return new (C, ID, additionalSizeToAlloc<ImplicitParamDecl *>(NumParams))
5690 CapturedDecl(nullptr, NumParams);
5691}
5692
5693Stmt *CapturedDecl::getBody() const { return BodyAndNothrow.getPointer(); }
5694void CapturedDecl::setBody(Stmt *B) { BodyAndNothrow.setPointer(B); }
5695
5696bool CapturedDecl::isNothrow() const { return BodyAndNothrow.getInt(); }
5697void CapturedDecl::setNothrow(bool Nothrow) { BodyAndNothrow.setInt(Nothrow); }
5698
5701 QualType T, Expr *E, const llvm::APSInt &V)
5702 : ValueDecl(EnumConstant, DC, L, Id, T), Init((Stmt *)E) {
5703 setInitVal(C, V);
5704}
5705
5709 Expr *E, const llvm::APSInt &V) {
5710 return new (C, CD) EnumConstantDecl(C, CD, L, Id, T, E, V);
5711}
5712
5714 GlobalDeclID ID) {
5715 return new (C, ID) EnumConstantDecl(C, nullptr, SourceLocation(), nullptr,
5716 QualType(), nullptr, llvm::APSInt());
5717}
5718
5719void IndirectFieldDecl::anchor() {}
5720
5721IndirectFieldDecl::IndirectFieldDecl(ASTContext &C, DeclContext *DC,
5723 QualType T,
5725 : ValueDecl(IndirectField, DC, L, N, T), Chaining(CH.data()),
5726 ChainingSize(CH.size()) {
5727 // In C++, indirect field declarations conflict with tag declarations in the
5728 // same scope, so add them to IDNS_Tag so that tag redeclaration finds them.
5729 if (C.getLangOpts().CPlusPlus)
5731}
5732
5735 const IdentifierInfo *Id,
5736 QualType T,
5738 return new (C, DC) IndirectFieldDecl(C, DC, L, Id, T, CH);
5739}
5740
5742 GlobalDeclID ID) {
5743 return new (C, ID) IndirectFieldDecl(C, nullptr, SourceLocation(),
5744 DeclarationName(), QualType(), {});
5745}
5746
5749 if (Init)
5750 End = Init->getEndLoc();
5751 return SourceRange(getLocation(), End);
5752}
5753
5754void TypeDecl::anchor() {}
5755
5757 SourceLocation StartLoc, SourceLocation IdLoc,
5758 const IdentifierInfo *Id,
5759 TypeSourceInfo *TInfo) {
5760 return new (C, DC) TypedefDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5761}
5762
5763void TypedefNameDecl::anchor() {}
5764
5766 if (auto *TT = getTypeSourceInfo()->getType()->getAs<TagType>()) {
5767 auto *OwningTypedef = TT->getDecl()->getTypedefNameForAnonDecl();
5768 auto *ThisTypedef = this;
5769 if (AnyRedecl && OwningTypedef) {
5770 OwningTypedef = OwningTypedef->getCanonicalDecl();
5771 ThisTypedef = ThisTypedef->getCanonicalDecl();
5772 }
5773 if (OwningTypedef == ThisTypedef)
5774 return TT->getDecl()->getDefinitionOrSelf();
5775 }
5776
5777 return nullptr;
5778}
5779
5780bool TypedefNameDecl::isTransparentTagSlow() const {
5781 auto determineIsTransparent = [&]() {
5782 if (auto *TT = getUnderlyingType()->getAs<TagType>()) {
5783 if (auto *TD = TT->getDecl()) {
5784 if (TD->getName() != getName())
5785 return false;
5786 SourceLocation TTLoc = getLocation();
5787 SourceLocation TDLoc = TD->getLocation();
5788 if (!TTLoc.isMacroID() || !TDLoc.isMacroID())
5789 return false;
5791 return SM.getSpellingLoc(TTLoc) == SM.getSpellingLoc(TDLoc);
5792 }
5793 }
5794 return false;
5795 };
5796
5797 bool isTransparent = determineIsTransparent();
5798 MaybeModedTInfo.setInt((isTransparent << 1) | 1);
5799 return isTransparent;
5800}
5801
5803 return new (C, ID) TypedefDecl(C, nullptr, SourceLocation(), SourceLocation(),
5804 nullptr, nullptr);
5805}
5806
5808 SourceLocation StartLoc,
5809 SourceLocation IdLoc,
5810 const IdentifierInfo *Id,
5811 TypeSourceInfo *TInfo) {
5812 return new (C, DC) TypeAliasDecl(C, DC, StartLoc, IdLoc, Id, TInfo);
5813}
5814
5816 GlobalDeclID ID) {
5817 return new (C, ID) TypeAliasDecl(C, nullptr, SourceLocation(),
5818 SourceLocation(), nullptr, nullptr);
5819}
5820
5822 SourceLocation RangeEnd = getLocation();
5823 if (TypeSourceInfo *TInfo = getTypeSourceInfo()) {
5824 if (typeIsPostfix(TInfo->getType()))
5825 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5826 }
5827 return SourceRange(getBeginLoc(), RangeEnd);
5828}
5829
5831 SourceLocation RangeEnd = getBeginLoc();
5832 if (TypeSourceInfo *TInfo = getTypeSourceInfo())
5833 RangeEnd = TInfo->getTypeLoc().getSourceRange().getEnd();
5834 return SourceRange(getBeginLoc(), RangeEnd);
5835}
5836
5837void FileScopeAsmDecl::anchor() {}
5838
5840 Expr *Str, SourceLocation AsmLoc,
5841 SourceLocation RParenLoc) {
5842 return new (C, DC) FileScopeAsmDecl(DC, Str, AsmLoc, RParenLoc);
5843}
5844
5846 GlobalDeclID ID) {
5847 return new (C, ID) FileScopeAsmDecl(nullptr, nullptr, SourceLocation(),
5848 SourceLocation());
5849}
5850
5854
5855void TopLevelStmtDecl::anchor() {}
5856
5857TopLevelStmtDecl *TopLevelStmtDecl::Create(ASTContext &C, Stmt *Statement) {
5858 assert(C.getLangOpts().IncrementalExtensions &&
5859 "Must be used only in incremental mode");
5860
5861 SourceLocation Loc = Statement ? Statement->getBeginLoc() : SourceLocation();
5862 DeclContext *DC = C.getTranslationUnitDecl();
5863
5864 return new (C, DC) TopLevelStmtDecl(DC, Loc, Statement);
5865}
5866
5868 GlobalDeclID ID) {
5869 return new (C, ID)
5870 TopLevelStmtDecl(/*DC=*/nullptr, SourceLocation(), /*S=*/nullptr);
5871}
5872
5874 return SourceRange(getLocation(), Statement->getEndLoc());
5875}
5876
5878 assert(S);
5879 Statement = S;
5880 setLocation(Statement->getBeginLoc());
5881}
5882
5883void EmptyDecl::anchor() {}
5884
5886 return new (C, DC) EmptyDecl(DC, L);
5887}
5888
5890 return new (C, ID) EmptyDecl(nullptr, SourceLocation());
5891}
5892
5893HLSLBufferDecl::HLSLBufferDecl(DeclContext *DC, bool CBuffer,
5894 SourceLocation KwLoc, IdentifierInfo *ID,
5895 SourceLocation IDLoc, SourceLocation LBrace)
5896 : NamedDecl(Decl::Kind::HLSLBuffer, DC, IDLoc, DeclarationName(ID)),
5897 DeclContext(Decl::Kind::HLSLBuffer), LBraceLoc(LBrace), KwLoc(KwLoc),
5898 IsCBuffer(CBuffer), HasValidPackoffset(false), LayoutStruct(nullptr) {}
5899
5901 DeclContext *LexicalParent, bool CBuffer,
5902 SourceLocation KwLoc, IdentifierInfo *ID,
5903 SourceLocation IDLoc,
5904 SourceLocation LBrace) {
5905 // For hlsl like this
5906 // cbuffer A {
5907 // cbuffer B {
5908 // }
5909 // }
5910 // compiler should treat it as
5911 // cbuffer A {
5912 // }
5913 // cbuffer B {
5914 // }
5915 // FIXME: support nested buffers if required for back-compat.
5916 DeclContext *DC = LexicalParent;
5917 HLSLBufferDecl *Result =
5918 new (C, DC) HLSLBufferDecl(DC, CBuffer, KwLoc, ID, IDLoc, LBrace);
5919 return Result;
5920}
5921
5924 ArrayRef<Decl *> DefaultCBufferDecls) {
5925 DeclContext *DC = LexicalParent;
5926 IdentifierInfo *II = &C.Idents.get("$Globals", tok::TokenKind::identifier);
5927 HLSLBufferDecl *Result = new (C, DC) HLSLBufferDecl(
5928 DC, true, SourceLocation(), II, SourceLocation(), SourceLocation());
5929 Result->setImplicit(true);
5930 Result->setDefaultBufferDecls(DefaultCBufferDecls);
5931 return Result;
5932}
5933
5935 GlobalDeclID ID) {
5936 return new (C, ID) HLSLBufferDecl(nullptr, false, SourceLocation(), nullptr,
5938}
5939
5941 assert(LayoutStruct == nullptr && "layout struct has already been set");
5942 LayoutStruct = LS;
5943 addDecl(LS);
5944}
5945
5946void HLSLBufferDecl::setDefaultBufferDecls(ArrayRef<Decl *> Decls) {
5947 assert(!Decls.empty());
5948 assert(DefaultBufferDecls.empty() && "default decls are already set");
5949 assert(isImplicit() &&
5950 "default decls can only be added to the implicit/default constant "
5951 "buffer $Globals");
5952
5953 // allocate array for default decls with ASTContext allocator
5954 Decl **DeclsArray = new (getASTContext()) Decl *[Decls.size()];
5955 llvm::copy(Decls, DeclsArray);
5956 DefaultBufferDecls = ArrayRef<Decl *>(DeclsArray, Decls.size());
5957}
5958
5961 return buffer_decl_iterator(llvm::iterator_range(DefaultBufferDecls.begin(),
5962 DefaultBufferDecls.end()),
5964}
5965
5967 return buffer_decl_iterator(
5968 llvm::iterator_range(DefaultBufferDecls.end(), DefaultBufferDecls.end()),
5970}
5971
5973 return DefaultBufferDecls.empty() && decls_empty();
5974}
5975
5976//===----------------------------------------------------------------------===//
5977// HLSLRootSignatureDecl Implementation
5978//===----------------------------------------------------------------------===//
5979
5980HLSLRootSignatureDecl::HLSLRootSignatureDecl(
5982 llvm::dxbc::RootSignatureVersion Version, unsigned NumElems)
5983 : NamedDecl(Decl::Kind::HLSLRootSignature, DC, Loc, DeclarationName(ID)),
5984 Version(Version), NumElems(NumElems) {}
5985
5986HLSLRootSignatureDecl *HLSLRootSignatureDecl::Create(
5988 llvm::dxbc::RootSignatureVersion Version,
5990 HLSLRootSignatureDecl *RSDecl =
5991 new (C, DC,
5992 additionalSizeToAlloc<llvm::hlsl::rootsig::RootElement>(
5993 RootElements.size()))
5994 HLSLRootSignatureDecl(DC, Loc, ID, Version, RootElements.size());
5995 auto *StoredElems = RSDecl->getElems();
5996 llvm::uninitialized_copy(RootElements, StoredElems);
5997 return RSDecl;
5998}
5999
6002 HLSLRootSignatureDecl *Result = new (C, ID)
6003 HLSLRootSignatureDecl(nullptr, SourceLocation(), nullptr,
6004 /*Version*/ llvm::dxbc::RootSignatureVersion::V1_1,
6005 /*NumElems=*/0);
6006 return Result;
6007}
6008
6009//===----------------------------------------------------------------------===//
6010// ImportDecl Implementation
6011//===----------------------------------------------------------------------===//
6012
6013/// Retrieve the number of module identifiers needed to name the given
6014/// module.
6015static unsigned getNumModuleIdentifiers(Module *Mod) {
6016 unsigned Result = 1;
6017 while (Mod->Parent) {
6018 Mod = Mod->Parent;
6019 ++Result;
6020 }
6021 return Result;
6022}
6023
6024ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
6025 Module *Imported,
6026 ArrayRef<SourceLocation> IdentifierLocs)
6027 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
6028 NextLocalImportAndComplete(nullptr, true) {
6029 assert(getNumModuleIdentifiers(Imported) == IdentifierLocs.size());
6030 auto *StoredLocs = getTrailingObjects();
6031 llvm::uninitialized_copy(IdentifierLocs, StoredLocs);
6032}
6033
6034ImportDecl::ImportDecl(DeclContext *DC, SourceLocation StartLoc,
6035 Module *Imported, SourceLocation EndLoc)
6036 : Decl(Import, DC, StartLoc), ImportedModule(Imported),
6037 NextLocalImportAndComplete(nullptr, false) {
6038 *getTrailingObjects() = EndLoc;
6039}
6040
6042 SourceLocation StartLoc, Module *Imported,
6043 ArrayRef<SourceLocation> IdentifierLocs) {
6044 return new (C, DC,
6045 additionalSizeToAlloc<SourceLocation>(IdentifierLocs.size()))
6046 ImportDecl(DC, StartLoc, Imported, IdentifierLocs);
6047}
6048
6050 SourceLocation StartLoc,
6051 Module *Imported,
6052 SourceLocation EndLoc) {
6053 ImportDecl *Import = new (C, DC, additionalSizeToAlloc<SourceLocation>(1))
6054 ImportDecl(DC, StartLoc, Imported, EndLoc);
6055 Import->setImplicit();
6056 return Import;
6057}
6058
6060 unsigned NumLocations) {
6061 return new (C, ID, additionalSizeToAlloc<SourceLocation>(NumLocations))
6062 ImportDecl(EmptyShell());
6063}
6064
6066 if (!isImportComplete())
6067 return {};
6068
6069 return getTrailingObjects(getNumModuleIdentifiers(getImportedModule()));
6070}
6071
6073 if (!isImportComplete())
6074 return SourceRange(getLocation(), *getTrailingObjects());
6075
6076 return SourceRange(getLocation(), getIdentifierLocs().back());
6077}
6078
6079//===----------------------------------------------------------------------===//
6080// ExportDecl Implementation
6081//===----------------------------------------------------------------------===//
6082
6083void ExportDecl::anchor() {}
6084
6086 SourceLocation ExportLoc) {
6087 return new (C, DC) ExportDecl(DC, ExportLoc);
6088}
6089
6091 return new (C, ID) ExportDecl(nullptr, SourceLocation());
6092}
6093
6095 bool IncludeLocallyStreaming) {
6096 if (IncludeLocallyStreaming)
6097 if (FD->hasAttr<ArmLocallyStreamingAttr>())
6098 return true;
6099
6100 assert(!FD->getType().isNull() && "Expected a valid FunctionDecl");
6101 if (const auto *FPT = FD->getType()->getAs<FunctionProtoType>())
6102 if (FPT->getAArch64SMEAttributes() & FunctionType::SME_PStateSMEnabledMask)
6103 return true;
6104
6105 return false;
6106}
6107
6109 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6110 return (T && FunctionType::getArmZAState(T->getAArch64SMEAttributes()) !=
6112 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZA());
6113}
6114
6116 const auto *T = FD->getType()->getAs<FunctionProtoType>();
6117 return (T && FunctionType::getArmZT0State(T->getAArch64SMEAttributes()) !=
6119 (FD->hasAttr<ArmNewAttr>() && FD->getAttr<ArmNewAttr>()->isNewZT0());
6120}
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:1854
static bool isDeclExternC(const T &D)
Definition Decl.cpp:2240
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:3919
static bool isExportedFromModuleInterfaceUnit(const NamedDecl *D)
Definition Decl.cpp:1190
static bool isRedeclarable(Decl::Kind K)
Definition Decl.cpp:1858
static bool redeclForcesDefMSVC(const FunctionDecl *Redecl)
Definition Decl.cpp:3907
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:2213
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:6015
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:2702
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:2067
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:1993
static bool isNamed(const NamedDecl *ND, const char(&Str)[Len])
Definition Decl.cpp:3306
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:851
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:870
const LangOptions & getLangOpts() const
Definition ASTContext.h:944
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:909
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:5431
void setParams(ArrayRef< ParmVarDecl * > NewParamInfo)
Definition Decl.cpp:5441
void setDoesNotEscape(bool B=true)
Definition Decl.h:4823
void setCapturesCXXThis(bool B=true)
Definition Decl.h:4804
void setCanAvoidCopyToHeap(bool B=true)
Definition Decl.h:4828
void setIsConversionFromLambda(bool val=true)
Definition Decl.h:4818
void setBlockMissingReturnType(bool val=true)
Definition Decl.h:4810
ArrayRef< Capture > captures() const
Definition Decl.h:4798
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5474
static BlockDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5644
void setIsVariadic(bool value)
Definition Decl.h:4747
bool capturesVariable(const VarDecl *var) const
Definition Decl.cpp:5465
void setCaptures(ASTContext &Context, ArrayRef< Capture > Captures, bool CapturesCXXThis)
Definition Decl.cpp:5452
static BlockDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5640
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:5694
static CapturedDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5687
bool isNothrow() const
Definition Decl.cpp:5696
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5697
static CapturedDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5681
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:5693
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:3831
Represents a sugar type with __counted_by or __sized_by annotations, including their _or_null variant...
Definition TypeBase.h:3437
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:2005
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:2061
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2101
SourceLocation getTypeSpecStartLoc() const
Definition Decl.cpp:1999
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:2011
void setTrailingRequiresClause(const AssociatedConstraint &AC)
Definition Decl.cpp:2030
TypeSourceInfo * getTypeSourceInfo() const
Definition Decl.h:809
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:2045
Provides information about a dependent function-template specialization declaration.
static DependentFunctionTemplateSpecializationInfo * Create(ASTContext &Context, const UnresolvedSetImpl &Candidates, const TemplateArgumentListInfo *TemplateArgs)
Definition Decl.cpp:4395
static EmptyDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L)
Definition Decl.cpp:5885
static EmptyDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5889
EnumConstantDecl(const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, QualType T, Expr *E, const llvm::APSInt &V)
Definition Decl.cpp:5699
static EnumConstantDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5713
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:5706
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5747
Represents an enum.
Definition Decl.h:4010
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this enumeration is an instantiation of a member enumeration of a class template specialization,...
Definition Decl.h:4282
unsigned getNumNegativeBits() const
Returns the width in bits required to store all the negative enumerators of this enum.
Definition Decl.h:4220
unsigned getODRHash()
Definition Decl.cpp:5162
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:5123
static EnumDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, EnumDecl *PrevDecl, bool IsScoped, bool IsScopedUsingClassTag, bool IsFixed)
Definition Decl.cpp:5069
TypeSourceInfo * getIntegerTypeSourceInfo() const
Return the type source info for the underlying integer type, if no type source info exists,...
Definition Decl.h:4199
static EnumDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5078
bool isClosedFlag() const
Returns true if this enum is annotated with flag_enum and isn't annotated with enum_extensibility(ope...
Definition Decl.cpp:5108
SourceRange getIntegerTypeRange() const LLVM_READONLY
Retrieve the source range that covers the underlying type if specified.
Definition Decl.cpp:5083
SourceRange getSourceRange() const override LLVM_READONLY
Overrides to provide correct range when there's an enum-base specifier with forward declarations.
Definition Decl.cpp:5173
QualType getIntegerType() const
Return the integer type this enum decl corresponds to.
Definition Decl.h:4183
EnumDecl * getInstantiatedFromMemberEnum() const
Returns the enumeration (declared within the template) from which this enumeration type was instantia...
Definition Decl.cpp:5149
unsigned getNumPositiveBits() const
Returns the width in bits required to store all the non-negative enumerators of this enum.
Definition Decl.h:4209
TemplateSpecializationKind getTemplateSpecializationKind() const
If this enumeration is a member of a specialization of a templated class, determine what kind of temp...
Definition Decl.cpp:5116
bool isClosed() const
Returns true if this enum is either annotated with enum_extensibility(closed) or isn't annotated with...
Definition Decl.cpp:5102
EnumDecl * getTemplateInstantiationPattern() const
Retrieve the enum definition from which this enumeration could be instantiated, if it is an instantia...
Definition Decl.cpp:5134
bool isClosedNonFlag() const
Returns true if this enum is annotated with neither flag_enum nor enum_extensibility(open).
Definition Decl.cpp:5112
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:5184
static ExportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation ExportLoc)
Definition Decl.cpp:6085
static ExportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:6090
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:3669
QualType getType() const
Definition Expr.h:144
static ExternCContextDecl * Create(const ASTContext &C, TranslationUnitDecl *TU)
Definition Decl.cpp:5543
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:4725
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:4752
bool isAnonymousStructOrUnion() const
Determines whether this field is a representative for an anonymous struct or union.
Definition Decl.cpp:4715
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4826
bool hasConstantIntegerBitWidth() const
Determines whether the bit width of this field is a constant integer.
Definition Decl.cpp:4747
static FieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:4709
void setInClassInitializer(Expr *NewInit)
Set the C++11 in-class initializer for this member.
Definition Decl.cpp:4735
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:4766
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:4700
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:4761
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:4845
const FieldDecl * findCountedByField() const
Find the FieldDecl specified in a FAM's "counted_by" attribute.
Definition Decl.cpp:4855
bool isPotentiallyOverlapping() const
Determine if this field is of potentially-overlapping class type, that is, subobject with the [[no_un...
Definition Decl.cpp:4804
void setCapturedVLAType(const VariableArrayType *VLAType)
Set the captured variable length array type for this field.
Definition Decl.cpp:4835
const VariableArrayType * CapturedVLAType
Definition Decl.h:3216
std::string getAsmString() const
Definition Decl.cpp:5851
const Expr * getAsmStringExpr() const
Definition Decl.h:4619
static FileScopeAsmDecl * Create(ASTContext &C, DeclContext *DC, Expr *Str, SourceLocation AsmLoc, SourceLocation RParenLoc)
Definition Decl.cpp:5839
static FileScopeAsmDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5845
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:3140
void setDeletedMessage(StringLiteral *Message)
Definition Decl.cpp:3182
Represents a function declaration or definition.
Definition Decl.h:2000
unsigned getMemoryFunctionKind() const
Identify a memory copying or setting function.
Definition Decl.cpp:4553
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:3724
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:3210
DefaultedOrDeletedFunctionInfo * getDefaultedOrDeletedInfo() const
Definition Decl.cpp:3194
unsigned getMinRequiredArguments() const
Returns the minimum number of arguments needed to call this function.
Definition Decl.cpp:3847
bool isFunctionTemplateSpecialization() const
Determine whether this function is a function template specialization.
Definition Decl.cpp:4205
void setPreviousDeclaration(FunctionDecl *PrevDecl)
Definition Decl.cpp:3733
void setDescribedFunctionTemplate(FunctionTemplateDecl *Template)
Definition Decl.cpp:4198
FunctionTemplateDecl * getDescribedFunctionTemplate() const
Retrieves the function template that is described by this function declaration.
Definition Decl.cpp:4193
void setIsPureVirtual(bool P=true)
Definition Decl.cpp:3298
bool isImmediateFunction() const
Definition Decl.cpp:3340
void setDefaultedOrDeletedInfo(DefaultedOrDeletedFunctionInfo *Info)
Definition Decl.cpp:3160
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:4024
bool isDestroyingOperatorDelete() const
Determine whether this is a destroying operator delete.
Definition Decl.cpp:3551
static FunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5628
unsigned getBuiltinID(bool ConsiderWrapperFunctions=false) const
Returns a value indicating whether this function corresponds to a builtin function.
Definition Decl.cpp:3762
SourceLocation getPointOfInstantiation() const
Retrieve the (first) point of instantiation of a function template specialization or a member of a cl...
Definition Decl.cpp:4514
bool isMemberLikeConstrainedFriend() const
Determine whether a function is a friend function that cannot be redeclared outside of its class,...
Definition Decl.cpp:3666
bool hasCXXExplicitFunctionObjectParameter() const
Definition Decl.cpp:3865
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:3651
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:3706
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:4264
bool isMSExternInline() const
The combination of the extern and inline keywords under MSVC forces the function to be required.
Definition Decl.cpp:3891
unsigned getMinRequiredExplicitArguments() const
Returns the minimum number of non-object arguments needed to call this function.
Definition Decl.cpp:3874
bool BodyContainsImmediateEscalatingExpressions() const
Definition Decl.h:2490
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:3614
FunctionTemplateDecl * getPrimaryTemplate() const
Retrieve the primary template that this function template specialization either specializes or was in...
Definition Decl.cpp:4313
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:4172
FunctionTemplateSpecializationInfo * getTemplateSpecializationInfo() const
If this function is actually a function template specialization, retrieve information about this func...
Definition Decl.cpp:4323
FunctionDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:3747
FunctionTypeLoc getFunctionTypeLoc() const
Find the source location information for how the type of this function was written.
Definition Decl.cpp:4001
bool isVariadic() const
Whether this function is variadic.
Definition Decl.cpp:3133
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:4389
const TemplateArgumentList * getTemplateSpecializationArgs() const
Retrieve the template arguments used to produce this function template specialization from the primar...
Definition Decl.cpp:4329
SourceRange getExceptionSpecSourceRange() const
Attempt to compute an informative source range covering the function exception specification,...
Definition Decl.cpp:4056
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:3375
unsigned getODRHash()
Returns ODRHash of the function.
Definition Decl.cpp:4679
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Determine the kind of template specialization this function represents for the purpose of template in...
Definition Decl.cpp:4441
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:3079
bool isTemplateInstantiation() const
Determines if the given function was instantiated from a function template.
Definition Decl.cpp:4257
unsigned getNumNonObjectParams() const
Definition Decl.cpp:3869
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:3567
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:4526
bool isInlineBuiltinDeclaration() const
Determine if this function provides an inline implementation of a builtin.
Definition Decl.cpp:3526
bool FriendConstraintRefersToEnclosingTemplate() const
Definition Decl.h:2707
TemplatedKind getTemplatedKind() const
What kind of templated function this is.
Definition Decl.cpp:4144
void setInstantiatedFromDecl(FunctionDecl *FD)
Specify that this function declaration was instantiated from a FunctionDecl FD.
Definition Decl.cpp:4211
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:3403
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:4378
bool isInExternCContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:3622
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:4222
bool isExternC() const
Determines whether this function is a function with external, C linkage.
Definition Decl.cpp:3618
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:3311
void setIsDestroyingOperatorDelete(bool IsDestroyingDelete)
Definition Decl.cpp:3555
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:3426
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:3559
bool isInExternCXXContext() const
Determines whether this function's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:3628
bool isMain() const
Determines whether this function is "main", which is the entry point into an executable program.
Definition Decl.cpp:3368
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:3728
void setIsTypeAwareOperatorNewOrDelete(bool IsTypeAwareOperator=true)
Definition Decl.cpp:3563
bool isThisDeclarationInstantiatedFromAFriendDefinition() const
Determine whether this specific declaration of the function is a friend declaration that was instanti...
Definition Decl.cpp:3223
bool isCPUDispatchMultiVersion() const
True if this function is a multiversioned dispatch function as a part of the cpu_specific/cpu_dispatc...
Definition Decl.cpp:3702
bool isDefaulted() const
Whether this function is defaulted.
Definition Decl.h:2385
bool isReferenceableKernel() const
Definition Decl.cpp:5635
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4549
FunctionDecl * getInstantiatedFromDecl() const
Definition Decl.cpp:4217
void setTemplateSpecializationKind(TemplateSpecializationKind TSK, SourceLocation PointOfInstantiation=SourceLocation())
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4486
const IdentifierInfo * getLiteralIdentifier() const
getLiteralIdentifier - The literal suffix identifier this function represents, if any.
Definition Decl.cpp:4138
OverloadedOperatorKind getOverloadedOperator() const
getOverloadedOperator - Which C++ overloaded operator this function represents, if any.
Definition Decl.cpp:4130
TemplateSpecializationKind getTemplateSpecializationKind() const
Determine what kind of template instantiation this function represents.
Definition Decl.cpp:4417
bool doesDeclarationForceExternallyVisibleDefinition() const
For a function declaration in C or C++, determine whether this declaration causes the definition to b...
Definition Decl.cpp:3941
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:3710
bool isAnalyzerNoReturn() const
Determines whether this function is known to be 'noreturn' for analyzer, through an analyzer_noreturn...
Definition Decl.cpp:3662
void setBody(Stmt *B)
Definition Decl.cpp:3291
bool isGlobal() const
Determines whether this is a global function.
Definition Decl.cpp:3632
bool hasOneParamOrDefaultArgs() const
Determine whether this function has a single parameter, or multiple parameters where all but the firs...
Definition Decl.cpp:3879
void setDeletedAsWritten(bool D=true, StringLiteral *Message=nullptr)
Definition Decl.cpp:3169
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:3715
FunctionDecl * getInstantiatedFromMemberFunction() const
If this function is an instantiation of a member function of a class template specialization,...
Definition Decl.cpp:4165
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:4078
unsigned getNumParams() const
Return the number of parameters this function must have based on its FunctionType.
Definition Decl.cpp:3826
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:3199
SourceRange getParametersSourceRange() const
Attempt to compute an informative source range covering the function parameters, including the ellips...
Definition Decl.cpp:4040
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:3688
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:3125
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:4339
Represents a prototype with parameter type info, e.g.
Definition TypeBase.h:5269
param_type_iterator param_type_begin() const
Definition TypeBase.h:5713
unsigned getNumParams() const
Definition TypeBase.h:5547
bool isVariadic() const
Whether this function prototype is variadic.
Definition TypeBase.h:5673
param_type_iterator param_type_end() const
Definition TypeBase.h:5717
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:4465
static ArmStateValue getArmZT0State(unsigned AttrBits)
Definition TypeBase.h:4774
static ArmStateValue getArmZAState(unsigned AttrBits)
Definition TypeBase.h:4770
static std::string ExtractStringFromGCCAsmStmtComponent(const Expr *E)
Definition Stmt.cpp:516
HLSLBufferDecl - Represent a cbuffer or tbuffer declaration.
Definition Decl.h:5193
buffer_decl_iterator buffer_decls_begin() const
Definition Decl.cpp:5960
static HLSLBufferDecl * Create(ASTContext &C, DeclContext *LexicalParent, bool CBuffer, SourceLocation KwLoc, IdentifierInfo *ID, SourceLocation IDLoc, SourceLocation LBrace)
Definition Decl.cpp:5900
void addLayoutStruct(CXXRecordDecl *LS)
Definition Decl.cpp:5940
bool buffer_decls_empty()
Definition Decl.cpp:5972
llvm::concat_iterator< Decl *const, SmallVector< Decl * >::const_iterator, decl_iterator > buffer_decl_iterator
Definition Decl.h:5263
static HLSLBufferDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5934
buffer_decl_iterator buffer_decls_end() const
Definition Decl.cpp:5966
static HLSLBufferDecl * CreateDefaultCBuffer(ASTContext &C, DeclContext *LexicalParent, ArrayRef< Decl * > DefaultCBufferDecls)
Definition Decl.cpp:5923
static HLSLRootSignatureDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation Loc, IdentifierInfo *ID, llvm::dxbc::RootSignatureVersion Version, ArrayRef< llvm::hlsl::rootsig::RootElement > RootElements)
Definition Decl.cpp:5986
static HLSLRootSignatureDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:6001
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:5597
static ImplicitParamDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5609
static ImportDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, Module *Imported, ArrayRef< SourceLocation > IdentifierLocs)
Create a new module import declaration.
Definition Decl.cpp:6041
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:6072
static ImportDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumLocations)
Create a new, deserialized module import declaration.
Definition Decl.cpp:6059
friend class ASTContext
Definition Decl.h:5053
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:6065
Module * getImportedModule() const
Retrieve the module that was imported by the import declaration.
Definition Decl.h:5110
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:6049
static bool classofKind(Kind K)
Definition Decl.h:3509
static IndirectFieldDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5741
static IndirectFieldDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation L, const IdentifierInfo *Id, QualType T, MutableArrayRef< NamedDecl * > CH)
Definition Decl.cpp:5733
void setMSAsmLabel(StringRef Name)
Definition Decl.cpp:5567
static LabelDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation IdentL, IdentifierInfo *II)
Definition Decl.cpp:5550
static LabelDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5562
@ Microsoft
Use Microsoft C++ ABI rules for bit-field layout and fundamental types alignment.
@ Default
Use default layout rules of the target.
RegisterStaticDestructorsKind
Controls which variables have static destructors registered.
Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that i...
LinkageInfo getTypeLinkageAndVisibility(const Type *T)
Definition Type.cpp:5002
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:1845
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:1869
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:1973
bool hasLinkage() const
Determine whether this declaration has linkage.
Definition Decl.cpp:1941
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:4878
static OutlinedFunctionDecl * Create(ASTContext &C, DeclContext *DC, unsigned NumParams)
Definition Decl.cpp:5653
void setNothrow(bool Nothrow=true)
Definition Decl.cpp:5673
static OutlinedFunctionDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NumParams)
Definition Decl.cpp:5661
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:5667
Represents a parameter to a function.
Definition Decl.h:1790
void setDefaultArg(Expr *defarg)
Definition Decl.cpp:3022
static ParmVarDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:2974
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:3027
void setUninstantiatedDefaultArg(Expr *arg)
Definition Decl.cpp:3047
bool hasUninstantiatedDefaultArg() const
Definition Decl.h:1923
bool isDestroyedInCallee() const
Determines whether this parameter is destroyed in the callee function.
Definition Decl.cpp:2995
bool hasInheritedDefaultArg() const
Definition Decl.h:1935
bool isExplicitObjectParameter() const
Definition Decl.h:1878
QualType getOriginalType() const
Definition Decl.cpp:2966
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:2957
Expr * getDefaultArg()
Definition Decl.cpp:3010
Expr * getUninstantiatedDefaultArg()
Definition Decl.cpp:3052
bool hasDefaultArg() const
Determines whether this parameter has a default argument, either parsed or not.
Definition Decl.cpp:3058
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2980
static PragmaCommentDecl * Create(const ASTContext &C, TranslationUnitDecl *DC, SourceLocation CommentLoc, PragmaMSCommentKind CommentKind, StringRef Arg)
Definition Decl.cpp:5497
static PragmaCommentDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned ArgSize)
Definition Decl.cpp:5510
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:5520
static PragmaDetectMismatchDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID, unsigned NameValueSize)
Definition Decl.cpp:5535
Represents an unpacked "presumed" location which can be presented to the user.
unsigned getColumn() const
Return the presumed column number of this location.
const char * getFilename() const
Return the presumed filename of this location.
unsigned getLine() const
Return the presumed line number of this location.
void print(raw_ostream &OS) const override
Definition Decl.cpp:80
virtual bool isScopeVisible(const DeclContext *DC) const
When printing type to be inserted into code in specific context, this callback can be used to avoid p...
A (possibly-)qualified type.
Definition TypeBase.h:937
bool isNull() const
Return true if this QualType doesn't point to a type yet.
Definition TypeBase.h:1004
const Type * getTypePtr() const
Retrieves a pointer to the underlying (unqualified) type.
Definition TypeBase.h:8292
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:8338
Represents a struct/union/class.
Definition Decl.h:4324
bool hasLoadedFieldsFromExternalStorage() const
Definition Decl.h:4393
unsigned getODRHash()
Get precomputed ODRHash or add a new one.
Definition Decl.cpp:5413
bool isLambda() const
Determine whether this record is a class describing a lambda function object.
Definition Decl.cpp:5241
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:5307
void setAnonymousStructOrUnion(bool Anon)
Definition Decl.h:4380
RecordDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl)
Definition Decl.cpp:5203
const FieldDecl * findFirstNamedDataMember() const
Finds the first data member which has a name.
Definition Decl.cpp:5399
field_iterator noload_field_begin() const
Definition Decl.cpp:5280
void setArgPassingRestrictions(RecordArgPassingKind Kind)
Definition Decl.h:4470
void setNonTrivialToPrimitiveCopy(bool V)
Definition Decl.h:4414
bool isCapturedRecord() const
Determine whether this record is a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5247
void setHasNonTrivialToPrimitiveCopyCUnion(bool V)
Definition Decl.h:4446
field_range fields() const
Definition Decl.h:4527
void setHasNonTrivialToPrimitiveDestructCUnion(bool V)
Definition Decl.h:4438
void setHasFlexibleArrayMember(bool V)
Definition Decl.h:4361
void setParamDestroyedInCallee(bool V)
Definition Decl.h:4478
void setNonTrivialToPrimitiveDestroy(bool V)
Definition Decl.h:4422
void setHasObjectMember(bool val)
Definition Decl.h:4385
static RecordDecl * Create(const ASTContext &C, TagKind TK, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, IdentifierInfo *Id, RecordDecl *PrevDecl=nullptr)
Definition Decl.cpp:5227
void setHasVolatileMember(bool val)
Definition Decl.h:4389
void setHasNonTrivialToPrimitiveDefaultInitializeCUnion(bool V)
Definition Decl.h:4430
void reorderDecls(const SmallVectorImpl< Decl * > &Decls)
Definition Decl.cpp:5318
void setIsRandomized(bool V)
Definition Decl.h:4484
static RecordDecl * CreateDeserialized(const ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5234
bool mayInsertExtraPadding(bool EmitRemark=false) const
Whether we are allowed to insert extra padding between fields.
Definition Decl.cpp:5355
static bool classof(const Decl *D)
Definition Decl.h:4564
bool isOrContainsUnion() const
Returns whether this record is a union, or contains (at any nesting level) a union member.
Definition Decl.cpp:5255
virtual void completeDefinition()
Note that the definition of this type is now complete.
Definition Decl.cpp:5286
RecordDecl * getDefinition() const
Returns the RecordDecl that actually defines this struct/union/class.
Definition Decl.h:4508
void setCapturedRecord()
Mark the record as a record for captured variables in CapturedStmt construct.
Definition Decl.cpp:5251
specific_decl_iterator< FieldDecl > field_iterator
Definition Decl.h:4524
void setHasUninitializedExplicitInitFields(bool V)
Definition Decl.h:4454
void setNonTrivialToPrimitiveDefaultInitialize(bool V)
Definition Decl.h:4406
RecordDecl * getDefinitionOrSelf() const
Definition Decl.h:4512
friend class DeclContext
Definition Decl.h:4328
void setHasLoadedFieldsFromExternalStorage(bool val) const
Definition Decl.h:4397
field_iterator field_begin() const
Definition Decl.cpp:5270
Declaration of a redeclarable template.
bool isMemberSpecialization() const
Determines whether this template was a specialization of a member template.
Provides common interface for the Decls that can be redeclared.
TagDecl * getNextRedeclaration() const
void setPreviousDecl(FunctionDecl *PrevDecl)
Encodes a location in the source.
bool isValid() const
Return true if this is a valid SourceLocation object.
This class handles loading and caching of source files into memory.
PresumedLoc getPresumedLoc(SourceLocation Loc, bool UseLineDirectives=true) const
Returns the "presumed" location of a SourceLocation specifies.
A trivial tuple used to represent a source range.
bool isInvalid() const
SourceLocation getEnd() const
Stmt - This represents one statement.
Definition Stmt.h: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:3918
void setCompleteDefinitionRequired(bool V=true)
True if this complete decl is required to be complete for some existing use.
Definition Decl.h:3830
SourceRange getBraceRange() const
Definition Decl.h:3791
TagTypeKind TagKind
Definition Decl.h:3722
bool isBeingDefined() const
Return true if this decl is currently being defined.
Definition Decl.h:3835
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:4929
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:3845
StringRef getKindName() const
Definition Decl.h:3910
bool isCompleteDefinition() const
Return true if this decl has its body fully specified.
Definition Decl.h:3815
redeclarable_base::redecl_iterator redecl_iterator
Definition Decl.h:3782
TypedefNameDecl * getTypedefNameForAnonDecl() const
Definition Decl.h:3951
void startDefinition()
Starts the definition of this tag declaration.
Definition Decl.cpp:4906
TagDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:4899
void setTypedefNameForAnonDecl(TypedefNameDecl *TDD)
Definition Decl.cpp:4901
SourceLocation getOuterLocStart() const
Return SourceLocation representing start of source range taking into account any outer template decla...
Definition Decl.cpp:4889
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:4893
bool isUnion() const
Definition Decl.h:3925
void setBeingDefined(bool V=true)
True if this decl is currently being defined.
Definition Decl.h:3772
void setQualifierInfo(NestedNameSpecifierLoc QualifierLoc)
Definition Decl.cpp:4943
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Definition Decl.cpp:5037
void completeDefinition()
Completes the definition of this tag declaration.
Definition Decl.cpp:4917
void printName(raw_ostream &OS, const PrintingPolicy &Policy) const override
Pretty-print the unqualified name of this declaration.
Definition Decl.cpp:5023
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:3853
redeclarable_base::redecl_range redecl_range
Definition Decl.h:3781
bool isDependentType() const
Whether this declaration declares a type that is dependent, i.e., a type that somehow depends on temp...
Definition Decl.h:3860
void printAnonymousTagDecl(llvm::raw_ostream &OS, const PrintingPolicy &Policy) const
Definition Decl.cpp:4963
TagDecl(Kind DK, TagKind TK, const ASTContext &C, DeclContext *DC, SourceLocation L, IdentifierInfo *Id, TagDecl *PrevDecl, SourceLocation StartL)
Definition Decl.cpp:4872
void setCompleteDefinition(bool V=true)
True if this decl has its body fully specified.
Definition Decl.h:3818
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:5867
static TopLevelStmtDecl * Create(ASTContext &C, Stmt *Statement)
Definition Decl.cpp:5857
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5873
void setStmt(Stmt *S)
Definition Decl.cpp:5877
The top declaration context.
Definition Decl.h:105
static TranslationUnitDecl * Create(ASTContext &C)
Definition Decl.cpp:5484
ASTContext & getASTContext() const
Definition Decl.h:141
void setAnonymousNamespace(NamespaceDecl *D)
Definition Decl.cpp:5488
static TypeAliasDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5815
static TypeAliasDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5807
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5830
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:8263
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:8274
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:3171
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:8935
const T * castAs() const
Member-template castAs<specific type>.
Definition TypeBase.h:9178
bool isReferenceType() const
Definition TypeBase.h:8553
bool isEnumeralType() const
Definition TypeBase.h:8660
bool isAlignValT() const
Definition Type.cpp:3180
QualType getPointeeType() const
If this is a pointer, ObjC object pointer, or block pointer, this returns the respective pointee.
Definition Type.cpp:753
DeducedType * getContainedDeducedType() const
Get the DeducedType whose type will be deduced for a variable with an initializer of this type.
Definition Type.cpp:2057
const T * getAsCanonical() const
If this type is canonically the specified type, return its canonical type cast to that specified type...
Definition TypeBase.h:2922
Linkage getLinkage() const
Determine the linkage of this type.
Definition Type.cpp:4892
const T * getAs() const
Member-template getAs<specific type>'.
Definition TypeBase.h:9111
static TypedefDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, TypeSourceInfo *TInfo)
Definition Decl.cpp:5756
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:5821
static TypedefDecl * CreateDeserialized(ASTContext &C, GlobalDeclID ID)
Definition Decl.cpp:5802
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:5765
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:5588
bool isWeak() const
Determine whether this symbol is weakly-imported, or declared with the weak or weak-ref attr.
Definition Decl.cpp:5576
bool isInitCapture() const
Whether this variable is the implicit variable for a lambda init-capture.
Definition Decl.cpp:5582
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:2821
static VarDecl * Create(ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass S)
Definition Decl.cpp:2162
Stmt ** getInitAddress()
Retrieve the address of the initializer expression.
Definition Decl.cpp:2433
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:2946
TLSKind getTLSKind() const
Definition Decl.cpp:2179
@ DAK_Uninstantiated
Definition Decl.h:1003
bool hasInit() const
Definition Decl.cpp:2409
bool hasICEInitializer(const ASTContext &Context) const
Determine whether the initializer of this variable is an integer constant expression.
Definition Decl.cpp:2647
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:2132
SourceRange getSourceRange() const override LLVM_READONLY
Source range that this declaration covers.
Definition Decl.cpp:2201
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:2472
VarDecl * getCanonicalDecl() override
Retrieves the "canonical" declaration of the given declaration.
Definition Decl.cpp:2268
bool hasFlexibleArrayInit(const ASTContext &Ctx) const
Whether this variable has a flexible array member initialized with one or more elements.
Definition Decl.cpp:2873
bool isNoDestroy(const ASTContext &) const
Is destruction of this variable entirely suppressed?
Definition Decl.cpp:2847
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:2174
bool hasInitWithSideEffects() const
Checks whether this declaration has an initializer with side effects.
Definition Decl.cpp:2455
APValue * evaluateValue() const
Attempt to evaluate the value of the initializer attached to this declaration, and produce notes expl...
Definition Decl.cpp:2586
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:2168
VarDecl * getTemplateInstantiationPattern() const
Retrieve the variable declaration from which this variable could be instantiated, if it is an instant...
Definition Decl.cpp:2725
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:2888
bool hasConstantInitialization() const
Determine whether this variable has constant initialization.
Definition Decl.cpp:2659
LanguageLinkage getLanguageLinkage() const
Compute the language linkage.
Definition Decl.cpp:2252
unsigned AllBits
Definition Decl.h:1122
EvaluatedStmt * getEvaluatedStmt() const
Definition Decl.cpp:2582
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:2497
EvaluatedStmt * ensureEvaluatedStmt() const
Convert the initializer for this declaration to the elaborated EvaluatedStmt form,...
Definition Decl.cpp:2568
VarDecl * getInstantiatedFromStaticDataMember() const
If this variable is an instantiated static data member of a class template specialization,...
Definition Decl.cpp:2783
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:2918
QualType::DestructionKind needsDestruction(const ASTContext &Ctx) const
Would the destruction of this variable have any effect, and if so, what kind?
Definition Decl.cpp:2862
bool checkForConstantInitialization(SmallVectorImpl< PartialDiagnosticAt > &Notes) const
Evaluate the initializer of this variable to determine whether it's a constant initializer.
Definition Decl.cpp:2675
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:2713
bool isInExternCContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C" linkage spec.
Definition Decl.cpp:2260
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:2639
VarDecl * getInitializingDeclaration()
Get the initializing declaration of this variable, if any.
Definition Decl.cpp:2440
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:2488
VarDecl * getActingDefinition()
Get the tentative definition that acts as the real definition in a TU.
Definition Decl.cpp:2356
@ 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:2826
bool isExternC() const
Determines whether this variable is a variable with external, C linkage.
Definition Decl.cpp:2256
VarDecl(Kind DK, ASTContext &C, DeclContext *DC, SourceLocation StartLoc, SourceLocation IdLoc, const IdentifierInfo *Id, QualType T, TypeSourceInfo *TInfo, StorageClass SC)
Definition Decl.cpp:2145
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:2709
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:2539
bool isInExternCXXContext() const
Determines whether this variable's context is, or is nested within, a C++ extern "C++" linkage spec.
Definition Decl.cpp:2264
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:2811
bool hasDependentAlignment() const
Determines if this variable's alignment is dependent.
Definition Decl.cpp:2717
TemplateSpecializationKind getTemplateSpecializationKindForInstantiation() const
Get the template specialization kind of this variable for the purposes of template instantiation.
Definition Decl.cpp:2801
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:2790
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:2830
MemberSpecializationInfo * getMemberSpecializationInfo() const
If this variable is an instantiation of a static data member of a class template specialization,...
Definition Decl.cpp:2909
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:3967
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:6115
TagTypeKind
The kind of a tag type.
Definition TypeBase.h:5893
@ Struct
The "struct" keyword.
Definition TypeBase.h:5895
@ Enum
The "enum" keyword.
Definition TypeBase.h:5907
@ VarTemplate
The name was classified as a variable template name.
Definition Sema.h:584
bool isTypeAwareAllocation(TypeAwareAllocationMode Mode)
Definition ExprCXX.h:2253
@ CanPassInRegs
The argument of this type can be passed directly in registers.
Definition Decl.h:4303
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:5882
bool IsArmStreamingFunction(const FunctionDecl *FD, bool IncludeLocallyStreaming)
Returns whether the given FunctionDecl has an __arm[_locally]_streaming attribute.
Definition Decl.cpp:6094
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:6108
#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 AnonymousTagLocations
When printing an anonymous tag name, also print the location of that entity (e.g.,...
unsigned SuppressTagKeyword
Whether type printing should skip printing the tag keyword.
unsigned SuppressInlineNamespace
Suppress printing parts of scope specifiers that correspond to inline namespaces.
const PrintingCallbacks * Callbacks
Callbacks to use to allow the behavior of printing to be customized.
unsigned SuppressTagKeywordInAnonNames
Whether type printing should skip printing the tag keyword of anonymous entities.
TemplateParameterList ** TemplParamLists
A new-allocated array of size NumTemplParamLists, containing pointers to the "outer" template paramet...
Definition Decl.h:767
unsigned NumTemplParamLists
The number of "outer" template parameter lists.
Definition Decl.h:760
void setTemplateParameterListsInfo(ASTContext &Context, ArrayRef< TemplateParameterList * > TPLists)
Sets info about "outer" template parameter lists.
Definition Decl.cpp:2112
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