Home | History | Annotate | Download | only in AST
      1 //===-- DeclCXX.h - Classes for representing C++ declarations -*- C++ -*-=====//
      2 //
      3 //                     The LLVM Compiler Infrastructure
      4 //
      5 // This file is distributed under the University of Illinois Open Source
      6 // License. See LICENSE.TXT for details.
      7 //
      8 //===----------------------------------------------------------------------===//
      9 ///
     10 /// \file
     11 /// \brief Defines the C++ Decl subclasses, other than those for templates
     12 /// (found in DeclTemplate.h) and friends (in DeclFriend.h).
     13 ///
     14 //===----------------------------------------------------------------------===//
     15 
     16 #ifndef LLVM_CLANG_AST_DECLCXX_H
     17 #define LLVM_CLANG_AST_DECLCXX_H
     18 
     19 #include "clang/AST/ASTContext.h"
     20 #include "clang/AST/ASTUnresolvedSet.h"
     21 #include "clang/AST/Attr.h"
     22 #include "clang/AST/Decl.h"
     23 #include "clang/AST/Expr.h"
     24 #include "clang/AST/LambdaCapture.h"
     25 #include "llvm/ADT/DenseMap.h"
     26 #include "llvm/ADT/PointerIntPair.h"
     27 #include "llvm/Support/Compiler.h"
     28 
     29 namespace clang {
     30 
     31 class ClassTemplateDecl;
     32 class ClassTemplateSpecializationDecl;
     33 class ConstructorUsingShadowDecl;
     34 class CXXBasePath;
     35 class CXXBasePaths;
     36 class CXXConstructorDecl;
     37 class CXXConversionDecl;
     38 class CXXDestructorDecl;
     39 class CXXMethodDecl;
     40 class CXXRecordDecl;
     41 class CXXMemberLookupCriteria;
     42 class CXXFinalOverriderMap;
     43 class CXXIndirectPrimaryBaseSet;
     44 class FriendDecl;
     45 class LambdaExpr;
     46 class UsingDecl;
     47 
     48 /// \brief Represents any kind of function declaration, whether it is a
     49 /// concrete function or a function template.
     50 class AnyFunctionDecl {
     51   NamedDecl *Function;
     52 
     53   AnyFunctionDecl(NamedDecl *ND) : Function(ND) { }
     54 
     55 public:
     56   AnyFunctionDecl(FunctionDecl *FD) : Function(FD) { }
     57   AnyFunctionDecl(FunctionTemplateDecl *FTD);
     58 
     59   /// \brief Implicily converts any function or function template into a
     60   /// named declaration.
     61   operator NamedDecl *() const { return Function; }
     62 
     63   /// \brief Retrieve the underlying function or function template.
     64   NamedDecl *get() const { return Function; }
     65 
     66   static AnyFunctionDecl getFromNamedDecl(NamedDecl *ND) {
     67     return AnyFunctionDecl(ND);
     68   }
     69 };
     70 
     71 } // end namespace clang
     72 
     73 namespace llvm {
     74   // Provide PointerLikeTypeTraits for non-cvr pointers.
     75   template<>
     76   class PointerLikeTypeTraits< ::clang::AnyFunctionDecl> {
     77   public:
     78     static inline void *getAsVoidPointer(::clang::AnyFunctionDecl F) {
     79       return F.get();
     80     }
     81     static inline ::clang::AnyFunctionDecl getFromVoidPointer(void *P) {
     82       return ::clang::AnyFunctionDecl::getFromNamedDecl(
     83                                       static_cast< ::clang::NamedDecl*>(P));
     84     }
     85 
     86     enum { NumLowBitsAvailable = 2 };
     87   };
     88 
     89 } // end namespace llvm
     90 
     91 namespace clang {
     92 
     93 /// \brief Represents an access specifier followed by colon ':'.
     94 ///
     95 /// An objects of this class represents sugar for the syntactic occurrence
     96 /// of an access specifier followed by a colon in the list of member
     97 /// specifiers of a C++ class definition.
     98 ///
     99 /// Note that they do not represent other uses of access specifiers,
    100 /// such as those occurring in a list of base specifiers.
    101 /// Also note that this class has nothing to do with so-called
    102 /// "access declarations" (C++98 11.3 [class.access.dcl]).
    103 class AccessSpecDecl : public Decl {
    104   virtual void anchor();
    105   /// \brief The location of the ':'.
    106   SourceLocation ColonLoc;
    107 
    108   AccessSpecDecl(AccessSpecifier AS, DeclContext *DC,
    109                  SourceLocation ASLoc, SourceLocation ColonLoc)
    110     : Decl(AccessSpec, DC, ASLoc), ColonLoc(ColonLoc) {
    111     setAccess(AS);
    112   }
    113   AccessSpecDecl(EmptyShell Empty)
    114     : Decl(AccessSpec, Empty) { }
    115 public:
    116   /// \brief The location of the access specifier.
    117   SourceLocation getAccessSpecifierLoc() const { return getLocation(); }
    118   /// \brief Sets the location of the access specifier.
    119   void setAccessSpecifierLoc(SourceLocation ASLoc) { setLocation(ASLoc); }
    120 
    121   /// \brief The location of the colon following the access specifier.
    122   SourceLocation getColonLoc() const { return ColonLoc; }
    123   /// \brief Sets the location of the colon.
    124   void setColonLoc(SourceLocation CLoc) { ColonLoc = CLoc; }
    125 
    126   SourceRange getSourceRange() const override LLVM_READONLY {
    127     return SourceRange(getAccessSpecifierLoc(), getColonLoc());
    128   }
    129 
    130   static AccessSpecDecl *Create(ASTContext &C, AccessSpecifier AS,
    131                                 DeclContext *DC, SourceLocation ASLoc,
    132                                 SourceLocation ColonLoc) {
    133     return new (C, DC) AccessSpecDecl(AS, DC, ASLoc, ColonLoc);
    134   }
    135   static AccessSpecDecl *CreateDeserialized(ASTContext &C, unsigned ID);
    136 
    137   // Implement isa/cast/dyncast/etc.
    138   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
    139   static bool classofKind(Kind K) { return K == AccessSpec; }
    140 };
    141 
    142 
    143 /// \brief Represents a base class of a C++ class.
    144 ///
    145 /// Each CXXBaseSpecifier represents a single, direct base class (or
    146 /// struct) of a C++ class (or struct). It specifies the type of that
    147 /// base class, whether it is a virtual or non-virtual base, and what
    148 /// level of access (public, protected, private) is used for the
    149 /// derivation. For example:
    150 ///
    151 /// \code
    152 ///   class A { };
    153 ///   class B { };
    154 ///   class C : public virtual A, protected B { };
    155 /// \endcode
    156 ///
    157 /// In this code, C will have two CXXBaseSpecifiers, one for "public
    158 /// virtual A" and the other for "protected B".
    159 class CXXBaseSpecifier {
    160   /// \brief The source code range that covers the full base
    161   /// specifier, including the "virtual" (if present) and access
    162   /// specifier (if present).
    163   SourceRange Range;
    164 
    165   /// \brief The source location of the ellipsis, if this is a pack
    166   /// expansion.
    167   SourceLocation EllipsisLoc;
    168 
    169   /// \brief Whether this is a virtual base class or not.
    170   unsigned Virtual : 1;
    171 
    172   /// \brief Whether this is the base of a class (true) or of a struct (false).
    173   ///
    174   /// This determines the mapping from the access specifier as written in the
    175   /// source code to the access specifier used for semantic analysis.
    176   unsigned BaseOfClass : 1;
    177 
    178   /// \brief Access specifier as written in the source code (may be AS_none).
    179   ///
    180   /// The actual type of data stored here is an AccessSpecifier, but we use
    181   /// "unsigned" here to work around a VC++ bug.
    182   unsigned Access : 2;
    183 
    184   /// \brief Whether the class contains a using declaration
    185   /// to inherit the named class's constructors.
    186   unsigned InheritConstructors : 1;
    187 
    188   /// \brief The type of the base class.
    189   ///
    190   /// This will be a class or struct (or a typedef of such). The source code
    191   /// range does not include the \c virtual or the access specifier.
    192   TypeSourceInfo *BaseTypeInfo;
    193 
    194 public:
    195   CXXBaseSpecifier() { }
    196 
    197   CXXBaseSpecifier(SourceRange R, bool V, bool BC, AccessSpecifier A,
    198                    TypeSourceInfo *TInfo, SourceLocation EllipsisLoc)
    199     : Range(R), EllipsisLoc(EllipsisLoc), Virtual(V), BaseOfClass(BC),
    200       Access(A), InheritConstructors(false), BaseTypeInfo(TInfo) { }
    201 
    202   /// \brief Retrieves the source range that contains the entire base specifier.
    203   SourceRange getSourceRange() const LLVM_READONLY { return Range; }
    204   SourceLocation getLocStart() const LLVM_READONLY { return Range.getBegin(); }
    205   SourceLocation getLocEnd() const LLVM_READONLY { return Range.getEnd(); }
    206 
    207   /// \brief Determines whether the base class is a virtual base class (or not).
    208   bool isVirtual() const { return Virtual; }
    209 
    210   /// \brief Determine whether this base class is a base of a class declared
    211   /// with the 'class' keyword (vs. one declared with the 'struct' keyword).
    212   bool isBaseOfClass() const { return BaseOfClass; }
    213 
    214   /// \brief Determine whether this base specifier is a pack expansion.
    215   bool isPackExpansion() const { return EllipsisLoc.isValid(); }
    216 
    217   /// \brief Determine whether this base class's constructors get inherited.
    218   bool getInheritConstructors() const { return InheritConstructors; }
    219 
    220   /// \brief Set that this base class's constructors should be inherited.
    221   void setInheritConstructors(bool Inherit = true) {
    222     InheritConstructors = Inherit;
    223   }
    224 
    225   /// \brief For a pack expansion, determine the location of the ellipsis.
    226   SourceLocation getEllipsisLoc() const {
    227     return EllipsisLoc;
    228   }
    229 
    230   /// \brief Returns the access specifier for this base specifier.
    231   ///
    232   /// This is the actual base specifier as used for semantic analysis, so
    233   /// the result can never be AS_none. To retrieve the access specifier as
    234   /// written in the source code, use getAccessSpecifierAsWritten().
    235   AccessSpecifier getAccessSpecifier() const {
    236     if ((AccessSpecifier)Access == AS_none)
    237       return BaseOfClass? AS_private : AS_public;
    238     else
    239       return (AccessSpecifier)Access;
    240   }
    241 
    242   /// \brief Retrieves the access specifier as written in the source code
    243   /// (which may mean that no access specifier was explicitly written).
    244   ///
    245   /// Use getAccessSpecifier() to retrieve the access specifier for use in
    246   /// semantic analysis.
    247   AccessSpecifier getAccessSpecifierAsWritten() const {
    248     return (AccessSpecifier)Access;
    249   }
    250 
    251   /// \brief Retrieves the type of the base class.
    252   ///
    253   /// This type will always be an unqualified class type.
    254   QualType getType() const {
    255     return BaseTypeInfo->getType().getUnqualifiedType();
    256   }
    257 
    258   /// \brief Retrieves the type and source location of the base class.
    259   TypeSourceInfo *getTypeSourceInfo() const { return BaseTypeInfo; }
    260 };
    261 
    262 /// \brief Represents a C++ struct/union/class.
    263 class CXXRecordDecl : public RecordDecl {
    264 
    265   friend void TagDecl::startDefinition();
    266 
    267   /// Values used in DefinitionData fields to represent special members.
    268   enum SpecialMemberFlags {
    269     SMF_DefaultConstructor = 0x1,
    270     SMF_CopyConstructor = 0x2,
    271     SMF_MoveConstructor = 0x4,
    272     SMF_CopyAssignment = 0x8,
    273     SMF_MoveAssignment = 0x10,
    274     SMF_Destructor = 0x20,
    275     SMF_All = 0x3f
    276   };
    277 
    278   struct DefinitionData {
    279     DefinitionData(CXXRecordDecl *D);
    280 
    281     /// \brief True if this class has any user-declared constructors.
    282     unsigned UserDeclaredConstructor : 1;
    283 
    284     /// \brief The user-declared special members which this class has.
    285     unsigned UserDeclaredSpecialMembers : 6;
    286 
    287     /// \brief True when this class is an aggregate.
    288     unsigned Aggregate : 1;
    289 
    290     /// \brief True when this class is a POD-type.
    291     unsigned PlainOldData : 1;
    292 
    293     /// true when this class is empty for traits purposes,
    294     /// i.e. has no data members other than 0-width bit-fields, has no
    295     /// virtual function/base, and doesn't inherit from a non-empty
    296     /// class. Doesn't take union-ness into account.
    297     unsigned Empty : 1;
    298 
    299     /// \brief True when this class is polymorphic, i.e., has at
    300     /// least one virtual member or derives from a polymorphic class.
    301     unsigned Polymorphic : 1;
    302 
    303     /// \brief True when this class is abstract, i.e., has at least
    304     /// one pure virtual function, (that can come from a base class).
    305     unsigned Abstract : 1;
    306 
    307     /// \brief True when this class has standard layout.
    308     ///
    309     /// C++11 [class]p7.  A standard-layout class is a class that:
    310     /// * has no non-static data members of type non-standard-layout class (or
    311     ///   array of such types) or reference,
    312     /// * has no virtual functions (10.3) and no virtual base classes (10.1),
    313     /// * has the same access control (Clause 11) for all non-static data
    314     ///   members
    315     /// * has no non-standard-layout base classes,
    316     /// * either has no non-static data members in the most derived class and at
    317     ///   most one base class with non-static data members, or has no base
    318     ///   classes with non-static data members, and
    319     /// * has no base classes of the same type as the first non-static data
    320     ///   member.
    321     unsigned IsStandardLayout : 1;
    322 
    323     /// \brief True when there are no non-empty base classes.
    324     ///
    325     /// This is a helper bit of state used to implement IsStandardLayout more
    326     /// efficiently.
    327     unsigned HasNoNonEmptyBases : 1;
    328 
    329     /// \brief True when there are private non-static data members.
    330     unsigned HasPrivateFields : 1;
    331 
    332     /// \brief True when there are protected non-static data members.
    333     unsigned HasProtectedFields : 1;
    334 
    335     /// \brief True when there are private non-static data members.
    336     unsigned HasPublicFields : 1;
    337 
    338     /// \brief True if this class (or any subobject) has mutable fields.
    339     unsigned HasMutableFields : 1;
    340 
    341     /// \brief True if this class (or any nested anonymous struct or union)
    342     /// has variant members.
    343     unsigned HasVariantMembers : 1;
    344 
    345     /// \brief True if there no non-field members declared by the user.
    346     unsigned HasOnlyCMembers : 1;
    347 
    348     /// \brief True if any field has an in-class initializer, including those
    349     /// within anonymous unions or structs.
    350     unsigned HasInClassInitializer : 1;
    351 
    352     /// \brief True if any field is of reference type, and does not have an
    353     /// in-class initializer.
    354     ///
    355     /// In this case, value-initialization of this class is illegal in C++98
    356     /// even if the class has a trivial default constructor.
    357     unsigned HasUninitializedReferenceMember : 1;
    358 
    359     /// \brief True if any non-mutable field whose type doesn't have a user-
    360     /// provided default ctor also doesn't have an in-class initializer.
    361     unsigned HasUninitializedFields : 1;
    362 
    363     /// \brief True if there are any member using-declarations that inherit
    364     /// constructors from a base class.
    365     unsigned HasInheritedConstructor : 1;
    366 
    367     /// \brief True if there are any member using-declarations named
    368     /// 'operator='.
    369     unsigned HasInheritedAssignment : 1;
    370 
    371     /// \brief These flags are \c true if a defaulted corresponding special
    372     /// member can't be fully analyzed without performing overload resolution.
    373     /// @{
    374     unsigned NeedOverloadResolutionForMoveConstructor : 1;
    375     unsigned NeedOverloadResolutionForMoveAssignment : 1;
    376     unsigned NeedOverloadResolutionForDestructor : 1;
    377     /// @}
    378 
    379     /// \brief These flags are \c true if an implicit defaulted corresponding
    380     /// special member would be defined as deleted.
    381     /// @{
    382     unsigned DefaultedMoveConstructorIsDeleted : 1;
    383     unsigned DefaultedMoveAssignmentIsDeleted : 1;
    384     unsigned DefaultedDestructorIsDeleted : 1;
    385     /// @}
    386 
    387     /// \brief The trivial special members which this class has, per
    388     /// C++11 [class.ctor]p5, C++11 [class.copy]p12, C++11 [class.copy]p25,
    389     /// C++11 [class.dtor]p5, or would have if the member were not suppressed.
    390     ///
    391     /// This excludes any user-declared but not user-provided special members
    392     /// which have been declared but not yet defined.
    393     unsigned HasTrivialSpecialMembers : 6;
    394 
    395     /// \brief The declared special members of this class which are known to be
    396     /// non-trivial.
    397     ///
    398     /// This excludes any user-declared but not user-provided special members
    399     /// which have been declared but not yet defined, and any implicit special
    400     /// members which have not yet been declared.
    401     unsigned DeclaredNonTrivialSpecialMembers : 6;
    402 
    403     /// \brief True when this class has a destructor with no semantic effect.
    404     unsigned HasIrrelevantDestructor : 1;
    405 
    406     /// \brief True when this class has at least one user-declared constexpr
    407     /// constructor which is neither the copy nor move constructor.
    408     unsigned HasConstexprNonCopyMoveConstructor : 1;
    409 
    410     /// \brief True if this class has a (possibly implicit) defaulted default
    411     /// constructor.
    412     unsigned HasDefaultedDefaultConstructor : 1;
    413 
    414     /// \brief True if a defaulted default constructor for this class would
    415     /// be constexpr.
    416     unsigned DefaultedDefaultConstructorIsConstexpr : 1;
    417 
    418     /// \brief True if this class has a constexpr default constructor.
    419     ///
    420     /// This is true for either a user-declared constexpr default constructor
    421     /// or an implicitly declared constexpr default constructor.
    422     unsigned HasConstexprDefaultConstructor : 1;
    423 
    424     /// \brief True when this class contains at least one non-static data
    425     /// member or base class of non-literal or volatile type.
    426     unsigned HasNonLiteralTypeFieldsOrBases : 1;
    427 
    428     /// \brief True when visible conversion functions are already computed
    429     /// and are available.
    430     unsigned ComputedVisibleConversions : 1;
    431 
    432     /// \brief Whether we have a C++11 user-provided default constructor (not
    433     /// explicitly deleted or defaulted).
    434     unsigned UserProvidedDefaultConstructor : 1;
    435 
    436     /// \brief The special members which have been declared for this class,
    437     /// either by the user or implicitly.
    438     unsigned DeclaredSpecialMembers : 6;
    439 
    440     /// \brief Whether an implicit copy constructor would have a const-qualified
    441     /// parameter.
    442     unsigned ImplicitCopyConstructorHasConstParam : 1;
    443 
    444     /// \brief Whether an implicit copy assignment operator would have a
    445     /// const-qualified parameter.
    446     unsigned ImplicitCopyAssignmentHasConstParam : 1;
    447 
    448     /// \brief Whether any declared copy constructor has a const-qualified
    449     /// parameter.
    450     unsigned HasDeclaredCopyConstructorWithConstParam : 1;
    451 
    452     /// \brief Whether any declared copy assignment operator has either a
    453     /// const-qualified reference parameter or a non-reference parameter.
    454     unsigned HasDeclaredCopyAssignmentWithConstParam : 1;
    455 
    456     /// \brief Whether this class describes a C++ lambda.
    457     unsigned IsLambda : 1;
    458 
    459     /// \brief Whether we are currently parsing base specifiers.
    460     unsigned IsParsingBaseSpecifiers : 1;
    461 
    462     /// \brief The number of base class specifiers in Bases.
    463     unsigned NumBases;
    464 
    465     /// \brief The number of virtual base class specifiers in VBases.
    466     unsigned NumVBases;
    467 
    468     /// \brief Base classes of this class.
    469     ///
    470     /// FIXME: This is wasted space for a union.
    471     LazyCXXBaseSpecifiersPtr Bases;
    472 
    473     /// \brief direct and indirect virtual base classes of this class.
    474     LazyCXXBaseSpecifiersPtr VBases;
    475 
    476     /// \brief The conversion functions of this C++ class (but not its
    477     /// inherited conversion functions).
    478     ///
    479     /// Each of the entries in this overload set is a CXXConversionDecl.
    480     LazyASTUnresolvedSet Conversions;
    481 
    482     /// \brief The conversion functions of this C++ class and all those
    483     /// inherited conversion functions that are visible in this class.
    484     ///
    485     /// Each of the entries in this overload set is a CXXConversionDecl or a
    486     /// FunctionTemplateDecl.
    487     LazyASTUnresolvedSet VisibleConversions;
    488 
    489     /// \brief The declaration which defines this record.
    490     CXXRecordDecl *Definition;
    491 
    492     /// \brief The first friend declaration in this class, or null if there
    493     /// aren't any.
    494     ///
    495     /// This is actually currently stored in reverse order.
    496     LazyDeclPtr FirstFriend;
    497 
    498     /// \brief Retrieve the set of direct base classes.
    499     CXXBaseSpecifier *getBases() const {
    500       if (!Bases.isOffset())
    501         return Bases.get(nullptr);
    502       return getBasesSlowCase();
    503     }
    504 
    505     /// \brief Retrieve the set of virtual base classes.
    506     CXXBaseSpecifier *getVBases() const {
    507       if (!VBases.isOffset())
    508         return VBases.get(nullptr);
    509       return getVBasesSlowCase();
    510     }
    511 
    512     ArrayRef<CXXBaseSpecifier> bases() const {
    513       return llvm::makeArrayRef(getBases(), NumBases);
    514     }
    515     ArrayRef<CXXBaseSpecifier> vbases() const {
    516       return llvm::makeArrayRef(getVBases(), NumVBases);
    517     }
    518 
    519   private:
    520     CXXBaseSpecifier *getBasesSlowCase() const;
    521     CXXBaseSpecifier *getVBasesSlowCase() const;
    522   };
    523 
    524   struct DefinitionData *DefinitionData;
    525 
    526   /// \brief Describes a C++ closure type (generated by a lambda expression).
    527   struct LambdaDefinitionData : public DefinitionData {
    528     typedef LambdaCapture Capture;
    529 
    530     LambdaDefinitionData(CXXRecordDecl *D, TypeSourceInfo *Info,
    531                          bool Dependent, bool IsGeneric,
    532                          LambdaCaptureDefault CaptureDefault)
    533       : DefinitionData(D), Dependent(Dependent), IsGenericLambda(IsGeneric),
    534         CaptureDefault(CaptureDefault), NumCaptures(0), NumExplicitCaptures(0),
    535         ManglingNumber(0), ContextDecl(nullptr), Captures(nullptr),
    536         MethodTyInfo(Info) {
    537       IsLambda = true;
    538 
    539       // C++11 [expr.prim.lambda]p3:
    540       //   This class type is neither an aggregate nor a literal type.
    541       Aggregate = false;
    542       PlainOldData = false;
    543       HasNonLiteralTypeFieldsOrBases = true;
    544     }
    545 
    546     /// \brief Whether this lambda is known to be dependent, even if its
    547     /// context isn't dependent.
    548     ///
    549     /// A lambda with a non-dependent context can be dependent if it occurs
    550     /// within the default argument of a function template, because the
    551     /// lambda will have been created with the enclosing context as its
    552     /// declaration context, rather than function. This is an unfortunate
    553     /// artifact of having to parse the default arguments before.
    554     unsigned Dependent : 1;
    555 
    556     /// \brief Whether this lambda is a generic lambda.
    557     unsigned IsGenericLambda : 1;
    558 
    559     /// \brief The Default Capture.
    560     unsigned CaptureDefault : 2;
    561 
    562     /// \brief The number of captures in this lambda is limited 2^NumCaptures.
    563     unsigned NumCaptures : 15;
    564 
    565     /// \brief The number of explicit captures in this lambda.
    566     unsigned NumExplicitCaptures : 13;
    567 
    568     /// \brief The number used to indicate this lambda expression for name
    569     /// mangling in the Itanium C++ ABI.
    570     unsigned ManglingNumber;
    571 
    572     /// \brief The declaration that provides context for this lambda, if the
    573     /// actual DeclContext does not suffice. This is used for lambdas that
    574     /// occur within default arguments of function parameters within the class
    575     /// or within a data member initializer.
    576     Decl *ContextDecl;
    577 
    578     /// \brief The list of captures, both explicit and implicit, for this
    579     /// lambda.
    580     Capture *Captures;
    581 
    582     /// \brief The type of the call method.
    583     TypeSourceInfo *MethodTyInfo;
    584 
    585   };
    586 
    587   struct DefinitionData *dataPtr() const {
    588     // Complete the redecl chain (if necessary).
    589     getMostRecentDecl();
    590     return DefinitionData;
    591   }
    592 
    593   struct DefinitionData &data() const {
    594     auto *DD = dataPtr();
    595     assert(DD && "queried property of class with no definition");
    596     return *DD;
    597   }
    598 
    599   struct LambdaDefinitionData &getLambdaData() const {
    600     // No update required: a merged definition cannot change any lambda
    601     // properties.
    602     auto *DD = DefinitionData;
    603     assert(DD && DD->IsLambda && "queried lambda property of non-lambda class");
    604     return static_cast<LambdaDefinitionData&>(*DD);
    605   }
    606 
    607   /// \brief The template or declaration that this declaration
    608   /// describes or was instantiated from, respectively.
    609   ///
    610   /// For non-templates, this value will be null. For record
    611   /// declarations that describe a class template, this will be a
    612   /// pointer to a ClassTemplateDecl. For member
    613   /// classes of class template specializations, this will be the
    614   /// MemberSpecializationInfo referring to the member class that was
    615   /// instantiated or specialized.
    616   llvm::PointerUnion<ClassTemplateDecl*, MemberSpecializationInfo*>
    617     TemplateOrInstantiation;
    618 
    619   friend class DeclContext;
    620   friend class LambdaExpr;
    621 
    622   /// \brief Called from setBases and addedMember to notify the class that a
    623   /// direct or virtual base class or a member of class type has been added.
    624   void addedClassSubobject(CXXRecordDecl *Base);
    625 
    626   /// \brief Notify the class that member has been added.
    627   ///
    628   /// This routine helps maintain information about the class based on which
    629   /// members have been added. It will be invoked by DeclContext::addDecl()
    630   /// whenever a member is added to this record.
    631   void addedMember(Decl *D);
    632 
    633   void markedVirtualFunctionPure();
    634   friend void FunctionDecl::setPure(bool);
    635 
    636   friend class ASTNodeImporter;
    637 
    638   /// \brief Get the head of our list of friend declarations, possibly
    639   /// deserializing the friends from an external AST source.
    640   FriendDecl *getFirstFriend() const;
    641 
    642 protected:
    643   CXXRecordDecl(Kind K, TagKind TK, const ASTContext &C, DeclContext *DC,
    644                 SourceLocation StartLoc, SourceLocation IdLoc,
    645                 IdentifierInfo *Id, CXXRecordDecl *PrevDecl);
    646 
    647 public:
    648   /// \brief Iterator that traverses the base classes of a class.
    649   typedef CXXBaseSpecifier*       base_class_iterator;
    650 
    651   /// \brief Iterator that traverses the base classes of a class.
    652   typedef const CXXBaseSpecifier* base_class_const_iterator;
    653 
    654   CXXRecordDecl *getCanonicalDecl() override {
    655     return cast<CXXRecordDecl>(RecordDecl::getCanonicalDecl());
    656   }
    657   const CXXRecordDecl *getCanonicalDecl() const {
    658     return const_cast<CXXRecordDecl*>(this)->getCanonicalDecl();
    659   }
    660 
    661   CXXRecordDecl *getPreviousDecl() {
    662     return cast_or_null<CXXRecordDecl>(
    663             static_cast<RecordDecl *>(this)->getPreviousDecl());
    664   }
    665   const CXXRecordDecl *getPreviousDecl() const {
    666     return const_cast<CXXRecordDecl*>(this)->getPreviousDecl();
    667   }
    668 
    669   CXXRecordDecl *getMostRecentDecl() {
    670     return cast<CXXRecordDecl>(
    671             static_cast<RecordDecl *>(this)->getMostRecentDecl());
    672   }
    673 
    674   const CXXRecordDecl *getMostRecentDecl() const {
    675     return const_cast<CXXRecordDecl*>(this)->getMostRecentDecl();
    676   }
    677 
    678   CXXRecordDecl *getDefinition() const {
    679     // We only need an update if we don't already know which
    680     // declaration is the definition.
    681     auto *DD = DefinitionData ? DefinitionData : dataPtr();
    682     return DD ? DD->Definition : nullptr;
    683   }
    684 
    685   bool hasDefinition() const { return DefinitionData || dataPtr(); }
    686 
    687   static CXXRecordDecl *Create(const ASTContext &C, TagKind TK, DeclContext *DC,
    688                                SourceLocation StartLoc, SourceLocation IdLoc,
    689                                IdentifierInfo *Id,
    690                                CXXRecordDecl *PrevDecl = nullptr,
    691                                bool DelayTypeCreation = false);
    692   static CXXRecordDecl *CreateLambda(const ASTContext &C, DeclContext *DC,
    693                                      TypeSourceInfo *Info, SourceLocation Loc,
    694                                      bool DependentLambda, bool IsGeneric,
    695                                      LambdaCaptureDefault CaptureDefault);
    696   static CXXRecordDecl *CreateDeserialized(const ASTContext &C, unsigned ID);
    697 
    698   bool isDynamicClass() const {
    699     return data().Polymorphic || data().NumVBases != 0;
    700   }
    701 
    702   void setIsParsingBaseSpecifiers() { data().IsParsingBaseSpecifiers = true; }
    703 
    704   bool isParsingBaseSpecifiers() const {
    705     return data().IsParsingBaseSpecifiers;
    706   }
    707 
    708   /// \brief Sets the base classes of this struct or class.
    709   void setBases(CXXBaseSpecifier const * const *Bases, unsigned NumBases);
    710 
    711   /// \brief Retrieves the number of base classes of this class.
    712   unsigned getNumBases() const { return data().NumBases; }
    713 
    714   typedef llvm::iterator_range<base_class_iterator> base_class_range;
    715   typedef llvm::iterator_range<base_class_const_iterator>
    716     base_class_const_range;
    717 
    718   base_class_range bases() {
    719     return base_class_range(bases_begin(), bases_end());
    720   }
    721   base_class_const_range bases() const {
    722     return base_class_const_range(bases_begin(), bases_end());
    723   }
    724 
    725   base_class_iterator bases_begin() { return data().getBases(); }
    726   base_class_const_iterator bases_begin() const { return data().getBases(); }
    727   base_class_iterator bases_end() { return bases_begin() + data().NumBases; }
    728   base_class_const_iterator bases_end() const {
    729     return bases_begin() + data().NumBases;
    730   }
    731 
    732   /// \brief Retrieves the number of virtual base classes of this class.
    733   unsigned getNumVBases() const { return data().NumVBases; }
    734 
    735   base_class_range vbases() {
    736     return base_class_range(vbases_begin(), vbases_end());
    737   }
    738   base_class_const_range vbases() const {
    739     return base_class_const_range(vbases_begin(), vbases_end());
    740   }
    741 
    742   base_class_iterator vbases_begin() { return data().getVBases(); }
    743   base_class_const_iterator vbases_begin() const { return data().getVBases(); }
    744   base_class_iterator vbases_end() { return vbases_begin() + data().NumVBases; }
    745   base_class_const_iterator vbases_end() const {
    746     return vbases_begin() + data().NumVBases;
    747   }
    748 
    749   /// \brief Determine whether this class has any dependent base classes which
    750   /// are not the current instantiation.
    751   bool hasAnyDependentBases() const;
    752 
    753   /// Iterator access to method members.  The method iterator visits
    754   /// all method members of the class, including non-instance methods,
    755   /// special methods, etc.
    756   typedef specific_decl_iterator<CXXMethodDecl> method_iterator;
    757   typedef llvm::iterator_range<specific_decl_iterator<CXXMethodDecl>>
    758     method_range;
    759 
    760   method_range methods() const {
    761     return method_range(method_begin(), method_end());
    762   }
    763 
    764   /// \brief Method begin iterator.  Iterates in the order the methods
    765   /// were declared.
    766   method_iterator method_begin() const {
    767     return method_iterator(decls_begin());
    768   }
    769   /// \brief Method past-the-end iterator.
    770   method_iterator method_end() const {
    771     return method_iterator(decls_end());
    772   }
    773 
    774   /// Iterator access to constructor members.
    775   typedef specific_decl_iterator<CXXConstructorDecl> ctor_iterator;
    776   typedef llvm::iterator_range<specific_decl_iterator<CXXConstructorDecl>>
    777     ctor_range;
    778 
    779   ctor_range ctors() const { return ctor_range(ctor_begin(), ctor_end()); }
    780 
    781   ctor_iterator ctor_begin() const {
    782     return ctor_iterator(decls_begin());
    783   }
    784   ctor_iterator ctor_end() const {
    785     return ctor_iterator(decls_end());
    786   }
    787 
    788   /// An iterator over friend declarations.  All of these are defined
    789   /// in DeclFriend.h.
    790   class friend_iterator;
    791   typedef llvm::iterator_range<friend_iterator> friend_range;
    792 
    793   friend_range friends() const;
    794   friend_iterator friend_begin() const;
    795   friend_iterator friend_end() const;
    796   void pushFriendDecl(FriendDecl *FD);
    797 
    798   /// Determines whether this record has any friends.
    799   bool hasFriends() const {
    800     return data().FirstFriend.isValid();
    801   }
    802 
    803   /// \brief \c true if we know for sure that this class has a single,
    804   /// accessible, unambiguous move constructor that is not deleted.
    805   bool hasSimpleMoveConstructor() const {
    806     return !hasUserDeclaredMoveConstructor() && hasMoveConstructor() &&
    807            !data().DefaultedMoveConstructorIsDeleted;
    808   }
    809   /// \brief \c true if we know for sure that this class has a single,
    810   /// accessible, unambiguous move assignment operator that is not deleted.
    811   bool hasSimpleMoveAssignment() const {
    812     return !hasUserDeclaredMoveAssignment() && hasMoveAssignment() &&
    813            !data().DefaultedMoveAssignmentIsDeleted;
    814   }
    815   /// \brief \c true if we know for sure that this class has an accessible
    816   /// destructor that is not deleted.
    817   bool hasSimpleDestructor() const {
    818     return !hasUserDeclaredDestructor() &&
    819            !data().DefaultedDestructorIsDeleted;
    820   }
    821 
    822   /// \brief Determine whether this class has any default constructors.
    823   bool hasDefaultConstructor() const {
    824     return (data().DeclaredSpecialMembers & SMF_DefaultConstructor) ||
    825            needsImplicitDefaultConstructor();
    826   }
    827 
    828   /// \brief Determine if we need to declare a default constructor for
    829   /// this class.
    830   ///
    831   /// This value is used for lazy creation of default constructors.
    832   bool needsImplicitDefaultConstructor() const {
    833     return !data().UserDeclaredConstructor &&
    834            !(data().DeclaredSpecialMembers & SMF_DefaultConstructor) &&
    835            // C++14 [expr.prim.lambda]p20:
    836            //   The closure type associated with a lambda-expression has no
    837            //   default constructor.
    838            !isLambda();
    839   }
    840 
    841   /// \brief Determine whether this class has any user-declared constructors.
    842   ///
    843   /// When true, a default constructor will not be implicitly declared.
    844   bool hasUserDeclaredConstructor() const {
    845     return data().UserDeclaredConstructor;
    846   }
    847 
    848   /// \brief Whether this class has a user-provided default constructor
    849   /// per C++11.
    850   bool hasUserProvidedDefaultConstructor() const {
    851     return data().UserProvidedDefaultConstructor;
    852   }
    853 
    854   /// \brief Determine whether this class has a user-declared copy constructor.
    855   ///
    856   /// When false, a copy constructor will be implicitly declared.
    857   bool hasUserDeclaredCopyConstructor() const {
    858     return data().UserDeclaredSpecialMembers & SMF_CopyConstructor;
    859   }
    860 
    861   /// \brief Determine whether this class needs an implicit copy
    862   /// constructor to be lazily declared.
    863   bool needsImplicitCopyConstructor() const {
    864     return !(data().DeclaredSpecialMembers & SMF_CopyConstructor);
    865   }
    866 
    867   /// \brief Determine whether we need to eagerly declare a defaulted copy
    868   /// constructor for this class.
    869   bool needsOverloadResolutionForCopyConstructor() const {
    870     return data().HasMutableFields;
    871   }
    872 
    873   /// \brief Determine whether an implicit copy constructor for this type
    874   /// would have a parameter with a const-qualified reference type.
    875   bool implicitCopyConstructorHasConstParam() const {
    876     return data().ImplicitCopyConstructorHasConstParam;
    877   }
    878 
    879   /// \brief Determine whether this class has a copy constructor with
    880   /// a parameter type which is a reference to a const-qualified type.
    881   bool hasCopyConstructorWithConstParam() const {
    882     return data().HasDeclaredCopyConstructorWithConstParam ||
    883            (needsImplicitCopyConstructor() &&
    884             implicitCopyConstructorHasConstParam());
    885   }
    886 
    887   /// \brief Whether this class has a user-declared move constructor or
    888   /// assignment operator.
    889   ///
    890   /// When false, a move constructor and assignment operator may be
    891   /// implicitly declared.
    892   bool hasUserDeclaredMoveOperation() const {
    893     return data().UserDeclaredSpecialMembers &
    894              (SMF_MoveConstructor | SMF_MoveAssignment);
    895   }
    896 
    897   /// \brief Determine whether this class has had a move constructor
    898   /// declared by the user.
    899   bool hasUserDeclaredMoveConstructor() const {
    900     return data().UserDeclaredSpecialMembers & SMF_MoveConstructor;
    901   }
    902 
    903   /// \brief Determine whether this class has a move constructor.
    904   bool hasMoveConstructor() const {
    905     return (data().DeclaredSpecialMembers & SMF_MoveConstructor) ||
    906            needsImplicitMoveConstructor();
    907   }
    908 
    909   /// \brief Set that we attempted to declare an implicitly move
    910   /// constructor, but overload resolution failed so we deleted it.
    911   void setImplicitMoveConstructorIsDeleted() {
    912     assert((data().DefaultedMoveConstructorIsDeleted ||
    913             needsOverloadResolutionForMoveConstructor()) &&
    914            "move constructor should not be deleted");
    915     data().DefaultedMoveConstructorIsDeleted = true;
    916   }
    917 
    918   /// \brief Determine whether this class should get an implicit move
    919   /// constructor or if any existing special member function inhibits this.
    920   bool needsImplicitMoveConstructor() const {
    921     return !(data().DeclaredSpecialMembers & SMF_MoveConstructor) &&
    922            !hasUserDeclaredCopyConstructor() &&
    923            !hasUserDeclaredCopyAssignment() &&
    924            !hasUserDeclaredMoveAssignment() &&
    925            !hasUserDeclaredDestructor();
    926   }
    927 
    928   /// \brief Determine whether we need to eagerly declare a defaulted move
    929   /// constructor for this class.
    930   bool needsOverloadResolutionForMoveConstructor() const {
    931     return data().NeedOverloadResolutionForMoveConstructor;
    932   }
    933 
    934   /// \brief Determine whether this class has a user-declared copy assignment
    935   /// operator.
    936   ///
    937   /// When false, a copy assigment operator will be implicitly declared.
    938   bool hasUserDeclaredCopyAssignment() const {
    939     return data().UserDeclaredSpecialMembers & SMF_CopyAssignment;
    940   }
    941 
    942   /// \brief Determine whether this class needs an implicit copy
    943   /// assignment operator to be lazily declared.
    944   bool needsImplicitCopyAssignment() const {
    945     return !(data().DeclaredSpecialMembers & SMF_CopyAssignment);
    946   }
    947 
    948   /// \brief Determine whether we need to eagerly declare a defaulted copy
    949   /// assignment operator for this class.
    950   bool needsOverloadResolutionForCopyAssignment() const {
    951     return data().HasMutableFields;
    952   }
    953 
    954   /// \brief Determine whether an implicit copy assignment operator for this
    955   /// type would have a parameter with a const-qualified reference type.
    956   bool implicitCopyAssignmentHasConstParam() const {
    957     return data().ImplicitCopyAssignmentHasConstParam;
    958   }
    959 
    960   /// \brief Determine whether this class has a copy assignment operator with
    961   /// a parameter type which is a reference to a const-qualified type or is not
    962   /// a reference.
    963   bool hasCopyAssignmentWithConstParam() const {
    964     return data().HasDeclaredCopyAssignmentWithConstParam ||
    965            (needsImplicitCopyAssignment() &&
    966             implicitCopyAssignmentHasConstParam());
    967   }
    968 
    969   /// \brief Determine whether this class has had a move assignment
    970   /// declared by the user.
    971   bool hasUserDeclaredMoveAssignment() const {
    972     return data().UserDeclaredSpecialMembers & SMF_MoveAssignment;
    973   }
    974 
    975   /// \brief Determine whether this class has a move assignment operator.
    976   bool hasMoveAssignment() const {
    977     return (data().DeclaredSpecialMembers & SMF_MoveAssignment) ||
    978            needsImplicitMoveAssignment();
    979   }
    980 
    981   /// \brief Set that we attempted to declare an implicit move assignment
    982   /// operator, but overload resolution failed so we deleted it.
    983   void setImplicitMoveAssignmentIsDeleted() {
    984     assert((data().DefaultedMoveAssignmentIsDeleted ||
    985             needsOverloadResolutionForMoveAssignment()) &&
    986            "move assignment should not be deleted");
    987     data().DefaultedMoveAssignmentIsDeleted = true;
    988   }
    989 
    990   /// \brief Determine whether this class should get an implicit move
    991   /// assignment operator or if any existing special member function inhibits
    992   /// this.
    993   bool needsImplicitMoveAssignment() const {
    994     return !(data().DeclaredSpecialMembers & SMF_MoveAssignment) &&
    995            !hasUserDeclaredCopyConstructor() &&
    996            !hasUserDeclaredCopyAssignment() &&
    997            !hasUserDeclaredMoveConstructor() &&
    998            !hasUserDeclaredDestructor();
    999   }
   1000 
   1001   /// \brief Determine whether we need to eagerly declare a move assignment
   1002   /// operator for this class.
   1003   bool needsOverloadResolutionForMoveAssignment() const {
   1004     return data().NeedOverloadResolutionForMoveAssignment;
   1005   }
   1006 
   1007   /// \brief Determine whether this class has a user-declared destructor.
   1008   ///
   1009   /// When false, a destructor will be implicitly declared.
   1010   bool hasUserDeclaredDestructor() const {
   1011     return data().UserDeclaredSpecialMembers & SMF_Destructor;
   1012   }
   1013 
   1014   /// \brief Determine whether this class needs an implicit destructor to
   1015   /// be lazily declared.
   1016   bool needsImplicitDestructor() const {
   1017     return !(data().DeclaredSpecialMembers & SMF_Destructor);
   1018   }
   1019 
   1020   /// \brief Determine whether we need to eagerly declare a destructor for this
   1021   /// class.
   1022   bool needsOverloadResolutionForDestructor() const {
   1023     return data().NeedOverloadResolutionForDestructor;
   1024   }
   1025 
   1026   /// \brief Determine whether this class describes a lambda function object.
   1027   bool isLambda() const {
   1028     // An update record can't turn a non-lambda into a lambda.
   1029     auto *DD = DefinitionData;
   1030     return DD && DD->IsLambda;
   1031   }
   1032 
   1033   /// \brief Determine whether this class describes a generic
   1034   /// lambda function object (i.e. function call operator is
   1035   /// a template).
   1036   bool isGenericLambda() const;
   1037 
   1038   /// \brief Retrieve the lambda call operator of the closure type
   1039   /// if this is a closure type.
   1040   CXXMethodDecl *getLambdaCallOperator() const;
   1041 
   1042   /// \brief Retrieve the lambda static invoker, the address of which
   1043   /// is returned by the conversion operator, and the body of which
   1044   /// is forwarded to the lambda call operator.
   1045   CXXMethodDecl *getLambdaStaticInvoker() const;
   1046 
   1047   /// \brief Retrieve the generic lambda's template parameter list.
   1048   /// Returns null if the class does not represent a lambda or a generic
   1049   /// lambda.
   1050   TemplateParameterList *getGenericLambdaTemplateParameterList() const;
   1051 
   1052   LambdaCaptureDefault getLambdaCaptureDefault() const {
   1053     assert(isLambda());
   1054     return static_cast<LambdaCaptureDefault>(getLambdaData().CaptureDefault);
   1055   }
   1056 
   1057   /// \brief For a closure type, retrieve the mapping from captured
   1058   /// variables and \c this to the non-static data members that store the
   1059   /// values or references of the captures.
   1060   ///
   1061   /// \param Captures Will be populated with the mapping from captured
   1062   /// variables to the corresponding fields.
   1063   ///
   1064   /// \param ThisCapture Will be set to the field declaration for the
   1065   /// \c this capture.
   1066   ///
   1067   /// \note No entries will be added for init-captures, as they do not capture
   1068   /// variables.
   1069   void getCaptureFields(llvm::DenseMap<const VarDecl *, FieldDecl *> &Captures,
   1070                         FieldDecl *&ThisCapture) const;
   1071 
   1072   typedef const LambdaCapture *capture_const_iterator;
   1073   typedef llvm::iterator_range<capture_const_iterator> capture_const_range;
   1074 
   1075   capture_const_range captures() const {
   1076     return capture_const_range(captures_begin(), captures_end());
   1077   }
   1078   capture_const_iterator captures_begin() const {
   1079     return isLambda() ? getLambdaData().Captures : nullptr;
   1080   }
   1081   capture_const_iterator captures_end() const {
   1082     return isLambda() ? captures_begin() + getLambdaData().NumCaptures
   1083                       : nullptr;
   1084   }
   1085 
   1086   typedef UnresolvedSetIterator conversion_iterator;
   1087   conversion_iterator conversion_begin() const {
   1088     return data().Conversions.get(getASTContext()).begin();
   1089   }
   1090   conversion_iterator conversion_end() const {
   1091     return data().Conversions.get(getASTContext()).end();
   1092   }
   1093 
   1094   /// Removes a conversion function from this class.  The conversion
   1095   /// function must currently be a member of this class.  Furthermore,
   1096   /// this class must currently be in the process of being defined.
   1097   void removeConversion(const NamedDecl *Old);
   1098 
   1099   /// \brief Get all conversion functions visible in current class,
   1100   /// including conversion function templates.
   1101   llvm::iterator_range<conversion_iterator> getVisibleConversionFunctions();
   1102 
   1103   /// Determine whether this class is an aggregate (C++ [dcl.init.aggr]),
   1104   /// which is a class with no user-declared constructors, no private
   1105   /// or protected non-static data members, no base classes, and no virtual
   1106   /// functions (C++ [dcl.init.aggr]p1).
   1107   bool isAggregate() const { return data().Aggregate; }
   1108 
   1109   /// \brief Whether this class has any in-class initializers
   1110   /// for non-static data members (including those in anonymous unions or
   1111   /// structs).
   1112   bool hasInClassInitializer() const { return data().HasInClassInitializer; }
   1113 
   1114   /// \brief Whether this class or any of its subobjects has any members of
   1115   /// reference type which would make value-initialization ill-formed.
   1116   ///
   1117   /// Per C++03 [dcl.init]p5:
   1118   ///  - if T is a non-union class type without a user-declared constructor,
   1119   ///    then every non-static data member and base-class component of T is
   1120   ///    value-initialized [...] A program that calls for [...]
   1121   ///    value-initialization of an entity of reference type is ill-formed.
   1122   bool hasUninitializedReferenceMember() const {
   1123     return !isUnion() && !hasUserDeclaredConstructor() &&
   1124            data().HasUninitializedReferenceMember;
   1125   }
   1126 
   1127   /// \brief Whether this class is a POD-type (C++ [class]p4)
   1128   ///
   1129   /// For purposes of this function a class is POD if it is an aggregate
   1130   /// that has no non-static non-POD data members, no reference data
   1131   /// members, no user-defined copy assignment operator and no
   1132   /// user-defined destructor.
   1133   ///
   1134   /// Note that this is the C++ TR1 definition of POD.
   1135   bool isPOD() const { return data().PlainOldData; }
   1136 
   1137   /// \brief True if this class is C-like, without C++-specific features, e.g.
   1138   /// it contains only public fields, no bases, tag kind is not 'class', etc.
   1139   bool isCLike() const;
   1140 
   1141   /// \brief Determine whether this is an empty class in the sense of
   1142   /// (C++11 [meta.unary.prop]).
   1143   ///
   1144   /// The CXXRecordDecl is a class type, but not a union type,
   1145   /// with no non-static data members other than bit-fields of length 0,
   1146   /// no virtual member functions, no virtual base classes,
   1147   /// and no base class B for which is_empty<B>::value is false.
   1148   ///
   1149   /// \note This does NOT include a check for union-ness.
   1150   bool isEmpty() const { return data().Empty; }
   1151 
   1152   /// Whether this class is polymorphic (C++ [class.virtual]),
   1153   /// which means that the class contains or inherits a virtual function.
   1154   bool isPolymorphic() const { return data().Polymorphic; }
   1155 
   1156   /// \brief Determine whether this class has a pure virtual function.
   1157   ///
   1158   /// The class is is abstract per (C++ [class.abstract]p2) if it declares
   1159   /// a pure virtual function or inherits a pure virtual function that is
   1160   /// not overridden.
   1161   bool isAbstract() const { return data().Abstract; }
   1162 
   1163   /// \brief Determine whether this class has standard layout per
   1164   /// (C++ [class]p7)
   1165   bool isStandardLayout() const { return data().IsStandardLayout; }
   1166 
   1167   /// \brief Determine whether this class, or any of its class subobjects,
   1168   /// contains a mutable field.
   1169   bool hasMutableFields() const { return data().HasMutableFields; }
   1170 
   1171   /// \brief Determine whether this class has any variant members.
   1172   bool hasVariantMembers() const { return data().HasVariantMembers; }
   1173 
   1174   /// \brief Determine whether this class has a trivial default constructor
   1175   /// (C++11 [class.ctor]p5).
   1176   bool hasTrivialDefaultConstructor() const {
   1177     return hasDefaultConstructor() &&
   1178            (data().HasTrivialSpecialMembers & SMF_DefaultConstructor);
   1179   }
   1180 
   1181   /// \brief Determine whether this class has a non-trivial default constructor
   1182   /// (C++11 [class.ctor]p5).
   1183   bool hasNonTrivialDefaultConstructor() const {
   1184     return (data().DeclaredNonTrivialSpecialMembers & SMF_DefaultConstructor) ||
   1185            (needsImplicitDefaultConstructor() &&
   1186             !(data().HasTrivialSpecialMembers & SMF_DefaultConstructor));
   1187   }
   1188 
   1189   /// \brief Determine whether this class has at least one constexpr constructor
   1190   /// other than the copy or move constructors.
   1191   bool hasConstexprNonCopyMoveConstructor() const {
   1192     return data().HasConstexprNonCopyMoveConstructor ||
   1193            (needsImplicitDefaultConstructor() &&
   1194             defaultedDefaultConstructorIsConstexpr());
   1195   }
   1196 
   1197   /// \brief Determine whether a defaulted default constructor for this class
   1198   /// would be constexpr.
   1199   bool defaultedDefaultConstructorIsConstexpr() const {
   1200     return data().DefaultedDefaultConstructorIsConstexpr &&
   1201            (!isUnion() || hasInClassInitializer() || !hasVariantMembers());
   1202   }
   1203 
   1204   /// \brief Determine whether this class has a constexpr default constructor.
   1205   bool hasConstexprDefaultConstructor() const {
   1206     return data().HasConstexprDefaultConstructor ||
   1207            (needsImplicitDefaultConstructor() &&
   1208             defaultedDefaultConstructorIsConstexpr());
   1209   }
   1210 
   1211   /// \brief Determine whether this class has a trivial copy constructor
   1212   /// (C++ [class.copy]p6, C++11 [class.copy]p12)
   1213   bool hasTrivialCopyConstructor() const {
   1214     return data().HasTrivialSpecialMembers & SMF_CopyConstructor;
   1215   }
   1216 
   1217   /// \brief Determine whether this class has a non-trivial copy constructor
   1218   /// (C++ [class.copy]p6, C++11 [class.copy]p12)
   1219   bool hasNonTrivialCopyConstructor() const {
   1220     return data().DeclaredNonTrivialSpecialMembers & SMF_CopyConstructor ||
   1221            !hasTrivialCopyConstructor();
   1222   }
   1223 
   1224   /// \brief Determine whether this class has a trivial move constructor
   1225   /// (C++11 [class.copy]p12)
   1226   bool hasTrivialMoveConstructor() const {
   1227     return hasMoveConstructor() &&
   1228            (data().HasTrivialSpecialMembers & SMF_MoveConstructor);
   1229   }
   1230 
   1231   /// \brief Determine whether this class has a non-trivial move constructor
   1232   /// (C++11 [class.copy]p12)
   1233   bool hasNonTrivialMoveConstructor() const {
   1234     return (data().DeclaredNonTrivialSpecialMembers & SMF_MoveConstructor) ||
   1235            (needsImplicitMoveConstructor() &&
   1236             !(data().HasTrivialSpecialMembers & SMF_MoveConstructor));
   1237   }
   1238 
   1239   /// \brief Determine whether this class has a trivial copy assignment operator
   1240   /// (C++ [class.copy]p11, C++11 [class.copy]p25)
   1241   bool hasTrivialCopyAssignment() const {
   1242     return data().HasTrivialSpecialMembers & SMF_CopyAssignment;
   1243   }
   1244 
   1245   /// \brief Determine whether this class has a non-trivial copy assignment
   1246   /// operator (C++ [class.copy]p11, C++11 [class.copy]p25)
   1247   bool hasNonTrivialCopyAssignment() const {
   1248     return data().DeclaredNonTrivialSpecialMembers & SMF_CopyAssignment ||
   1249            !hasTrivialCopyAssignment();
   1250   }
   1251 
   1252   /// \brief Determine whether this class has a trivial move assignment operator
   1253   /// (C++11 [class.copy]p25)
   1254   bool hasTrivialMoveAssignment() const {
   1255     return hasMoveAssignment() &&
   1256            (data().HasTrivialSpecialMembers & SMF_MoveAssignment);
   1257   }
   1258 
   1259   /// \brief Determine whether this class has a non-trivial move assignment
   1260   /// operator (C++11 [class.copy]p25)
   1261   bool hasNonTrivialMoveAssignment() const {
   1262     return (data().DeclaredNonTrivialSpecialMembers & SMF_MoveAssignment) ||
   1263            (needsImplicitMoveAssignment() &&
   1264             !(data().HasTrivialSpecialMembers & SMF_MoveAssignment));
   1265   }
   1266 
   1267   /// \brief Determine whether this class has a trivial destructor
   1268   /// (C++ [class.dtor]p3)
   1269   bool hasTrivialDestructor() const {
   1270     return data().HasTrivialSpecialMembers & SMF_Destructor;
   1271   }
   1272 
   1273   /// \brief Determine whether this class has a non-trivial destructor
   1274   /// (C++ [class.dtor]p3)
   1275   bool hasNonTrivialDestructor() const {
   1276     return !(data().HasTrivialSpecialMembers & SMF_Destructor);
   1277   }
   1278 
   1279   /// \brief Determine whether declaring a const variable with this type is ok
   1280   /// per core issue 253.
   1281   bool allowConstDefaultInit() const {
   1282     return !data().HasUninitializedFields ||
   1283            !(data().HasDefaultedDefaultConstructor ||
   1284              needsImplicitDefaultConstructor());
   1285   }
   1286 
   1287   /// \brief Determine whether this class has a destructor which has no
   1288   /// semantic effect.
   1289   ///
   1290   /// Any such destructor will be trivial, public, defaulted and not deleted,
   1291   /// and will call only irrelevant destructors.
   1292   bool hasIrrelevantDestructor() const {
   1293     return data().HasIrrelevantDestructor;
   1294   }
   1295 
   1296   /// \brief Determine whether this class has a non-literal or/ volatile type
   1297   /// non-static data member or base class.
   1298   bool hasNonLiteralTypeFieldsOrBases() const {
   1299     return data().HasNonLiteralTypeFieldsOrBases;
   1300   }
   1301 
   1302   /// \brief Determine whether this class has a using-declaration that names
   1303   /// a user-declared base class constructor.
   1304   bool hasInheritedConstructor() const {
   1305     return data().HasInheritedConstructor;
   1306   }
   1307 
   1308   /// \brief Determine whether this class has a using-declaration that names
   1309   /// a base class assignment operator.
   1310   bool hasInheritedAssignment() const {
   1311     return data().HasInheritedAssignment;
   1312   }
   1313 
   1314   /// \brief Determine whether this class is considered trivially copyable per
   1315   /// (C++11 [class]p6).
   1316   bool isTriviallyCopyable() const;
   1317 
   1318   /// \brief Determine whether this class is considered trivial.
   1319   ///
   1320   /// C++11 [class]p6:
   1321   ///    "A trivial class is a class that has a trivial default constructor and
   1322   ///    is trivially copiable."
   1323   bool isTrivial() const {
   1324     return isTriviallyCopyable() && hasTrivialDefaultConstructor();
   1325   }
   1326 
   1327   /// \brief Determine whether this class is a literal type.
   1328   ///
   1329   /// C++11 [basic.types]p10:
   1330   ///   A class type that has all the following properties:
   1331   ///     - it has a trivial destructor
   1332   ///     - every constructor call and full-expression in the
   1333   ///       brace-or-equal-intializers for non-static data members (if any) is
   1334   ///       a constant expression.
   1335   ///     - it is an aggregate type or has at least one constexpr constructor
   1336   ///       or constructor template that is not a copy or move constructor, and
   1337   ///     - all of its non-static data members and base classes are of literal
   1338   ///       types
   1339   ///
   1340   /// We resolve DR1361 by ignoring the second bullet. We resolve DR1452 by
   1341   /// treating types with trivial default constructors as literal types.
   1342   bool isLiteral() const {
   1343     return hasTrivialDestructor() &&
   1344            (isAggregate() || hasConstexprNonCopyMoveConstructor() ||
   1345             hasTrivialDefaultConstructor()) &&
   1346            !hasNonLiteralTypeFieldsOrBases();
   1347   }
   1348 
   1349   /// \brief If this record is an instantiation of a member class,
   1350   /// retrieves the member class from which it was instantiated.
   1351   ///
   1352   /// This routine will return non-null for (non-templated) member
   1353   /// classes of class templates. For example, given:
   1354   ///
   1355   /// \code
   1356   /// template<typename T>
   1357   /// struct X {
   1358   ///   struct A { };
   1359   /// };
   1360   /// \endcode
   1361   ///
   1362   /// The declaration for X<int>::A is a (non-templated) CXXRecordDecl
   1363   /// whose parent is the class template specialization X<int>. For
   1364   /// this declaration, getInstantiatedFromMemberClass() will return
   1365   /// the CXXRecordDecl X<T>::A. When a complete definition of
   1366   /// X<int>::A is required, it will be instantiated from the
   1367   /// declaration returned by getInstantiatedFromMemberClass().
   1368   CXXRecordDecl *getInstantiatedFromMemberClass() const;
   1369 
   1370   /// \brief If this class is an instantiation of a member class of a
   1371   /// class template specialization, retrieves the member specialization
   1372   /// information.
   1373   MemberSpecializationInfo *getMemberSpecializationInfo() const;
   1374 
   1375   /// \brief Specify that this record is an instantiation of the
   1376   /// member class \p RD.
   1377   void setInstantiationOfMemberClass(CXXRecordDecl *RD,
   1378                                      TemplateSpecializationKind TSK);
   1379 
   1380   /// \brief Retrieves the class template that is described by this
   1381   /// class declaration.
   1382   ///
   1383   /// Every class template is represented as a ClassTemplateDecl and a
   1384   /// CXXRecordDecl. The former contains template properties (such as
   1385   /// the template parameter lists) while the latter contains the
   1386   /// actual description of the template's
   1387   /// contents. ClassTemplateDecl::getTemplatedDecl() retrieves the
   1388   /// CXXRecordDecl that from a ClassTemplateDecl, while
   1389   /// getDescribedClassTemplate() retrieves the ClassTemplateDecl from
   1390   /// a CXXRecordDecl.
   1391   ClassTemplateDecl *getDescribedClassTemplate() const;
   1392 
   1393   void setDescribedClassTemplate(ClassTemplateDecl *Template);
   1394 
   1395   /// \brief Determine whether this particular class is a specialization or
   1396   /// instantiation of a class template or member class of a class template,
   1397   /// and how it was instantiated or specialized.
   1398   TemplateSpecializationKind getTemplateSpecializationKind() const;
   1399 
   1400   /// \brief Set the kind of specialization or template instantiation this is.
   1401   void setTemplateSpecializationKind(TemplateSpecializationKind TSK);
   1402 
   1403   /// \brief Retrieve the record declaration from which this record could be
   1404   /// instantiated. Returns null if this class is not a template instantiation.
   1405   const CXXRecordDecl *getTemplateInstantiationPattern() const;
   1406 
   1407   CXXRecordDecl *getTemplateInstantiationPattern() {
   1408     return const_cast<CXXRecordDecl *>(const_cast<const CXXRecordDecl *>(this)
   1409                                            ->getTemplateInstantiationPattern());
   1410   }
   1411 
   1412   /// \brief Returns the destructor decl for this class.
   1413   CXXDestructorDecl *getDestructor() const;
   1414 
   1415   /// \brief Returns true if the class destructor, or any implicitly invoked
   1416   /// destructors are marked noreturn.
   1417   bool isAnyDestructorNoReturn() const;
   1418 
   1419   /// \brief If the class is a local class [class.local], returns
   1420   /// the enclosing function declaration.
   1421   const FunctionDecl *isLocalClass() const {
   1422     if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(getDeclContext()))
   1423       return RD->isLocalClass();
   1424 
   1425     return dyn_cast<FunctionDecl>(getDeclContext());
   1426   }
   1427 
   1428   FunctionDecl *isLocalClass() {
   1429     return const_cast<FunctionDecl*>(
   1430         const_cast<const CXXRecordDecl*>(this)->isLocalClass());
   1431   }
   1432 
   1433   /// \brief Determine whether this dependent class is a current instantiation,
   1434   /// when viewed from within the given context.
   1435   bool isCurrentInstantiation(const DeclContext *CurContext) const;
   1436 
   1437   /// \brief Determine whether this class is derived from the class \p Base.
   1438   ///
   1439   /// This routine only determines whether this class is derived from \p Base,
   1440   /// but does not account for factors that may make a Derived -> Base class
   1441   /// ill-formed, such as private/protected inheritance or multiple, ambiguous
   1442   /// base class subobjects.
   1443   ///
   1444   /// \param Base the base class we are searching for.
   1445   ///
   1446   /// \returns true if this class is derived from Base, false otherwise.
   1447   bool isDerivedFrom(const CXXRecordDecl *Base) const;
   1448 
   1449   /// \brief Determine whether this class is derived from the type \p Base.
   1450   ///
   1451   /// This routine only determines whether this class is derived from \p Base,
   1452   /// but does not account for factors that may make a Derived -> Base class
   1453   /// ill-formed, such as private/protected inheritance or multiple, ambiguous
   1454   /// base class subobjects.
   1455   ///
   1456   /// \param Base the base class we are searching for.
   1457   ///
   1458   /// \param Paths will contain the paths taken from the current class to the
   1459   /// given \p Base class.
   1460   ///
   1461   /// \returns true if this class is derived from \p Base, false otherwise.
   1462   ///
   1463   /// \todo add a separate parameter to configure IsDerivedFrom, rather than
   1464   /// tangling input and output in \p Paths
   1465   bool isDerivedFrom(const CXXRecordDecl *Base, CXXBasePaths &Paths) const;
   1466 
   1467   /// \brief Determine whether this class is virtually derived from
   1468   /// the class \p Base.
   1469   ///
   1470   /// This routine only determines whether this class is virtually
   1471   /// derived from \p Base, but does not account for factors that may
   1472   /// make a Derived -> Base class ill-formed, such as
   1473   /// private/protected inheritance or multiple, ambiguous base class
   1474   /// subobjects.
   1475   ///
   1476   /// \param Base the base class we are searching for.
   1477   ///
   1478   /// \returns true if this class is virtually derived from Base,
   1479   /// false otherwise.
   1480   bool isVirtuallyDerivedFrom(const CXXRecordDecl *Base) const;
   1481 
   1482   /// \brief Determine whether this class is provably not derived from
   1483   /// the type \p Base.
   1484   bool isProvablyNotDerivedFrom(const CXXRecordDecl *Base) const;
   1485 
   1486   /// \brief Function type used by forallBases() as a callback.
   1487   ///
   1488   /// \param BaseDefinition the definition of the base class
   1489   ///
   1490   /// \returns true if this base matched the search criteria
   1491   typedef llvm::function_ref<bool(const CXXRecordDecl *BaseDefinition)>
   1492       ForallBasesCallback;
   1493 
   1494   /// \brief Determines if the given callback holds for all the direct
   1495   /// or indirect base classes of this type.
   1496   ///
   1497   /// The class itself does not count as a base class.  This routine
   1498   /// returns false if the class has non-computable base classes.
   1499   ///
   1500   /// \param BaseMatches Callback invoked for each (direct or indirect) base
   1501   /// class of this type, or if \p AllowShortCircuit is true then until a call
   1502   /// returns false.
   1503   ///
   1504   /// \param AllowShortCircuit if false, forces the callback to be called
   1505   /// for every base class, even if a dependent or non-matching base was
   1506   /// found.
   1507   bool forallBases(ForallBasesCallback BaseMatches,
   1508                    bool AllowShortCircuit = true) const;
   1509 
   1510   /// \brief Function type used by lookupInBases() to determine whether a
   1511   /// specific base class subobject matches the lookup criteria.
   1512   ///
   1513   /// \param Specifier the base-class specifier that describes the inheritance
   1514   /// from the base class we are trying to match.
   1515   ///
   1516   /// \param Path the current path, from the most-derived class down to the
   1517   /// base named by the \p Specifier.
   1518   ///
   1519   /// \returns true if this base matched the search criteria, false otherwise.
   1520   typedef llvm::function_ref<bool(const CXXBaseSpecifier *Specifier,
   1521                                   CXXBasePath &Path)> BaseMatchesCallback;
   1522 
   1523   /// \brief Look for entities within the base classes of this C++ class,
   1524   /// transitively searching all base class subobjects.
   1525   ///
   1526   /// This routine uses the callback function \p BaseMatches to find base
   1527   /// classes meeting some search criteria, walking all base class subobjects
   1528   /// and populating the given \p Paths structure with the paths through the
   1529   /// inheritance hierarchy that resulted in a match. On a successful search,
   1530   /// the \p Paths structure can be queried to retrieve the matching paths and
   1531   /// to determine if there were any ambiguities.
   1532   ///
   1533   /// \param BaseMatches callback function used to determine whether a given
   1534   /// base matches the user-defined search criteria.
   1535   ///
   1536   /// \param Paths used to record the paths from this class to its base class
   1537   /// subobjects that match the search criteria.
   1538   ///
   1539   /// \returns true if there exists any path from this class to a base class
   1540   /// subobject that matches the search criteria.
   1541   bool lookupInBases(BaseMatchesCallback BaseMatches,
   1542                      CXXBasePaths &Paths) const;
   1543 
   1544   /// \brief Base-class lookup callback that determines whether the given
   1545   /// base class specifier refers to a specific class declaration.
   1546   ///
   1547   /// This callback can be used with \c lookupInBases() to determine whether
   1548   /// a given derived class has is a base class subobject of a particular type.
   1549   /// The base record pointer should refer to the canonical CXXRecordDecl of the
   1550   /// base class that we are searching for.
   1551   static bool FindBaseClass(const CXXBaseSpecifier *Specifier,
   1552                             CXXBasePath &Path, const CXXRecordDecl *BaseRecord);
   1553 
   1554   /// \brief Base-class lookup callback that determines whether the
   1555   /// given base class specifier refers to a specific class
   1556   /// declaration and describes virtual derivation.
   1557   ///
   1558   /// This callback can be used with \c lookupInBases() to determine
   1559   /// whether a given derived class has is a virtual base class
   1560   /// subobject of a particular type.  The base record pointer should
   1561   /// refer to the canonical CXXRecordDecl of the base class that we
   1562   /// are searching for.
   1563   static bool FindVirtualBaseClass(const CXXBaseSpecifier *Specifier,
   1564                                    CXXBasePath &Path,
   1565                                    const CXXRecordDecl *BaseRecord);
   1566 
   1567   /// \brief Base-class lookup callback that determines whether there exists
   1568   /// a tag with the given name.
   1569   ///
   1570   /// This callback can be used with \c lookupInBases() to find tag members
   1571   /// of the given name within a C++ class hierarchy.
   1572   static bool FindTagMember(const CXXBaseSpecifier *Specifier,
   1573                             CXXBasePath &Path, DeclarationName Name);
   1574 
   1575   /// \brief Base-class lookup callback that determines whether there exists
   1576   /// a member with the given name.
   1577   ///
   1578   /// This callback can be used with \c lookupInBases() to find members
   1579   /// of the given name within a C++ class hierarchy.
   1580   static bool FindOrdinaryMember(const CXXBaseSpecifier *Specifier,
   1581                                  CXXBasePath &Path, DeclarationName Name);
   1582 
   1583   /// \brief Base-class lookup callback that determines whether there exists
   1584   /// an OpenMP declare reduction member with the given name.
   1585   ///
   1586   /// This callback can be used with \c lookupInBases() to find members
   1587   /// of the given name within a C++ class hierarchy.
   1588   static bool FindOMPReductionMember(const CXXBaseSpecifier *Specifier,
   1589                                      CXXBasePath &Path, DeclarationName Name);
   1590 
   1591   /// \brief Base-class lookup callback that determines whether there exists
   1592   /// a member with the given name that can be used in a nested-name-specifier.
   1593   ///
   1594   /// This callback can be used with \c lookupInBases() to find members of
   1595   /// the given name within a C++ class hierarchy that can occur within
   1596   /// nested-name-specifiers.
   1597   static bool FindNestedNameSpecifierMember(const CXXBaseSpecifier *Specifier,
   1598                                             CXXBasePath &Path,
   1599                                             DeclarationName Name);
   1600 
   1601   /// \brief Retrieve the final overriders for each virtual member
   1602   /// function in the class hierarchy where this class is the
   1603   /// most-derived class in the class hierarchy.
   1604   void getFinalOverriders(CXXFinalOverriderMap &FinaOverriders) const;
   1605 
   1606   /// \brief Get the indirect primary bases for this class.
   1607   void getIndirectPrimaryBases(CXXIndirectPrimaryBaseSet& Bases) const;
   1608 
   1609   /// Renders and displays an inheritance diagram
   1610   /// for this C++ class and all of its base classes (transitively) using
   1611   /// GraphViz.
   1612   void viewInheritance(ASTContext& Context) const;
   1613 
   1614   /// \brief Calculates the access of a decl that is reached
   1615   /// along a path.
   1616   static AccessSpecifier MergeAccess(AccessSpecifier PathAccess,
   1617                                      AccessSpecifier DeclAccess) {
   1618     assert(DeclAccess != AS_none);
   1619     if (DeclAccess == AS_private) return AS_none;
   1620     return (PathAccess > DeclAccess ? PathAccess : DeclAccess);
   1621   }
   1622 
   1623   /// \brief Indicates that the declaration of a defaulted or deleted special
   1624   /// member function is now complete.
   1625   void finishedDefaultedOrDeletedMember(CXXMethodDecl *MD);
   1626 
   1627   /// \brief Indicates that the definition of this class is now complete.
   1628   void completeDefinition() override;
   1629 
   1630   /// \brief Indicates that the definition of this class is now complete,
   1631   /// and provides a final overrider map to help determine
   1632   ///
   1633   /// \param FinalOverriders The final overrider map for this class, which can
   1634   /// be provided as an optimization for abstract-class checking. If NULL,
   1635   /// final overriders will be computed if they are needed to complete the
   1636   /// definition.
   1637   void completeDefinition(CXXFinalOverriderMap *FinalOverriders);
   1638 
   1639   /// \brief Determine whether this class may end up being abstract, even though
   1640   /// it is not yet known to be abstract.
   1641   ///
   1642   /// \returns true if this class is not known to be abstract but has any
   1643   /// base classes that are abstract. In this case, \c completeDefinition()
   1644   /// will need to compute final overriders to determine whether the class is
   1645   /// actually abstract.
   1646   bool mayBeAbstract() const;
   1647 
   1648   /// \brief If this is the closure type of a lambda expression, retrieve the
   1649   /// number to be used for name mangling in the Itanium C++ ABI.
   1650   ///
   1651   /// Zero indicates that this closure type has internal linkage, so the
   1652   /// mangling number does not matter, while a non-zero value indicates which
   1653   /// lambda expression this is in this particular context.
   1654   unsigned getLambdaManglingNumber() const {
   1655     assert(isLambda() && "Not a lambda closure type!");
   1656     return getLambdaData().ManglingNumber;
   1657   }
   1658 
   1659   /// \brief Retrieve the declaration that provides additional context for a
   1660   /// lambda, when the normal declaration context is not specific enough.
   1661   ///
   1662   /// Certain contexts (default arguments of in-class function parameters and
   1663   /// the initializers of data members) have separate name mangling rules for
   1664   /// lambdas within the Itanium C++ ABI. For these cases, this routine provides
   1665   /// the declaration in which the lambda occurs, e.g., the function parameter
   1666   /// or the non-static data member. Otherwise, it returns NULL to imply that
   1667   /// the declaration context suffices.
   1668   Decl *getLambdaContextDecl() const {
   1669     assert(isLambda() && "Not a lambda closure type!");
   1670     return getLambdaData().ContextDecl;
   1671   }
   1672 
   1673   /// \brief Set the mangling number and context declaration for a lambda
   1674   /// class.
   1675   void setLambdaMangling(unsigned ManglingNumber, Decl *ContextDecl) {
   1676     getLambdaData().ManglingNumber = ManglingNumber;
   1677     getLambdaData().ContextDecl = ContextDecl;
   1678   }
   1679 
   1680   /// \brief Returns the inheritance model used for this record.
   1681   MSInheritanceAttr::Spelling getMSInheritanceModel() const;
   1682   /// \brief Calculate what the inheritance model would be for this class.
   1683   MSInheritanceAttr::Spelling calculateInheritanceModel() const;
   1684 
   1685   /// In the Microsoft C++ ABI, use zero for the field offset of a null data
   1686   /// member pointer if we can guarantee that zero is not a valid field offset,
   1687   /// or if the member pointer has multiple fields.  Polymorphic classes have a
   1688   /// vfptr at offset zero, so we can use zero for null.  If there are multiple
   1689   /// fields, we can use zero even if it is a valid field offset because
   1690   /// null-ness testing will check the other fields.
   1691   bool nullFieldOffsetIsZero() const {
   1692     return !MSInheritanceAttr::hasOnlyOneField(/*IsMemberFunction=*/false,
   1693                                                getMSInheritanceModel()) ||
   1694            (hasDefinition() && isPolymorphic());
   1695   }
   1696 
   1697   /// \brief Controls when vtordisps will be emitted if this record is used as a
   1698   /// virtual base.
   1699   MSVtorDispAttr::Mode getMSVtorDispMode() const;
   1700 
   1701   /// \brief Determine whether this lambda expression was known to be dependent
   1702   /// at the time it was created, even if its context does not appear to be
   1703   /// dependent.
   1704   ///
   1705   /// This flag is a workaround for an issue with parsing, where default
   1706   /// arguments are parsed before their enclosing function declarations have
   1707   /// been created. This means that any lambda expressions within those
   1708   /// default arguments will have as their DeclContext the context enclosing
   1709   /// the function declaration, which may be non-dependent even when the
   1710   /// function declaration itself is dependent. This flag indicates when we
   1711   /// know that the lambda is dependent despite that.
   1712   bool isDependentLambda() const {
   1713     return isLambda() && getLambdaData().Dependent;
   1714   }
   1715 
   1716   TypeSourceInfo *getLambdaTypeInfo() const {
   1717     return getLambdaData().MethodTyInfo;
   1718   }
   1719 
   1720   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   1721   static bool classofKind(Kind K) {
   1722     return K >= firstCXXRecord && K <= lastCXXRecord;
   1723   }
   1724 
   1725   friend class ASTDeclReader;
   1726   friend class ASTDeclWriter;
   1727   friend class ASTRecordWriter;
   1728   friend class ASTReader;
   1729   friend class ASTWriter;
   1730 };
   1731 
   1732 /// \brief Represents a static or instance method of a struct/union/class.
   1733 ///
   1734 /// In the terminology of the C++ Standard, these are the (static and
   1735 /// non-static) member functions, whether virtual or not.
   1736 class CXXMethodDecl : public FunctionDecl {
   1737   void anchor() override;
   1738 protected:
   1739   CXXMethodDecl(Kind DK, ASTContext &C, CXXRecordDecl *RD,
   1740                 SourceLocation StartLoc, const DeclarationNameInfo &NameInfo,
   1741                 QualType T, TypeSourceInfo *TInfo,
   1742                 StorageClass SC, bool isInline,
   1743                 bool isConstexpr, SourceLocation EndLocation)
   1744     : FunctionDecl(DK, C, RD, StartLoc, NameInfo, T, TInfo,
   1745                    SC, isInline, isConstexpr) {
   1746     if (EndLocation.isValid())
   1747       setRangeEnd(EndLocation);
   1748   }
   1749 
   1750 public:
   1751   static CXXMethodDecl *Create(ASTContext &C, CXXRecordDecl *RD,
   1752                                SourceLocation StartLoc,
   1753                                const DeclarationNameInfo &NameInfo,
   1754                                QualType T, TypeSourceInfo *TInfo,
   1755                                StorageClass SC,
   1756                                bool isInline,
   1757                                bool isConstexpr,
   1758                                SourceLocation EndLocation);
   1759 
   1760   static CXXMethodDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   1761 
   1762   bool isStatic() const;
   1763   bool isInstance() const { return !isStatic(); }
   1764 
   1765   /// Returns true if the given operator is implicitly static in a record
   1766   /// context.
   1767   static bool isStaticOverloadedOperator(OverloadedOperatorKind OOK) {
   1768     // [class.free]p1:
   1769     // Any allocation function for a class T is a static member
   1770     // (even if not explicitly declared static).
   1771     // [class.free]p6 Any deallocation function for a class X is a static member
   1772     // (even if not explicitly declared static).
   1773     return OOK == OO_New || OOK == OO_Array_New || OOK == OO_Delete ||
   1774            OOK == OO_Array_Delete;
   1775   }
   1776 
   1777   bool isConst() const { return getType()->castAs<FunctionType>()->isConst(); }
   1778   bool isVolatile() const { return getType()->castAs<FunctionType>()->isVolatile(); }
   1779 
   1780   bool isVirtual() const {
   1781     CXXMethodDecl *CD =
   1782       cast<CXXMethodDecl>(const_cast<CXXMethodDecl*>(this)->getCanonicalDecl());
   1783 
   1784     // Member function is virtual if it is marked explicitly so, or if it is
   1785     // declared in __interface -- then it is automatically pure virtual.
   1786     if (CD->isVirtualAsWritten() || CD->isPure())
   1787       return true;
   1788 
   1789     return (CD->begin_overridden_methods() != CD->end_overridden_methods());
   1790   }
   1791 
   1792   /// \brief Determine whether this is a usual deallocation function
   1793   /// (C++ [basic.stc.dynamic.deallocation]p2), which is an overloaded
   1794   /// delete or delete[] operator with a particular signature.
   1795   bool isUsualDeallocationFunction() const;
   1796 
   1797   /// \brief Determine whether this is a copy-assignment operator, regardless
   1798   /// of whether it was declared implicitly or explicitly.
   1799   bool isCopyAssignmentOperator() const;
   1800 
   1801   /// \brief Determine whether this is a move assignment operator.
   1802   bool isMoveAssignmentOperator() const;
   1803 
   1804   CXXMethodDecl *getCanonicalDecl() override {
   1805     return cast<CXXMethodDecl>(FunctionDecl::getCanonicalDecl());
   1806   }
   1807   const CXXMethodDecl *getCanonicalDecl() const {
   1808     return const_cast<CXXMethodDecl*>(this)->getCanonicalDecl();
   1809   }
   1810 
   1811   CXXMethodDecl *getMostRecentDecl() {
   1812     return cast<CXXMethodDecl>(
   1813             static_cast<FunctionDecl *>(this)->getMostRecentDecl());
   1814   }
   1815   const CXXMethodDecl *getMostRecentDecl() const {
   1816     return const_cast<CXXMethodDecl*>(this)->getMostRecentDecl();
   1817   }
   1818 
   1819   /// True if this method is user-declared and was not
   1820   /// deleted or defaulted on its first declaration.
   1821   bool isUserProvided() const {
   1822     return !(isDeleted() || getCanonicalDecl()->isDefaulted());
   1823   }
   1824 
   1825   ///
   1826   void addOverriddenMethod(const CXXMethodDecl *MD);
   1827 
   1828   typedef const CXXMethodDecl *const* method_iterator;
   1829 
   1830   method_iterator begin_overridden_methods() const;
   1831   method_iterator end_overridden_methods() const;
   1832   unsigned size_overridden_methods() const;
   1833   typedef ASTContext::overridden_method_range overridden_method_range;
   1834   overridden_method_range overridden_methods() const;
   1835 
   1836   /// Returns the parent of this method declaration, which
   1837   /// is the class in which this method is defined.
   1838   const CXXRecordDecl *getParent() const {
   1839     return cast<CXXRecordDecl>(FunctionDecl::getParent());
   1840   }
   1841 
   1842   /// Returns the parent of this method declaration, which
   1843   /// is the class in which this method is defined.
   1844   CXXRecordDecl *getParent() {
   1845     return const_cast<CXXRecordDecl *>(
   1846              cast<CXXRecordDecl>(FunctionDecl::getParent()));
   1847   }
   1848 
   1849   /// \brief Returns the type of the \c this pointer.
   1850   ///
   1851   /// Should only be called for instance (i.e., non-static) methods.
   1852   QualType getThisType(ASTContext &C) const;
   1853 
   1854   unsigned getTypeQualifiers() const {
   1855     return getType()->getAs<FunctionProtoType>()->getTypeQuals();
   1856   }
   1857 
   1858   /// \brief Retrieve the ref-qualifier associated with this method.
   1859   ///
   1860   /// In the following example, \c f() has an lvalue ref-qualifier, \c g()
   1861   /// has an rvalue ref-qualifier, and \c h() has no ref-qualifier.
   1862   /// @code
   1863   /// struct X {
   1864   ///   void f() &;
   1865   ///   void g() &&;
   1866   ///   void h();
   1867   /// };
   1868   /// @endcode
   1869   RefQualifierKind getRefQualifier() const {
   1870     return getType()->getAs<FunctionProtoType>()->getRefQualifier();
   1871   }
   1872 
   1873   bool hasInlineBody() const;
   1874 
   1875   /// \brief Determine whether this is a lambda closure type's static member
   1876   /// function that is used for the result of the lambda's conversion to
   1877   /// function pointer (for a lambda with no captures).
   1878   ///
   1879   /// The function itself, if used, will have a placeholder body that will be
   1880   /// supplied by IR generation to either forward to the function call operator
   1881   /// or clone the function call operator.
   1882   bool isLambdaStaticInvoker() const;
   1883 
   1884   /// \brief Find the method in \p RD that corresponds to this one.
   1885   ///
   1886   /// Find if \p RD or one of the classes it inherits from override this method.
   1887   /// If so, return it. \p RD is assumed to be a subclass of the class defining
   1888   /// this method (or be the class itself), unless \p MayBeBase is set to true.
   1889   CXXMethodDecl *
   1890   getCorrespondingMethodInClass(const CXXRecordDecl *RD,
   1891                                 bool MayBeBase = false);
   1892 
   1893   const CXXMethodDecl *
   1894   getCorrespondingMethodInClass(const CXXRecordDecl *RD,
   1895                                 bool MayBeBase = false) const {
   1896     return const_cast<CXXMethodDecl *>(this)
   1897               ->getCorrespondingMethodInClass(RD, MayBeBase);
   1898   }
   1899 
   1900   // Implement isa/cast/dyncast/etc.
   1901   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   1902   static bool classofKind(Kind K) {
   1903     return K >= firstCXXMethod && K <= lastCXXMethod;
   1904   }
   1905 };
   1906 
   1907 /// \brief Represents a C++ base or member initializer.
   1908 ///
   1909 /// This is part of a constructor initializer that
   1910 /// initializes one non-static member variable or one base class. For
   1911 /// example, in the following, both 'A(a)' and 'f(3.14159)' are member
   1912 /// initializers:
   1913 ///
   1914 /// \code
   1915 /// class A { };
   1916 /// class B : public A {
   1917 ///   float f;
   1918 /// public:
   1919 ///   B(A& a) : A(a), f(3.14159) { }
   1920 /// };
   1921 /// \endcode
   1922 class CXXCtorInitializer final
   1923     : private llvm::TrailingObjects<CXXCtorInitializer, VarDecl *> {
   1924   /// \brief Either the base class name/delegating constructor type (stored as
   1925   /// a TypeSourceInfo*), an normal field (FieldDecl), or an anonymous field
   1926   /// (IndirectFieldDecl*) being initialized.
   1927   llvm::PointerUnion3<TypeSourceInfo *, FieldDecl *, IndirectFieldDecl *>
   1928     Initializee;
   1929 
   1930   /// \brief The source location for the field name or, for a base initializer
   1931   /// pack expansion, the location of the ellipsis.
   1932   ///
   1933   /// In the case of a delegating
   1934   /// constructor, it will still include the type's source location as the
   1935   /// Initializee points to the CXXConstructorDecl (to allow loop detection).
   1936   SourceLocation MemberOrEllipsisLocation;
   1937 
   1938   /// \brief The argument used to initialize the base or member, which may
   1939   /// end up constructing an object (when multiple arguments are involved).
   1940   Stmt *Init;
   1941 
   1942   /// \brief Location of the left paren of the ctor-initializer.
   1943   SourceLocation LParenLoc;
   1944 
   1945   /// \brief Location of the right paren of the ctor-initializer.
   1946   SourceLocation RParenLoc;
   1947 
   1948   /// \brief If the initializee is a type, whether that type makes this
   1949   /// a delegating initialization.
   1950   unsigned IsDelegating : 1;
   1951 
   1952   /// \brief If the initializer is a base initializer, this keeps track
   1953   /// of whether the base is virtual or not.
   1954   unsigned IsVirtual : 1;
   1955 
   1956   /// \brief Whether or not the initializer is explicitly written
   1957   /// in the sources.
   1958   unsigned IsWritten : 1;
   1959 
   1960   /// If IsWritten is true, then this number keeps track of the textual order
   1961   /// of this initializer in the original sources, counting from 0; otherwise,
   1962   /// it stores the number of array index variables stored after this object
   1963   /// in memory.
   1964   unsigned SourceOrderOrNumArrayIndices : 13;
   1965 
   1966   CXXCtorInitializer(ASTContext &Context, FieldDecl *Member,
   1967                      SourceLocation MemberLoc, SourceLocation L, Expr *Init,
   1968                      SourceLocation R, VarDecl **Indices, unsigned NumIndices);
   1969 
   1970 public:
   1971   /// \brief Creates a new base-class initializer.
   1972   explicit
   1973   CXXCtorInitializer(ASTContext &Context, TypeSourceInfo *TInfo, bool IsVirtual,
   1974                      SourceLocation L, Expr *Init, SourceLocation R,
   1975                      SourceLocation EllipsisLoc);
   1976 
   1977   /// \brief Creates a new member initializer.
   1978   explicit
   1979   CXXCtorInitializer(ASTContext &Context, FieldDecl *Member,
   1980                      SourceLocation MemberLoc, SourceLocation L, Expr *Init,
   1981                      SourceLocation R);
   1982 
   1983   /// \brief Creates a new anonymous field initializer.
   1984   explicit
   1985   CXXCtorInitializer(ASTContext &Context, IndirectFieldDecl *Member,
   1986                      SourceLocation MemberLoc, SourceLocation L, Expr *Init,
   1987                      SourceLocation R);
   1988 
   1989   /// \brief Creates a new delegating initializer.
   1990   explicit
   1991   CXXCtorInitializer(ASTContext &Context, TypeSourceInfo *TInfo,
   1992                      SourceLocation L, Expr *Init, SourceLocation R);
   1993 
   1994   /// \brief Creates a new member initializer that optionally contains
   1995   /// array indices used to describe an elementwise initialization.
   1996   static CXXCtorInitializer *Create(ASTContext &Context, FieldDecl *Member,
   1997                                     SourceLocation MemberLoc, SourceLocation L,
   1998                                     Expr *Init, SourceLocation R,
   1999                                     VarDecl **Indices, unsigned NumIndices);
   2000 
   2001   /// \brief Determine whether this initializer is initializing a base class.
   2002   bool isBaseInitializer() const {
   2003     return Initializee.is<TypeSourceInfo*>() && !IsDelegating;
   2004   }
   2005 
   2006   /// \brief Determine whether this initializer is initializing a non-static
   2007   /// data member.
   2008   bool isMemberInitializer() const { return Initializee.is<FieldDecl*>(); }
   2009 
   2010   bool isAnyMemberInitializer() const {
   2011     return isMemberInitializer() || isIndirectMemberInitializer();
   2012   }
   2013 
   2014   bool isIndirectMemberInitializer() const {
   2015     return Initializee.is<IndirectFieldDecl*>();
   2016   }
   2017 
   2018   /// \brief Determine whether this initializer is an implicit initializer
   2019   /// generated for a field with an initializer defined on the member
   2020   /// declaration.
   2021   ///
   2022   /// In-class member initializers (also known as "non-static data member
   2023   /// initializations", NSDMIs) were introduced in C++11.
   2024   bool isInClassMemberInitializer() const {
   2025     return Init->getStmtClass() == Stmt::CXXDefaultInitExprClass;
   2026   }
   2027 
   2028   /// \brief Determine whether this initializer is creating a delegating
   2029   /// constructor.
   2030   bool isDelegatingInitializer() const {
   2031     return Initializee.is<TypeSourceInfo*>() && IsDelegating;
   2032   }
   2033 
   2034   /// \brief Determine whether this initializer is a pack expansion.
   2035   bool isPackExpansion() const {
   2036     return isBaseInitializer() && MemberOrEllipsisLocation.isValid();
   2037   }
   2038 
   2039   // \brief For a pack expansion, returns the location of the ellipsis.
   2040   SourceLocation getEllipsisLoc() const {
   2041     assert(isPackExpansion() && "Initializer is not a pack expansion");
   2042     return MemberOrEllipsisLocation;
   2043   }
   2044 
   2045   /// If this is a base class initializer, returns the type of the
   2046   /// base class with location information. Otherwise, returns an NULL
   2047   /// type location.
   2048   TypeLoc getBaseClassLoc() const;
   2049 
   2050   /// If this is a base class initializer, returns the type of the base class.
   2051   /// Otherwise, returns null.
   2052   const Type *getBaseClass() const;
   2053 
   2054   /// Returns whether the base is virtual or not.
   2055   bool isBaseVirtual() const {
   2056     assert(isBaseInitializer() && "Must call this on base initializer!");
   2057 
   2058     return IsVirtual;
   2059   }
   2060 
   2061   /// \brief Returns the declarator information for a base class or delegating
   2062   /// initializer.
   2063   TypeSourceInfo *getTypeSourceInfo() const {
   2064     return Initializee.dyn_cast<TypeSourceInfo *>();
   2065   }
   2066 
   2067   /// \brief If this is a member initializer, returns the declaration of the
   2068   /// non-static data member being initialized. Otherwise, returns null.
   2069   FieldDecl *getMember() const {
   2070     if (isMemberInitializer())
   2071       return Initializee.get<FieldDecl*>();
   2072     return nullptr;
   2073   }
   2074   FieldDecl *getAnyMember() const {
   2075     if (isMemberInitializer())
   2076       return Initializee.get<FieldDecl*>();
   2077     if (isIndirectMemberInitializer())
   2078       return Initializee.get<IndirectFieldDecl*>()->getAnonField();
   2079     return nullptr;
   2080   }
   2081 
   2082   IndirectFieldDecl *getIndirectMember() const {
   2083     if (isIndirectMemberInitializer())
   2084       return Initializee.get<IndirectFieldDecl*>();
   2085     return nullptr;
   2086   }
   2087 
   2088   SourceLocation getMemberLocation() const {
   2089     return MemberOrEllipsisLocation;
   2090   }
   2091 
   2092   /// \brief Determine the source location of the initializer.
   2093   SourceLocation getSourceLocation() const;
   2094 
   2095   /// \brief Determine the source range covering the entire initializer.
   2096   SourceRange getSourceRange() const LLVM_READONLY;
   2097 
   2098   /// \brief Determine whether this initializer is explicitly written
   2099   /// in the source code.
   2100   bool isWritten() const { return IsWritten; }
   2101 
   2102   /// \brief Return the source position of the initializer, counting from 0.
   2103   /// If the initializer was implicit, -1 is returned.
   2104   int getSourceOrder() const {
   2105     return IsWritten ? static_cast<int>(SourceOrderOrNumArrayIndices) : -1;
   2106   }
   2107 
   2108   /// \brief Set the source order of this initializer.
   2109   ///
   2110   /// This can only be called once for each initializer; it cannot be called
   2111   /// on an initializer having a positive number of (implicit) array indices.
   2112   ///
   2113   /// This assumes that the initializer was written in the source code, and
   2114   /// ensures that isWritten() returns true.
   2115   void setSourceOrder(int pos) {
   2116     assert(!IsWritten &&
   2117            "calling twice setSourceOrder() on the same initializer");
   2118     assert(SourceOrderOrNumArrayIndices == 0 &&
   2119            "setSourceOrder() used when there are implicit array indices");
   2120     assert(pos >= 0 &&
   2121            "setSourceOrder() used to make an initializer implicit");
   2122     IsWritten = true;
   2123     SourceOrderOrNumArrayIndices = static_cast<unsigned>(pos);
   2124   }
   2125 
   2126   SourceLocation getLParenLoc() const { return LParenLoc; }
   2127   SourceLocation getRParenLoc() const { return RParenLoc; }
   2128 
   2129   /// \brief Determine the number of implicit array indices used while
   2130   /// described an array member initialization.
   2131   unsigned getNumArrayIndices() const {
   2132     return IsWritten ? 0 : SourceOrderOrNumArrayIndices;
   2133   }
   2134 
   2135   /// \brief Retrieve a particular array index variable used to
   2136   /// describe an array member initialization.
   2137   VarDecl *getArrayIndex(unsigned I) {
   2138     assert(I < getNumArrayIndices() && "Out of bounds member array index");
   2139     return getTrailingObjects<VarDecl *>()[I];
   2140   }
   2141   const VarDecl *getArrayIndex(unsigned I) const {
   2142     assert(I < getNumArrayIndices() && "Out of bounds member array index");
   2143     return getTrailingObjects<VarDecl *>()[I];
   2144   }
   2145   void setArrayIndex(unsigned I, VarDecl *Index) {
   2146     assert(I < getNumArrayIndices() && "Out of bounds member array index");
   2147     getTrailingObjects<VarDecl *>()[I] = Index;
   2148   }
   2149   ArrayRef<VarDecl *> getArrayIndices() {
   2150     return llvm::makeArrayRef(getTrailingObjects<VarDecl *>(),
   2151                               getNumArrayIndices());
   2152   }
   2153 
   2154   /// \brief Get the initializer.
   2155   Expr *getInit() const { return static_cast<Expr*>(Init); }
   2156 
   2157   friend TrailingObjects;
   2158 };
   2159 
   2160 /// Description of a constructor that was inherited from a base class.
   2161 class InheritedConstructor {
   2162   ConstructorUsingShadowDecl *Shadow;
   2163   CXXConstructorDecl *BaseCtor;
   2164 
   2165 public:
   2166   InheritedConstructor() : Shadow(), BaseCtor() {}
   2167   InheritedConstructor(ConstructorUsingShadowDecl *Shadow,
   2168                        CXXConstructorDecl *BaseCtor)
   2169       : Shadow(Shadow), BaseCtor(BaseCtor) {}
   2170 
   2171   explicit operator bool() const { return Shadow; }
   2172 
   2173   ConstructorUsingShadowDecl *getShadowDecl() const { return Shadow; }
   2174   CXXConstructorDecl *getConstructor() const { return BaseCtor; }
   2175 };
   2176 
   2177 /// \brief Represents a C++ constructor within a class.
   2178 ///
   2179 /// For example:
   2180 ///
   2181 /// \code
   2182 /// class X {
   2183 /// public:
   2184 ///   explicit X(int); // represented by a CXXConstructorDecl.
   2185 /// };
   2186 /// \endcode
   2187 class CXXConstructorDecl final
   2188     : public CXXMethodDecl,
   2189       private llvm::TrailingObjects<CXXConstructorDecl, InheritedConstructor> {
   2190   void anchor() override;
   2191 
   2192   /// \name Support for base and member initializers.
   2193   /// \{
   2194   /// \brief The arguments used to initialize the base or member.
   2195   LazyCXXCtorInitializersPtr CtorInitializers;
   2196   unsigned NumCtorInitializers : 30;
   2197   /// \}
   2198 
   2199   /// \brief Whether this constructor declaration has the \c explicit keyword
   2200   /// specified.
   2201   unsigned IsExplicitSpecified : 1;
   2202 
   2203   /// \brief Whether this constructor declaration is an implicitly-declared
   2204   /// inheriting constructor.
   2205   unsigned IsInheritingConstructor : 1;
   2206 
   2207   CXXConstructorDecl(ASTContext &C, CXXRecordDecl *RD, SourceLocation StartLoc,
   2208                      const DeclarationNameInfo &NameInfo,
   2209                      QualType T, TypeSourceInfo *TInfo,
   2210                      bool isExplicitSpecified, bool isInline,
   2211                      bool isImplicitlyDeclared, bool isConstexpr,
   2212                      InheritedConstructor Inherited)
   2213     : CXXMethodDecl(CXXConstructor, C, RD, StartLoc, NameInfo, T, TInfo,
   2214                     SC_None, isInline, isConstexpr, SourceLocation()),
   2215       CtorInitializers(nullptr), NumCtorInitializers(0),
   2216       IsExplicitSpecified(isExplicitSpecified),
   2217       IsInheritingConstructor((bool)Inherited) {
   2218     setImplicit(isImplicitlyDeclared);
   2219     if (Inherited)
   2220       *getTrailingObjects<InheritedConstructor>() = Inherited;
   2221   }
   2222 
   2223 public:
   2224   static CXXConstructorDecl *CreateDeserialized(ASTContext &C, unsigned ID,
   2225                                                 bool InheritsConstructor);
   2226   static CXXConstructorDecl *
   2227   Create(ASTContext &C, CXXRecordDecl *RD, SourceLocation StartLoc,
   2228          const DeclarationNameInfo &NameInfo, QualType T, TypeSourceInfo *TInfo,
   2229          bool isExplicit, bool isInline, bool isImplicitlyDeclared,
   2230          bool isConstexpr,
   2231          InheritedConstructor Inherited = InheritedConstructor());
   2232 
   2233   /// \brief Determine whether this constructor declaration has the
   2234   /// \c explicit keyword specified.
   2235   bool isExplicitSpecified() const { return IsExplicitSpecified; }
   2236 
   2237   /// \brief Determine whether this constructor was marked "explicit" or not.
   2238   bool isExplicit() const {
   2239     return cast<CXXConstructorDecl>(getFirstDecl())->isExplicitSpecified();
   2240   }
   2241 
   2242   /// \brief Iterates through the member/base initializer list.
   2243   typedef CXXCtorInitializer **init_iterator;
   2244 
   2245   /// \brief Iterates through the member/base initializer list.
   2246   typedef CXXCtorInitializer *const *init_const_iterator;
   2247 
   2248   typedef llvm::iterator_range<init_iterator> init_range;
   2249   typedef llvm::iterator_range<init_const_iterator> init_const_range;
   2250 
   2251   init_range inits() { return init_range(init_begin(), init_end()); }
   2252   init_const_range inits() const {
   2253     return init_const_range(init_begin(), init_end());
   2254   }
   2255 
   2256   /// \brief Retrieve an iterator to the first initializer.
   2257   init_iterator init_begin() {
   2258     const auto *ConstThis = this;
   2259     return const_cast<init_iterator>(ConstThis->init_begin());
   2260   }
   2261   /// \brief Retrieve an iterator to the first initializer.
   2262   init_const_iterator init_begin() const;
   2263 
   2264   /// \brief Retrieve an iterator past the last initializer.
   2265   init_iterator       init_end()       {
   2266     return init_begin() + NumCtorInitializers;
   2267   }
   2268   /// \brief Retrieve an iterator past the last initializer.
   2269   init_const_iterator init_end() const {
   2270     return init_begin() + NumCtorInitializers;
   2271   }
   2272 
   2273   typedef std::reverse_iterator<init_iterator> init_reverse_iterator;
   2274   typedef std::reverse_iterator<init_const_iterator>
   2275           init_const_reverse_iterator;
   2276 
   2277   init_reverse_iterator init_rbegin() {
   2278     return init_reverse_iterator(init_end());
   2279   }
   2280   init_const_reverse_iterator init_rbegin() const {
   2281     return init_const_reverse_iterator(init_end());
   2282   }
   2283 
   2284   init_reverse_iterator init_rend() {
   2285     return init_reverse_iterator(init_begin());
   2286   }
   2287   init_const_reverse_iterator init_rend() const {
   2288     return init_const_reverse_iterator(init_begin());
   2289   }
   2290 
   2291   /// \brief Determine the number of arguments used to initialize the member
   2292   /// or base.
   2293   unsigned getNumCtorInitializers() const {
   2294       return NumCtorInitializers;
   2295   }
   2296 
   2297   void setNumCtorInitializers(unsigned numCtorInitializers) {
   2298     NumCtorInitializers = numCtorInitializers;
   2299   }
   2300 
   2301   void setCtorInitializers(CXXCtorInitializer **Initializers) {
   2302     CtorInitializers = Initializers;
   2303   }
   2304 
   2305   /// \brief Determine whether this constructor is a delegating constructor.
   2306   bool isDelegatingConstructor() const {
   2307     return (getNumCtorInitializers() == 1) &&
   2308            init_begin()[0]->isDelegatingInitializer();
   2309   }
   2310 
   2311   /// \brief When this constructor delegates to another, retrieve the target.
   2312   CXXConstructorDecl *getTargetConstructor() const;
   2313 
   2314   /// Whether this constructor is a default
   2315   /// constructor (C++ [class.ctor]p5), which can be used to
   2316   /// default-initialize a class of this type.
   2317   bool isDefaultConstructor() const;
   2318 
   2319   /// \brief Whether this constructor is a copy constructor (C++ [class.copy]p2,
   2320   /// which can be used to copy the class.
   2321   ///
   2322   /// \p TypeQuals will be set to the qualifiers on the
   2323   /// argument type. For example, \p TypeQuals would be set to \c
   2324   /// Qualifiers::Const for the following copy constructor:
   2325   ///
   2326   /// \code
   2327   /// class X {
   2328   /// public:
   2329   ///   X(const X&);
   2330   /// };
   2331   /// \endcode
   2332   bool isCopyConstructor(unsigned &TypeQuals) const;
   2333 
   2334   /// Whether this constructor is a copy
   2335   /// constructor (C++ [class.copy]p2, which can be used to copy the
   2336   /// class.
   2337   bool isCopyConstructor() const {
   2338     unsigned TypeQuals = 0;
   2339     return isCopyConstructor(TypeQuals);
   2340   }
   2341 
   2342   /// \brief Determine whether this constructor is a move constructor
   2343   /// (C++11 [class.copy]p3), which can be used to move values of the class.
   2344   ///
   2345   /// \param TypeQuals If this constructor is a move constructor, will be set
   2346   /// to the type qualifiers on the referent of the first parameter's type.
   2347   bool isMoveConstructor(unsigned &TypeQuals) const;
   2348 
   2349   /// \brief Determine whether this constructor is a move constructor
   2350   /// (C++11 [class.copy]p3), which can be used to move values of the class.
   2351   bool isMoveConstructor() const {
   2352     unsigned TypeQuals = 0;
   2353     return isMoveConstructor(TypeQuals);
   2354   }
   2355 
   2356   /// \brief Determine whether this is a copy or move constructor.
   2357   ///
   2358   /// \param TypeQuals Will be set to the type qualifiers on the reference
   2359   /// parameter, if in fact this is a copy or move constructor.
   2360   bool isCopyOrMoveConstructor(unsigned &TypeQuals) const;
   2361 
   2362   /// \brief Determine whether this a copy or move constructor.
   2363   bool isCopyOrMoveConstructor() const {
   2364     unsigned Quals;
   2365     return isCopyOrMoveConstructor(Quals);
   2366   }
   2367 
   2368   /// Whether this constructor is a
   2369   /// converting constructor (C++ [class.conv.ctor]), which can be
   2370   /// used for user-defined conversions.
   2371   bool isConvertingConstructor(bool AllowExplicit) const;
   2372 
   2373   /// \brief Determine whether this is a member template specialization that
   2374   /// would copy the object to itself. Such constructors are never used to copy
   2375   /// an object.
   2376   bool isSpecializationCopyingObject() const;
   2377 
   2378   /// \brief Determine whether this is an implicit constructor synthesized to
   2379   /// model a call to a constructor inherited from a base class.
   2380   bool isInheritingConstructor() const { return IsInheritingConstructor; }
   2381 
   2382   /// \brief Get the constructor that this inheriting constructor is based on.
   2383   InheritedConstructor getInheritedConstructor() const {
   2384     return IsInheritingConstructor ? *getTrailingObjects<InheritedConstructor>()
   2385                                    : InheritedConstructor();
   2386   }
   2387 
   2388   CXXConstructorDecl *getCanonicalDecl() override {
   2389     return cast<CXXConstructorDecl>(FunctionDecl::getCanonicalDecl());
   2390   }
   2391   const CXXConstructorDecl *getCanonicalDecl() const {
   2392     return const_cast<CXXConstructorDecl*>(this)->getCanonicalDecl();
   2393   }
   2394 
   2395   // Implement isa/cast/dyncast/etc.
   2396   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2397   static bool classofKind(Kind K) { return K == CXXConstructor; }
   2398 
   2399   friend class ASTDeclReader;
   2400   friend class ASTDeclWriter;
   2401   friend TrailingObjects;
   2402 };
   2403 
   2404 /// \brief Represents a C++ destructor within a class.
   2405 ///
   2406 /// For example:
   2407 ///
   2408 /// \code
   2409 /// class X {
   2410 /// public:
   2411 ///   ~X(); // represented by a CXXDestructorDecl.
   2412 /// };
   2413 /// \endcode
   2414 class CXXDestructorDecl : public CXXMethodDecl {
   2415   void anchor() override;
   2416 
   2417   FunctionDecl *OperatorDelete;
   2418 
   2419   CXXDestructorDecl(ASTContext &C, CXXRecordDecl *RD, SourceLocation StartLoc,
   2420                     const DeclarationNameInfo &NameInfo,
   2421                     QualType T, TypeSourceInfo *TInfo,
   2422                     bool isInline, bool isImplicitlyDeclared)
   2423     : CXXMethodDecl(CXXDestructor, C, RD, StartLoc, NameInfo, T, TInfo,
   2424                     SC_None, isInline, /*isConstexpr=*/false, SourceLocation()),
   2425       OperatorDelete(nullptr) {
   2426     setImplicit(isImplicitlyDeclared);
   2427   }
   2428 
   2429 public:
   2430   static CXXDestructorDecl *Create(ASTContext &C, CXXRecordDecl *RD,
   2431                                    SourceLocation StartLoc,
   2432                                    const DeclarationNameInfo &NameInfo,
   2433                                    QualType T, TypeSourceInfo* TInfo,
   2434                                    bool isInline,
   2435                                    bool isImplicitlyDeclared);
   2436   static CXXDestructorDecl *CreateDeserialized(ASTContext & C, unsigned ID);
   2437 
   2438   void setOperatorDelete(FunctionDecl *OD);
   2439   const FunctionDecl *getOperatorDelete() const {
   2440     return cast<CXXDestructorDecl>(getFirstDecl())->OperatorDelete;
   2441   }
   2442 
   2443   // Implement isa/cast/dyncast/etc.
   2444   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2445   static bool classofKind(Kind K) { return K == CXXDestructor; }
   2446 
   2447   friend class ASTDeclReader;
   2448   friend class ASTDeclWriter;
   2449 };
   2450 
   2451 /// \brief Represents a C++ conversion function within a class.
   2452 ///
   2453 /// For example:
   2454 ///
   2455 /// \code
   2456 /// class X {
   2457 /// public:
   2458 ///   operator bool();
   2459 /// };
   2460 /// \endcode
   2461 class CXXConversionDecl : public CXXMethodDecl {
   2462   void anchor() override;
   2463   /// Whether this conversion function declaration is marked
   2464   /// "explicit", meaning that it can only be applied when the user
   2465   /// explicitly wrote a cast. This is a C++11 feature.
   2466   bool IsExplicitSpecified : 1;
   2467 
   2468   CXXConversionDecl(ASTContext &C, CXXRecordDecl *RD, SourceLocation StartLoc,
   2469                     const DeclarationNameInfo &NameInfo,
   2470                     QualType T, TypeSourceInfo *TInfo,
   2471                     bool isInline, bool isExplicitSpecified,
   2472                     bool isConstexpr, SourceLocation EndLocation)
   2473     : CXXMethodDecl(CXXConversion, C, RD, StartLoc, NameInfo, T, TInfo,
   2474                     SC_None, isInline, isConstexpr, EndLocation),
   2475       IsExplicitSpecified(isExplicitSpecified) { }
   2476 
   2477 public:
   2478   static CXXConversionDecl *Create(ASTContext &C, CXXRecordDecl *RD,
   2479                                    SourceLocation StartLoc,
   2480                                    const DeclarationNameInfo &NameInfo,
   2481                                    QualType T, TypeSourceInfo *TInfo,
   2482                                    bool isInline, bool isExplicit,
   2483                                    bool isConstexpr,
   2484                                    SourceLocation EndLocation);
   2485   static CXXConversionDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   2486 
   2487   /// Whether this conversion function declaration is marked
   2488   /// "explicit", meaning that it can only be used for direct initialization
   2489   /// (including explitly written casts).  This is a C++11 feature.
   2490   bool isExplicitSpecified() const { return IsExplicitSpecified; }
   2491 
   2492   /// \brief Whether this is an explicit conversion operator (C++11 and later).
   2493   ///
   2494   /// Explicit conversion operators are only considered for direct
   2495   /// initialization, e.g., when the user has explicitly written a cast.
   2496   bool isExplicit() const {
   2497     return cast<CXXConversionDecl>(getFirstDecl())->isExplicitSpecified();
   2498   }
   2499 
   2500   /// \brief Returns the type that this conversion function is converting to.
   2501   QualType getConversionType() const {
   2502     return getType()->getAs<FunctionType>()->getReturnType();
   2503   }
   2504 
   2505   /// \brief Determine whether this conversion function is a conversion from
   2506   /// a lambda closure type to a block pointer.
   2507   bool isLambdaToBlockPointerConversion() const;
   2508 
   2509   // Implement isa/cast/dyncast/etc.
   2510   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2511   static bool classofKind(Kind K) { return K == CXXConversion; }
   2512 
   2513   friend class ASTDeclReader;
   2514   friend class ASTDeclWriter;
   2515 };
   2516 
   2517 /// \brief Represents a linkage specification.
   2518 ///
   2519 /// For example:
   2520 /// \code
   2521 ///   extern "C" void foo();
   2522 /// \endcode
   2523 class LinkageSpecDecl : public Decl, public DeclContext {
   2524   virtual void anchor();
   2525 public:
   2526   /// \brief Represents the language in a linkage specification.
   2527   ///
   2528   /// The values are part of the serialization ABI for
   2529   /// ASTs and cannot be changed without altering that ABI.  To help
   2530   /// ensure a stable ABI for this, we choose the DW_LANG_ encodings
   2531   /// from the dwarf standard.
   2532   enum LanguageIDs {
   2533     lang_c = /* DW_LANG_C */ 0x0002,
   2534     lang_cxx = /* DW_LANG_C_plus_plus */ 0x0004
   2535   };
   2536 private:
   2537   /// \brief The language for this linkage specification.
   2538   unsigned Language : 3;
   2539   /// \brief True if this linkage spec has braces.
   2540   ///
   2541   /// This is needed so that hasBraces() returns the correct result while the
   2542   /// linkage spec body is being parsed.  Once RBraceLoc has been set this is
   2543   /// not used, so it doesn't need to be serialized.
   2544   unsigned HasBraces : 1;
   2545   /// \brief The source location for the extern keyword.
   2546   SourceLocation ExternLoc;
   2547   /// \brief The source location for the right brace (if valid).
   2548   SourceLocation RBraceLoc;
   2549 
   2550   LinkageSpecDecl(DeclContext *DC, SourceLocation ExternLoc,
   2551                   SourceLocation LangLoc, LanguageIDs lang, bool HasBraces)
   2552     : Decl(LinkageSpec, DC, LangLoc), DeclContext(LinkageSpec),
   2553       Language(lang), HasBraces(HasBraces), ExternLoc(ExternLoc),
   2554       RBraceLoc(SourceLocation()) { }
   2555 
   2556 public:
   2557   static LinkageSpecDecl *Create(ASTContext &C, DeclContext *DC,
   2558                                  SourceLocation ExternLoc,
   2559                                  SourceLocation LangLoc, LanguageIDs Lang,
   2560                                  bool HasBraces);
   2561   static LinkageSpecDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   2562 
   2563   /// \brief Return the language specified by this linkage specification.
   2564   LanguageIDs getLanguage() const { return LanguageIDs(Language); }
   2565   /// \brief Set the language specified by this linkage specification.
   2566   void setLanguage(LanguageIDs L) { Language = L; }
   2567 
   2568   /// \brief Determines whether this linkage specification had braces in
   2569   /// its syntactic form.
   2570   bool hasBraces() const {
   2571     assert(!RBraceLoc.isValid() || HasBraces);
   2572     return HasBraces;
   2573   }
   2574 
   2575   SourceLocation getExternLoc() const { return ExternLoc; }
   2576   SourceLocation getRBraceLoc() const { return RBraceLoc; }
   2577   void setExternLoc(SourceLocation L) { ExternLoc = L; }
   2578   void setRBraceLoc(SourceLocation L) {
   2579     RBraceLoc = L;
   2580     HasBraces = RBraceLoc.isValid();
   2581   }
   2582 
   2583   SourceLocation getLocEnd() const LLVM_READONLY {
   2584     if (hasBraces())
   2585       return getRBraceLoc();
   2586     // No braces: get the end location of the (only) declaration in context
   2587     // (if present).
   2588     return decls_empty() ? getLocation() : decls_begin()->getLocEnd();
   2589   }
   2590 
   2591   SourceRange getSourceRange() const override LLVM_READONLY {
   2592     return SourceRange(ExternLoc, getLocEnd());
   2593   }
   2594 
   2595   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2596   static bool classofKind(Kind K) { return K == LinkageSpec; }
   2597   static DeclContext *castToDeclContext(const LinkageSpecDecl *D) {
   2598     return static_cast<DeclContext *>(const_cast<LinkageSpecDecl*>(D));
   2599   }
   2600   static LinkageSpecDecl *castFromDeclContext(const DeclContext *DC) {
   2601     return static_cast<LinkageSpecDecl *>(const_cast<DeclContext*>(DC));
   2602   }
   2603 };
   2604 
   2605 /// \brief Represents C++ using-directive.
   2606 ///
   2607 /// For example:
   2608 /// \code
   2609 ///    using namespace std;
   2610 /// \endcode
   2611 ///
   2612 /// \note UsingDirectiveDecl should be Decl not NamedDecl, but we provide
   2613 /// artificial names for all using-directives in order to store
   2614 /// them in DeclContext effectively.
   2615 class UsingDirectiveDecl : public NamedDecl {
   2616   void anchor() override;
   2617   /// \brief The location of the \c using keyword.
   2618   SourceLocation UsingLoc;
   2619 
   2620   /// \brief The location of the \c namespace keyword.
   2621   SourceLocation NamespaceLoc;
   2622 
   2623   /// \brief The nested-name-specifier that precedes the namespace.
   2624   NestedNameSpecifierLoc QualifierLoc;
   2625 
   2626   /// \brief The namespace nominated by this using-directive.
   2627   NamedDecl *NominatedNamespace;
   2628 
   2629   /// Enclosing context containing both using-directive and nominated
   2630   /// namespace.
   2631   DeclContext *CommonAncestor;
   2632 
   2633   /// \brief Returns special DeclarationName used by using-directives.
   2634   ///
   2635   /// This is only used by DeclContext for storing UsingDirectiveDecls in
   2636   /// its lookup structure.
   2637   static DeclarationName getName() {
   2638     return DeclarationName::getUsingDirectiveName();
   2639   }
   2640 
   2641   UsingDirectiveDecl(DeclContext *DC, SourceLocation UsingLoc,
   2642                      SourceLocation NamespcLoc,
   2643                      NestedNameSpecifierLoc QualifierLoc,
   2644                      SourceLocation IdentLoc,
   2645                      NamedDecl *Nominated,
   2646                      DeclContext *CommonAncestor)
   2647     : NamedDecl(UsingDirective, DC, IdentLoc, getName()), UsingLoc(UsingLoc),
   2648       NamespaceLoc(NamespcLoc), QualifierLoc(QualifierLoc),
   2649       NominatedNamespace(Nominated), CommonAncestor(CommonAncestor) { }
   2650 
   2651 public:
   2652   /// \brief Retrieve the nested-name-specifier that qualifies the
   2653   /// name of the namespace, with source-location information.
   2654   NestedNameSpecifierLoc getQualifierLoc() const { return QualifierLoc; }
   2655 
   2656   /// \brief Retrieve the nested-name-specifier that qualifies the
   2657   /// name of the namespace.
   2658   NestedNameSpecifier *getQualifier() const {
   2659     return QualifierLoc.getNestedNameSpecifier();
   2660   }
   2661 
   2662   NamedDecl *getNominatedNamespaceAsWritten() { return NominatedNamespace; }
   2663   const NamedDecl *getNominatedNamespaceAsWritten() const {
   2664     return NominatedNamespace;
   2665   }
   2666 
   2667   /// \brief Returns the namespace nominated by this using-directive.
   2668   NamespaceDecl *getNominatedNamespace();
   2669 
   2670   const NamespaceDecl *getNominatedNamespace() const {
   2671     return const_cast<UsingDirectiveDecl*>(this)->getNominatedNamespace();
   2672   }
   2673 
   2674   /// \brief Returns the common ancestor context of this using-directive and
   2675   /// its nominated namespace.
   2676   DeclContext *getCommonAncestor() { return CommonAncestor; }
   2677   const DeclContext *getCommonAncestor() const { return CommonAncestor; }
   2678 
   2679   /// \brief Return the location of the \c using keyword.
   2680   SourceLocation getUsingLoc() const { return UsingLoc; }
   2681 
   2682   // FIXME: Could omit 'Key' in name.
   2683   /// \brief Returns the location of the \c namespace keyword.
   2684   SourceLocation getNamespaceKeyLocation() const { return NamespaceLoc; }
   2685 
   2686   /// \brief Returns the location of this using declaration's identifier.
   2687   SourceLocation getIdentLocation() const { return getLocation(); }
   2688 
   2689   static UsingDirectiveDecl *Create(ASTContext &C, DeclContext *DC,
   2690                                     SourceLocation UsingLoc,
   2691                                     SourceLocation NamespaceLoc,
   2692                                     NestedNameSpecifierLoc QualifierLoc,
   2693                                     SourceLocation IdentLoc,
   2694                                     NamedDecl *Nominated,
   2695                                     DeclContext *CommonAncestor);
   2696   static UsingDirectiveDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   2697 
   2698   SourceRange getSourceRange() const override LLVM_READONLY {
   2699     return SourceRange(UsingLoc, getLocation());
   2700   }
   2701 
   2702   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2703   static bool classofKind(Kind K) { return K == UsingDirective; }
   2704 
   2705   // Friend for getUsingDirectiveName.
   2706   friend class DeclContext;
   2707 
   2708   friend class ASTDeclReader;
   2709 };
   2710 
   2711 /// \brief Represents a C++ namespace alias.
   2712 ///
   2713 /// For example:
   2714 ///
   2715 /// \code
   2716 /// namespace Foo = Bar;
   2717 /// \endcode
   2718 class NamespaceAliasDecl : public NamedDecl,
   2719                            public Redeclarable<NamespaceAliasDecl> {
   2720   void anchor() override;
   2721 
   2722   /// \brief The location of the \c namespace keyword.
   2723   SourceLocation NamespaceLoc;
   2724 
   2725   /// \brief The location of the namespace's identifier.
   2726   ///
   2727   /// This is accessed by TargetNameLoc.
   2728   SourceLocation IdentLoc;
   2729 
   2730   /// \brief The nested-name-specifier that precedes the namespace.
   2731   NestedNameSpecifierLoc QualifierLoc;
   2732 
   2733   /// \brief The Decl that this alias points to, either a NamespaceDecl or
   2734   /// a NamespaceAliasDecl.
   2735   NamedDecl *Namespace;
   2736 
   2737   NamespaceAliasDecl(ASTContext &C, DeclContext *DC,
   2738                      SourceLocation NamespaceLoc, SourceLocation AliasLoc,
   2739                      IdentifierInfo *Alias, NestedNameSpecifierLoc QualifierLoc,
   2740                      SourceLocation IdentLoc, NamedDecl *Namespace)
   2741       : NamedDecl(NamespaceAlias, DC, AliasLoc, Alias), redeclarable_base(C),
   2742         NamespaceLoc(NamespaceLoc), IdentLoc(IdentLoc),
   2743         QualifierLoc(QualifierLoc), Namespace(Namespace) {}
   2744 
   2745   typedef Redeclarable<NamespaceAliasDecl> redeclarable_base;
   2746   NamespaceAliasDecl *getNextRedeclarationImpl() override;
   2747   NamespaceAliasDecl *getPreviousDeclImpl() override;
   2748   NamespaceAliasDecl *getMostRecentDeclImpl() override;
   2749 
   2750   friend class ASTDeclReader;
   2751 
   2752 public:
   2753   static NamespaceAliasDecl *Create(ASTContext &C, DeclContext *DC,
   2754                                     SourceLocation NamespaceLoc,
   2755                                     SourceLocation AliasLoc,
   2756                                     IdentifierInfo *Alias,
   2757                                     NestedNameSpecifierLoc QualifierLoc,
   2758                                     SourceLocation IdentLoc,
   2759                                     NamedDecl *Namespace);
   2760 
   2761   static NamespaceAliasDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   2762 
   2763   typedef redeclarable_base::redecl_range redecl_range;
   2764   typedef redeclarable_base::redecl_iterator redecl_iterator;
   2765   using redeclarable_base::redecls_begin;
   2766   using redeclarable_base::redecls_end;
   2767   using redeclarable_base::redecls;
   2768   using redeclarable_base::getPreviousDecl;
   2769   using redeclarable_base::getMostRecentDecl;
   2770 
   2771   NamespaceAliasDecl *getCanonicalDecl() override {
   2772     return getFirstDecl();
   2773   }
   2774   const NamespaceAliasDecl *getCanonicalDecl() const {
   2775     return getFirstDecl();
   2776   }
   2777 
   2778   /// \brief Retrieve the nested-name-specifier that qualifies the
   2779   /// name of the namespace, with source-location information.
   2780   NestedNameSpecifierLoc getQualifierLoc() const { return QualifierLoc; }
   2781 
   2782   /// \brief Retrieve the nested-name-specifier that qualifies the
   2783   /// name of the namespace.
   2784   NestedNameSpecifier *getQualifier() const {
   2785     return QualifierLoc.getNestedNameSpecifier();
   2786   }
   2787 
   2788   /// \brief Retrieve the namespace declaration aliased by this directive.
   2789   NamespaceDecl *getNamespace() {
   2790     if (NamespaceAliasDecl *AD = dyn_cast<NamespaceAliasDecl>(Namespace))
   2791       return AD->getNamespace();
   2792 
   2793     return cast<NamespaceDecl>(Namespace);
   2794   }
   2795 
   2796   const NamespaceDecl *getNamespace() const {
   2797     return const_cast<NamespaceAliasDecl*>(this)->getNamespace();
   2798   }
   2799 
   2800   /// Returns the location of the alias name, i.e. 'foo' in
   2801   /// "namespace foo = ns::bar;".
   2802   SourceLocation getAliasLoc() const { return getLocation(); }
   2803 
   2804   /// Returns the location of the \c namespace keyword.
   2805   SourceLocation getNamespaceLoc() const { return NamespaceLoc; }
   2806 
   2807   /// Returns the location of the identifier in the named namespace.
   2808   SourceLocation getTargetNameLoc() const { return IdentLoc; }
   2809 
   2810   /// \brief Retrieve the namespace that this alias refers to, which
   2811   /// may either be a NamespaceDecl or a NamespaceAliasDecl.
   2812   NamedDecl *getAliasedNamespace() const { return Namespace; }
   2813 
   2814   SourceRange getSourceRange() const override LLVM_READONLY {
   2815     return SourceRange(NamespaceLoc, IdentLoc);
   2816   }
   2817 
   2818   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2819   static bool classofKind(Kind K) { return K == NamespaceAlias; }
   2820 };
   2821 
   2822 /// \brief Represents a shadow declaration introduced into a scope by a
   2823 /// (resolved) using declaration.
   2824 ///
   2825 /// For example,
   2826 /// \code
   2827 /// namespace A {
   2828 ///   void foo();
   2829 /// }
   2830 /// namespace B {
   2831 ///   using A::foo; // <- a UsingDecl
   2832 ///                 // Also creates a UsingShadowDecl for A::foo() in B
   2833 /// }
   2834 /// \endcode
   2835 class UsingShadowDecl : public NamedDecl, public Redeclarable<UsingShadowDecl> {
   2836   void anchor() override;
   2837 
   2838   /// The referenced declaration.
   2839   NamedDecl *Underlying;
   2840 
   2841   /// \brief The using declaration which introduced this decl or the next using
   2842   /// shadow declaration contained in the aforementioned using declaration.
   2843   NamedDecl *UsingOrNextShadow;
   2844   friend class UsingDecl;
   2845 
   2846   typedef Redeclarable<UsingShadowDecl> redeclarable_base;
   2847   UsingShadowDecl *getNextRedeclarationImpl() override {
   2848     return getNextRedeclaration();
   2849   }
   2850   UsingShadowDecl *getPreviousDeclImpl() override {
   2851     return getPreviousDecl();
   2852   }
   2853   UsingShadowDecl *getMostRecentDeclImpl() override {
   2854     return getMostRecentDecl();
   2855   }
   2856 
   2857 protected:
   2858   UsingShadowDecl(Kind K, ASTContext &C, DeclContext *DC, SourceLocation Loc,
   2859                   UsingDecl *Using, NamedDecl *Target);
   2860   UsingShadowDecl(Kind K, ASTContext &C, EmptyShell);
   2861 
   2862 public:
   2863   static UsingShadowDecl *Create(ASTContext &C, DeclContext *DC,
   2864                                  SourceLocation Loc, UsingDecl *Using,
   2865                                  NamedDecl *Target) {
   2866     return new (C, DC) UsingShadowDecl(UsingShadow, C, DC, Loc, Using, Target);
   2867   }
   2868 
   2869   static UsingShadowDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   2870 
   2871   typedef redeclarable_base::redecl_range redecl_range;
   2872   typedef redeclarable_base::redecl_iterator redecl_iterator;
   2873   using redeclarable_base::redecls_begin;
   2874   using redeclarable_base::redecls_end;
   2875   using redeclarable_base::redecls;
   2876   using redeclarable_base::getPreviousDecl;
   2877   using redeclarable_base::getMostRecentDecl;
   2878   using redeclarable_base::isFirstDecl;
   2879 
   2880   UsingShadowDecl *getCanonicalDecl() override {
   2881     return getFirstDecl();
   2882   }
   2883   const UsingShadowDecl *getCanonicalDecl() const {
   2884     return getFirstDecl();
   2885   }
   2886 
   2887   /// \brief Gets the underlying declaration which has been brought into the
   2888   /// local scope.
   2889   NamedDecl *getTargetDecl() const { return Underlying; }
   2890 
   2891   /// \brief Sets the underlying declaration which has been brought into the
   2892   /// local scope.
   2893   void setTargetDecl(NamedDecl* ND) {
   2894     assert(ND && "Target decl is null!");
   2895     Underlying = ND;
   2896     IdentifierNamespace = ND->getIdentifierNamespace();
   2897   }
   2898 
   2899   /// \brief Gets the using declaration to which this declaration is tied.
   2900   UsingDecl *getUsingDecl() const;
   2901 
   2902   /// \brief The next using shadow declaration contained in the shadow decl
   2903   /// chain of the using declaration which introduced this decl.
   2904   UsingShadowDecl *getNextUsingShadowDecl() const {
   2905     return dyn_cast_or_null<UsingShadowDecl>(UsingOrNextShadow);
   2906   }
   2907 
   2908   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   2909   static bool classofKind(Kind K) {
   2910     return K == Decl::UsingShadow || K == Decl::ConstructorUsingShadow;
   2911   }
   2912 
   2913   friend class ASTDeclReader;
   2914   friend class ASTDeclWriter;
   2915 };
   2916 
   2917 /// \brief Represents a shadow constructor declaration introduced into a
   2918 /// class by a C++11 using-declaration that names a constructor.
   2919 ///
   2920 /// For example:
   2921 /// \code
   2922 /// struct Base { Base(int); };
   2923 /// struct Derived {
   2924 ///    using Base::Base; // creates a UsingDecl and a ConstructorUsingShadowDecl
   2925 /// };
   2926 /// \endcode
   2927 class ConstructorUsingShadowDecl final : public UsingShadowDecl {
   2928   void anchor() override;
   2929 
   2930   /// \brief If this constructor using declaration inherted the constructor
   2931   /// from an indirect base class, this is the ConstructorUsingShadowDecl
   2932   /// in the named direct base class from which the declaration was inherited.
   2933   ConstructorUsingShadowDecl *NominatedBaseClassShadowDecl;
   2934 
   2935   /// \brief If this constructor using declaration inherted the constructor
   2936   /// from an indirect base class, this is the ConstructorUsingShadowDecl
   2937   /// that will be used to construct the unique direct or virtual base class
   2938   /// that receives the constructor arguments.
   2939   ConstructorUsingShadowDecl *ConstructedBaseClassShadowDecl;
   2940 
   2941   /// \brief \c true if the constructor ultimately named by this using shadow
   2942   /// declaration is within a virtual base class subobject of the class that
   2943   /// contains this declaration.
   2944   unsigned IsVirtual : 1;
   2945 
   2946   ConstructorUsingShadowDecl(ASTContext &C, DeclContext *DC, SourceLocation Loc,
   2947                              UsingDecl *Using, NamedDecl *Target,
   2948                              bool TargetInVirtualBase)
   2949       : UsingShadowDecl(ConstructorUsingShadow, C, DC, Loc, Using,
   2950                         Target->getUnderlyingDecl()),
   2951         NominatedBaseClassShadowDecl(
   2952             dyn_cast<ConstructorUsingShadowDecl>(Target)),
   2953         ConstructedBaseClassShadowDecl(NominatedBaseClassShadowDecl),
   2954         IsVirtual(TargetInVirtualBase) {
   2955     // If we found a constructor for a non-virtual base class, but it chains to
   2956     // a constructor for a virtual base, we should directly call the virtual
   2957     // base constructor instead.
   2958     // FIXME: This logic belongs in Sema.
   2959     if (!TargetInVirtualBase && NominatedBaseClassShadowDecl &&
   2960         NominatedBaseClassShadowDecl->constructsVirtualBase()) {
   2961       ConstructedBaseClassShadowDecl =
   2962           NominatedBaseClassShadowDecl->ConstructedBaseClassShadowDecl;
   2963       IsVirtual = true;
   2964     }
   2965   }
   2966   ConstructorUsingShadowDecl(ASTContext &C, EmptyShell Empty)
   2967       : UsingShadowDecl(ConstructorUsingShadow, C, Empty) {}
   2968 
   2969 public:
   2970   static ConstructorUsingShadowDecl *Create(ASTContext &C, DeclContext *DC,
   2971                                             SourceLocation Loc,
   2972                                             UsingDecl *Using, NamedDecl *Target,
   2973                                             bool IsVirtual);
   2974   static ConstructorUsingShadowDecl *CreateDeserialized(ASTContext &C,
   2975                                                         unsigned ID);
   2976 
   2977   /// Returns the parent of this using shadow declaration, which
   2978   /// is the class in which this is declared.
   2979   //@{
   2980   const CXXRecordDecl *getParent() const {
   2981     return cast<CXXRecordDecl>(getDeclContext());
   2982   }
   2983   CXXRecordDecl *getParent() {
   2984     return cast<CXXRecordDecl>(getDeclContext());
   2985   }
   2986   //@}
   2987 
   2988   /// \brief Get the inheriting constructor declaration for the direct base
   2989   /// class from which this using shadow declaration was inherited, if there is
   2990   /// one. This can be different for each redeclaration of the same shadow decl.
   2991   ConstructorUsingShadowDecl *getNominatedBaseClassShadowDecl() const {
   2992     return NominatedBaseClassShadowDecl;
   2993   }
   2994 
   2995   /// \brief Get the inheriting constructor declaration for the base class
   2996   /// for which we don't have an explicit initializer, if there is one.
   2997   ConstructorUsingShadowDecl *getConstructedBaseClassShadowDecl() const {
   2998     return ConstructedBaseClassShadowDecl;
   2999   }
   3000 
   3001   /// \brief Get the base class that was named in the using declaration. This
   3002   /// can be different for each redeclaration of this same shadow decl.
   3003   CXXRecordDecl *getNominatedBaseClass() const;
   3004 
   3005   /// \brief Get the base class whose constructor or constructor shadow
   3006   /// declaration is passed the constructor arguments.
   3007   CXXRecordDecl *getConstructedBaseClass() const {
   3008     return cast<CXXRecordDecl>((ConstructedBaseClassShadowDecl
   3009                                     ? ConstructedBaseClassShadowDecl
   3010                                     : getTargetDecl())
   3011                                    ->getDeclContext());
   3012   }
   3013 
   3014   /// \brief Returns \c true if the constructed base class is a virtual base
   3015   /// class subobject of this declaration's class.
   3016   bool constructsVirtualBase() const {
   3017     return IsVirtual;
   3018   }
   3019 
   3020   /// \brief Get the constructor or constructor template in the derived class
   3021   /// correspnding to this using shadow declaration, if it has been implicitly
   3022   /// declared already.
   3023   CXXConstructorDecl *getConstructor() const;
   3024   void setConstructor(NamedDecl *Ctor);
   3025 
   3026   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   3027   static bool classofKind(Kind K) { return K == ConstructorUsingShadow; }
   3028 
   3029   friend class ASTDeclReader;
   3030   friend class ASTDeclWriter;
   3031 };
   3032 
   3033 /// \brief Represents a C++ using-declaration.
   3034 ///
   3035 /// For example:
   3036 /// \code
   3037 ///    using someNameSpace::someIdentifier;
   3038 /// \endcode
   3039 class UsingDecl : public NamedDecl, public Mergeable<UsingDecl> {
   3040   void anchor() override;
   3041 
   3042   /// \brief The source location of the 'using' keyword itself.
   3043   SourceLocation UsingLocation;
   3044 
   3045   /// \brief The nested-name-specifier that precedes the name.
   3046   NestedNameSpecifierLoc QualifierLoc;
   3047 
   3048   /// \brief Provides source/type location info for the declaration name
   3049   /// embedded in the ValueDecl base class.
   3050   DeclarationNameLoc DNLoc;
   3051 
   3052   /// \brief The first shadow declaration of the shadow decl chain associated
   3053   /// with this using declaration.
   3054   ///
   3055   /// The bool member of the pair store whether this decl has the \c typename
   3056   /// keyword.
   3057   llvm::PointerIntPair<UsingShadowDecl *, 1, bool> FirstUsingShadow;
   3058 
   3059   UsingDecl(DeclContext *DC, SourceLocation UL,
   3060             NestedNameSpecifierLoc QualifierLoc,
   3061             const DeclarationNameInfo &NameInfo, bool HasTypenameKeyword)
   3062     : NamedDecl(Using, DC, NameInfo.getLoc(), NameInfo.getName()),
   3063       UsingLocation(UL), QualifierLoc(QualifierLoc),
   3064       DNLoc(NameInfo.getInfo()), FirstUsingShadow(nullptr, HasTypenameKeyword) {
   3065   }
   3066 
   3067 public:
   3068   /// \brief Return the source location of the 'using' keyword.
   3069   SourceLocation getUsingLoc() const { return UsingLocation; }
   3070 
   3071   /// \brief Set the source location of the 'using' keyword.
   3072   void setUsingLoc(SourceLocation L) { UsingLocation = L; }
   3073 
   3074   /// \brief Retrieve the nested-name-specifier that qualifies the name,
   3075   /// with source-location information.
   3076   NestedNameSpecifierLoc getQualifierLoc() const { return QualifierLoc; }
   3077 
   3078   /// \brief Retrieve the nested-name-specifier that qualifies the name.
   3079   NestedNameSpecifier *getQualifier() const {
   3080     return QualifierLoc.getNestedNameSpecifier();
   3081   }
   3082 
   3083   DeclarationNameInfo getNameInfo() const {
   3084     return DeclarationNameInfo(getDeclName(), getLocation(), DNLoc);
   3085   }
   3086 
   3087   /// \brief Return true if it is a C++03 access declaration (no 'using').
   3088   bool isAccessDeclaration() const { return UsingLocation.isInvalid(); }
   3089 
   3090   /// \brief Return true if the using declaration has 'typename'.
   3091   bool hasTypename() const { return FirstUsingShadow.getInt(); }
   3092 
   3093   /// \brief Sets whether the using declaration has 'typename'.
   3094   void setTypename(bool TN) { FirstUsingShadow.setInt(TN); }
   3095 
   3096   /// \brief Iterates through the using shadow declarations associated with
   3097   /// this using declaration.
   3098   class shadow_iterator {
   3099     /// \brief The current using shadow declaration.
   3100     UsingShadowDecl *Current;
   3101 
   3102   public:
   3103     typedef UsingShadowDecl*          value_type;
   3104     typedef UsingShadowDecl*          reference;
   3105     typedef UsingShadowDecl*          pointer;
   3106     typedef std::forward_iterator_tag iterator_category;
   3107     typedef std::ptrdiff_t            difference_type;
   3108 
   3109     shadow_iterator() : Current(nullptr) { }
   3110     explicit shadow_iterator(UsingShadowDecl *C) : Current(C) { }
   3111 
   3112     reference operator*() const { return Current; }
   3113     pointer operator->() const { return Current; }
   3114 
   3115     shadow_iterator& operator++() {
   3116       Current = Current->getNextUsingShadowDecl();
   3117       return *this;
   3118     }
   3119 
   3120     shadow_iterator operator++(int) {
   3121       shadow_iterator tmp(*this);
   3122       ++(*this);
   3123       return tmp;
   3124     }
   3125 
   3126     friend bool operator==(shadow_iterator x, shadow_iterator y) {
   3127       return x.Current == y.Current;
   3128     }
   3129     friend bool operator!=(shadow_iterator x, shadow_iterator y) {
   3130       return x.Current != y.Current;
   3131     }
   3132   };
   3133 
   3134   typedef llvm::iterator_range<shadow_iterator> shadow_range;
   3135 
   3136   shadow_range shadows() const {
   3137     return shadow_range(shadow_begin(), shadow_end());
   3138   }
   3139   shadow_iterator shadow_begin() const {
   3140     return shadow_iterator(FirstUsingShadow.getPointer());
   3141   }
   3142   shadow_iterator shadow_end() const { return shadow_iterator(); }
   3143 
   3144   /// \brief Return the number of shadowed declarations associated with this
   3145   /// using declaration.
   3146   unsigned shadow_size() const {
   3147     return std::distance(shadow_begin(), shadow_end());
   3148   }
   3149 
   3150   void addShadowDecl(UsingShadowDecl *S);
   3151   void removeShadowDecl(UsingShadowDecl *S);
   3152 
   3153   static UsingDecl *Create(ASTContext &C, DeclContext *DC,
   3154                            SourceLocation UsingL,
   3155                            NestedNameSpecifierLoc QualifierLoc,
   3156                            const DeclarationNameInfo &NameInfo,
   3157                            bool HasTypenameKeyword);
   3158 
   3159   static UsingDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   3160 
   3161   SourceRange getSourceRange() const override LLVM_READONLY;
   3162 
   3163   /// Retrieves the canonical declaration of this declaration.
   3164   UsingDecl *getCanonicalDecl() override { return getFirstDecl(); }
   3165   const UsingDecl *getCanonicalDecl() const { return getFirstDecl(); }
   3166 
   3167   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   3168   static bool classofKind(Kind K) { return K == Using; }
   3169 
   3170   friend class ASTDeclReader;
   3171   friend class ASTDeclWriter;
   3172 };
   3173 
   3174 /// \brief Represents a dependent using declaration which was not marked with
   3175 /// \c typename.
   3176 ///
   3177 /// Unlike non-dependent using declarations, these *only* bring through
   3178 /// non-types; otherwise they would break two-phase lookup.
   3179 ///
   3180 /// \code
   3181 /// template \<class T> class A : public Base<T> {
   3182 ///   using Base<T>::foo;
   3183 /// };
   3184 /// \endcode
   3185 class UnresolvedUsingValueDecl : public ValueDecl,
   3186                                  public Mergeable<UnresolvedUsingValueDecl> {
   3187   void anchor() override;
   3188 
   3189   /// \brief The source location of the 'using' keyword
   3190   SourceLocation UsingLocation;
   3191 
   3192   /// \brief The nested-name-specifier that precedes the name.
   3193   NestedNameSpecifierLoc QualifierLoc;
   3194 
   3195   /// \brief Provides source/type location info for the declaration name
   3196   /// embedded in the ValueDecl base class.
   3197   DeclarationNameLoc DNLoc;
   3198 
   3199   UnresolvedUsingValueDecl(DeclContext *DC, QualType Ty,
   3200                            SourceLocation UsingLoc,
   3201                            NestedNameSpecifierLoc QualifierLoc,
   3202                            const DeclarationNameInfo &NameInfo)
   3203     : ValueDecl(UnresolvedUsingValue, DC,
   3204                 NameInfo.getLoc(), NameInfo.getName(), Ty),
   3205       UsingLocation(UsingLoc), QualifierLoc(QualifierLoc),
   3206       DNLoc(NameInfo.getInfo())
   3207   { }
   3208 
   3209 public:
   3210   /// \brief Returns the source location of the 'using' keyword.
   3211   SourceLocation getUsingLoc() const { return UsingLocation; }
   3212 
   3213   /// \brief Set the source location of the 'using' keyword.
   3214   void setUsingLoc(SourceLocation L) { UsingLocation = L; }
   3215 
   3216   /// \brief Return true if it is a C++03 access declaration (no 'using').
   3217   bool isAccessDeclaration() const { return UsingLocation.isInvalid(); }
   3218 
   3219   /// \brief Retrieve the nested-name-specifier that qualifies the name,
   3220   /// with source-location information.
   3221   NestedNameSpecifierLoc getQualifierLoc() const { return QualifierLoc; }
   3222 
   3223   /// \brief Retrieve the nested-name-specifier that qualifies the name.
   3224   NestedNameSpecifier *getQualifier() const {
   3225     return QualifierLoc.getNestedNameSpecifier();
   3226   }
   3227 
   3228   DeclarationNameInfo getNameInfo() const {
   3229     return DeclarationNameInfo(getDeclName(), getLocation(), DNLoc);
   3230   }
   3231 
   3232   static UnresolvedUsingValueDecl *
   3233     Create(ASTContext &C, DeclContext *DC, SourceLocation UsingLoc,
   3234            NestedNameSpecifierLoc QualifierLoc,
   3235            const DeclarationNameInfo &NameInfo);
   3236 
   3237   static UnresolvedUsingValueDecl *
   3238   CreateDeserialized(ASTContext &C, unsigned ID);
   3239 
   3240   SourceRange getSourceRange() const override LLVM_READONLY;
   3241 
   3242   /// Retrieves the canonical declaration of this declaration.
   3243   UnresolvedUsingValueDecl *getCanonicalDecl() override {
   3244     return getFirstDecl();
   3245   }
   3246   const UnresolvedUsingValueDecl *getCanonicalDecl() const {
   3247     return getFirstDecl();
   3248   }
   3249 
   3250   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   3251   static bool classofKind(Kind K) { return K == UnresolvedUsingValue; }
   3252 
   3253   friend class ASTDeclReader;
   3254   friend class ASTDeclWriter;
   3255 };
   3256 
   3257 /// \brief Represents a dependent using declaration which was marked with
   3258 /// \c typename.
   3259 ///
   3260 /// \code
   3261 /// template \<class T> class A : public Base<T> {
   3262 ///   using typename Base<T>::foo;
   3263 /// };
   3264 /// \endcode
   3265 ///
   3266 /// The type associated with an unresolved using typename decl is
   3267 /// currently always a typename type.
   3268 class UnresolvedUsingTypenameDecl
   3269     : public TypeDecl,
   3270       public Mergeable<UnresolvedUsingTypenameDecl> {
   3271   void anchor() override;
   3272 
   3273   /// \brief The source location of the 'typename' keyword
   3274   SourceLocation TypenameLocation;
   3275 
   3276   /// \brief The nested-name-specifier that precedes the name.
   3277   NestedNameSpecifierLoc QualifierLoc;
   3278 
   3279   UnresolvedUsingTypenameDecl(DeclContext *DC, SourceLocation UsingLoc,
   3280                               SourceLocation TypenameLoc,
   3281                               NestedNameSpecifierLoc QualifierLoc,
   3282                               SourceLocation TargetNameLoc,
   3283                               IdentifierInfo *TargetName)
   3284     : TypeDecl(UnresolvedUsingTypename, DC, TargetNameLoc, TargetName,
   3285                UsingLoc),
   3286       TypenameLocation(TypenameLoc), QualifierLoc(QualifierLoc) { }
   3287 
   3288   friend class ASTDeclReader;
   3289 
   3290 public:
   3291   /// \brief Returns the source location of the 'using' keyword.
   3292   SourceLocation getUsingLoc() const { return getLocStart(); }
   3293 
   3294   /// \brief Returns the source location of the 'typename' keyword.
   3295   SourceLocation getTypenameLoc() const { return TypenameLocation; }
   3296 
   3297   /// \brief Retrieve the nested-name-specifier that qualifies the name,
   3298   /// with source-location information.
   3299   NestedNameSpecifierLoc getQualifierLoc() const { return QualifierLoc; }
   3300 
   3301   /// \brief Retrieve the nested-name-specifier that qualifies the name.
   3302   NestedNameSpecifier *getQualifier() const {
   3303     return QualifierLoc.getNestedNameSpecifier();
   3304   }
   3305 
   3306   static UnresolvedUsingTypenameDecl *
   3307     Create(ASTContext &C, DeclContext *DC, SourceLocation UsingLoc,
   3308            SourceLocation TypenameLoc, NestedNameSpecifierLoc QualifierLoc,
   3309            SourceLocation TargetNameLoc, DeclarationName TargetName);
   3310 
   3311   static UnresolvedUsingTypenameDecl *
   3312   CreateDeserialized(ASTContext &C, unsigned ID);
   3313 
   3314   /// Retrieves the canonical declaration of this declaration.
   3315   UnresolvedUsingTypenameDecl *getCanonicalDecl() override {
   3316     return getFirstDecl();
   3317   }
   3318   const UnresolvedUsingTypenameDecl *getCanonicalDecl() const {
   3319     return getFirstDecl();
   3320   }
   3321 
   3322   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   3323   static bool classofKind(Kind K) { return K == UnresolvedUsingTypename; }
   3324 };
   3325 
   3326 /// \brief Represents a C++11 static_assert declaration.
   3327 class StaticAssertDecl : public Decl {
   3328   virtual void anchor();
   3329   llvm::PointerIntPair<Expr *, 1, bool> AssertExprAndFailed;
   3330   StringLiteral *Message;
   3331   SourceLocation RParenLoc;
   3332 
   3333   StaticAssertDecl(DeclContext *DC, SourceLocation StaticAssertLoc,
   3334                    Expr *AssertExpr, StringLiteral *Message,
   3335                    SourceLocation RParenLoc, bool Failed)
   3336     : Decl(StaticAssert, DC, StaticAssertLoc),
   3337       AssertExprAndFailed(AssertExpr, Failed), Message(Message),
   3338       RParenLoc(RParenLoc) { }
   3339 
   3340 public:
   3341   static StaticAssertDecl *Create(ASTContext &C, DeclContext *DC,
   3342                                   SourceLocation StaticAssertLoc,
   3343                                   Expr *AssertExpr, StringLiteral *Message,
   3344                                   SourceLocation RParenLoc, bool Failed);
   3345   static StaticAssertDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   3346 
   3347   Expr *getAssertExpr() { return AssertExprAndFailed.getPointer(); }
   3348   const Expr *getAssertExpr() const { return AssertExprAndFailed.getPointer(); }
   3349 
   3350   StringLiteral *getMessage() { return Message; }
   3351   const StringLiteral *getMessage() const { return Message; }
   3352 
   3353   bool isFailed() const { return AssertExprAndFailed.getInt(); }
   3354 
   3355   SourceLocation getRParenLoc() const { return RParenLoc; }
   3356 
   3357   SourceRange getSourceRange() const override LLVM_READONLY {
   3358     return SourceRange(getLocation(), getRParenLoc());
   3359   }
   3360 
   3361   static bool classof(const Decl *D) { return classofKind(D->getKind()); }
   3362   static bool classofKind(Kind K) { return K == StaticAssert; }
   3363 
   3364   friend class ASTDeclReader;
   3365 };
   3366 
   3367 /// An instance of this class represents the declaration of a property
   3368 /// member.  This is a Microsoft extension to C++, first introduced in
   3369 /// Visual Studio .NET 2003 as a parallel to similar features in C#
   3370 /// and Managed C++.
   3371 ///
   3372 /// A property must always be a non-static class member.
   3373 ///
   3374 /// A property member superficially resembles a non-static data
   3375 /// member, except preceded by a property attribute:
   3376 ///   __declspec(property(get=GetX, put=PutX)) int x;
   3377 /// Either (but not both) of the 'get' and 'put' names may be omitted.
   3378 ///
   3379 /// A reference to a property is always an lvalue.  If the lvalue
   3380 /// undergoes lvalue-to-rvalue conversion, then a getter name is
   3381 /// required, and that member is called with no arguments.
   3382 /// If the lvalue is assigned into, then a setter name is required,
   3383 /// and that member is called with one argument, the value assigned.
   3384 /// Both operations are potentially overloaded.  Compound assignments
   3385 /// are permitted, as are the increment and decrement operators.
   3386 ///
   3387 /// The getter and putter methods are permitted to be overloaded,
   3388 /// although their return and parameter types are subject to certain
   3389 /// restrictions according to the type of the property.
   3390 ///
   3391 /// A property declared using an incomplete array type may
   3392 /// additionally be subscripted, adding extra parameters to the getter
   3393 /// and putter methods.
   3394 class MSPropertyDecl : public DeclaratorDecl {
   3395   IdentifierInfo *GetterId, *SetterId;
   3396 
   3397   MSPropertyDecl(DeclContext *DC, SourceLocation L, DeclarationName N,
   3398                  QualType T, TypeSourceInfo *TInfo, SourceLocation StartL,
   3399                  IdentifierInfo *Getter, IdentifierInfo *Setter)
   3400       : DeclaratorDecl(MSProperty, DC, L, N, T, TInfo, StartL),
   3401         GetterId(Getter), SetterId(Setter) {}
   3402 
   3403 public:
   3404   static MSPropertyDecl *Create(ASTContext &C, DeclContext *DC,
   3405                                 SourceLocation L, DeclarationName N, QualType T,
   3406                                 TypeSourceInfo *TInfo, SourceLocation StartL,
   3407                                 IdentifierInfo *Getter, IdentifierInfo *Setter);
   3408   static MSPropertyDecl *CreateDeserialized(ASTContext &C, unsigned ID);
   3409 
   3410   static bool classof(const Decl *D) { return D->getKind() == MSProperty; }
   3411 
   3412   bool hasGetter() const { return GetterId != nullptr; }
   3413   IdentifierInfo* getGetterId() const { return GetterId; }
   3414   bool hasSetter() const { return SetterId != nullptr; }
   3415   IdentifierInfo* getSetterId() const { return SetterId; }
   3416 
   3417   friend class ASTDeclReader;
   3418 };
   3419 
   3420 /// Insertion operator for diagnostics.  This allows sending an AccessSpecifier
   3421 /// into a diagnostic with <<.
   3422 const DiagnosticBuilder &operator<<(const DiagnosticBuilder &DB,
   3423                                     AccessSpecifier AS);
   3424 
   3425 const PartialDiagnostic &operator<<(const PartialDiagnostic &DB,
   3426                                     AccessSpecifier AS);
   3427 
   3428 } // end namespace clang
   3429 
   3430 #endif
   3431