25#include "llvm/Support/raw_ostream.h"
29 class DeclPrinter :
public DeclVisitor<DeclPrinter> {
34 bool PrintInstantiation;
36 raw_ostream& Indent() {
return Indent(Indentation); }
37 raw_ostream& Indent(
unsigned Indentation);
55 const ASTContext &Context,
unsigned Indentation = 0,
56 bool PrintInstantiation =
false)
57 : Out(Out), Policy(Policy), Context(Context), Indentation(Indentation),
58 PrintInstantiation(PrintInstantiation) {}
60 void VisitDeclContext(
DeclContext *DC,
bool Indent =
true);
87 void VisitClassTemplateSpecializationDecl(
89 void VisitClassTemplatePartialSpecializationDecl(
116 bool OmitTemplateKW =
false);
121 enum class AttrPosAsWritten {
Default = 0, Left, Right };
123 prettyPrintAttributes(
const Decl *D,
124 AttrPosAsWritten Pos = AttrPosAsWritten::Default);
125 void prettyPrintPragmas(
Decl *D);
126 void printDeclType(
QualType T, StringRef DeclName,
bool Pack =
false);
131 bool PrintInstantiation)
const {
136 unsigned Indentation,
bool PrintInstantiation)
const {
137 DeclPrinter Printer(Out, Policy,
getASTContext(), Indentation,
139 Printer.Visit(
const_cast<Decl*
>(
this));
143 bool OmitTemplateKW)
const {
149 bool OmitTemplateKW)
const {
150 DeclPrinter Printer(Out, Policy, Context);
151 Printer.printTemplateParameters(
this, OmitTemplateKW);
165 else if (
const ArrayType *ATy = dyn_cast<ArrayType>(BaseType))
166 BaseType = ATy->getElementType();
168 BaseType = FTy->getReturnType();
170 BaseType = VTy->getElementType();
174 BaseType = ATy->getDeducedType();
176 BaseType = PTy->desugar();
186 return TDD->getUnderlyingType();
187 if (
ValueDecl* VD = dyn_cast<ValueDecl>(D))
188 return VD->getType();
194 unsigned Indentation) {
196 (*Begin)->print(Out, Policy, Indentation);
215 if (!isFirst) Out <<
", ";
220 (*Begin)->print(Out, SubPolicy, Indentation);
230 ASTContext &Ctx = cast<TranslationUnitDecl>(DC)->getASTContext();
232 Printer.VisitDeclContext(
const_cast<DeclContext *
>(
this),
false);
235raw_ostream& DeclPrinter::Indent(
unsigned Indentation) {
236 for (
unsigned i = 0; i != Indentation; ++i)
247 return DeclPrinter::AttrPosAsWritten::Left;
249 if (
C.getSourceManager().isBeforeInTranslationUnit(ALoc, DLoc))
250 return DeclPrinter::AttrPosAsWritten::Left;
252 return DeclPrinter::AttrPosAsWritten::Right;
256bool DeclPrinter::prettyPrintAttributes(
const Decl *D,
257 AttrPosAsWritten Pos ) {
258 bool hasPrinted =
false;
262 for (
auto *A : Attrs) {
263 if (A->isInherited() || A->isImplicit())
268 switch (A->getKind()) {
270#define PRAGMA_SPELLING_ATTR(X) case attr::X:
271#include "clang/Basic/AttrList.inc"
275 assert(APos != AttrPosAsWritten::Default &&
276 "Default not a valid for an attribute location");
277 if (Pos == AttrPosAsWritten::Default || Pos == APos) {
278 if (Pos != AttrPosAsWritten::Left)
280 A->printPretty(Out, Policy);
282 if (Pos == AttrPosAsWritten::Left)
292void DeclPrinter::prettyPrintPragmas(
Decl *D) {
298 for (
auto *A : Attrs) {
299 switch (A->getKind()) {
301#define PRAGMA_SPELLING_ATTR(X) case attr::X:
302#include "clang/Basic/AttrList.inc"
303 A->printPretty(Out, Policy);
313void DeclPrinter::printDeclType(
QualType T, StringRef DeclName,
bool Pack) {
319 T = PET->getPattern();
321 T.print(Out, Policy, (Pack ?
"..." :
"") + DeclName, Indentation);
334 if (AccessSpelling.empty())
335 llvm_unreachable(
"No access specifier!");
336 Out << AccessSpelling;
340 std::string &Proto) {
341 bool HasInitializerList =
false;
342 for (
const auto *BMInitializer : CDecl->
inits()) {
343 if (BMInitializer->isInClassMemberInitializer())
345 if (!BMInitializer->isWritten())
348 if (!HasInitializerList) {
352 HasInitializerList =
true;
356 if (BMInitializer->isAnyMemberInitializer()) {
357 FieldDecl *FD = BMInitializer->getAnyMember();
359 }
else if (BMInitializer->isDelegatingInitializer()) {
365 if (
Expr *
Init = BMInitializer->getInit()) {
366 bool OutParens = !isa<InitListExpr>(
Init);
372 Init = Tmp->getSubExpr();
376 Expr *SimpleInit =
nullptr;
377 Expr **Args =
nullptr;
378 unsigned NumArgs = 0;
380 Args = ParenList->getExprs();
381 NumArgs = ParenList->getNumExprs();
383 dyn_cast<CXXConstructExpr>(
Init)) {
384 Args = Construct->getArgs();
385 NumArgs = Construct->getNumArgs();
390 SimpleInit->
printPretty(Out,
nullptr, Policy, Indentation,
"\n",
393 for (
unsigned I = 0; I != NumArgs; ++I) {
394 assert(Args[I] !=
nullptr &&
"Expected non-null Expr");
395 if (isa<CXXDefaultArgExpr>(Args[I]))
400 Args[I]->
printPretty(Out,
nullptr, Policy, Indentation,
"\n",
411 if (BMInitializer->isPackExpansion())
420void DeclPrinter::VisitDeclContext(
DeclContext *DC,
bool Indent) {
433 if (isa<ObjCIvarDecl>(*D))
442 if (
auto FD = dyn_cast<FunctionDecl>(*D))
444 !isa<ClassTemplateSpecializationDecl>(DC))
460 if (!Decls.empty() && !CurDeclType.
isNull()) {
462 if (!BaseType.
isNull() && isa<ElaboratedType>(BaseType) &&
463 cast<ElaboratedType>(BaseType)->getOwnedTagDecl() == Decls[0]) {
471 ProcessDeclGroup(Decls);
475 if (isa<TagDecl>(*D) && !cast<TagDecl>(*D)->isFreeStanding()) {
480 if (isa<AccessSpecDecl>(*D)) {
493 const char *Terminator =
nullptr;
494 if (isa<OMPThreadPrivateDecl>(*D) || isa<OMPDeclareReductionDecl>(*D) ||
495 isa<OMPDeclareMapperDecl>(*D) || isa<OMPRequiresDecl>(*D) ||
496 isa<OMPAllocateDecl>(*D))
497 Terminator =
nullptr;
498 else if (isa<ObjCMethodDecl>(*D) && cast<ObjCMethodDecl>(*D)->hasBody())
499 Terminator =
nullptr;
500 else if (
auto FD = dyn_cast<FunctionDecl>(*D)) {
501 if (FD->doesThisDeclarationHaveABody() && !FD->isDefaulted())
502 Terminator =
nullptr;
505 }
else if (
auto TD = dyn_cast<FunctionTemplateDecl>(*D)) {
506 if (TD->getTemplatedDecl()->doesThisDeclarationHaveABody())
507 Terminator =
nullptr;
513 Terminator =
nullptr;
514 else if (isa<EnumConstantDecl>(*D)) {
525 ((isa<FunctionDecl>(*D) &&
526 cast<FunctionDecl>(*D)->doesThisDeclarationHaveABody()) ||
527 (isa<FunctionTemplateDecl>(*D) &&
528 cast<FunctionTemplateDecl>(*D)->getTemplatedDecl()->doesThisDeclarationHaveABody())))
535 if (D->
hasAttr<OMPDeclareTargetDeclAttr>())
536 Out <<
"#pragma omp end declare target\n";
540 ProcessDeclGroup(Decls);
547 VisitDeclContext(D,
false);
550void DeclPrinter::VisitTypedefDecl(
TypedefDecl *D) {
555 Out <<
"__module_private__ ";
559 prettyPrintAttributes(D);
563 Out <<
"using " << *D;
564 prettyPrintAttributes(D);
568void DeclPrinter::VisitEnumDecl(
EnumDecl *D) {
570 Out <<
"__module_private__ ";
579 prettyPrintAttributes(D);
594void DeclPrinter::VisitRecordDecl(
RecordDecl *D) {
596 Out <<
"__module_private__ ";
599 prettyPrintAttributes(D);
604 if (D->isCompleteDefinition()) {
613 prettyPrintAttributes(D);
616 Init->printPretty(Out,
nullptr, Policy, Indentation,
"\n", &Context);
623 std::string Proto =
"explicit";
624 llvm::raw_string_ostream EOut(Proto);
638 llvm::raw_ostream &Out) {
649 prettyPrintPragmas(D);
650 prettyPrintAttributes(D, AttrPosAsWritten::Left);
654 Out <<
"template<> ";
657 I < NumTemplateParams; ++I)
671 llvm_unreachable(
"invalid for functions");
688 SubPolicy.SuppressSpecifiers =
false;
694 llvm::raw_string_ostream OS(Proto);
697 NS->print(OS, Policy);
706 llvm::raw_string_ostream POut(Proto);
707 DeclPrinter TArgPrinter(POut, SubPolicy, Context, Indentation);
710 TArgPrinter.printTemplateArguments(TArgAsWritten->arguments(),
nullptr);
713 TArgPrinter.printTemplateArguments(TArgs->asArray(),
nullptr);
717 while (
const ParenType *PT = dyn_cast<ParenType>(Ty)) {
718 Proto =
'(' + Proto +
')';
719 Ty = PT->getInnerType();
725 FT = dyn_cast<FunctionProtoType>(AFT);
729 llvm::raw_string_ostream POut(Proto);
730 DeclPrinter ParamPrinter(POut, SubPolicy, Context, Indentation);
731 for (
unsigned i = 0, e = D->
getNumParams(); i != e; ++i) {
745 for (
unsigned i = 0, e = D->
getNumParams(); i != e; ++i) {
758 Proto +=
" volatile";
760 Proto +=
" restrict";
787 Proto +=
" noexcept";
790 llvm::raw_string_ostream EOut(Proto);
792 Indentation,
"\n", &Context);
800 PrintConstructorInitializers(CDecl, Proto);
801 }
else if (!ConversionDecl && !isa<CXXDestructorDecl>(D)) {
805 Out << Proto <<
" -> ";
812 AFT->getReturnType().print(Out, Policy, Proto);
819 TrailingRequiresClause->printPretty(Out,
nullptr, SubPolicy, Indentation,
823 Ty.
print(Out, Policy, Proto);
826 prettyPrintAttributes(D, AttrPosAsWritten::Right);
834 M->outputString(Out);
845 DeclPrinter ParamPrinter(Out, SubPolicy, Context, Indentation);
847 for (
unsigned i = 0, e = D->
getNumParams(); i != e; ++i) {
859 if (!Policy.
TerseOutput && isa<CXXConstructorDecl>(*D))
865void DeclPrinter::VisitFriendDecl(
FriendDecl *D) {
868 for (
unsigned i = 0; i < NumTPLists; ++i)
871 Out <<
" " << TSI->getType().getAsString(Policy);
876 VisitFunctionDecl(FD);
881 VisitFunctionTemplateDecl(FTD);
886 VisitRedeclarableTemplateDecl(CTD);
890void DeclPrinter::VisitFieldDecl(
FieldDecl *D) {
895 Out <<
"__module_private__ ";
898 stream(Policy, D->
getName(), Indentation);
912 Init->printPretty(Out,
nullptr, Policy, Indentation,
"\n", &Context);
914 prettyPrintAttributes(D);
917void DeclPrinter::VisitLabelDecl(
LabelDecl *D) {
921void DeclPrinter::VisitVarDecl(
VarDecl *D) {
922 prettyPrintPragmas(D);
924 prettyPrintAttributes(D, AttrPosAsWritten::Left);
926 if (
const auto *Param = dyn_cast<ParmVarDecl>(D);
927 Param && Param->isExplicitObjectParameter())
946 Out <<
"_Thread_local ";
949 Out <<
"thread_local ";
954 Out <<
"__module_private__ ";
958 T.removeLocalConst();
971 prettyPrintAttributes(D, AttrPosAsWritten::Right);
975 bool ImplicitInit =
false;
980 dyn_cast<CXXConstructExpr>(
Init->IgnoreImplicit())) {
982 !Construct->isListInitialization()) {
983 ImplicitInit = Construct->getNumArgs() == 0 ||
994 SubPolicy.SuppressSpecifiers =
false;
995 SubPolicy.IncludeTagDefinition =
false;
996 Init->printPretty(Out,
nullptr, SubPolicy, Indentation,
"\n", &Context);
1003void DeclPrinter::VisitParmVarDecl(
ParmVarDecl *D) {
1019void DeclPrinter::VisitImportDecl(
ImportDecl *D) {
1025 Out <<
"static_assert(";
1030 E->printPretty(Out,
nullptr, Policy, Indentation,
"\n", &Context);
1042 Out <<
"namespace ";
1047 VisitDeclContext(D);
1052 Out <<
"using namespace ";
1059 Out <<
"namespace " << *D <<
" = ";
1065void DeclPrinter::VisitEmptyDecl(
EmptyDecl *D) {
1066 prettyPrintAttributes(D);
1072 Out <<
"__module_private__ ";
1078 if (prettyPrintAttributes(D, AttrPosAsWritten::Left))
1083 NNS->print(Out, Policy);
1086 if (
auto S = dyn_cast<ClassTemplateSpecializationDecl>(D)) {
1089 if (
const auto* TSI = S->getTypeAsWritten())
1090 if (
const auto *TST =
1091 dyn_cast<TemplateSpecializationType>(TSI->getType()))
1092 Args = TST->template_arguments();
1093 printTemplateArguments(
1094 Args, S->getSpecializedTemplate()->getTemplateParameters());
1098 prettyPrintAttributes(D, AttrPosAsWritten::Right);
1100 if (D->isCompleteDefinition()) {
1103 if (D->getNumBases()) {
1106 BaseEnd = D->bases_end();
Base != BaseEnd; ++
Base) {
1107 if (
Base != D->bases_begin())
1110 if (
Base->isVirtual())
1118 Out <<
Base->getType().getAsString(Policy);
1120 if (
Base->isPackExpansion())
1132 VisitDeclContext(D);
1144 "unknown language in linkage specification");
1148 Out <<
"extern \"" << l <<
"\" ";
1151 VisitDeclContext(D);
1158 bool OmitTemplateKW) {
1165 if (!OmitTemplateKW)
1169 bool NeedComma =
false;
1170 for (
const Decl *Param : *Params) {
1171 if (Param->isImplicit())
1179 if (
const auto *TTP = dyn_cast<TemplateTypeParmDecl>(Param)) {
1180 VisitTemplateTypeParmDecl(TTP);
1181 }
else if (
auto NTTP = dyn_cast<NonTypeTemplateParmDecl>(Param)) {
1182 VisitNonTypeTemplateParmDecl(NTTP);
1183 }
else if (
auto TTPD = dyn_cast<TemplateTemplateParmDecl>(Param)) {
1184 VisitTemplateDecl(TTPD);
1190 if (!OmitTemplateKW)
1197 for (
size_t I = 0, E = Args.size(); I < E; ++I) {
1201 Args[I].print(Policy, Out,
true);
1203 Args[I].print(Policy, Out,
1205 Policy, Params, I));
1213 for (
size_t I = 0, E = Args.size(); I < E; ++I) {
1217 Args[I].getArgument().print(Policy, Out,
true);
1219 Args[I].getArgument().print(
1227void DeclPrinter::VisitTemplateDecl(
const TemplateDecl *D) {
1231 dyn_cast<TemplateTemplateParmDecl>(D)) {
1232 if (TTP->wasDeclaredWithTypename())
1237 if (TTP->isParameterPack())
1239 else if (TTP->getDeclName())
1242 if (TTP->getDeclName()) {
1244 Out << TTP->getIdentifier()->deuglifiedName();
1246 Out << TTP->getDeclName();
1250 else if (
const auto *Concept = dyn_cast<ConceptDecl>(D)) {
1251 Out <<
"concept " <<
Concept->getName() <<
" = " ;
1252 Concept->getConstraintExpr()->printPretty(Out,
nullptr, Policy, Indentation,
1262 I < NumTemplateParams; ++I)
1265 VisitRedeclarableTemplateDecl(D);
1269 Out <<
"#pragma omp end declare target\n";
1273 if (PrintInstantiation &&
1277 if (PrevDecl->
isDefined(Def) && Def != PrevDecl)
1284 prettyPrintPragmas(I);
1291 VisitRedeclarableTemplateDecl(D);
1293 if (PrintInstantiation) {
1305void DeclPrinter::VisitClassTemplateSpecializationDecl(
1307 Out <<
"template<> ";
1308 VisitCXXRecordDecl(D);
1311void DeclPrinter::VisitClassTemplatePartialSpecializationDecl(
1314 VisitCXXRecordDecl(D);
1321void DeclPrinter::PrintObjCMethodType(
ASTContext &Ctx,
1348 unsigned First =
true;
1349 for (
auto *Param : *Params) {
1356 switch (Param->getVariance()) {
1361 Out <<
"__covariant ";
1365 Out <<
"__contravariant ";
1369 Out << Param->getDeclName();
1371 if (Param->hasExplicitBound()) {
1372 Out <<
" : " << Param->getUnderlyingType().getAsString(Policy);
1389 std::string::size_type pos, lastPos = 0;
1392 pos =
name.find_first_of(
':', lastPos);
1395 Out <<
name.substr(lastPos, pos - lastPos) <<
':';
1397 PI->getObjCDeclQualifier(),
1409 prettyPrintAttributes(OMD);
1424 bool eolnOut =
false;
1426 Out <<
"@implementation " << I <<
" : " << *SID;
1428 Out <<
"@implementation " << I;
1434 for (
const auto *I : OID->
ivars()) {
1435 Indent() << I->getASTContext().getUnqualifiedObjCPointerType(I->getType()).
1445 VisitDeclContext(OID,
false);
1456 Out <<
"@class " << I;
1459 PrintObjCTypeParams(TypeParams);
1465 bool eolnOut =
false;
1467 prettyPrintAttributes(OID);
1471 Out <<
"@interface " << I;
1474 PrintObjCTypeParams(TypeParams);
1482 if (!Protocols.
empty()) {
1484 E = Protocols.
end(); I != E; ++I)
1485 Out << (I == Protocols.
begin() ?
'<' :
',') << **I;
1493 for (
const auto *I : OID->
ivars()) {
1494 Indent() << I->getASTContext()
1495 .getUnqualifiedObjCPointerType(I->getType())
1496 .getAsString(Policy) <<
' ' << *I <<
";\n";
1506 VisitDeclContext(OID,
false);
1515 Out <<
"@protocol " << *PID <<
";\n";
1520 if (!Protocols.
empty()) {
1521 Out <<
"@protocol " << *PID;
1523 E = Protocols.
end(); I != E; ++I)
1524 Out << (I == Protocols.
begin() ?
'<' :
',') << **I;
1527 Out <<
"@protocol " << *PID <<
'\n';
1528 VisitDeclContext(PID,
false);
1533 Out <<
"@implementation ";
1537 Out <<
"<<error-type>>";
1538 Out <<
'(' << *PID <<
")\n";
1540 VisitDeclContext(PID,
false);
1546 Out <<
"@interface ";
1550 Out <<
"<<error-type>>";
1552 PrintObjCTypeParams(TypeParams);
1554 Out <<
"(" << *PID <<
")\n";
1555 if (PID->ivar_size() > 0) {
1558 for (
const auto *I : PID->ivars())
1559 Indent() << I->getASTContext().getUnqualifiedObjCPointerType(I->getType()).
1565 VisitDeclContext(PID,
false);
1572 Out <<
"@compatibility_alias " << *AID
1587 Out <<
"@required\n";
1589 Out <<
"@optional\n";
1598 Out << (first ?
"" :
", ") <<
"class";
1603 Out << (first ?
"" :
", ") <<
"direct";
1609 Out << (first ?
"" :
", ") <<
"nonatomic";
1613 Out << (first ?
"" :
", ") <<
"atomic";
1618 Out << (first ?
"" :
", ") <<
"assign";
1622 Out << (first ?
"" :
", ") <<
"retain";
1627 Out << (first ?
"" :
", ") <<
"strong";
1631 Out << (first ?
"" :
", ") <<
"copy";
1635 Out << (first ?
"" :
", ") <<
"weak";
1640 Out << (first ?
"" :
", ") <<
"unsafe_unretained";
1646 Out << (first ?
"" :
", ") <<
"readwrite";
1650 Out << (first ?
"" :
", ") <<
"readonly";
1655 Out << (first ?
"" :
", ") <<
"getter = ";
1660 Out << (first ?
"" :
", ") <<
"setter = ";
1671 Out << (first ?
"" :
", ") <<
"null_resettable";
1673 Out << (first ?
"" :
", ")
1685 Out <<
' ' << TypeStr;
1686 if (!StringRef(TypeStr).ends_with(
"*"))
1695 Out <<
"@synthesize ";
1703void DeclPrinter::VisitUsingDecl(
UsingDecl *D) {
1712 for (
const auto *Shadow : D->
shadows()) {
1713 if (
const auto *ConstructorShadow =
1714 dyn_cast<ConstructorUsingShadowDecl>(Shadow)) {
1715 assert(Shadow->getDeclContext() == ConstructorShadow->getDeclContext());
1716 Out << *ConstructorShadow->getNominatedBaseClass();
1729 Out <<
"using typename ";
1746 Out <<
"#pragma omp threadprivate";
1752 NamedDecl *ND = cast<DeclRefExpr>(*I)->getDecl();
1767 prettyPrintAttributes(D);
1770 VisitDeclContext(D);
1775 Out <<
"#pragma omp allocate";
1781 NamedDecl *ND = cast<DeclRefExpr>(*I)->getDecl();
1796 Out <<
"#pragma omp requires ";
1806 Out <<
"#pragma omp declare reduction (";
1808 const char *OpName =
1810 assert(OpName &&
"not an overloaded operator");
1822 Out <<
" initializer(";
1828 Out <<
"omp_priv = ";
1833 Init->printPretty(Out,
nullptr, Policy, 0,
"\n", &Context);
1843 Out <<
"#pragma omp declare mapper (";
1866 TC->print(Out, Policy);
1890void DeclPrinter::VisitNonTypeTemplateParmDecl(
Defines the clang::ASTContext interface.
Defines the C++ Decl subclasses, other than those for templates (found in DeclTemplate....
static DeclPrinter::AttrPosAsWritten getPosAsWritten(const Attr *A, const Decl *D)
static QualType getDeclType(Decl *D)
static QualType GetBaseType(QualType T)
static void MaybePrintTagKeywordIfSupressingScopes(PrintingPolicy &Policy, QualType T, llvm::raw_ostream &Out)
static void printExplicitSpecifier(ExplicitSpecifier ES, llvm::raw_ostream &Out, PrintingPolicy &Policy, unsigned Indentation, const ASTContext &Context)
Defines the C++ template declaration subclasses.
Defines the clang::Expr interface and subclasses for C++ expressions.
Defines the clang::Module class, which describes a module in the source code.
Defines the SourceManager interface.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
const LangOptions & getLangOpts() const
const clang::PrintingPolicy & getPrintingPolicy() const
QualType getUnqualifiedObjCPointerType(QualType type) const
getUnqualifiedObjCPointerType - Returns version of Objective-C pointer type with lifetime qualifier r...
Represents an array type, per C99 6.7.5.2 - Array Declarators.
Attr - This represents one attribute.
SourceLocation getLoc() const
static std::optional< NullabilityKind > stripOuterNullability(QualType &T)
Strip off the top-level nullability annotation on the given type, if it's there.
Represents a C++11 auto or C++14 decltype(auto) type, possibly constrained by a type-constraint.
shadow_range shadows() const
Represents a base class of a C++ class.
Represents a call to a C++ constructor.
Represents a C++ constructor within a class.
Represents a C++ conversion function within a class.
Represents a C++ deduction guide declaration.
TemplateDecl * getDeducedTemplate() const
Get the template for which this guide performs deduction.
Represents a C++ struct/union/class.
Declaration of a class template.
bool isThisDeclarationADefinition() const
Returns whether this template declaration defines the primary class pattern.
spec_range specializations() const
TemplateParameterList * getTemplateParameters() const
Get the list of template parameters.
Represents a class template specialization, which refers to a class template with a given set of temp...
decl_iterator - Iterates through the declarations stored within this context.
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
DeclContext * getParent()
getParent - Returns the containing DeclContext.
bool isTranslationUnit() const
void dumpDeclContext() const
decl_iterator decls_end() const
decl_iterator decls_begin() const
A simple visitor class that helps create declaration visitors.
Decl - This represents one declaration (or definition), e.g.
ASTContext & getASTContext() const LLVM_READONLY
bool isImplicit() const
isImplicit - Indicates whether the declaration was implicitly generated by the implementation.
ObjCDeclQualifier
ObjCDeclQualifier - 'Qualifiers' written next to the return and parameter types in method declaration...
@ OBJC_TQ_CSNullability
The nullability qualifier is set when the nullability of the result or parameter was expressed via a ...
bool isInvalidDecl() const
SourceLocation getLocation() const
static void printGroup(Decl **Begin, unsigned NumDecls, raw_ostream &Out, const PrintingPolicy &Policy, unsigned Indentation=0)
AccessSpecifier getAccess() const
void print(raw_ostream &Out, unsigned Indentation=0, bool PrintInstantiation=false) const
std::string getAsString() const
Retrieve the human-readable string for this name.
OverloadedOperatorKind getCXXOverloadedOperator() const
If this name is the name of an overloadable operator in C++ (e.g., operator+), retrieve the kind of o...
NameKind getNameKind() const
Determine what kind of name this is.
bool isIdentifier() const
Predicate functions for querying what type of name this is.
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name of this declaration, if it was present in ...
TemplateParameterList * getTemplateParameterList(unsigned index) const
unsigned getNumTemplateParameterLists() const
Expr * getTrailingRequiresClause()
Get the constraint-expression introduced by the trailing requires-clause in the function/member decla...
TypeSourceInfo * getTypeSourceInfo() const
Represents an empty-declaration.
An instance of this object exists for each enum constant that is defined.
const Expr * getInitExpr() const
bool isScoped() const
Returns true if this is a C++11 scoped enumeration.
bool isScopedUsingClassTag() const
Returns true if this is a C++11 scoped enumeration.
bool isFixed() const
Returns true if this is an Objective-C, C++11, or Microsoft-style enumeration with a fixed underlying...
QualType getIntegerType() const
Return the integer type this enum decl corresponds to.
Store information needed for an explicit specifier.
const Expr * getExpr() const
static ExplicitSpecifier getFromDecl(FunctionDecl *Function)
bool isSpecified() const
Determine if the declaration had an explicit specifier of any kind.
Represents an expression – generally a full-expression – that introduces cleanups to be run at the en...
This represents one expression.
bool isDefaultArgument() const
Determine whether this expression is a default function argument.
Represents a member of a struct/union/class.
bool isMutable() const
Determines whether this field is mutable (C++ only).
Expr * getInClassInitializer() const
Get the C++11 default member initializer for this member, or null if one has not been set.
bool isBitField() const
Determines whether this field is a bitfield.
InClassInitStyle getInClassInitStyle() const
Get the kind of (C++11) default member initializer that this field has.
Expr * getBitWidth() const
Returns the expression that represents the bit width, if this field is a bit field.
const StringLiteral * getAsmString() const
FriendDecl - Represents the declaration of a friend entity, which can be a function,...
unsigned getFriendTypeNumTemplateParameterLists() const
TemplateParameterList * getFriendTypeTemplateParameterList(unsigned N) const
NamedDecl * getFriendDecl() const
If this friend declaration doesn't name a type, return the inner declaration.
TypeSourceInfo * getFriendType() const
If this friend declaration names an (untemplated but possibly dependent) type, return the type; other...
Represents a function declaration or definition.
const ParmVarDecl * getParamDecl(unsigned i) const
Stmt * getBody(const FunctionDecl *&Definition) const
Retrieve the body (definition) of the function.
bool isFunctionTemplateSpecialization() const
Determine whether this function is a function template specialization.
FunctionTemplateDecl * getDescribedFunctionTemplate() const
Retrieves the function template that is described by this function declaration.
bool isThisDeclarationADefinition() const
Returns whether this specific declaration of the function is also a definition that does not contain ...
bool isImmediateFunction() const
StringLiteral * getDeletedMessage() const
Get the message that indicates why this function was deleted.
bool isExplicitlyDefaulted() const
Whether this function is explicitly defaulted.
bool hasWrittenPrototype() const
Whether this function has a written prototype.
bool hasPrototype() const
Whether this function has a prototype, either because one was explicitly written or because it was "i...
bool doesThisDeclarationHaveABody() const
Returns whether this specific declaration of the function has a body.
bool isConstexprSpecified() const
const TemplateArgumentList * getTemplateSpecializationArgs() const
Retrieve the template arguments used to produce this function template specialization from the primar...
StorageClass getStorageClass() const
Returns the storage class as written in the source.
bool isDeletedAsWritten() const
bool isPureVirtual() const
Whether this virtual function is pure, i.e.
bool isVirtualAsWritten() const
Whether this function is marked as virtual explicitly.
unsigned getNumParams() const
Return the number of parameters this function must have based on its FunctionType.
DeclarationNameInfo getNameInfo() const
bool isDefined(const FunctionDecl *&Definition, bool CheckForPendingFriendDefinition=false) const
Returns true if the function has a definition that does not need to be instantiated.
bool isInlineSpecified() const
Determine whether the "inline" keyword was specified for this function.
const ASTTemplateArgumentListInfo * getTemplateSpecializationArgsAsWritten() const
Retrieve the template argument list as written in the sources, if any.
Represents a prototype with parameter type info, e.g.
ExceptionSpecificationType getExceptionSpecType() const
Get the kind of exception specification on this function.
bool hasTrailingReturn() const
Whether this function prototype has a trailing return type.
QualType getExceptionType(unsigned i) const
Return the ith exception type, where 0 <= i < getNumExceptions().
unsigned getNumExceptions() const
Return the number of types in the exception specification.
bool hasDynamicExceptionSpec() const
Return whether this function has a dynamic (throw) exception spec.
bool isVariadic() const
Whether this function prototype is variadic.
Expr * getNoexceptExpr() const
Return the expression inside noexcept(expression), or a null pointer if there is none (because the ex...
RefQualifierKind getRefQualifier() const
Retrieve the ref-qualifier associated with this function type.
Declaration of a template function.
FunctionDecl * getTemplatedDecl() const
Get the underlying function declaration of the template.
spec_range specializations() const
FunctionType - C99 6.7.5.3 - Function Declarators.
HLSLBufferDecl - Represent a cbuffer or tbuffer declaration.
One of these records is kept for each identifier that is lexed.
StringRef deuglifiedName() const
If the identifier is an "uglified" reserved name, return a cleaned form.
Describes a module import declaration, which makes the contents of the named module visible in the cu...
Module * getImportedModule() const
Retrieve the module that was imported by the import declaration.
Represents the declaration of a label.
Represents a linkage specification.
LinkageSpecLanguageIDs getLanguage() const
Return the language specified by this linkage specification.
bool hasBraces() const
Determines whether this linkage specification had braces in its syntactic form.
std::string getFullModuleName(bool AllowStringLiterals=false) const
Retrieve the full name of this module, including the path from its top-level module.
This represents a decl that may have a name.
bool isModulePrivate() const
Whether this declaration was marked as being private to the module in which it was defined.
IdentifierInfo * getIdentifier() const
Get the identifier that names this declaration, if there is one.
StringRef getName() const
Get the name of identifier for this declaration as a StringRef.
DeclarationName getDeclName() const
Get the actual, stored name of the declaration, which may be a special name.
std::string getQualifiedNameAsString() const
std::string getNameAsString() const
Get a human-readable name for the declaration, even if it is one of the special kinds of names (C++ c...
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...
virtual void printName(raw_ostream &OS, const PrintingPolicy &Policy) const
Pretty-print the unqualified name of this declaration.
Represents a C++ namespace alias.
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name of the namespace.
NamedDecl * getAliasedNamespace() const
Retrieve the namespace that this alias refers to, which may either be a NamespaceDecl or a NamespaceA...
Represent a C++ namespace.
bool isInline() const
Returns true if this is an inline namespace declaration.
Represents a C++ nested name specifier, such as "\::std::vector<int>::".
void print(raw_ostream &OS, const PrintingPolicy &Policy, bool ResolveTemplateArguments=false) const
Print this nested name specifier to the given output stream.
NonTypeTemplateParmDecl - Declares a non-type template parameter, e.g., "Size" in.
bool hasDefaultArgument() const
Determine whether this template parameter has a default argument.
bool isParameterPack() const
Whether this parameter is a non-type template parameter pack.
Expr * getDefaultArgument() const
Retrieve the default argument, if any.
This represents '#pragma omp allocate ...' directive.
bool varlist_empty() const
bool clauselist_empty() const
varlist_iterator varlist_begin()
MutableArrayRef< Expr * >::iterator varlist_iterator
clauselist_range clauselists()
varlist_iterator varlist_end()
Pseudo declaration for capturing expressions.
This is a basic class for representing single OpenMP clause.
This represents '#pragma omp declare mapper ...' directive.
clauselist_range clauselists()
DeclarationName getVarName()
Get the name of the variable declared in the mapper.
bool clauselist_empty() const
This represents '#pragma omp declare reduction ...' directive.
Expr * getInitializer()
Get initializer expression (if specified) of the declare reduction construct.
Expr * getCombiner()
Get combiner expression of the declare reduction construct.
OMPDeclareReductionInitKind getInitializerKind() const
Get initializer kind.
This represents '#pragma omp requires...' directive.
clauselist_iterator clauselist_begin()
bool clauselist_empty() const
clauselist_iterator clauselist_end()
This represents '#pragma omp threadprivate ...' directive.
MutableArrayRef< Expr * >::iterator varlist_iterator
bool varlist_empty() const
varlist_iterator varlist_end()
varlist_iterator varlist_begin()
ObjCCategoryDecl - Represents a category declaration.
ObjCInterfaceDecl * getClassInterface()
ObjCTypeParamList * getTypeParamList() const
Retrieve the type parameter list associated with this category or extension.
ObjCCategoryImplDecl - An object of this class encapsulates a category @implementation declaration.
ObjCCompatibleAliasDecl - Represents alias of a class.
const ObjCInterfaceDecl * getClassInterface() const
const ObjCInterfaceDecl * getClassInterface() const
ObjCImplementationDecl - Represents a class definition - this is where method definitions are specifi...
std::string getNameAsString() const
Get the name of the class associated with this interface.
unsigned ivar_size() const
const ObjCInterfaceDecl * getSuperClass() const
Represents an ObjC class declaration.
unsigned ivar_size() const
ObjCTypeParamList * getTypeParamListAsWritten() const
Retrieve the type parameters written on this particular declaration of the class.
bool isThisDeclarationADefinition() const
Determine whether this particular declaration of this class is actually also a definition.
const ObjCProtocolList & getReferencedProtocols() const
const ObjCObjectType * getSuperClassType() const
Retrieve the superclass type.
ObjCInterfaceDecl * getSuperClass() const
ObjCList - This is a simple template class used to hold various lists of decls etc,...
ObjCMethodDecl - Represents an instance or class method declaration.
ObjCDeclQualifier getObjCDeclQualifier() const
ArrayRef< ParmVarDecl * > parameters() const
param_const_iterator param_end() const
param_const_iterator param_begin() const
Stmt * getBody() const override
Retrieve the body of this method, if it has one.
Selector getSelector() const
bool isInstanceMethod() const
QualType getReturnType() const
Represents a pointer to an Objective C object.
Represents one property declaration in an Objective-C interface.
Selector getSetterName() const
Selector getGetterName() const
ObjCPropertyAttribute::Kind getPropertyAttributes() const
PropertyControl getPropertyImplementation() const
ObjCPropertyImplDecl - Represents implementation declaration of a property in a class or category imp...
ObjCIvarDecl * getPropertyIvarDecl() const
Kind getPropertyImplementation() const
ObjCPropertyDecl * getPropertyDecl() const
Represents an Objective-C protocol declaration.
bool isThisDeclarationADefinition() const
Determine whether this particular declaration is also the definition.
const ObjCProtocolList & getReferencedProtocols() const
Stores a list of Objective-C type parameters for a parameterized class or a category/extension thereo...
Represents a pack expansion of types.
Sugar for parentheses used when specifying types.
Represents a parameter to a function.
PointerType - C99 6.7.5.1 - Pointer Declarators.
A (possibly-)qualified type.
bool isNull() const
Return true if this QualType doesn't point to a type yet.
void print(raw_ostream &OS, const PrintingPolicy &Policy, const Twine &PlaceHolder=Twine(), unsigned Indentation=0) const
StreamedQualTypeHelper stream(const PrintingPolicy &Policy, const Twine &PlaceHolder=Twine(), unsigned Indentation=0) const
static std::string getAsString(SplitQualType split, const PrintingPolicy &Policy)
Represents a struct/union/class.
Base for LValueReferenceType and RValueReferenceType.
std::string getAsString() const
Derive the full selector name (e.g.
void print(llvm::raw_ostream &OS) const
Prints the full selector name (e.g. "foo:bar:").
Encodes a location in the source.
Represents a C++11 static_assert declaration.
void printPretty(raw_ostream &OS, PrinterHelper *Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext *Context=nullptr) const
void printPrettyControlled(raw_ostream &OS, PrinterHelper *Helper, const PrintingPolicy &Policy, unsigned Indentation=0, StringRef NewlineSymbol="\n", const ASTContext *Context=nullptr) const
StringLiteral - This represents a string literal expression, e.g.
Represents the declaration of a struct/union/class/enum.
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name of this declaration, if it was present in ...
StringRef getKindName() const
bool isCompleteDefinition() const
Return true if this decl has its body fully specified.
A template argument list.
The base class of all kinds of template declarations (e.g., class, function, etc.).
NamedDecl * getTemplatedDecl() const
Get the underlying, templated declaration.
TemplateParameterList * getTemplateParameters() const
Get the list of template parameters.
Stores a list of template parameters for a TemplateDecl and its derived classes.
NamedDecl * getParam(unsigned Idx)
void print(raw_ostream &Out, const ASTContext &Context, bool OmitTemplateKW=false) const
static bool shouldIncludeTypeForArgument(const PrintingPolicy &Policy, const TemplateParameterList *TPL, unsigned Idx)
TemplateTemplateParmDecl - Declares a template template parameter, e.g., "T" in.
Declaration of a template type parameter.
bool wasDeclaredWithTypename() const
Whether this template type parameter was declared with the 'typename' keyword.
QualType getDefaultArgument() const
Retrieve the default argument, if any.
const TypeConstraint * getTypeConstraint() const
Returns the type constraint associated with this template parameter (if any).
bool hasDefaultArgument() const
Determine whether this template parameter has a default argument.
bool isParameterPack() const
Returns whether this is a parameter pack.
A declaration that models statements at global scope.
The top declaration context.
Represents the declaration of a typedef-name via a C++11 alias-declaration.
Models the abbreviated syntax to constrain a template type parameter: template <convertible_to<string...
A container of type source information.
QualType getType() const
Return the type wrapped by this type source info.
bool isStructureType() const
QualType getPointeeType() const
If this is a pointer, ObjC object pointer, or block pointer, this returns the respective pointee.
bool isSpecifierType() const
Returns true if this type can be represented by some set of type specifiers.
const T * getAs() const
Member-template getAs<specific type>'.
Represents the declaration of a typedef-name via the 'typedef' type specifier.
Base class for declarations which introduce a typedef-name.
TypeSourceInfo * getTypeSourceInfo() const
Represents a dependent using declaration which was marked with typename.
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name.
Represents a dependent using declaration which was not marked with typename.
bool isAccessDeclaration() const
Return true if it is a C++03 access declaration (no 'using').
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name.
Represents a C++ using-declaration.
bool hasTypename() const
Return true if the using declaration has 'typename'.
bool isAccessDeclaration() const
Return true if it is a C++03 access declaration (no 'using').
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name.
Represents C++ using-directive.
NestedNameSpecifier * getQualifier() const
Retrieve the nested-name-specifier that qualifies the name of the namespace.
NamedDecl * getNominatedNamespaceAsWritten()
Represents a C++ using-enum-declaration.
EnumDecl * getEnumDecl() const
Represents a shadow declaration implicitly introduced into a scope by a (resolved) using-declaration ...
Represent the declaration of a variable (in which case it is an lvalue) a function (in which case it ...
Represents a variable declaration or definition.
bool isConstexpr() const
Whether this variable is (C++11) constexpr.
InitializationStyle getInitStyle() const
The style of initialization for this declaration.
static const char * getStorageClassSpecifierString(StorageClass SC)
Return the string used to specify the storage class SC.
@ CInit
C-style initialization with assignment.
@ CallInit
Call-style initialization (C++98)
bool isCXXForRangeDecl() const
Determine whether this variable is the for-range-declaration in a C++0x for-range statement.
ThreadStorageClassSpecifier getTSCSpec() const
const Expr * getInit() const
StorageClass getStorageClass() const
Returns the storage class as written in the source.
Represents a GCC generic vector type.
@ kind_nullability
Indicates that the nullability of the type was spelled with a property attribute rather than a type q...
The JSON file list parser is used to communicate input to InstallAPI.
llvm::StringRef getAccessSpelling(AccessSpecifier AS)
@ Unspecified
Whether values of this type can be null is (explicitly) unspecified.
@ ICIS_ListInit
Direct list-initialization.
@ RQ_None
No ref-qualifier was provided.
@ RQ_LValue
An lvalue ref-qualifier was provided (&).
@ RQ_RValue
An rvalue ref-qualifier was provided (&&).
StorageClass
Storage classes.
@ TSCS_thread_local
C++11 thread_local.
@ TSCS__Thread_local
C11 _Thread_local.
@ TSCS___thread
GNU __thread.
llvm::StringRef getNullabilitySpelling(NullabilityKind kind, bool isContextSensitive=false)
Retrieve the spelling of the given nullability kind.
bool isComputedNoexcept(ExceptionSpecificationType ESpecType)
bool isNoexceptExceptionSpec(ExceptionSpecificationType ESpecType)
const FunctionProtoType * T
llvm::StringRef getAsString(SyncScope S)
@ TSK_ImplicitInstantiation
This template specialization was implicitly instantiated from a template.
@ Invariant
The parameter is invariant: must match exactly.
@ Contravariant
The parameter is contravariant, e.g., X<T> is a subtype of X when the type parameter is covariant and...
@ Covariant
The parameter is covariant, e.g., X<T> is a subtype of X when the type parameter is covariant and T i...
const char * getOperatorSpelling(OverloadedOperatorKind Operator)
Retrieve the spelling of the given overloaded operator, without the preceding "operator" keyword.
@ EST_MSAny
Microsoft throw(...) extension.
AccessSpecifier
A C++ access specifier (public, private, protected), plus the special value "none" which means differ...
void printName(raw_ostream &OS, PrintingPolicy Policy) const
printName - Print the human-readable name to a stream.
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 FullyQualifiedName
When true, print the fully qualified name of function declarations.
unsigned PrintCanonicalTypes
Whether to print types as written or canonically.
unsigned PolishForDeclaration
When true, do certain refinement needed for producing proper declaration tag; such as,...
unsigned CleanUglifiedParameters
Whether to strip underscores when printing reserved parameter names.
unsigned SuppressSpecifiers
Whether we should suppress printing of the actual specifiers for the given type or declaration.
unsigned SuppressTagKeyword
Whether type printing should skip printing the tag keyword.
unsigned SuppressScope
Suppresses printing of scope specifiers.
unsigned Indentation
The number of spaces to use to indent each line.
unsigned SuppressInitializers
Suppress printing of variable initializers.
unsigned IncludeTagDefinition
When true, include the body of a tag definition.
unsigned TerseOutput
Provide a 'terse' output.