DeclCXX.h revision 208954
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//  This file defines the C++ Decl subclasses, other than those for
11//  templates (in DeclTemplate.h) and friends (in DeclFriend.h).
12//
13//===----------------------------------------------------------------------===//
14
15#ifndef LLVM_CLANG_AST_DECLCXX_H
16#define LLVM_CLANG_AST_DECLCXX_H
17
18#include "clang/AST/Expr.h"
19#include "clang/AST/Decl.h"
20#include "clang/AST/UnresolvedSet.h"
21#include "llvm/ADT/SmallVector.h"
22#include "llvm/ADT/SmallPtrSet.h"
23
24namespace clang {
25
26class ClassTemplateDecl;
27class ClassTemplateSpecializationDecl;
28class CXXBasePath;
29class CXXBasePaths;
30class CXXConstructorDecl;
31class CXXConversionDecl;
32class CXXDestructorDecl;
33class CXXMethodDecl;
34class CXXRecordDecl;
35class CXXMemberLookupCriteria;
36class CXXFinalOverriderMap;
37class FriendDecl;
38
39/// \brief Represents any kind of function declaration, whether it is a
40/// concrete function or a function template.
41class AnyFunctionDecl {
42  NamedDecl *Function;
43
44  AnyFunctionDecl(NamedDecl *ND) : Function(ND) { }
45
46public:
47  AnyFunctionDecl(FunctionDecl *FD) : Function(FD) { }
48  AnyFunctionDecl(FunctionTemplateDecl *FTD);
49
50  /// \brief Implicily converts any function or function template into a
51  /// named declaration.
52  operator NamedDecl *() const { return Function; }
53
54  /// \brief Retrieve the underlying function or function template.
55  NamedDecl *get() const { return Function; }
56
57  static AnyFunctionDecl getFromNamedDecl(NamedDecl *ND) {
58    return AnyFunctionDecl(ND);
59  }
60};
61
62} // end namespace clang
63
64namespace llvm {
65  /// Implement simplify_type for AnyFunctionDecl, so that we can dyn_cast from
66  /// AnyFunctionDecl to any function or function template declaration.
67  template<> struct simplify_type<const ::clang::AnyFunctionDecl> {
68    typedef ::clang::NamedDecl* SimpleType;
69    static SimpleType getSimplifiedValue(const ::clang::AnyFunctionDecl &Val) {
70      return Val;
71    }
72  };
73  template<> struct simplify_type< ::clang::AnyFunctionDecl>
74  : public simplify_type<const ::clang::AnyFunctionDecl> {};
75
76  // Provide PointerLikeTypeTraits for non-cvr pointers.
77  template<>
78  class PointerLikeTypeTraits< ::clang::AnyFunctionDecl> {
79  public:
80    static inline void *getAsVoidPointer(::clang::AnyFunctionDecl F) {
81      return F.get();
82    }
83    static inline ::clang::AnyFunctionDecl getFromVoidPointer(void *P) {
84      return ::clang::AnyFunctionDecl::getFromNamedDecl(
85                                      static_cast< ::clang::NamedDecl*>(P));
86    }
87
88    enum { NumLowBitsAvailable = 2 };
89  };
90
91} // end namespace llvm
92
93namespace clang {
94
95/// CXXBaseSpecifier - A base class of a C++ class.
96///
97/// Each CXXBaseSpecifier represents a single, direct base class (or
98/// struct) of a C++ class (or struct). It specifies the type of that
99/// base class, whether it is a virtual or non-virtual base, and what
100/// level of access (public, protected, private) is used for the
101/// derivation. For example:
102///
103/// @code
104///   class A { };
105///   class B { };
106///   class C : public virtual A, protected B { };
107/// @endcode
108///
109/// In this code, C will have two CXXBaseSpecifiers, one for "public
110/// virtual A" and the other for "protected B".
111class CXXBaseSpecifier {
112  /// Range - The source code range that covers the full base
113  /// specifier, including the "virtual" (if present) and access
114  /// specifier (if present).
115  // FIXME: Move over to a TypeLoc!
116  SourceRange Range;
117
118  /// Virtual - Whether this is a virtual base class or not.
119  bool Virtual : 1;
120
121  /// BaseOfClass - Whether this is the base of a class (true) or of a
122  /// struct (false). This determines the mapping from the access
123  /// specifier as written in the source code to the access specifier
124  /// used for semantic analysis.
125  bool BaseOfClass : 1;
126
127  /// Access - Access specifier as written in the source code (which
128  /// may be AS_none). The actual type of data stored here is an
129  /// AccessSpecifier, but we use "unsigned" here to work around a
130  /// VC++ bug.
131  unsigned Access : 2;
132
133  /// BaseType - The type of the base class. This will be a class or
134  /// struct (or a typedef of such).
135  QualType BaseType;
136
137public:
138  CXXBaseSpecifier() { }
139
140  CXXBaseSpecifier(SourceRange R, bool V, bool BC, AccessSpecifier A, QualType T)
141    : Range(R), Virtual(V), BaseOfClass(BC), Access(A), BaseType(T) { }
142
143  /// getSourceRange - Retrieves the source range that contains the
144  /// entire base specifier.
145  SourceRange getSourceRange() const { return Range; }
146
147  /// isVirtual - Determines whether the base class is a virtual base
148  /// class (or not).
149  bool isVirtual() const { return Virtual; }
150
151  /// \brief Determine whether this base class if a base of a class declared
152  /// with the 'class' keyword (vs. one declared with the 'struct' keyword).
153  bool isBaseOfClass() const { return BaseOfClass; }
154
155  /// getAccessSpecifier - Returns the access specifier for this base
156  /// specifier. This is the actual base specifier as used for
157  /// semantic analysis, so the result can never be AS_none. To
158  /// retrieve the access specifier as written in the source code, use
159  /// getAccessSpecifierAsWritten().
160  AccessSpecifier getAccessSpecifier() const {
161    if ((AccessSpecifier)Access == AS_none)
162      return BaseOfClass? AS_private : AS_public;
163    else
164      return (AccessSpecifier)Access;
165  }
166
167  /// getAccessSpecifierAsWritten - Retrieves the access specifier as
168  /// written in the source code (which may mean that no access
169  /// specifier was explicitly written). Use getAccessSpecifier() to
170  /// retrieve the access specifier for use in semantic analysis.
171  AccessSpecifier getAccessSpecifierAsWritten() const {
172    return (AccessSpecifier)Access;
173  }
174
175  /// getType - Retrieves the type of the base class. This type will
176  /// always be an unqualified class type.
177  QualType getType() const { return BaseType; }
178};
179
180/// CXXRecordDecl - Represents a C++ struct/union/class.
181/// FIXME: This class will disappear once we've properly taught RecordDecl
182/// to deal with C++-specific things.
183class CXXRecordDecl : public RecordDecl {
184
185  friend void TagDecl::startDefinition();
186
187  struct DefinitionData {
188    DefinitionData(CXXRecordDecl *D);
189
190    /// UserDeclaredConstructor - True when this class has a
191    /// user-declared constructor.
192    bool UserDeclaredConstructor : 1;
193
194    /// UserDeclaredCopyConstructor - True when this class has a
195    /// user-declared copy constructor.
196    bool UserDeclaredCopyConstructor : 1;
197
198    /// UserDeclaredCopyAssignment - True when this class has a
199    /// user-declared copy assignment operator.
200    bool UserDeclaredCopyAssignment : 1;
201
202    /// UserDeclaredDestructor - True when this class has a
203    /// user-declared destructor.
204    bool UserDeclaredDestructor : 1;
205
206    /// Aggregate - True when this class is an aggregate.
207    bool Aggregate : 1;
208
209    /// PlainOldData - True when this class is a POD-type.
210    bool PlainOldData : 1;
211
212    /// Empty - true when this class is empty for traits purposes,
213    /// i.e. has no data members other than 0-width bit-fields, has no
214    /// virtual function/base, and doesn't inherit from a non-empty
215    /// class. Doesn't take union-ness into account.
216    bool Empty : 1;
217
218    /// Polymorphic - True when this class is polymorphic, i.e. has at
219    /// least one virtual member or derives from a polymorphic class.
220    bool Polymorphic : 1;
221
222    /// Abstract - True when this class is abstract, i.e. has at least
223    /// one pure virtual function, (that can come from a base class).
224    bool Abstract : 1;
225
226    /// HasTrivialConstructor - True when this class has a trivial constructor.
227    ///
228    /// C++ [class.ctor]p5.  A constructor is trivial if it is an
229    /// implicitly-declared default constructor and if:
230    /// * its class has no virtual functions and no virtual base classes, and
231    /// * all the direct base classes of its class have trivial constructors, and
232    /// * for all the nonstatic data members of its class that are of class type
233    ///   (or array thereof), each such class has a trivial constructor.
234    bool HasTrivialConstructor : 1;
235
236    /// HasTrivialCopyConstructor - True when this class has a trivial copy
237    /// constructor.
238    ///
239    /// C++ [class.copy]p6.  A copy constructor for class X is trivial
240    /// if it is implicitly declared and if
241    /// * class X has no virtual functions and no virtual base classes, and
242    /// * each direct base class of X has a trivial copy constructor, and
243    /// * for all the nonstatic data members of X that are of class type (or
244    ///   array thereof), each such class type has a trivial copy constructor;
245    /// otherwise the copy constructor is non-trivial.
246    bool HasTrivialCopyConstructor : 1;
247
248    /// HasTrivialCopyAssignment - True when this class has a trivial copy
249    /// assignment operator.
250    ///
251    /// C++ [class.copy]p11.  A copy assignment operator for class X is
252    /// trivial if it is implicitly declared and if
253    /// * class X has no virtual functions and no virtual base classes, and
254    /// * each direct base class of X has a trivial copy assignment operator, and
255    /// * for all the nonstatic data members of X that are of class type (or
256    ///   array thereof), each such class type has a trivial copy assignment
257    ///   operator;
258    /// otherwise the copy assignment operator is non-trivial.
259    bool HasTrivialCopyAssignment : 1;
260
261    /// HasTrivialDestructor - True when this class has a trivial destructor.
262    ///
263    /// C++ [class.dtor]p3.  A destructor is trivial if it is an
264    /// implicitly-declared destructor and if:
265    /// * all of the direct base classes of its class have trivial destructors
266    ///   and
267    /// * for all of the non-static data members of its class that are of class
268    ///   type (or array thereof), each such class has a trivial destructor.
269    bool HasTrivialDestructor : 1;
270
271    /// ComputedVisibleConversions - True when visible conversion functions are
272    /// already computed and are available.
273    bool ComputedVisibleConversions : 1;
274
275    /// Bases - Base classes of this class.
276    /// FIXME: This is wasted space for a union.
277    CXXBaseSpecifier *Bases;
278
279    /// NumBases - The number of base class specifiers in Bases.
280    unsigned NumBases;
281
282    /// VBases - direct and indirect virtual base classes of this class.
283    CXXBaseSpecifier *VBases;
284
285    /// NumVBases - The number of virtual base class specifiers in VBases.
286    unsigned NumVBases;
287
288    /// Conversions - Overload set containing the conversion functions
289    /// of this C++ class (but not its inherited conversion
290    /// functions). Each of the entries in this overload set is a
291    /// CXXConversionDecl.
292    UnresolvedSet<4> Conversions;
293
294    /// VisibleConversions - Overload set containing the conversion
295    /// functions of this C++ class and all those inherited conversion
296    /// functions that are visible in this class. Each of the entries
297    /// in this overload set is a CXXConversionDecl or a
298    /// FunctionTemplateDecl.
299    UnresolvedSet<4> VisibleConversions;
300
301    /// Definition - The declaration which defines this record.
302    CXXRecordDecl *Definition;
303
304    /// FirstFriend - The first friend declaration in this class, or
305    /// null if there aren't any.  This is actually currently stored
306    /// in reverse order.
307    FriendDecl *FirstFriend;
308
309  } *DefinitionData;
310
311  struct DefinitionData &data() {
312    assert(DefinitionData && "queried property of class with no definition");
313    return *DefinitionData;
314  }
315
316  const struct DefinitionData &data() const {
317    assert(DefinitionData && "queried property of class with no definition");
318    return *DefinitionData;
319  }
320
321  /// \brief The template or declaration that this declaration
322  /// describes or was instantiated from, respectively.
323  ///
324  /// For non-templates, this value will be NULL. For record
325  /// declarations that describe a class template, this will be a
326  /// pointer to a ClassTemplateDecl. For member
327  /// classes of class template specializations, this will be the
328  /// MemberSpecializationInfo referring to the member class that was
329  /// instantiated or specialized.
330  llvm::PointerUnion<ClassTemplateDecl*, MemberSpecializationInfo*>
331    TemplateOrInstantiation;
332
333#ifndef NDEBUG
334  void CheckConversionFunction(NamedDecl *D);
335#endif
336
337protected:
338  CXXRecordDecl(Kind K, TagKind TK, DeclContext *DC,
339                SourceLocation L, IdentifierInfo *Id,
340                CXXRecordDecl *PrevDecl,
341                SourceLocation TKL = SourceLocation());
342
343  ~CXXRecordDecl();
344
345public:
346  /// base_class_iterator - Iterator that traverses the base classes
347  /// of a class.
348  typedef CXXBaseSpecifier*       base_class_iterator;
349
350  /// base_class_const_iterator - Iterator that traverses the base
351  /// classes of a class.
352  typedef const CXXBaseSpecifier* base_class_const_iterator;
353
354  /// reverse_base_class_iterator = Iterator that traverses the base classes
355  /// of a class in reverse order.
356  typedef std::reverse_iterator<base_class_iterator>
357    reverse_base_class_iterator;
358
359  /// reverse_base_class_iterator = Iterator that traverses the base classes
360  /// of a class in reverse order.
361  typedef std::reverse_iterator<base_class_const_iterator>
362    reverse_base_class_const_iterator;
363
364  virtual CXXRecordDecl *getCanonicalDecl() {
365    return cast<CXXRecordDecl>(RecordDecl::getCanonicalDecl());
366  }
367  virtual const CXXRecordDecl *getCanonicalDecl() const {
368    return cast<CXXRecordDecl>(RecordDecl::getCanonicalDecl());
369  }
370
371  CXXRecordDecl *getDefinition() const {
372    if (!DefinitionData) return 0;
373    return data().Definition;
374  }
375
376  bool hasDefinition() const { return DefinitionData != 0; }
377
378  static CXXRecordDecl *Create(ASTContext &C, TagKind TK, DeclContext *DC,
379                               SourceLocation L, IdentifierInfo *Id,
380                               SourceLocation TKL = SourceLocation(),
381                               CXXRecordDecl* PrevDecl=0,
382                               bool DelayTypeCreation = false);
383
384  virtual void Destroy(ASTContext& C);
385
386  bool isDynamicClass() const {
387    return data().Polymorphic || data().NumVBases != 0;
388  }
389
390  /// setBases - Sets the base classes of this struct or class.
391  void setBases(CXXBaseSpecifier const * const *Bases, unsigned NumBases);
392
393  /// getNumBases - Retrieves the number of base classes of this
394  /// class.
395  unsigned getNumBases() const { return data().NumBases; }
396
397  base_class_iterator bases_begin() { return data().Bases; }
398  base_class_const_iterator bases_begin() const { return data().Bases; }
399  base_class_iterator bases_end() { return bases_begin() + data().NumBases; }
400  base_class_const_iterator bases_end() const {
401    return bases_begin() + data().NumBases;
402  }
403  reverse_base_class_iterator       bases_rbegin() {
404    return reverse_base_class_iterator(bases_end());
405  }
406  reverse_base_class_const_iterator bases_rbegin() const {
407    return reverse_base_class_const_iterator(bases_end());
408  }
409  reverse_base_class_iterator bases_rend() {
410    return reverse_base_class_iterator(bases_begin());
411  }
412  reverse_base_class_const_iterator bases_rend() const {
413    return reverse_base_class_const_iterator(bases_begin());
414  }
415
416  /// getNumVBases - Retrieves the number of virtual base classes of this
417  /// class.
418  unsigned getNumVBases() const { return data().NumVBases; }
419
420  base_class_iterator vbases_begin() { return data().VBases; }
421  base_class_const_iterator vbases_begin() const { return data().VBases; }
422  base_class_iterator vbases_end() { return vbases_begin() + data().NumVBases; }
423  base_class_const_iterator vbases_end() const {
424    return vbases_begin() + data().NumVBases;
425  }
426  reverse_base_class_iterator vbases_rbegin() {
427    return reverse_base_class_iterator(vbases_end());
428  }
429  reverse_base_class_const_iterator vbases_rbegin() const {
430    return reverse_base_class_const_iterator(vbases_end());
431  }
432  reverse_base_class_iterator vbases_rend() {
433    return reverse_base_class_iterator(vbases_begin());
434  }
435  reverse_base_class_const_iterator vbases_rend() const {
436    return reverse_base_class_const_iterator(vbases_begin());
437 }
438
439  /// \brief Determine whether this class has any dependent base classes.
440  bool hasAnyDependentBases() const;
441
442  /// Iterator access to method members.  The method iterator visits
443  /// all method members of the class, including non-instance methods,
444  /// special methods, etc.
445  typedef specific_decl_iterator<CXXMethodDecl> method_iterator;
446
447  /// method_begin - Method begin iterator.  Iterates in the order the methods
448  /// were declared.
449  method_iterator method_begin() const {
450    return method_iterator(decls_begin());
451  }
452  /// method_end - Method end iterator.
453  method_iterator method_end() const {
454    return method_iterator(decls_end());
455  }
456
457  /// Iterator access to constructor members.
458  typedef specific_decl_iterator<CXXConstructorDecl> ctor_iterator;
459
460  ctor_iterator ctor_begin() const {
461    return ctor_iterator(decls_begin());
462  }
463  ctor_iterator ctor_end() const {
464    return ctor_iterator(decls_end());
465  }
466
467  /// An iterator over friend declarations.  All of these are defined
468  /// in DeclFriend.h.
469  class friend_iterator;
470  friend_iterator friend_begin() const;
471  friend_iterator friend_end() const;
472  void pushFriendDecl(FriendDecl *FD);
473
474  /// Determines whether this record has any friends.
475  bool hasFriends() const {
476    return data().FirstFriend != 0;
477  }
478
479  /// hasConstCopyConstructor - Determines whether this class has a
480  /// copy constructor that accepts a const-qualified argument.
481  bool hasConstCopyConstructor(ASTContext &Context) const;
482
483  /// getCopyConstructor - Returns the copy constructor for this class
484  CXXConstructorDecl *getCopyConstructor(ASTContext &Context,
485                                         unsigned TypeQuals) const;
486
487  /// hasConstCopyAssignment - Determines whether this class has a
488  /// copy assignment operator that accepts a const-qualified argument.
489  /// It returns its decl in MD if found.
490  bool hasConstCopyAssignment(ASTContext &Context,
491                              const CXXMethodDecl *&MD) const;
492
493  /// addedConstructor - Notify the class that another constructor has
494  /// been added. This routine helps maintain information about the
495  /// class based on which constructors have been added.
496  void addedConstructor(ASTContext &Context, CXXConstructorDecl *ConDecl);
497
498  /// hasUserDeclaredConstructor - Whether this class has any
499  /// user-declared constructors. When true, a default constructor
500  /// will not be implicitly declared.
501  bool hasUserDeclaredConstructor() const {
502    return data().UserDeclaredConstructor;
503  }
504
505  /// hasUserDeclaredCopyConstructor - Whether this class has a
506  /// user-declared copy constructor. When false, a copy constructor
507  /// will be implicitly declared.
508  bool hasUserDeclaredCopyConstructor() const {
509    return data().UserDeclaredCopyConstructor;
510  }
511
512  /// addedAssignmentOperator - Notify the class that another assignment
513  /// operator has been added. This routine helps maintain information about the
514   /// class based on which operators have been added.
515  void addedAssignmentOperator(ASTContext &Context, CXXMethodDecl *OpDecl);
516
517  /// hasUserDeclaredCopyAssignment - Whether this class has a
518  /// user-declared copy assignment operator. When false, a copy
519  /// assigment operator will be implicitly declared.
520  bool hasUserDeclaredCopyAssignment() const {
521    return data().UserDeclaredCopyAssignment;
522  }
523
524  /// hasUserDeclaredDestructor - Whether this class has a
525  /// user-declared destructor. When false, a destructor will be
526  /// implicitly declared.
527  bool hasUserDeclaredDestructor() const {
528    return data().UserDeclaredDestructor;
529  }
530
531  /// setUserDeclaredDestructor - Set whether this class has a
532  /// user-declared destructor. If not set by the time the class is
533  /// fully defined, a destructor will be implicitly declared.
534  void setUserDeclaredDestructor(bool UCD) {
535    data().UserDeclaredDestructor = UCD;
536  }
537
538  /// getConversions - Retrieve the overload set containing all of the
539  /// conversion functions in this class.
540  UnresolvedSetImpl *getConversionFunctions() {
541    return &data().Conversions;
542  }
543  const UnresolvedSetImpl *getConversionFunctions() const {
544    return &data().Conversions;
545  }
546
547  typedef UnresolvedSetImpl::iterator conversion_iterator;
548  conversion_iterator conversion_begin() const {
549    return getConversionFunctions()->begin();
550  }
551  conversion_iterator conversion_end() const {
552    return getConversionFunctions()->end();
553  }
554
555  /// Replaces a conversion function with a new declaration.
556  ///
557  /// Returns true if the old conversion was found.
558  bool replaceConversion(const NamedDecl* Old, NamedDecl *New) {
559    return getConversionFunctions()->replace(Old, New);
560  }
561
562  /// Removes a conversion function from this class.  The conversion
563  /// function must currently be a member of this class.  Furthermore,
564  /// this class must currently be in the process of being defined.
565  void removeConversion(const NamedDecl *Old);
566
567  /// getVisibleConversionFunctions - get all conversion functions visible
568  /// in current class; including conversion function templates.
569  const UnresolvedSetImpl *getVisibleConversionFunctions();
570
571  /// addConversionFunction - Registers a conversion function which
572  /// this class declares directly.
573  void addConversionFunction(NamedDecl *Decl) {
574#ifndef NDEBUG
575    CheckConversionFunction(Decl);
576#endif
577
578    // We intentionally don't use the decl's access here because it
579    // hasn't been set yet.  That's really just a misdesign in Sema.
580    data().Conversions.addDecl(Decl);
581  }
582
583  /// isAggregate - Whether this class is an aggregate (C++
584  /// [dcl.init.aggr]), which is a class with no user-declared
585  /// constructors, no private or protected non-static data members,
586  /// no base classes, and no virtual functions (C++ [dcl.init.aggr]p1).
587  bool isAggregate() const { return data().Aggregate; }
588
589  /// setAggregate - Set whether this class is an aggregate (C++
590  /// [dcl.init.aggr]).
591  void setAggregate(bool Agg) { data().Aggregate = Agg; }
592
593  /// setMethodAsVirtual - Make input method virtual and set the necesssary
594  /// special function bits and other bits accordingly.
595  void setMethodAsVirtual(FunctionDecl *Method);
596
597  /// isPOD - Whether this class is a POD-type (C++ [class]p4), which is a class
598  /// that is an aggregate that has no non-static non-POD data members, no
599  /// reference data members, no user-defined copy assignment operator and no
600  /// user-defined destructor.
601  bool isPOD() const { return data().PlainOldData; }
602
603  /// setPOD - Set whether this class is a POD-type (C++ [class]p4).
604  void setPOD(bool POD) { data().PlainOldData = POD; }
605
606  /// isEmpty - Whether this class is empty (C++0x [meta.unary.prop]), which
607  /// means it has a virtual function, virtual base, data member (other than
608  /// 0-width bit-field) or inherits from a non-empty class. Does NOT include
609  /// a check for union-ness.
610  bool isEmpty() const { return data().Empty; }
611
612  /// Set whether this class is empty (C++0x [meta.unary.prop])
613  void setEmpty(bool Emp) { data().Empty = Emp; }
614
615  /// isPolymorphic - Whether this class is polymorphic (C++ [class.virtual]),
616  /// which means that the class contains or inherits a virtual function.
617  bool isPolymorphic() const { return data().Polymorphic; }
618
619  /// setPolymorphic - Set whether this class is polymorphic (C++
620  /// [class.virtual]).
621  void setPolymorphic(bool Poly) { data().Polymorphic = Poly; }
622
623  /// isAbstract - Whether this class is abstract (C++ [class.abstract]),
624  /// which means that the class contains or inherits a pure virtual function.
625  bool isAbstract() const { return data().Abstract; }
626
627  /// setAbstract - Set whether this class is abstract (C++ [class.abstract])
628  void setAbstract(bool Abs) { data().Abstract = Abs; }
629
630  // hasTrivialConstructor - Whether this class has a trivial constructor
631  // (C++ [class.ctor]p5)
632  bool hasTrivialConstructor() const { return data().HasTrivialConstructor; }
633
634  // setHasTrivialConstructor - Set whether this class has a trivial constructor
635  // (C++ [class.ctor]p5)
636  void setHasTrivialConstructor(bool TC) { data().HasTrivialConstructor = TC; }
637
638  // hasTrivialCopyConstructor - Whether this class has a trivial copy
639  // constructor (C++ [class.copy]p6)
640  bool hasTrivialCopyConstructor() const {
641    return data().HasTrivialCopyConstructor;
642  }
643
644  // setHasTrivialCopyConstructor - Set whether this class has a trivial
645  // copy constructor (C++ [class.copy]p6)
646  void setHasTrivialCopyConstructor(bool TC) {
647    data().HasTrivialCopyConstructor = TC;
648  }
649
650  // hasTrivialCopyAssignment - Whether this class has a trivial copy
651  // assignment operator (C++ [class.copy]p11)
652  bool hasTrivialCopyAssignment() const {
653    return data().HasTrivialCopyAssignment;
654  }
655
656  // setHasTrivialCopyAssignment - Set whether this class has a
657  // trivial copy assignment operator (C++ [class.copy]p11)
658  void setHasTrivialCopyAssignment(bool TC) {
659    data().HasTrivialCopyAssignment = TC;
660  }
661
662  // hasTrivialDestructor - Whether this class has a trivial destructor
663  // (C++ [class.dtor]p3)
664  bool hasTrivialDestructor() const { return data().HasTrivialDestructor; }
665
666  // setHasTrivialDestructor - Set whether this class has a trivial destructor
667  // (C++ [class.dtor]p3)
668  void setHasTrivialDestructor(bool TC) { data().HasTrivialDestructor = TC; }
669
670  /// \brief If this record is an instantiation of a member class,
671  /// retrieves the member class from which it was instantiated.
672  ///
673  /// This routine will return non-NULL for (non-templated) member
674  /// classes of class templates. For example, given:
675  ///
676  /// \code
677  /// template<typename T>
678  /// struct X {
679  ///   struct A { };
680  /// };
681  /// \endcode
682  ///
683  /// The declaration for X<int>::A is a (non-templated) CXXRecordDecl
684  /// whose parent is the class template specialization X<int>. For
685  /// this declaration, getInstantiatedFromMemberClass() will return
686  /// the CXXRecordDecl X<T>::A. When a complete definition of
687  /// X<int>::A is required, it will be instantiated from the
688  /// declaration returned by getInstantiatedFromMemberClass().
689  CXXRecordDecl *getInstantiatedFromMemberClass() const;
690
691  /// \brief If this class is an instantiation of a member class of a
692  /// class template specialization, retrieves the member specialization
693  /// information.
694  MemberSpecializationInfo *getMemberSpecializationInfo() const;
695
696  /// \brief Specify that this record is an instantiation of the
697  /// member class RD.
698  void setInstantiationOfMemberClass(CXXRecordDecl *RD,
699                                     TemplateSpecializationKind TSK);
700
701  /// \brief Retrieves the class template that is described by this
702  /// class declaration.
703  ///
704  /// Every class template is represented as a ClassTemplateDecl and a
705  /// CXXRecordDecl. The former contains template properties (such as
706  /// the template parameter lists) while the latter contains the
707  /// actual description of the template's
708  /// contents. ClassTemplateDecl::getTemplatedDecl() retrieves the
709  /// CXXRecordDecl that from a ClassTemplateDecl, while
710  /// getDescribedClassTemplate() retrieves the ClassTemplateDecl from
711  /// a CXXRecordDecl.
712  ClassTemplateDecl *getDescribedClassTemplate() const {
713    return TemplateOrInstantiation.dyn_cast<ClassTemplateDecl*>();
714  }
715
716  void setDescribedClassTemplate(ClassTemplateDecl *Template) {
717    TemplateOrInstantiation = Template;
718  }
719
720  /// \brief Determine whether this particular class is a specialization or
721  /// instantiation of a class template or member class of a class template,
722  /// and how it was instantiated or specialized.
723  TemplateSpecializationKind getTemplateSpecializationKind() const;
724
725  /// \brief Set the kind of specialization or template instantiation this is.
726  void setTemplateSpecializationKind(TemplateSpecializationKind TSK);
727
728  /// getDefaultConstructor - Returns the default constructor for this class
729  CXXConstructorDecl *getDefaultConstructor(ASTContext &Context);
730
731  /// getDestructor - Returns the destructor decl for this class.
732  CXXDestructorDecl *getDestructor(ASTContext &Context) const;
733
734  /// isLocalClass - If the class is a local class [class.local], returns
735  /// the enclosing function declaration.
736  const FunctionDecl *isLocalClass() const {
737    if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(getDeclContext()))
738      return RD->isLocalClass();
739
740    return dyn_cast<FunctionDecl>(getDeclContext());
741  }
742
743  /// \brief Determine whether this class is derived from the class \p Base.
744  ///
745  /// This routine only determines whether this class is derived from \p Base,
746  /// but does not account for factors that may make a Derived -> Base class
747  /// ill-formed, such as private/protected inheritance or multiple, ambiguous
748  /// base class subobjects.
749  ///
750  /// \param Base the base class we are searching for.
751  ///
752  /// \returns true if this class is derived from Base, false otherwise.
753  bool isDerivedFrom(CXXRecordDecl *Base) const;
754
755  /// \brief Determine whether this class is derived from the type \p Base.
756  ///
757  /// This routine only determines whether this class is derived from \p Base,
758  /// but does not account for factors that may make a Derived -> Base class
759  /// ill-formed, such as private/protected inheritance or multiple, ambiguous
760  /// base class subobjects.
761  ///
762  /// \param Base the base class we are searching for.
763  ///
764  /// \param Paths will contain the paths taken from the current class to the
765  /// given \p Base class.
766  ///
767  /// \returns true if this class is derived from Base, false otherwise.
768  ///
769  /// \todo add a separate paramaeter to configure IsDerivedFrom, rather than
770  /// tangling input and output in \p Paths
771  bool isDerivedFrom(CXXRecordDecl *Base, CXXBasePaths &Paths) const;
772
773  /// \brief Determine whether this class is virtually derived from
774  /// the class \p Base.
775  ///
776  /// This routine only determines whether this class is virtually
777  /// derived from \p Base, but does not account for factors that may
778  /// make a Derived -> Base class ill-formed, such as
779  /// private/protected inheritance or multiple, ambiguous base class
780  /// subobjects.
781  ///
782  /// \param Base the base class we are searching for.
783  ///
784  /// \returns true if this class is virtually derived from Base,
785  /// false otherwise.
786  bool isVirtuallyDerivedFrom(CXXRecordDecl *Base) const;
787
788  /// \brief Determine whether this class is provably not derived from
789  /// the type \p Base.
790  bool isProvablyNotDerivedFrom(const CXXRecordDecl *Base) const;
791
792  /// \brief Function type used by forallBases() as a callback.
793  ///
794  /// \param Base the definition of the base class
795  ///
796  /// \returns true if this base matched the search criteria
797  typedef bool ForallBasesCallback(const CXXRecordDecl *BaseDefinition,
798                                   void *UserData);
799
800  /// \brief Determines if the given callback holds for all the direct
801  /// or indirect base classes of this type.
802  ///
803  /// The class itself does not count as a base class.  This routine
804  /// returns false if the class has non-computable base classes.
805  ///
806  /// \param AllowShortCircuit if false, forces the callback to be called
807  /// for every base class, even if a dependent or non-matching base was
808  /// found.
809  bool forallBases(ForallBasesCallback *BaseMatches, void *UserData,
810                   bool AllowShortCircuit = true) const;
811
812  /// \brief Function type used by lookupInBases() to determine whether a
813  /// specific base class subobject matches the lookup criteria.
814  ///
815  /// \param Specifier the base-class specifier that describes the inheritance
816  /// from the base class we are trying to match.
817  ///
818  /// \param Path the current path, from the most-derived class down to the
819  /// base named by the \p Specifier.
820  ///
821  /// \param UserData a single pointer to user-specified data, provided to
822  /// lookupInBases().
823  ///
824  /// \returns true if this base matched the search criteria, false otherwise.
825  typedef bool BaseMatchesCallback(const CXXBaseSpecifier *Specifier,
826                                   CXXBasePath &Path,
827                                   void *UserData);
828
829  /// \brief Look for entities within the base classes of this C++ class,
830  /// transitively searching all base class subobjects.
831  ///
832  /// This routine uses the callback function \p BaseMatches to find base
833  /// classes meeting some search criteria, walking all base class subobjects
834  /// and populating the given \p Paths structure with the paths through the
835  /// inheritance hierarchy that resulted in a match. On a successful search,
836  /// the \p Paths structure can be queried to retrieve the matching paths and
837  /// to determine if there were any ambiguities.
838  ///
839  /// \param BaseMatches callback function used to determine whether a given
840  /// base matches the user-defined search criteria.
841  ///
842  /// \param UserData user data pointer that will be provided to \p BaseMatches.
843  ///
844  /// \param Paths used to record the paths from this class to its base class
845  /// subobjects that match the search criteria.
846  ///
847  /// \returns true if there exists any path from this class to a base class
848  /// subobject that matches the search criteria.
849  bool lookupInBases(BaseMatchesCallback *BaseMatches, void *UserData,
850                     CXXBasePaths &Paths) const;
851
852  /// \brief Base-class lookup callback that determines whether the given
853  /// base class specifier refers to a specific class declaration.
854  ///
855  /// This callback can be used with \c lookupInBases() to determine whether
856  /// a given derived class has is a base class subobject of a particular type.
857  /// The user data pointer should refer to the canonical CXXRecordDecl of the
858  /// base class that we are searching for.
859  static bool FindBaseClass(const CXXBaseSpecifier *Specifier,
860                            CXXBasePath &Path, void *BaseRecord);
861
862  /// \brief Base-class lookup callback that determines whether the
863  /// given base class specifier refers to a specific class
864  /// declaration and describes virtual derivation.
865  ///
866  /// This callback can be used with \c lookupInBases() to determine
867  /// whether a given derived class has is a virtual base class
868  /// subobject of a particular type.  The user data pointer should
869  /// refer to the canonical CXXRecordDecl of the base class that we
870  /// are searching for.
871  static bool FindVirtualBaseClass(const CXXBaseSpecifier *Specifier,
872                                   CXXBasePath &Path, void *BaseRecord);
873
874  /// \brief Base-class lookup callback that determines whether there exists
875  /// a tag with the given name.
876  ///
877  /// This callback can be used with \c lookupInBases() to find tag members
878  /// of the given name within a C++ class hierarchy. The user data pointer
879  /// is an opaque \c DeclarationName pointer.
880  static bool FindTagMember(const CXXBaseSpecifier *Specifier,
881                            CXXBasePath &Path, void *Name);
882
883  /// \brief Base-class lookup callback that determines whether there exists
884  /// a member with the given name.
885  ///
886  /// This callback can be used with \c lookupInBases() to find members
887  /// of the given name within a C++ class hierarchy. The user data pointer
888  /// is an opaque \c DeclarationName pointer.
889  static bool FindOrdinaryMember(const CXXBaseSpecifier *Specifier,
890                                 CXXBasePath &Path, void *Name);
891
892  /// \brief Base-class lookup callback that determines whether there exists
893  /// a member with the given name that can be used in a nested-name-specifier.
894  ///
895  /// This callback can be used with \c lookupInBases() to find membes of
896  /// the given name within a C++ class hierarchy that can occur within
897  /// nested-name-specifiers.
898  static bool FindNestedNameSpecifierMember(const CXXBaseSpecifier *Specifier,
899                                            CXXBasePath &Path,
900                                            void *UserData);
901
902  /// \brief Retrieve the final overriders for each virtual member
903  /// function in the class hierarchy where this class is the
904  /// most-derived class in the class hierarchy.
905  void getFinalOverriders(CXXFinalOverriderMap &FinaOverriders) const;
906
907  /// viewInheritance - Renders and displays an inheritance diagram
908  /// for this C++ class and all of its base classes (transitively) using
909  /// GraphViz.
910  void viewInheritance(ASTContext& Context) const;
911
912  /// MergeAccess - Calculates the access of a decl that is reached
913  /// along a path.
914  static AccessSpecifier MergeAccess(AccessSpecifier PathAccess,
915                                     AccessSpecifier DeclAccess) {
916    assert(DeclAccess != AS_none);
917    if (DeclAccess == AS_private) return AS_none;
918    return (PathAccess > DeclAccess ? PathAccess : DeclAccess);
919  }
920
921  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
922  static bool classofKind(Kind K) {
923    return K == CXXRecord ||
924           K == ClassTemplateSpecialization ||
925           K == ClassTemplatePartialSpecialization;
926  }
927  static bool classof(const CXXRecordDecl *D) { return true; }
928  static bool classof(const ClassTemplateSpecializationDecl *D) {
929    return true;
930  }
931};
932
933/// CXXMethodDecl - Represents a static or instance method of a
934/// struct/union/class.
935class CXXMethodDecl : public FunctionDecl {
936protected:
937  CXXMethodDecl(Kind DK, CXXRecordDecl *RD, SourceLocation L,
938                DeclarationName N, QualType T, TypeSourceInfo *TInfo,
939                bool isStatic, StorageClass SCAsWritten, bool isInline)
940    : FunctionDecl(DK, RD, L, N, T, TInfo, (isStatic ? Static : None),
941                   SCAsWritten, isInline) {}
942
943public:
944  static CXXMethodDecl *Create(ASTContext &C, CXXRecordDecl *RD,
945                              SourceLocation L, DeclarationName N,
946                              QualType T, TypeSourceInfo *TInfo,
947                              bool isStatic = false,
948                              StorageClass SCAsWritten = FunctionDecl::None,
949                              bool isInline = false);
950
951  bool isStatic() const { return getStorageClass() == Static; }
952  bool isInstance() const { return !isStatic(); }
953
954  bool isVirtual() const {
955    CXXMethodDecl *CD =
956      cast<CXXMethodDecl>(const_cast<CXXMethodDecl*>(this)->getCanonicalDecl());
957
958    if (CD->isVirtualAsWritten())
959      return true;
960
961    return (CD->begin_overridden_methods() != CD->end_overridden_methods());
962  }
963
964  /// \brief Determine whether this is a usual deallocation function
965  /// (C++ [basic.stc.dynamic.deallocation]p2), which is an overloaded
966  /// delete or delete[] operator with a particular signature.
967  bool isUsualDeallocationFunction() const;
968
969  /// \brief Determine whether this is a copy-assignment operator, regardless
970  /// of whether it was declared implicitly or explicitly.
971  bool isCopyAssignmentOperator() const;
972
973  const CXXMethodDecl *getCanonicalDecl() const {
974    return cast<CXXMethodDecl>(FunctionDecl::getCanonicalDecl());
975  }
976  CXXMethodDecl *getCanonicalDecl() {
977    return cast<CXXMethodDecl>(FunctionDecl::getCanonicalDecl());
978  }
979
980  ///
981  void addOverriddenMethod(const CXXMethodDecl *MD);
982
983  typedef const CXXMethodDecl ** method_iterator;
984
985  method_iterator begin_overridden_methods() const;
986  method_iterator end_overridden_methods() const;
987
988  /// getParent - Returns the parent of this method declaration, which
989  /// is the class in which this method is defined.
990  const CXXRecordDecl *getParent() const {
991    return cast<CXXRecordDecl>(FunctionDecl::getParent());
992  }
993
994  /// getParent - Returns the parent of this method declaration, which
995  /// is the class in which this method is defined.
996  CXXRecordDecl *getParent() {
997    return const_cast<CXXRecordDecl *>(
998             cast<CXXRecordDecl>(FunctionDecl::getParent()));
999  }
1000
1001  /// getThisType - Returns the type of 'this' pointer.
1002  /// Should only be called for instance methods.
1003  QualType getThisType(ASTContext &C) const;
1004
1005  unsigned getTypeQualifiers() const {
1006    return getType()->getAs<FunctionProtoType>()->getTypeQuals();
1007  }
1008
1009  bool hasInlineBody() const;
1010
1011  // Implement isa/cast/dyncast/etc.
1012  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1013  static bool classof(const CXXMethodDecl *D) { return true; }
1014  static bool classofKind(Kind K) {
1015    return K >= CXXMethod && K <= CXXConversion;
1016  }
1017};
1018
1019/// CXXBaseOrMemberInitializer - Represents a C++ base or member
1020/// initializer, which is part of a constructor initializer that
1021/// initializes one non-static member variable or one base class. For
1022/// example, in the following, both 'A(a)' and 'f(3.14159)' are member
1023/// initializers:
1024///
1025/// @code
1026/// class A { };
1027/// class B : public A {
1028///   float f;
1029/// public:
1030///   B(A& a) : A(a), f(3.14159) { }
1031/// };
1032/// @endcode
1033class CXXBaseOrMemberInitializer {
1034  /// \brief Either the base class name (stored as a TypeSourceInfo*) or the
1035  /// field being initialized.
1036  llvm::PointerUnion<TypeSourceInfo *, FieldDecl *> BaseOrMember;
1037
1038  /// \brief The source location for the field name.
1039  SourceLocation MemberLocation;
1040
1041  /// \brief The argument used to initialize the base or member, which may
1042  /// end up constructing an object (when multiple arguments are involved).
1043  Stmt *Init;
1044
1045  /// \brief Stores either the constructor to call to initialize this base or
1046  /// member (a CXXConstructorDecl pointer), or stores the anonymous union of
1047  /// which the initialized value is a member.
1048  ///
1049  /// When the value is a FieldDecl pointer, 'BaseOrMember' is class's
1050  /// anonymous union data member, this field holds the FieldDecl for the
1051  /// member of the anonymous union being initialized.
1052  /// @code
1053  /// struct X {
1054  ///   X() : au_i1(123) {}
1055  ///   union {
1056  ///     int au_i1;
1057  ///     float au_f1;
1058  ///   };
1059  /// };
1060  /// @endcode
1061  /// In above example, BaseOrMember holds the field decl. for anonymous union
1062  /// and AnonUnionMember holds field decl for au_i1.
1063  FieldDecl *AnonUnionMember;
1064
1065  /// LParenLoc - Location of the left paren of the ctor-initializer.
1066  SourceLocation LParenLoc;
1067
1068  /// RParenLoc - Location of the right paren of the ctor-initializer.
1069  SourceLocation RParenLoc;
1070
1071  /// IsVirtual - If the initializer is a base initializer, this keeps track
1072  /// of whether the base is virtual or not.
1073  bool IsVirtual : 1;
1074
1075  /// IsWritten - Whether or not the initializer is explicitly written
1076  /// in the sources.
1077  bool IsWritten : 1;
1078  /// SourceOrderOrNumArrayIndices - If IsWritten is true, then this
1079  /// number keeps track of the textual order of this initializer in the
1080  /// original sources, counting from 0; otherwise, if IsWritten is false,
1081  /// it stores the number of array index variables stored after this
1082  /// object in memory.
1083  unsigned SourceOrderOrNumArrayIndices : 14;
1084
1085  CXXBaseOrMemberInitializer(ASTContext &Context,
1086                             FieldDecl *Member, SourceLocation MemberLoc,
1087                             SourceLocation L,
1088                             Expr *Init,
1089                             SourceLocation R,
1090                             VarDecl **Indices,
1091                             unsigned NumIndices);
1092
1093public:
1094  /// CXXBaseOrMemberInitializer - Creates a new base-class initializer.
1095  explicit
1096  CXXBaseOrMemberInitializer(ASTContext &Context,
1097                             TypeSourceInfo *TInfo, bool IsVirtual,
1098                             SourceLocation L,
1099                             Expr *Init,
1100                             SourceLocation R);
1101
1102  /// CXXBaseOrMemberInitializer - Creates a new member initializer.
1103  explicit
1104  CXXBaseOrMemberInitializer(ASTContext &Context,
1105                             FieldDecl *Member, SourceLocation MemberLoc,
1106                             SourceLocation L,
1107                             Expr *Init,
1108                             SourceLocation R);
1109
1110  /// \brief Creates a new member initializer that optionally contains
1111  /// array indices used to describe an elementwise initialization.
1112  static CXXBaseOrMemberInitializer *Create(ASTContext &Context,
1113                                            FieldDecl *Member,
1114                                            SourceLocation MemberLoc,
1115                                            SourceLocation L,
1116                                            Expr *Init,
1117                                            SourceLocation R,
1118                                            VarDecl **Indices,
1119                                            unsigned NumIndices);
1120
1121  /// \brief Destroy the base or member initializer.
1122  void Destroy(ASTContext &Context);
1123
1124  /// isBaseInitializer - Returns true when this initializer is
1125  /// initializing a base class.
1126  bool isBaseInitializer() const { return BaseOrMember.is<TypeSourceInfo*>(); }
1127
1128  /// isMemberInitializer - Returns true when this initializer is
1129  /// initializing a non-static data member.
1130  bool isMemberInitializer() const { return BaseOrMember.is<FieldDecl*>(); }
1131
1132  /// If this is a base class initializer, returns the type of the
1133  /// base class with location information. Otherwise, returns an NULL
1134  /// type location.
1135  TypeLoc getBaseClassLoc() const;
1136
1137  /// If this is a base class initializer, returns the type of the base class.
1138  /// Otherwise, returns NULL.
1139  const Type *getBaseClass() const;
1140  Type *getBaseClass();
1141
1142  /// Returns whether the base is virtual or not.
1143  bool isBaseVirtual() const {
1144    assert(isBaseInitializer() && "Must call this on base initializer!");
1145
1146    return IsVirtual;
1147  }
1148
1149  /// \brief Returns the declarator information for a base class initializer.
1150  TypeSourceInfo *getBaseClassInfo() const {
1151    return BaseOrMember.dyn_cast<TypeSourceInfo *>();
1152  }
1153
1154  /// getMember - If this is a member initializer, returns the
1155  /// declaration of the non-static data member being
1156  /// initialized. Otherwise, returns NULL.
1157  FieldDecl *getMember() {
1158    if (isMemberInitializer())
1159      return BaseOrMember.get<FieldDecl*>();
1160    else
1161      return 0;
1162  }
1163
1164  SourceLocation getMemberLocation() const {
1165    return MemberLocation;
1166  }
1167
1168  void setMember(FieldDecl *Member) {
1169    assert(isMemberInitializer());
1170    BaseOrMember = Member;
1171  }
1172
1173  /// \brief Determine the source location of the initializer.
1174  SourceLocation getSourceLocation() const;
1175
1176  /// \brief Determine the source range covering the entire initializer.
1177  SourceRange getSourceRange() const;
1178
1179  /// isWritten - Returns true if this initializer is explicitly written
1180  /// in the source code.
1181  bool isWritten() const { return IsWritten; }
1182
1183  /// \brief Return the source position of the initializer, counting from 0.
1184  /// If the initializer was implicit, -1 is returned.
1185  int getSourceOrder() const {
1186    return IsWritten ? static_cast<int>(SourceOrderOrNumArrayIndices) : -1;
1187  }
1188
1189  /// \brief Set the source order of this initializer. This method can only
1190  /// be called once for each initializer; it cannot be called on an
1191  /// initializer having a positive number of (implicit) array indices.
1192  void setSourceOrder(int pos) {
1193    assert(!IsWritten &&
1194           "calling twice setSourceOrder() on the same initializer");
1195    assert(SourceOrderOrNumArrayIndices == 0 &&
1196           "setSourceOrder() used when there are implicit array indices");
1197    assert(pos >= 0 &&
1198           "setSourceOrder() used to make an initializer implicit");
1199    IsWritten = true;
1200    SourceOrderOrNumArrayIndices = static_cast<unsigned>(pos);
1201  }
1202
1203  FieldDecl *getAnonUnionMember() const {
1204    return AnonUnionMember;
1205  }
1206  void setAnonUnionMember(FieldDecl *anonMember) {
1207    AnonUnionMember = anonMember;
1208  }
1209
1210
1211  SourceLocation getLParenLoc() const { return LParenLoc; }
1212  SourceLocation getRParenLoc() const { return RParenLoc; }
1213
1214  /// \brief Determine the number of implicit array indices used while
1215  /// described an array member initialization.
1216  unsigned getNumArrayIndices() const {
1217    return IsWritten ? 0 : SourceOrderOrNumArrayIndices;
1218  }
1219
1220  /// \brief Retrieve a particular array index variable used to
1221  /// describe an array member initialization.
1222  VarDecl *getArrayIndex(unsigned I) {
1223    assert(I < getNumArrayIndices() && "Out of bounds member array index");
1224    return reinterpret_cast<VarDecl **>(this + 1)[I];
1225  }
1226  const VarDecl *getArrayIndex(unsigned I) const {
1227    assert(I < getNumArrayIndices() && "Out of bounds member array index");
1228    return reinterpret_cast<const VarDecl * const *>(this + 1)[I];
1229  }
1230  void setArrayIndex(unsigned I, VarDecl *Index) {
1231    assert(I < getNumArrayIndices() && "Out of bounds member array index");
1232    reinterpret_cast<VarDecl **>(this + 1)[I] = Index;
1233  }
1234
1235  Expr *getInit() { return static_cast<Expr *>(Init); }
1236};
1237
1238/// CXXConstructorDecl - Represents a C++ constructor within a
1239/// class. For example:
1240///
1241/// @code
1242/// class X {
1243/// public:
1244///   explicit X(int); // represented by a CXXConstructorDecl.
1245/// };
1246/// @endcode
1247class CXXConstructorDecl : public CXXMethodDecl {
1248  /// IsExplicitSpecified - Whether this constructor declaration has the
1249  /// 'explicit' keyword specified.
1250  bool IsExplicitSpecified : 1;
1251
1252  /// ImplicitlyDefined - Whether this constructor was implicitly
1253  /// defined by the compiler. When false, the constructor was defined
1254  /// by the user. In C++03, this flag will have the same value as
1255  /// Implicit. In C++0x, however, a constructor that is
1256  /// explicitly defaulted (i.e., defined with " = default") will have
1257  /// @c !Implicit && ImplicitlyDefined.
1258  bool ImplicitlyDefined : 1;
1259
1260  /// Support for base and member initializers.
1261  /// BaseOrMemberInitializers - The arguments used to initialize the base
1262  /// or member.
1263  CXXBaseOrMemberInitializer **BaseOrMemberInitializers;
1264  unsigned NumBaseOrMemberInitializers;
1265
1266  CXXConstructorDecl(CXXRecordDecl *RD, SourceLocation L,
1267                     DeclarationName N, QualType T, TypeSourceInfo *TInfo,
1268                     bool isExplicitSpecified, bool isInline,
1269                     bool isImplicitlyDeclared)
1270    : CXXMethodDecl(CXXConstructor, RD, L, N, T, TInfo, false,
1271                    FunctionDecl::None, isInline),
1272      IsExplicitSpecified(isExplicitSpecified), ImplicitlyDefined(false),
1273      BaseOrMemberInitializers(0), NumBaseOrMemberInitializers(0) {
1274    setImplicit(isImplicitlyDeclared);
1275  }
1276  virtual void Destroy(ASTContext& C);
1277
1278public:
1279  static CXXConstructorDecl *Create(ASTContext &C, EmptyShell Empty);
1280  static CXXConstructorDecl *Create(ASTContext &C, CXXRecordDecl *RD,
1281                                    SourceLocation L, DeclarationName N,
1282                                    QualType T, TypeSourceInfo *TInfo,
1283                                    bool isExplicit,
1284                                    bool isInline, bool isImplicitlyDeclared);
1285
1286  /// isExplicitSpecified - Whether this constructor declaration has the
1287  /// 'explicit' keyword specified.
1288  bool isExplicitSpecified() const { return IsExplicitSpecified; }
1289
1290  /// isExplicit - Whether this constructor was marked "explicit" or not.
1291  bool isExplicit() const {
1292    return cast<CXXConstructorDecl>(getFirstDeclaration())
1293      ->isExplicitSpecified();
1294  }
1295
1296  /// isImplicitlyDefined - Whether this constructor was implicitly
1297  /// defined. If false, then this constructor was defined by the
1298  /// user. This operation can only be invoked if the constructor has
1299  /// already been defined.
1300  bool isImplicitlyDefined() const {
1301    assert(isThisDeclarationADefinition() &&
1302           "Can only get the implicit-definition flag once the "
1303           "constructor has been defined");
1304    return ImplicitlyDefined;
1305  }
1306
1307  /// setImplicitlyDefined - Set whether this constructor was
1308  /// implicitly defined or not.
1309  void setImplicitlyDefined(bool ID) {
1310    assert(isThisDeclarationADefinition() &&
1311           "Can only set the implicit-definition flag once the constructor "
1312           "has been defined");
1313    ImplicitlyDefined = ID;
1314  }
1315
1316  /// init_iterator - Iterates through the member/base initializer list.
1317  typedef CXXBaseOrMemberInitializer **init_iterator;
1318
1319  /// init_const_iterator - Iterates through the memberbase initializer list.
1320  typedef CXXBaseOrMemberInitializer * const * init_const_iterator;
1321
1322  /// init_begin() - Retrieve an iterator to the first initializer.
1323  init_iterator       init_begin()       { return BaseOrMemberInitializers; }
1324  /// begin() - Retrieve an iterator to the first initializer.
1325  init_const_iterator init_begin() const { return BaseOrMemberInitializers; }
1326
1327  /// init_end() - Retrieve an iterator past the last initializer.
1328  init_iterator       init_end()       {
1329    return BaseOrMemberInitializers + NumBaseOrMemberInitializers;
1330  }
1331  /// end() - Retrieve an iterator past the last initializer.
1332  init_const_iterator init_end() const {
1333    return BaseOrMemberInitializers + NumBaseOrMemberInitializers;
1334  }
1335
1336  /// getNumArgs - Determine the number of arguments used to
1337  /// initialize the member or base.
1338  unsigned getNumBaseOrMemberInitializers() const {
1339      return NumBaseOrMemberInitializers;
1340  }
1341
1342  void setNumBaseOrMemberInitializers(unsigned numBaseOrMemberInitializers) {
1343    NumBaseOrMemberInitializers = numBaseOrMemberInitializers;
1344  }
1345
1346  void setBaseOrMemberInitializers(CXXBaseOrMemberInitializer ** initializers) {
1347    BaseOrMemberInitializers = initializers;
1348  }
1349  /// isDefaultConstructor - Whether this constructor is a default
1350  /// constructor (C++ [class.ctor]p5), which can be used to
1351  /// default-initialize a class of this type.
1352  bool isDefaultConstructor() const;
1353
1354  /// isCopyConstructor - Whether this constructor is a copy
1355  /// constructor (C++ [class.copy]p2, which can be used to copy the
1356  /// class. @p TypeQuals will be set to the qualifiers on the
1357  /// argument type. For example, @p TypeQuals would be set to @c
1358  /// QualType::Const for the following copy constructor:
1359  ///
1360  /// @code
1361  /// class X {
1362  /// public:
1363  ///   X(const X&);
1364  /// };
1365  /// @endcode
1366  bool isCopyConstructor(unsigned &TypeQuals) const;
1367
1368  /// isCopyConstructor - Whether this constructor is a copy
1369  /// constructor (C++ [class.copy]p2, which can be used to copy the
1370  /// class.
1371  bool isCopyConstructor() const {
1372    unsigned TypeQuals = 0;
1373    return isCopyConstructor(TypeQuals);
1374  }
1375
1376  /// isConvertingConstructor - Whether this constructor is a
1377  /// converting constructor (C++ [class.conv.ctor]), which can be
1378  /// used for user-defined conversions.
1379  bool isConvertingConstructor(bool AllowExplicit) const;
1380
1381  /// \brief Determine whether this is a member template specialization that
1382  /// looks like a copy constructor. Such constructors are never used to copy
1383  /// an object.
1384  bool isCopyConstructorLikeSpecialization() const;
1385
1386  // Implement isa/cast/dyncast/etc.
1387  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1388  static bool classof(const CXXConstructorDecl *D) { return true; }
1389  static bool classofKind(Kind K) { return K == CXXConstructor; }
1390};
1391
1392/// CXXDestructorDecl - Represents a C++ destructor within a
1393/// class. For example:
1394///
1395/// @code
1396/// class X {
1397/// public:
1398///   ~X(); // represented by a CXXDestructorDecl.
1399/// };
1400/// @endcode
1401class CXXDestructorDecl : public CXXMethodDecl {
1402  /// ImplicitlyDefined - Whether this destructor was implicitly
1403  /// defined by the compiler. When false, the destructor was defined
1404  /// by the user. In C++03, this flag will have the same value as
1405  /// Implicit. In C++0x, however, a destructor that is
1406  /// explicitly defaulted (i.e., defined with " = default") will have
1407  /// @c !Implicit && ImplicitlyDefined.
1408  bool ImplicitlyDefined : 1;
1409
1410  FunctionDecl *OperatorDelete;
1411
1412  CXXDestructorDecl(CXXRecordDecl *RD, SourceLocation L,
1413                    DeclarationName N, QualType T,
1414                    bool isInline, bool isImplicitlyDeclared)
1415    : CXXMethodDecl(CXXDestructor, RD, L, N, T, /*TInfo=*/0, false,
1416                    FunctionDecl::None, isInline),
1417      ImplicitlyDefined(false), OperatorDelete(0) {
1418    setImplicit(isImplicitlyDeclared);
1419  }
1420
1421public:
1422  static CXXDestructorDecl *Create(ASTContext& C, EmptyShell Empty);
1423  static CXXDestructorDecl *Create(ASTContext &C, CXXRecordDecl *RD,
1424                                   SourceLocation L, DeclarationName N,
1425                                   QualType T, bool isInline,
1426                                   bool isImplicitlyDeclared);
1427
1428  /// isImplicitlyDefined - Whether this destructor was implicitly
1429  /// defined. If false, then this destructor was defined by the
1430  /// user. This operation can only be invoked if the destructor has
1431  /// already been defined.
1432  bool isImplicitlyDefined() const {
1433    assert(isThisDeclarationADefinition() &&
1434           "Can only get the implicit-definition flag once the destructor has been defined");
1435    return ImplicitlyDefined;
1436  }
1437
1438  /// setImplicitlyDefined - Set whether this destructor was
1439  /// implicitly defined or not.
1440  void setImplicitlyDefined(bool ID) {
1441    assert(isThisDeclarationADefinition() &&
1442           "Can only set the implicit-definition flag once the destructor has been defined");
1443    ImplicitlyDefined = ID;
1444  }
1445
1446  void setOperatorDelete(FunctionDecl *OD) { OperatorDelete = OD; }
1447  const FunctionDecl *getOperatorDelete() const { return OperatorDelete; }
1448
1449  // Implement isa/cast/dyncast/etc.
1450  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1451  static bool classof(const CXXDestructorDecl *D) { return true; }
1452  static bool classofKind(Kind K) { return K == CXXDestructor; }
1453};
1454
1455/// CXXConversionDecl - Represents a C++ conversion function within a
1456/// class. For example:
1457///
1458/// @code
1459/// class X {
1460/// public:
1461///   operator bool();
1462/// };
1463/// @endcode
1464class CXXConversionDecl : public CXXMethodDecl {
1465  /// IsExplicitSpecified - Whether this conversion function declaration is
1466  /// marked "explicit", meaning that it can only be applied when the user
1467  /// explicitly wrote a cast. This is a C++0x feature.
1468  bool IsExplicitSpecified : 1;
1469
1470  CXXConversionDecl(CXXRecordDecl *RD, SourceLocation L,
1471                    DeclarationName N, QualType T, TypeSourceInfo *TInfo,
1472                    bool isInline, bool isExplicitSpecified)
1473    : CXXMethodDecl(CXXConversion, RD, L, N, T, TInfo, false,
1474                    FunctionDecl::None, isInline),
1475      IsExplicitSpecified(isExplicitSpecified) { }
1476
1477public:
1478  static CXXConversionDecl *Create(ASTContext &C, EmptyShell Empty);
1479  static CXXConversionDecl *Create(ASTContext &C, CXXRecordDecl *RD,
1480                                   SourceLocation L, DeclarationName N,
1481                                   QualType T, TypeSourceInfo *TInfo,
1482                                   bool isInline, bool isExplicit);
1483
1484  /// IsExplicitSpecified - Whether this conversion function declaration is
1485  /// marked "explicit", meaning that it can only be applied when the user
1486  /// explicitly wrote a cast. This is a C++0x feature.
1487  bool isExplicitSpecified() const { return IsExplicitSpecified; }
1488
1489  /// isExplicit - Whether this is an explicit conversion operator
1490  /// (C++0x only). Explicit conversion operators are only considered
1491  /// when the user has explicitly written a cast.
1492  bool isExplicit() const {
1493    return cast<CXXConversionDecl>(getFirstDeclaration())
1494      ->isExplicitSpecified();
1495  }
1496
1497  /// getConversionType - Returns the type that this conversion
1498  /// function is converting to.
1499  QualType getConversionType() const {
1500    return getType()->getAs<FunctionType>()->getResultType();
1501  }
1502
1503  // Implement isa/cast/dyncast/etc.
1504  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1505  static bool classof(const CXXConversionDecl *D) { return true; }
1506  static bool classofKind(Kind K) { return K == CXXConversion; }
1507};
1508
1509/// LinkageSpecDecl - This represents a linkage specification.  For example:
1510///   extern "C" void foo();
1511///
1512class LinkageSpecDecl : public Decl, public DeclContext {
1513public:
1514  /// LanguageIDs - Used to represent the language in a linkage
1515  /// specification.  The values are part of the serialization abi for
1516  /// ASTs and cannot be changed without altering that abi.  To help
1517  /// ensure a stable abi for this, we choose the DW_LANG_ encodings
1518  /// from the dwarf standard.
1519  enum LanguageIDs {
1520    lang_c = /* DW_LANG_C */ 0x0002,
1521    lang_cxx = /* DW_LANG_C_plus_plus */ 0x0004
1522  };
1523private:
1524  /// Language - The language for this linkage specification.
1525  LanguageIDs Language;
1526
1527  /// HadBraces - Whether this linkage specification had curly braces or not.
1528  bool HadBraces : 1;
1529
1530  LinkageSpecDecl(DeclContext *DC, SourceLocation L, LanguageIDs lang,
1531                  bool Braces)
1532    : Decl(LinkageSpec, DC, L),
1533      DeclContext(LinkageSpec), Language(lang), HadBraces(Braces) { }
1534
1535public:
1536  static LinkageSpecDecl *Create(ASTContext &C, DeclContext *DC,
1537                                 SourceLocation L, LanguageIDs Lang,
1538                                 bool Braces);
1539
1540  /// \brief Return the language specified by this linkage specification.
1541  LanguageIDs getLanguage() const { return Language; }
1542
1543  /// \brief Set the language specified by this linkage specification.
1544  void setLanguage(LanguageIDs L) { Language = L; }
1545
1546  /// \brief Determines whether this linkage specification had braces in
1547  /// its syntactic form.
1548  bool hasBraces() const { return HadBraces; }
1549
1550  /// \brief Set whether this linkage specification has braces in its
1551  /// syntactic form.
1552  void setHasBraces(bool B) { HadBraces = B; }
1553
1554  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1555  static bool classof(const LinkageSpecDecl *D) { return true; }
1556  static bool classofKind(Kind K) { return K == LinkageSpec; }
1557  static DeclContext *castToDeclContext(const LinkageSpecDecl *D) {
1558    return static_cast<DeclContext *>(const_cast<LinkageSpecDecl*>(D));
1559  }
1560  static LinkageSpecDecl *castFromDeclContext(const DeclContext *DC) {
1561    return static_cast<LinkageSpecDecl *>(const_cast<DeclContext*>(DC));
1562  }
1563};
1564
1565/// UsingDirectiveDecl - Represents C++ using-directive. For example:
1566///
1567///    using namespace std;
1568///
1569// NB: UsingDirectiveDecl should be Decl not NamedDecl, but we provide
1570// artificial name, for all using-directives in order to store
1571// them in DeclContext effectively.
1572class UsingDirectiveDecl : public NamedDecl {
1573
1574  /// SourceLocation - Location of 'namespace' token.
1575  SourceLocation NamespaceLoc;
1576
1577  /// \brief The source range that covers the nested-name-specifier
1578  /// preceding the namespace name.
1579  SourceRange QualifierRange;
1580
1581  /// \brief The nested-name-specifier that precedes the namespace
1582  /// name, if any.
1583  NestedNameSpecifier *Qualifier;
1584
1585  /// IdentLoc - Location of nominated namespace-name identifier.
1586  // FIXME: We don't store location of scope specifier.
1587  SourceLocation IdentLoc;
1588
1589  /// NominatedNamespace - Namespace nominated by using-directive.
1590  NamedDecl *NominatedNamespace;
1591
1592  /// Enclosing context containing both using-directive and nominated
1593  /// namespace.
1594  DeclContext *CommonAncestor;
1595
1596  /// getUsingDirectiveName - Returns special DeclarationName used by
1597  /// using-directives. This is only used by DeclContext for storing
1598  /// UsingDirectiveDecls in its lookup structure.
1599  static DeclarationName getName() {
1600    return DeclarationName::getUsingDirectiveName();
1601  }
1602
1603  UsingDirectiveDecl(DeclContext *DC, SourceLocation L,
1604                     SourceLocation NamespcLoc,
1605                     SourceRange QualifierRange,
1606                     NestedNameSpecifier *Qualifier,
1607                     SourceLocation IdentLoc,
1608                     NamedDecl *Nominated,
1609                     DeclContext *CommonAncestor)
1610    : NamedDecl(Decl::UsingDirective, DC, L, getName()),
1611      NamespaceLoc(NamespcLoc), QualifierRange(QualifierRange),
1612      Qualifier(Qualifier), IdentLoc(IdentLoc),
1613      NominatedNamespace(Nominated),
1614      CommonAncestor(CommonAncestor) {
1615  }
1616
1617public:
1618  /// \brief Retrieve the source range of the nested-name-specifier
1619  /// that qualifies the namespace name.
1620  SourceRange getQualifierRange() const { return QualifierRange; }
1621
1622  /// \brief Set the source range of the nested-name-specifier that
1623  /// qualifies the namespace name.
1624  void setQualifierRange(SourceRange R) { QualifierRange = R; }
1625
1626  /// \brief Retrieve the nested-name-specifier that qualifies the
1627  /// name of the namespace.
1628  NestedNameSpecifier *getQualifier() const { return Qualifier; }
1629
1630  /// \brief Set the nested-name-specifier that qualifes the name of the
1631  /// namespace.
1632  void setQualifier(NestedNameSpecifier *NNS) { Qualifier = NNS; }
1633
1634  NamedDecl *getNominatedNamespaceAsWritten() { return NominatedNamespace; }
1635  const NamedDecl *getNominatedNamespaceAsWritten() const {
1636    return NominatedNamespace;
1637  }
1638
1639  /// getNominatedNamespace - Returns namespace nominated by using-directive.
1640  NamespaceDecl *getNominatedNamespace();
1641
1642  const NamespaceDecl *getNominatedNamespace() const {
1643    return const_cast<UsingDirectiveDecl*>(this)->getNominatedNamespace();
1644  }
1645
1646  /// setNominatedNamespace - Set the namespace nominataed by the
1647  /// using-directive.
1648  void setNominatedNamespace(NamedDecl* NS);
1649
1650  /// \brief Returns the common ancestor context of this using-directive and
1651  /// its nominated namespace.
1652  DeclContext *getCommonAncestor() { return CommonAncestor; }
1653  const DeclContext *getCommonAncestor() const { return CommonAncestor; }
1654
1655  /// \brief Set the common ancestor context of this using-directive and its
1656  /// nominated namespace.
1657  void setCommonAncestor(DeclContext* Cxt) { CommonAncestor = Cxt; }
1658
1659  // FIXME: Could omit 'Key' in name.
1660  /// getNamespaceKeyLocation - Returns location of namespace keyword.
1661  SourceLocation getNamespaceKeyLocation() const { return NamespaceLoc; }
1662
1663  /// setNamespaceKeyLocation - Set the the location of the namespacekeyword.
1664  void setNamespaceKeyLocation(SourceLocation L) { NamespaceLoc = L; }
1665
1666  /// getIdentLocation - Returns location of identifier.
1667  SourceLocation getIdentLocation() const { return IdentLoc; }
1668
1669  /// setIdentLocation - set the location of the identifier.
1670  void setIdentLocation(SourceLocation L) { IdentLoc = L; }
1671
1672  static UsingDirectiveDecl *Create(ASTContext &C, DeclContext *DC,
1673                                    SourceLocation L,
1674                                    SourceLocation NamespaceLoc,
1675                                    SourceRange QualifierRange,
1676                                    NestedNameSpecifier *Qualifier,
1677                                    SourceLocation IdentLoc,
1678                                    NamedDecl *Nominated,
1679                                    DeclContext *CommonAncestor);
1680
1681  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1682  static bool classof(const UsingDirectiveDecl *D) { return true; }
1683  static bool classofKind(Kind K) { return K == Decl::UsingDirective; }
1684
1685  // Friend for getUsingDirectiveName.
1686  friend class DeclContext;
1687};
1688
1689/// NamespaceAliasDecl - Represents a C++ namespace alias. For example:
1690///
1691/// @code
1692/// namespace Foo = Bar;
1693/// @endcode
1694class NamespaceAliasDecl : public NamedDecl {
1695  SourceLocation AliasLoc;
1696
1697  /// \brief The source range that covers the nested-name-specifier
1698  /// preceding the namespace name.
1699  SourceRange QualifierRange;
1700
1701  /// \brief The nested-name-specifier that precedes the namespace
1702  /// name, if any.
1703  NestedNameSpecifier *Qualifier;
1704
1705  /// IdentLoc - Location of namespace identifier. Accessed by TargetNameLoc.
1706  SourceLocation IdentLoc;
1707
1708  /// Namespace - The Decl that this alias points to. Can either be a
1709  /// NamespaceDecl or a NamespaceAliasDecl.
1710  NamedDecl *Namespace;
1711
1712  NamespaceAliasDecl(DeclContext *DC, SourceLocation L,
1713                     SourceLocation AliasLoc, IdentifierInfo *Alias,
1714                     SourceRange QualifierRange,
1715                     NestedNameSpecifier *Qualifier,
1716                     SourceLocation IdentLoc, NamedDecl *Namespace)
1717    : NamedDecl(Decl::NamespaceAlias, DC, L, Alias), AliasLoc(AliasLoc),
1718      QualifierRange(QualifierRange), Qualifier(Qualifier),
1719      IdentLoc(IdentLoc), Namespace(Namespace) { }
1720
1721public:
1722  /// \brief Retrieve the source range of the nested-name-specifier
1723  /// that qualifiers the namespace name.
1724  SourceRange getQualifierRange() const { return QualifierRange; }
1725
1726  /// \brief Set the source range of the nested-name-specifier that qualifies
1727  /// the namespace name.
1728  void setQualifierRange(SourceRange R) { QualifierRange = R; }
1729
1730  /// \brief Retrieve the nested-name-specifier that qualifies the
1731  /// name of the namespace.
1732  NestedNameSpecifier *getQualifier() const { return Qualifier; }
1733
1734  /// \brief Set the nested-name-specifier that qualifies the name of the
1735  /// namespace.
1736  void setQualifier(NestedNameSpecifier *NNS) { Qualifier = NNS; }
1737
1738  /// \brief Retrieve the namespace declaration aliased by this directive.
1739  NamespaceDecl *getNamespace() {
1740    if (NamespaceAliasDecl *AD = dyn_cast<NamespaceAliasDecl>(Namespace))
1741      return AD->getNamespace();
1742
1743    return cast<NamespaceDecl>(Namespace);
1744  }
1745
1746  const NamespaceDecl *getNamespace() const {
1747    return const_cast<NamespaceAliasDecl*>(this)->getNamespace();
1748  }
1749
1750  /// Returns the location of the alias name, i.e. 'foo' in
1751  /// "namespace foo = ns::bar;".
1752  SourceLocation getAliasLoc() const { return AliasLoc; }
1753
1754  /// Set the location o;f the alias name, e.e., 'foo' in
1755  /// "namespace foo = ns::bar;".
1756  void setAliasLoc(SourceLocation L) { AliasLoc = L; }
1757
1758  /// Returns the location of the 'namespace' keyword.
1759  SourceLocation getNamespaceLoc() const { return getLocation(); }
1760
1761  /// Returns the location of the identifier in the named namespace.
1762  SourceLocation getTargetNameLoc() const { return IdentLoc; }
1763
1764  /// Set the location of the identifier in the named namespace.
1765  void setTargetNameLoc(SourceLocation L) { IdentLoc = L; }
1766
1767  /// \brief Retrieve the namespace that this alias refers to, which
1768  /// may either be a NamespaceDecl or a NamespaceAliasDecl.
1769  NamedDecl *getAliasedNamespace() const { return Namespace; }
1770
1771  /// \brief Set the namespace or namespace alias pointed to by this
1772  /// alias decl.
1773  void setAliasedNamespace(NamedDecl *ND) {
1774    assert((isa<NamespaceAliasDecl>(ND) || isa<NamespaceDecl>(ND)) &&
1775      "expecting namespace or namespace alias decl");
1776      Namespace = ND;
1777  }
1778
1779  static NamespaceAliasDecl *Create(ASTContext &C, DeclContext *DC,
1780                                    SourceLocation L, SourceLocation AliasLoc,
1781                                    IdentifierInfo *Alias,
1782                                    SourceRange QualifierRange,
1783                                    NestedNameSpecifier *Qualifier,
1784                                    SourceLocation IdentLoc,
1785                                    NamedDecl *Namespace);
1786
1787  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1788  static bool classof(const NamespaceAliasDecl *D) { return true; }
1789  static bool classofKind(Kind K) { return K == Decl::NamespaceAlias; }
1790};
1791
1792/// UsingShadowDecl - Represents a shadow declaration introduced into
1793/// a scope by a (resolved) using declaration.  For example,
1794///
1795/// namespace A {
1796///   void foo();
1797/// }
1798/// namespace B {
1799///   using A::foo(); // <- a UsingDecl
1800///                   // Also creates a UsingShadowDecl for A::foo in B
1801/// }
1802///
1803class UsingShadowDecl : public NamedDecl {
1804  /// The referenced declaration.
1805  NamedDecl *Underlying;
1806
1807  /// The using declaration which introduced this decl.
1808  UsingDecl *Using;
1809
1810  UsingShadowDecl(DeclContext *DC, SourceLocation Loc, UsingDecl *Using,
1811                  NamedDecl *Target)
1812    : NamedDecl(UsingShadow, DC, Loc, Target->getDeclName()),
1813      Underlying(Target), Using(Using) {
1814    IdentifierNamespace = Target->getIdentifierNamespace();
1815    setImplicit();
1816  }
1817
1818public:
1819  static UsingShadowDecl *Create(ASTContext &C, DeclContext *DC,
1820                                 SourceLocation Loc, UsingDecl *Using,
1821                                 NamedDecl *Target) {
1822    return new (C) UsingShadowDecl(DC, Loc, Using, Target);
1823  }
1824
1825  /// \brief Gets the underlying declaration which has been brought into the
1826  /// local scope.
1827  NamedDecl *getTargetDecl() const { return Underlying; }
1828
1829  /// \brief Sets the underlying declaration which has been brought into the
1830  /// local scope.
1831  void setTargetDecl(NamedDecl* ND) { Underlying = ND; }
1832
1833  /// \brief Gets the using declaration to which this declaration is tied.
1834  UsingDecl *getUsingDecl() const { return Using; }
1835
1836  /// \brief Sets the using declaration that introduces this target
1837  /// declaration.
1838  void setUsingDecl(UsingDecl* UD) { Using = UD; }
1839
1840  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1841  static bool classof(const UsingShadowDecl *D) { return true; }
1842  static bool classofKind(Kind K) { return K == Decl::UsingShadow; }
1843};
1844
1845/// UsingDecl - Represents a C++ using-declaration. For example:
1846///    using someNameSpace::someIdentifier;
1847class UsingDecl : public NamedDecl {
1848  /// \brief The source range that covers the nested-name-specifier
1849  /// preceding the declaration name.
1850  SourceRange NestedNameRange;
1851
1852  /// \brief The source location of the "using" location itself.
1853  SourceLocation UsingLocation;
1854
1855  /// \brief Target nested name specifier.
1856  NestedNameSpecifier* TargetNestedName;
1857
1858  /// \brief The collection of shadow declarations associated with
1859  /// this using declaration.  This set can change as a class is
1860  /// processed.
1861  llvm::SmallPtrSet<UsingShadowDecl*, 8> Shadows;
1862
1863  // \brief Has 'typename' keyword.
1864  bool IsTypeName;
1865
1866  UsingDecl(DeclContext *DC, SourceLocation L, SourceRange NNR,
1867            SourceLocation UL, NestedNameSpecifier* TargetNNS,
1868            DeclarationName Name, bool IsTypeNameArg)
1869    : NamedDecl(Decl::Using, DC, L, Name),
1870      NestedNameRange(NNR), UsingLocation(UL), TargetNestedName(TargetNNS),
1871      IsTypeName(IsTypeNameArg) {
1872  }
1873
1874public:
1875  // FIXME: Should be const?
1876  /// \brief Returns the source range that covers the nested-name-specifier
1877  /// preceding the namespace name.
1878  SourceRange getNestedNameRange() { return NestedNameRange; }
1879
1880  /// \brief Set the source range of the nested-name-specifier.
1881  void setNestedNameRange(SourceRange R) { NestedNameRange = R; }
1882
1883  // FIXME; Should be const?
1884  // FIXME: Naming is inconsistent with other get*Loc functions.
1885  /// \brief Returns the source location of the "using" keyword.
1886  SourceLocation getUsingLocation() { return UsingLocation; }
1887
1888  /// \brief Set the source location of the 'using' keyword.
1889  void setUsingLocation(SourceLocation L) { UsingLocation = L; }
1890
1891
1892  /// \brief Get the target nested name declaration.
1893  NestedNameSpecifier* getTargetNestedNameDecl() {
1894    return TargetNestedName;
1895  }
1896
1897  /// \brief Set the target nested name declaration.
1898  void setTargetNestedNameDecl(NestedNameSpecifier *NNS) {
1899    TargetNestedName = NNS;
1900  }
1901
1902  /// \brief Return true if the using declaration has 'typename'.
1903  bool isTypeName() const { return IsTypeName; }
1904
1905  /// \brief Sets whether the using declaration has 'typename'.
1906  void setTypeName(bool TN) { IsTypeName = TN; }
1907
1908  typedef llvm::SmallPtrSet<UsingShadowDecl*,8>::const_iterator shadow_iterator;
1909  shadow_iterator shadow_begin() const { return Shadows.begin(); }
1910  shadow_iterator shadow_end() const { return Shadows.end(); }
1911
1912  void addShadowDecl(UsingShadowDecl *S) {
1913    assert(S->getUsingDecl() == this);
1914    if (!Shadows.insert(S)) {
1915      assert(false && "declaration already in set");
1916    }
1917  }
1918  void removeShadowDecl(UsingShadowDecl *S) {
1919    assert(S->getUsingDecl() == this);
1920    if (!Shadows.erase(S)) {
1921      assert(false && "declaration not in set");
1922    }
1923  }
1924
1925  /// \brief Return the number of shadowed declarations associated with this
1926  /// using declaration.
1927  unsigned getNumShadowDecls() const {
1928    return Shadows.size();
1929  }
1930
1931  static UsingDecl *Create(ASTContext &C, DeclContext *DC,
1932      SourceLocation IdentL, SourceRange NNR, SourceLocation UsingL,
1933      NestedNameSpecifier* TargetNNS, DeclarationName Name, bool IsTypeNameArg);
1934
1935  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1936  static bool classof(const UsingDecl *D) { return true; }
1937  static bool classofKind(Kind K) { return K == Decl::Using; }
1938};
1939
1940/// UnresolvedUsingValueDecl - Represents a dependent using
1941/// declaration which was not marked with 'typename'.  Unlike
1942/// non-dependent using declarations, these *only* bring through
1943/// non-types; otherwise they would break two-phase lookup.
1944///
1945/// template <class T> class A : public Base<T> {
1946///   using Base<T>::foo;
1947/// };
1948class UnresolvedUsingValueDecl : public ValueDecl {
1949  /// \brief The source range that covers the nested-name-specifier
1950  /// preceding the declaration name.
1951  SourceRange TargetNestedNameRange;
1952
1953  /// \brief The source location of the 'using' keyword
1954  SourceLocation UsingLocation;
1955
1956  NestedNameSpecifier *TargetNestedNameSpecifier;
1957
1958  UnresolvedUsingValueDecl(DeclContext *DC, QualType Ty,
1959                           SourceLocation UsingLoc, SourceRange TargetNNR,
1960                           NestedNameSpecifier *TargetNNS,
1961                           SourceLocation TargetNameLoc,
1962                           DeclarationName TargetName)
1963    : ValueDecl(Decl::UnresolvedUsingValue, DC, TargetNameLoc, TargetName, Ty),
1964    TargetNestedNameRange(TargetNNR), UsingLocation(UsingLoc),
1965    TargetNestedNameSpecifier(TargetNNS)
1966  { }
1967
1968public:
1969  /// \brief Returns the source range that covers the nested-name-specifier
1970  /// preceding the namespace name.
1971  SourceRange getTargetNestedNameRange() const { return TargetNestedNameRange; }
1972
1973  /// \brief Set the source range coverting the nested-name-specifier preceding
1974  /// the namespace name.
1975  void setTargetNestedNameRange(SourceRange R) { TargetNestedNameRange = R; }
1976
1977  /// \brief Get target nested name declaration.
1978  NestedNameSpecifier* getTargetNestedNameSpecifier() {
1979    return TargetNestedNameSpecifier;
1980  }
1981
1982  /// \brief Set the nested name declaration.
1983  void setTargetNestedNameSpecifier(NestedNameSpecifier* NNS) {
1984    TargetNestedNameSpecifier = NNS;
1985  }
1986
1987  /// \brief Returns the source location of the 'using' keyword.
1988  SourceLocation getUsingLoc() const { return UsingLocation; }
1989
1990  /// \brief Set the source location of the 'using' keyword.
1991  void setUsingLoc(SourceLocation L) { UsingLocation = L; }
1992
1993  static UnresolvedUsingValueDecl *
1994    Create(ASTContext &C, DeclContext *DC, SourceLocation UsingLoc,
1995           SourceRange TargetNNR, NestedNameSpecifier *TargetNNS,
1996           SourceLocation TargetNameLoc, DeclarationName TargetName);
1997
1998  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
1999  static bool classof(const UnresolvedUsingValueDecl *D) { return true; }
2000  static bool classofKind(Kind K) { return K == Decl::UnresolvedUsingValue; }
2001};
2002
2003/// UnresolvedUsingTypenameDecl - Represents a dependent using
2004/// declaration which was marked with 'typename'.
2005///
2006/// template <class T> class A : public Base<T> {
2007///   using typename Base<T>::foo;
2008/// };
2009///
2010/// The type associated with a unresolved using typename decl is
2011/// currently always a typename type.
2012class UnresolvedUsingTypenameDecl : public TypeDecl {
2013  /// \brief The source range that covers the nested-name-specifier
2014  /// preceding the declaration name.
2015  SourceRange TargetNestedNameRange;
2016
2017  /// \brief The source location of the 'using' keyword
2018  SourceLocation UsingLocation;
2019
2020  /// \brief The source location of the 'typename' keyword
2021  SourceLocation TypenameLocation;
2022
2023  NestedNameSpecifier *TargetNestedNameSpecifier;
2024
2025  UnresolvedUsingTypenameDecl(DeclContext *DC, SourceLocation UsingLoc,
2026                    SourceLocation TypenameLoc,
2027                    SourceRange TargetNNR, NestedNameSpecifier *TargetNNS,
2028                    SourceLocation TargetNameLoc, IdentifierInfo *TargetName)
2029  : TypeDecl(Decl::UnresolvedUsingTypename, DC, TargetNameLoc, TargetName),
2030    TargetNestedNameRange(TargetNNR), UsingLocation(UsingLoc),
2031    TypenameLocation(TypenameLoc), TargetNestedNameSpecifier(TargetNNS)
2032  { }
2033
2034public:
2035  /// \brief Returns the source range that covers the nested-name-specifier
2036  /// preceding the namespace name.
2037  SourceRange getTargetNestedNameRange() const { return TargetNestedNameRange; }
2038
2039  /// \brief Set the source range coverting the nested-name-specifier preceding
2040  /// the namespace name.
2041  void setTargetNestedNameRange(SourceRange R) { TargetNestedNameRange = R; }
2042
2043  /// \brief Get target nested name declaration.
2044  NestedNameSpecifier* getTargetNestedNameSpecifier() {
2045    return TargetNestedNameSpecifier;
2046  }
2047
2048  /// \brief Set the nested name declaration.
2049  void setTargetNestedNameSpecifier(NestedNameSpecifier* NNS) {
2050    TargetNestedNameSpecifier = NNS;
2051  }
2052
2053  /// \brief Returns the source location of the 'using' keyword.
2054  SourceLocation getUsingLoc() const { return UsingLocation; }
2055
2056  /// \brief Set the source location of the 'using' keyword.
2057  void setUsingLoc(SourceLocation L) { UsingLocation = L; }
2058
2059  /// \brief Returns the source location of the 'typename' keyword.
2060  SourceLocation getTypenameLoc() const { return TypenameLocation; }
2061
2062  /// \brief Set the source location of the 'typename' keyword.
2063  void setTypenameLoc(SourceLocation L) { TypenameLocation = L; }
2064
2065  static UnresolvedUsingTypenameDecl *
2066    Create(ASTContext &C, DeclContext *DC, SourceLocation UsingLoc,
2067           SourceLocation TypenameLoc,
2068           SourceRange TargetNNR, NestedNameSpecifier *TargetNNS,
2069           SourceLocation TargetNameLoc, DeclarationName TargetName);
2070
2071  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
2072  static bool classof(const UnresolvedUsingTypenameDecl *D) { return true; }
2073  static bool classofKind(Kind K) { return K == Decl::UnresolvedUsingTypename; }
2074};
2075
2076/// StaticAssertDecl - Represents a C++0x static_assert declaration.
2077class StaticAssertDecl : public Decl {
2078  Expr *AssertExpr;
2079  StringLiteral *Message;
2080
2081  StaticAssertDecl(DeclContext *DC, SourceLocation L,
2082                   Expr *assertexpr, StringLiteral *message)
2083  : Decl(StaticAssert, DC, L), AssertExpr(assertexpr), Message(message) { }
2084
2085public:
2086  static StaticAssertDecl *Create(ASTContext &C, DeclContext *DC,
2087                                  SourceLocation L, Expr *AssertExpr,
2088                                  StringLiteral *Message);
2089
2090  Expr *getAssertExpr() { return AssertExpr; }
2091  const Expr *getAssertExpr() const { return AssertExpr; }
2092
2093  StringLiteral *getMessage() { return Message; }
2094  const StringLiteral *getMessage() const { return Message; }
2095
2096  virtual ~StaticAssertDecl();
2097  virtual void Destroy(ASTContext& C);
2098
2099  static bool classof(const Decl *D) { return classofKind(D->getKind()); }
2100  static bool classof(StaticAssertDecl *D) { return true; }
2101  static bool classofKind(Kind K) { return K == Decl::StaticAssert; }
2102};
2103
2104/// Insertion operator for diagnostics.  This allows sending AccessSpecifier's
2105/// into a diagnostic with <<.
2106const DiagnosticBuilder &operator<<(const DiagnosticBuilder &DB,
2107                                    AccessSpecifier AS);
2108
2109} // end namespace clang
2110
2111#endif
2112