1 //===--- ASTContext.cpp - Context to hold long-lived AST nodes ------------===//
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 implements the ASTContext interface.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "clang/AST/ASTContext.h"
15 #include "CXXABI.h"
16 #include "clang/AST/ASTMutationListener.h"
17 #include "clang/AST/Attr.h"
18 #include "clang/AST/CharUnits.h"
19 #include "clang/AST/Comment.h"
20 #include "clang/AST/CommentCommandTraits.h"
21 #include "clang/AST/DeclCXX.h"
22 #include "clang/AST/DeclObjC.h"
23 #include "clang/AST/DeclTemplate.h"
24 #include "clang/AST/Expr.h"
25 #include "clang/AST/ExprCXX.h"
26 #include "clang/AST/ExternalASTSource.h"
27 #include "clang/AST/Mangle.h"
28 #include "clang/AST/MangleNumberingContext.h"
29 #include "clang/AST/RecordLayout.h"
30 #include "clang/AST/RecursiveASTVisitor.h"
31 #include "clang/AST/TypeLoc.h"
32 #include "clang/AST/VTableBuilder.h"
33 #include "clang/Basic/Builtins.h"
34 #include "clang/Basic/SourceManager.h"
35 #include "clang/Basic/TargetInfo.h"
36 #include "llvm/ADT/SmallString.h"
37 #include "llvm/ADT/StringExtras.h"
38 #include "llvm/ADT/Triple.h"
39 #include "llvm/Support/Capacity.h"
40 #include "llvm/Support/MathExtras.h"
41 #include "llvm/Support/raw_ostream.h"
42 #include <map>
43 
44 using namespace clang;
45 
46 unsigned ASTContext::NumImplicitDefaultConstructors;
47 unsigned ASTContext::NumImplicitDefaultConstructorsDeclared;
48 unsigned ASTContext::NumImplicitCopyConstructors;
49 unsigned ASTContext::NumImplicitCopyConstructorsDeclared;
50 unsigned ASTContext::NumImplicitMoveConstructors;
51 unsigned ASTContext::NumImplicitMoveConstructorsDeclared;
52 unsigned ASTContext::NumImplicitCopyAssignmentOperators;
53 unsigned ASTContext::NumImplicitCopyAssignmentOperatorsDeclared;
54 unsigned ASTContext::NumImplicitMoveAssignmentOperators;
55 unsigned ASTContext::NumImplicitMoveAssignmentOperatorsDeclared;
56 unsigned ASTContext::NumImplicitDestructors;
57 unsigned ASTContext::NumImplicitDestructorsDeclared;
58 
59 enum FloatingRank {
60   HalfRank, FloatRank, DoubleRank, LongDoubleRank
61 };
62 
63 RawComment *ASTContext::getRawCommentForDeclNoCache(const Decl *D) const {
64   if (!CommentsLoaded && ExternalSource) {
65     ExternalSource->ReadComments();
66     CommentsLoaded = true;
67   }
68 
69   assert(D);
70 
71   // User can not attach documentation to implicit declarations.
72   if (D->isImplicit())
73     return NULL;
74 
75   // User can not attach documentation to implicit instantiations.
76   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
77     if (FD->getTemplateSpecializationKind() == TSK_ImplicitInstantiation)
78       return NULL;
79   }
80 
81   if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
82     if (VD->isStaticDataMember() &&
83         VD->getTemplateSpecializationKind() == TSK_ImplicitInstantiation)
84       return NULL;
85   }
86 
87   if (const CXXRecordDecl *CRD = dyn_cast<CXXRecordDecl>(D)) {
88     if (CRD->getTemplateSpecializationKind() == TSK_ImplicitInstantiation)
89       return NULL;
90   }
91 
92   if (const ClassTemplateSpecializationDecl *CTSD =
93           dyn_cast<ClassTemplateSpecializationDecl>(D)) {
94     TemplateSpecializationKind TSK = CTSD->getSpecializationKind();
95     if (TSK == TSK_ImplicitInstantiation ||
96         TSK == TSK_Undeclared)
97       return NULL;
98   }
99 
100   if (const EnumDecl *ED = dyn_cast<EnumDecl>(D)) {
101     if (ED->getTemplateSpecializationKind() == TSK_ImplicitInstantiation)
102       return NULL;
103   }
104   if (const TagDecl *TD = dyn_cast<TagDecl>(D)) {
105     // When tag declaration (but not definition!) is part of the
106     // decl-specifier-seq of some other declaration, it doesn't get comment
107     if (TD->isEmbeddedInDeclarator() && !TD->isCompleteDefinition())
108       return NULL;
109   }
110   // TODO: handle comments for function parameters properly.
111   if (isa<ParmVarDecl>(D))
112     return NULL;
113 
114   // TODO: we could look up template parameter documentation in the template
115   // documentation.
116   if (isa<TemplateTypeParmDecl>(D) ||
117       isa<NonTypeTemplateParmDecl>(D) ||
118       isa<TemplateTemplateParmDecl>(D))
119     return NULL;
120 
121   ArrayRef<RawComment *> RawComments = Comments.getComments();
122 
123   // If there are no comments anywhere, we won't find anything.
124   if (RawComments.empty())
125     return NULL;
126 
127   // Find declaration location.
128   // For Objective-C declarations we generally don't expect to have multiple
129   // declarators, thus use declaration starting location as the "declaration
130   // location".
131   // For all other declarations multiple declarators are used quite frequently,
132   // so we use the location of the identifier as the "declaration location".
133   SourceLocation DeclLoc;
134   if (isa<ObjCMethodDecl>(D) || isa<ObjCContainerDecl>(D) ||
135       isa<ObjCPropertyDecl>(D) ||
136       isa<RedeclarableTemplateDecl>(D) ||
137       isa<ClassTemplateSpecializationDecl>(D))
138     DeclLoc = D->getLocStart();
139   else {
140     DeclLoc = D->getLocation();
141     // If location of the typedef name is in a macro, it is because being
142     // declared via a macro. Try using declaration's starting location
143     // as the "declaration location".
144     if (DeclLoc.isMacroID() && isa<TypedefDecl>(D))
145       DeclLoc = D->getLocStart();
146   }
147 
148   // If the declaration doesn't map directly to a location in a file, we
149   // can't find the comment.
150   if (DeclLoc.isInvalid() || !DeclLoc.isFileID())
151     return NULL;
152 
153   // Find the comment that occurs just after this declaration.
154   ArrayRef<RawComment *>::iterator Comment;
155   {
156     // When searching for comments during parsing, the comment we are looking
157     // for is usually among the last two comments we parsed -- check them
158     // first.
159     RawComment CommentAtDeclLoc(
160         SourceMgr, SourceRange(DeclLoc), false,
161         LangOpts.CommentOpts.ParseAllComments);
162     BeforeThanCompare<RawComment> Compare(SourceMgr);
163     ArrayRef<RawComment *>::iterator MaybeBeforeDecl = RawComments.end() - 1;
164     bool Found = Compare(*MaybeBeforeDecl, &CommentAtDeclLoc);
165     if (!Found && RawComments.size() >= 2) {
166       MaybeBeforeDecl--;
167       Found = Compare(*MaybeBeforeDecl, &CommentAtDeclLoc);
168     }
169 
170     if (Found) {
171       Comment = MaybeBeforeDecl + 1;
172       assert(Comment == std::lower_bound(RawComments.begin(), RawComments.end(),
173                                          &CommentAtDeclLoc, Compare));
174     } else {
175       // Slow path.
176       Comment = std::lower_bound(RawComments.begin(), RawComments.end(),
177                                  &CommentAtDeclLoc, Compare);
178     }
179   }
180 
181   // Decompose the location for the declaration and find the beginning of the
182   // file buffer.
183   std::pair<FileID, unsigned> DeclLocDecomp = SourceMgr.getDecomposedLoc(DeclLoc);
184 
185   // First check whether we have a trailing comment.
186   if (Comment != RawComments.end() &&
187       (*Comment)->isDocumentation() && (*Comment)->isTrailingComment() &&
188       (isa<FieldDecl>(D) || isa<EnumConstantDecl>(D) || isa<VarDecl>(D) ||
189        isa<ObjCMethodDecl>(D) || isa<ObjCPropertyDecl>(D))) {
190     std::pair<FileID, unsigned> CommentBeginDecomp
191       = SourceMgr.getDecomposedLoc((*Comment)->getSourceRange().getBegin());
192     // Check that Doxygen trailing comment comes after the declaration, starts
193     // on the same line and in the same file as the declaration.
194     if (DeclLocDecomp.first == CommentBeginDecomp.first &&
195         SourceMgr.getLineNumber(DeclLocDecomp.first, DeclLocDecomp.second)
196           == SourceMgr.getLineNumber(CommentBeginDecomp.first,
197                                      CommentBeginDecomp.second)) {
198       return *Comment;
199     }
200   }
201 
202   // The comment just after the declaration was not a trailing comment.
203   // Let's look at the previous comment.
204   if (Comment == RawComments.begin())
205     return NULL;
206   --Comment;
207 
208   // Check that we actually have a non-member Doxygen comment.
209   if (!(*Comment)->isDocumentation() || (*Comment)->isTrailingComment())
210     return NULL;
211 
212   // Decompose the end of the comment.
213   std::pair<FileID, unsigned> CommentEndDecomp
214     = SourceMgr.getDecomposedLoc((*Comment)->getSourceRange().getEnd());
215 
216   // If the comment and the declaration aren't in the same file, then they
217   // aren't related.
218   if (DeclLocDecomp.first != CommentEndDecomp.first)
219     return NULL;
220 
221   // Get the corresponding buffer.
222   bool Invalid = false;
223   const char *Buffer = SourceMgr.getBufferData(DeclLocDecomp.first,
224                                                &Invalid).data();
225   if (Invalid)
226     return NULL;
227 
228   // Extract text between the comment and declaration.
229   StringRef Text(Buffer + CommentEndDecomp.second,
230                  DeclLocDecomp.second - CommentEndDecomp.second);
231 
232   // There should be no other declarations or preprocessor directives between
233   // comment and declaration.
234   if (Text.find_first_of(";{}#@") != StringRef::npos)
235     return NULL;
236 
237   return *Comment;
238 }
239 
240 namespace {
241 /// If we have a 'templated' declaration for a template, adjust 'D' to
242 /// refer to the actual template.
243 /// If we have an implicit instantiation, adjust 'D' to refer to template.
244 const Decl *adjustDeclToTemplate(const Decl *D) {
245   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
246     // Is this function declaration part of a function template?
247     if (const FunctionTemplateDecl *FTD = FD->getDescribedFunctionTemplate())
248       return FTD;
249 
250     // Nothing to do if function is not an implicit instantiation.
251     if (FD->getTemplateSpecializationKind() != TSK_ImplicitInstantiation)
252       return D;
253 
254     // Function is an implicit instantiation of a function template?
255     if (const FunctionTemplateDecl *FTD = FD->getPrimaryTemplate())
256       return FTD;
257 
258     // Function is instantiated from a member definition of a class template?
259     if (const FunctionDecl *MemberDecl =
260             FD->getInstantiatedFromMemberFunction())
261       return MemberDecl;
262 
263     return D;
264   }
265   if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
266     // Static data member is instantiated from a member definition of a class
267     // template?
268     if (VD->isStaticDataMember())
269       if (const VarDecl *MemberDecl = VD->getInstantiatedFromStaticDataMember())
270         return MemberDecl;
271 
272     return D;
273   }
274   if (const CXXRecordDecl *CRD = dyn_cast<CXXRecordDecl>(D)) {
275     // Is this class declaration part of a class template?
276     if (const ClassTemplateDecl *CTD = CRD->getDescribedClassTemplate())
277       return CTD;
278 
279     // Class is an implicit instantiation of a class template or partial
280     // specialization?
281     if (const ClassTemplateSpecializationDecl *CTSD =
282             dyn_cast<ClassTemplateSpecializationDecl>(CRD)) {
283       if (CTSD->getSpecializationKind() != TSK_ImplicitInstantiation)
284         return D;
285       llvm::PointerUnion<ClassTemplateDecl *,
286                          ClassTemplatePartialSpecializationDecl *>
287           PU = CTSD->getSpecializedTemplateOrPartial();
288       return PU.is<ClassTemplateDecl*>() ?
289           static_cast<const Decl*>(PU.get<ClassTemplateDecl *>()) :
290           static_cast<const Decl*>(
291               PU.get<ClassTemplatePartialSpecializationDecl *>());
292     }
293 
294     // Class is instantiated from a member definition of a class template?
295     if (const MemberSpecializationInfo *Info =
296                    CRD->getMemberSpecializationInfo())
297       return Info->getInstantiatedFrom();
298 
299     return D;
300   }
301   if (const EnumDecl *ED = dyn_cast<EnumDecl>(D)) {
302     // Enum is instantiated from a member definition of a class template?
303     if (const EnumDecl *MemberDecl = ED->getInstantiatedFromMemberEnum())
304       return MemberDecl;
305 
306     return D;
307   }
308   // FIXME: Adjust alias templates?
309   return D;
310 }
311 } // unnamed namespace
312 
313 const RawComment *ASTContext::getRawCommentForAnyRedecl(
314                                                 const Decl *D,
315                                                 const Decl **OriginalDecl) const {
316   D = adjustDeclToTemplate(D);
317 
318   // Check whether we have cached a comment for this declaration already.
319   {
320     llvm::DenseMap<const Decl *, RawCommentAndCacheFlags>::iterator Pos =
321         RedeclComments.find(D);
322     if (Pos != RedeclComments.end()) {
323       const RawCommentAndCacheFlags &Raw = Pos->second;
324       if (Raw.getKind() != RawCommentAndCacheFlags::NoCommentInDecl) {
325         if (OriginalDecl)
326           *OriginalDecl = Raw.getOriginalDecl();
327         return Raw.getRaw();
328       }
329     }
330   }
331 
332   // Search for comments attached to declarations in the redeclaration chain.
333   const RawComment *RC = NULL;
334   const Decl *OriginalDeclForRC = NULL;
335   for (Decl::redecl_iterator I = D->redecls_begin(),
336                              E = D->redecls_end();
337        I != E; ++I) {
338     llvm::DenseMap<const Decl *, RawCommentAndCacheFlags>::iterator Pos =
339         RedeclComments.find(*I);
340     if (Pos != RedeclComments.end()) {
341       const RawCommentAndCacheFlags &Raw = Pos->second;
342       if (Raw.getKind() != RawCommentAndCacheFlags::NoCommentInDecl) {
343         RC = Raw.getRaw();
344         OriginalDeclForRC = Raw.getOriginalDecl();
345         break;
346       }
347     } else {
348       RC = getRawCommentForDeclNoCache(*I);
349       OriginalDeclForRC = *I;
350       RawCommentAndCacheFlags Raw;
351       if (RC) {
352         Raw.setRaw(RC);
353         Raw.setKind(RawCommentAndCacheFlags::FromDecl);
354       } else
355         Raw.setKind(RawCommentAndCacheFlags::NoCommentInDecl);
356       Raw.setOriginalDecl(*I);
357       RedeclComments[*I] = Raw;
358       if (RC)
359         break;
360     }
361   }
362 
363   // If we found a comment, it should be a documentation comment.
364   assert(!RC || RC->isDocumentation());
365 
366   if (OriginalDecl)
367     *OriginalDecl = OriginalDeclForRC;
368 
369   // Update cache for every declaration in the redeclaration chain.
370   RawCommentAndCacheFlags Raw;
371   Raw.setRaw(RC);
372   Raw.setKind(RawCommentAndCacheFlags::FromRedecl);
373   Raw.setOriginalDecl(OriginalDeclForRC);
374 
375   for (Decl::redecl_iterator I = D->redecls_begin(),
376                              E = D->redecls_end();
377        I != E; ++I) {
378     RawCommentAndCacheFlags &R = RedeclComments[*I];
379     if (R.getKind() == RawCommentAndCacheFlags::NoCommentInDecl)
380       R = Raw;
381   }
382 
383   return RC;
384 }
385 
386 static void addRedeclaredMethods(const ObjCMethodDecl *ObjCMethod,
387                    SmallVectorImpl<const NamedDecl *> &Redeclared) {
388   const DeclContext *DC = ObjCMethod->getDeclContext();
389   if (const ObjCImplDecl *IMD = dyn_cast<ObjCImplDecl>(DC)) {
390     const ObjCInterfaceDecl *ID = IMD->getClassInterface();
391     if (!ID)
392       return;
393     // Add redeclared method here.
394     for (ObjCInterfaceDecl::known_extensions_iterator
395            Ext = ID->known_extensions_begin(),
396            ExtEnd = ID->known_extensions_end();
397          Ext != ExtEnd; ++Ext) {
398       if (ObjCMethodDecl *RedeclaredMethod =
399             Ext->getMethod(ObjCMethod->getSelector(),
400                                   ObjCMethod->isInstanceMethod()))
401         Redeclared.push_back(RedeclaredMethod);
402     }
403   }
404 }
405 
406 comments::FullComment *ASTContext::cloneFullComment(comments::FullComment *FC,
407                                                     const Decl *D) const {
408   comments::DeclInfo *ThisDeclInfo = new (*this) comments::DeclInfo;
409   ThisDeclInfo->CommentDecl = D;
410   ThisDeclInfo->IsFilled = false;
411   ThisDeclInfo->fill();
412   ThisDeclInfo->CommentDecl = FC->getDecl();
413   comments::FullComment *CFC =
414     new (*this) comments::FullComment(FC->getBlocks(),
415                                       ThisDeclInfo);
416   return CFC;
417 
418 }
419 
420 comments::FullComment *ASTContext::getLocalCommentForDeclUncached(const Decl *D) const {
421   const RawComment *RC = getRawCommentForDeclNoCache(D);
422   return RC ? RC->parse(*this, 0, D) : 0;
423 }
424 
425 comments::FullComment *ASTContext::getCommentForDecl(
426                                               const Decl *D,
427                                               const Preprocessor *PP) const {
428   if (D->isInvalidDecl())
429     return NULL;
430   D = adjustDeclToTemplate(D);
431 
432   const Decl *Canonical = D->getCanonicalDecl();
433   llvm::DenseMap<const Decl *, comments::FullComment *>::iterator Pos =
434       ParsedComments.find(Canonical);
435 
436   if (Pos != ParsedComments.end()) {
437     if (Canonical != D) {
438       comments::FullComment *FC = Pos->second;
439       comments::FullComment *CFC = cloneFullComment(FC, D);
440       return CFC;
441     }
442     return Pos->second;
443   }
444 
445   const Decl *OriginalDecl;
446 
447   const RawComment *RC = getRawCommentForAnyRedecl(D, &OriginalDecl);
448   if (!RC) {
449     if (isa<ObjCMethodDecl>(D) || isa<FunctionDecl>(D)) {
450       SmallVector<const NamedDecl*, 8> Overridden;
451       const ObjCMethodDecl *OMD = dyn_cast<ObjCMethodDecl>(D);
452       if (OMD && OMD->isPropertyAccessor())
453         if (const ObjCPropertyDecl *PDecl = OMD->findPropertyDecl())
454           if (comments::FullComment *FC = getCommentForDecl(PDecl, PP))
455             return cloneFullComment(FC, D);
456       if (OMD)
457         addRedeclaredMethods(OMD, Overridden);
458       getOverriddenMethods(dyn_cast<NamedDecl>(D), Overridden);
459       for (unsigned i = 0, e = Overridden.size(); i < e; i++)
460         if (comments::FullComment *FC = getCommentForDecl(Overridden[i], PP))
461           return cloneFullComment(FC, D);
462     }
463     else if (const TypedefNameDecl *TD = dyn_cast<TypedefNameDecl>(D)) {
464       // Attach any tag type's documentation to its typedef if latter
465       // does not have one of its own.
466       QualType QT = TD->getUnderlyingType();
467       if (const TagType *TT = QT->getAs<TagType>())
468         if (const Decl *TD = TT->getDecl())
469           if (comments::FullComment *FC = getCommentForDecl(TD, PP))
470             return cloneFullComment(FC, D);
471     }
472     else if (const ObjCInterfaceDecl *IC = dyn_cast<ObjCInterfaceDecl>(D)) {
473       while (IC->getSuperClass()) {
474         IC = IC->getSuperClass();
475         if (comments::FullComment *FC = getCommentForDecl(IC, PP))
476           return cloneFullComment(FC, D);
477       }
478     }
479     else if (const ObjCCategoryDecl *CD = dyn_cast<ObjCCategoryDecl>(D)) {
480       if (const ObjCInterfaceDecl *IC = CD->getClassInterface())
481         if (comments::FullComment *FC = getCommentForDecl(IC, PP))
482           return cloneFullComment(FC, D);
483     }
484     else if (const CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(D)) {
485       if (!(RD = RD->getDefinition()))
486         return NULL;
487       // Check non-virtual bases.
488       for (CXXRecordDecl::base_class_const_iterator I =
489            RD->bases_begin(), E = RD->bases_end(); I != E; ++I) {
490         if (I->isVirtual() || (I->getAccessSpecifier() != AS_public))
491           continue;
492         QualType Ty = I->getType();
493         if (Ty.isNull())
494           continue;
495         if (const CXXRecordDecl *NonVirtualBase = Ty->getAsCXXRecordDecl()) {
496           if (!(NonVirtualBase= NonVirtualBase->getDefinition()))
497             continue;
498 
499           if (comments::FullComment *FC = getCommentForDecl((NonVirtualBase), PP))
500             return cloneFullComment(FC, D);
501         }
502       }
503       // Check virtual bases.
504       for (CXXRecordDecl::base_class_const_iterator I =
505            RD->vbases_begin(), E = RD->vbases_end(); I != E; ++I) {
506         if (I->getAccessSpecifier() != AS_public)
507           continue;
508         QualType Ty = I->getType();
509         if (Ty.isNull())
510           continue;
511         if (const CXXRecordDecl *VirtualBase = Ty->getAsCXXRecordDecl()) {
512           if (!(VirtualBase= VirtualBase->getDefinition()))
513             continue;
514           if (comments::FullComment *FC = getCommentForDecl((VirtualBase), PP))
515             return cloneFullComment(FC, D);
516         }
517       }
518     }
519     return NULL;
520   }
521 
522   // If the RawComment was attached to other redeclaration of this Decl, we
523   // should parse the comment in context of that other Decl.  This is important
524   // because comments can contain references to parameter names which can be
525   // different across redeclarations.
526   if (D != OriginalDecl)
527     return getCommentForDecl(OriginalDecl, PP);
528 
529   comments::FullComment *FC = RC->parse(*this, PP, D);
530   ParsedComments[Canonical] = FC;
531   return FC;
532 }
533 
534 void
535 ASTContext::CanonicalTemplateTemplateParm::Profile(llvm::FoldingSetNodeID &ID,
536                                                TemplateTemplateParmDecl *Parm) {
537   ID.AddInteger(Parm->getDepth());
538   ID.AddInteger(Parm->getPosition());
539   ID.AddBoolean(Parm->isParameterPack());
540 
541   TemplateParameterList *Params = Parm->getTemplateParameters();
542   ID.AddInteger(Params->size());
543   for (TemplateParameterList::const_iterator P = Params->begin(),
544                                           PEnd = Params->end();
545        P != PEnd; ++P) {
546     if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(*P)) {
547       ID.AddInteger(0);
548       ID.AddBoolean(TTP->isParameterPack());
549       continue;
550     }
551 
552     if (NonTypeTemplateParmDecl *NTTP = dyn_cast<NonTypeTemplateParmDecl>(*P)) {
553       ID.AddInteger(1);
554       ID.AddBoolean(NTTP->isParameterPack());
555       ID.AddPointer(NTTP->getType().getCanonicalType().getAsOpaquePtr());
556       if (NTTP->isExpandedParameterPack()) {
557         ID.AddBoolean(true);
558         ID.AddInteger(NTTP->getNumExpansionTypes());
559         for (unsigned I = 0, N = NTTP->getNumExpansionTypes(); I != N; ++I) {
560           QualType T = NTTP->getExpansionType(I);
561           ID.AddPointer(T.getCanonicalType().getAsOpaquePtr());
562         }
563       } else
564         ID.AddBoolean(false);
565       continue;
566     }
567 
568     TemplateTemplateParmDecl *TTP = cast<TemplateTemplateParmDecl>(*P);
569     ID.AddInteger(2);
570     Profile(ID, TTP);
571   }
572 }
573 
574 TemplateTemplateParmDecl *
575 ASTContext::getCanonicalTemplateTemplateParmDecl(
576                                           TemplateTemplateParmDecl *TTP) const {
577   // Check if we already have a canonical template template parameter.
578   llvm::FoldingSetNodeID ID;
579   CanonicalTemplateTemplateParm::Profile(ID, TTP);
580   void *InsertPos = 0;
581   CanonicalTemplateTemplateParm *Canonical
582     = CanonTemplateTemplateParms.FindNodeOrInsertPos(ID, InsertPos);
583   if (Canonical)
584     return Canonical->getParam();
585 
586   // Build a canonical template parameter list.
587   TemplateParameterList *Params = TTP->getTemplateParameters();
588   SmallVector<NamedDecl *, 4> CanonParams;
589   CanonParams.reserve(Params->size());
590   for (TemplateParameterList::const_iterator P = Params->begin(),
591                                           PEnd = Params->end();
592        P != PEnd; ++P) {
593     if (TemplateTypeParmDecl *TTP = dyn_cast<TemplateTypeParmDecl>(*P))
594       CanonParams.push_back(
595                   TemplateTypeParmDecl::Create(*this, getTranslationUnitDecl(),
596                                                SourceLocation(),
597                                                SourceLocation(),
598                                                TTP->getDepth(),
599                                                TTP->getIndex(), 0, false,
600                                                TTP->isParameterPack()));
601     else if (NonTypeTemplateParmDecl *NTTP
602              = dyn_cast<NonTypeTemplateParmDecl>(*P)) {
603       QualType T = getCanonicalType(NTTP->getType());
604       TypeSourceInfo *TInfo = getTrivialTypeSourceInfo(T);
605       NonTypeTemplateParmDecl *Param;
606       if (NTTP->isExpandedParameterPack()) {
607         SmallVector<QualType, 2> ExpandedTypes;
608         SmallVector<TypeSourceInfo *, 2> ExpandedTInfos;
609         for (unsigned I = 0, N = NTTP->getNumExpansionTypes(); I != N; ++I) {
610           ExpandedTypes.push_back(getCanonicalType(NTTP->getExpansionType(I)));
611           ExpandedTInfos.push_back(
612                                 getTrivialTypeSourceInfo(ExpandedTypes.back()));
613         }
614 
615         Param = NonTypeTemplateParmDecl::Create(*this, getTranslationUnitDecl(),
616                                                 SourceLocation(),
617                                                 SourceLocation(),
618                                                 NTTP->getDepth(),
619                                                 NTTP->getPosition(), 0,
620                                                 T,
621                                                 TInfo,
622                                                 ExpandedTypes.data(),
623                                                 ExpandedTypes.size(),
624                                                 ExpandedTInfos.data());
625       } else {
626         Param = NonTypeTemplateParmDecl::Create(*this, getTranslationUnitDecl(),
627                                                 SourceLocation(),
628                                                 SourceLocation(),
629                                                 NTTP->getDepth(),
630                                                 NTTP->getPosition(), 0,
631                                                 T,
632                                                 NTTP->isParameterPack(),
633                                                 TInfo);
634       }
635       CanonParams.push_back(Param);
636 
637     } else
638       CanonParams.push_back(getCanonicalTemplateTemplateParmDecl(
639                                            cast<TemplateTemplateParmDecl>(*P)));
640   }
641 
642   TemplateTemplateParmDecl *CanonTTP
643     = TemplateTemplateParmDecl::Create(*this, getTranslationUnitDecl(),
644                                        SourceLocation(), TTP->getDepth(),
645                                        TTP->getPosition(),
646                                        TTP->isParameterPack(),
647                                        0,
648                          TemplateParameterList::Create(*this, SourceLocation(),
649                                                        SourceLocation(),
650                                                        CanonParams.data(),
651                                                        CanonParams.size(),
652                                                        SourceLocation()));
653 
654   // Get the new insert position for the node we care about.
655   Canonical = CanonTemplateTemplateParms.FindNodeOrInsertPos(ID, InsertPos);
656   assert(Canonical == 0 && "Shouldn't be in the map!");
657   (void)Canonical;
658 
659   // Create the canonical template template parameter entry.
660   Canonical = new (*this) CanonicalTemplateTemplateParm(CanonTTP);
661   CanonTemplateTemplateParms.InsertNode(Canonical, InsertPos);
662   return CanonTTP;
663 }
664 
665 CXXABI *ASTContext::createCXXABI(const TargetInfo &T) {
666   if (!LangOpts.CPlusPlus) return 0;
667 
668   switch (T.getCXXABI().getKind()) {
669   case TargetCXXABI::GenericARM:
670   case TargetCXXABI::iOS:
671     return CreateARMCXXABI(*this);
672   case TargetCXXABI::GenericAArch64: // Same as Itanium at this level
673   case TargetCXXABI::GenericItanium:
674     return CreateItaniumCXXABI(*this);
675   case TargetCXXABI::Microsoft:
676     return CreateMicrosoftCXXABI(*this);
677   }
678   llvm_unreachable("Invalid CXXABI type!");
679 }
680 
681 static const LangAS::Map *getAddressSpaceMap(const TargetInfo &T,
682                                              const LangOptions &LOpts) {
683   if (LOpts.FakeAddressSpaceMap) {
684     // The fake address space map must have a distinct entry for each
685     // language-specific address space.
686     static const unsigned FakeAddrSpaceMap[] = {
687       1, // opencl_global
688       2, // opencl_local
689       3, // opencl_constant
690       4, // cuda_device
691       5, // cuda_constant
692       6  // cuda_shared
693     };
694     return &FakeAddrSpaceMap;
695   } else {
696     return &T.getAddressSpaceMap();
697   }
698 }
699 
700 static bool isAddrSpaceMapManglingEnabled(const TargetInfo &TI,
701                                           const LangOptions &LangOpts) {
702   switch (LangOpts.getAddressSpaceMapMangling()) {
703   case LangOptions::ASMM_Target:
704     return TI.useAddressSpaceMapMangling();
705   case LangOptions::ASMM_On:
706     return true;
707   case LangOptions::ASMM_Off:
708     return false;
709   }
710   llvm_unreachable("getAddressSpaceMapMangling() doesn't cover anything.");
711 }
712 
713 ASTContext::ASTContext(LangOptions& LOpts, SourceManager &SM,
714                        const TargetInfo *t,
715                        IdentifierTable &idents, SelectorTable &sels,
716                        Builtin::Context &builtins,
717                        unsigned size_reserve,
718                        bool DelayInitialization)
719   : FunctionProtoTypes(this_()),
720     TemplateSpecializationTypes(this_()),
721     DependentTemplateSpecializationTypes(this_()),
722     SubstTemplateTemplateParmPacks(this_()),
723     GlobalNestedNameSpecifier(0),
724     Int128Decl(0), UInt128Decl(0), Float128StubDecl(0),
725     BuiltinVaListDecl(0),
726     ObjCIdDecl(0), ObjCSelDecl(0), ObjCClassDecl(0), ObjCProtocolClassDecl(0),
727     BOOLDecl(0),
728     CFConstantStringTypeDecl(0), ObjCInstanceTypeDecl(0),
729     FILEDecl(0),
730     jmp_bufDecl(0), sigjmp_bufDecl(0), ucontext_tDecl(0),
731     BlockDescriptorType(0), BlockDescriptorExtendedType(0),
732     cudaConfigureCallDecl(0),
733     NullTypeSourceInfo(QualType()),
734     FirstLocalImport(), LastLocalImport(),
735     SourceMgr(SM), LangOpts(LOpts),
736     AddrSpaceMap(0), Target(t), PrintingPolicy(LOpts),
737     Idents(idents), Selectors(sels),
738     BuiltinInfo(builtins),
739     DeclarationNames(*this),
740     ExternalSource(0), Listener(0),
741     Comments(SM), CommentsLoaded(false),
742     CommentCommandTraits(BumpAlloc, LOpts.CommentOpts),
743     LastSDM(0, 0)
744 {
745   if (size_reserve > 0) Types.reserve(size_reserve);
746   TUDecl = TranslationUnitDecl::Create(*this);
747 
748   if (!DelayInitialization) {
749     assert(t && "No target supplied for ASTContext initialization");
750     InitBuiltinTypes(*t);
751   }
752 }
753 
754 ASTContext::~ASTContext() {
755   // Release the DenseMaps associated with DeclContext objects.
756   // FIXME: Is this the ideal solution?
757   ReleaseDeclContextMaps();
758 
759   // Call all of the deallocation functions on all of their targets.
760   for (DeallocationMap::const_iterator I = Deallocations.begin(),
761            E = Deallocations.end(); I != E; ++I)
762     for (unsigned J = 0, N = I->second.size(); J != N; ++J)
763       (I->first)((I->second)[J]);
764 
765   // ASTRecordLayout objects in ASTRecordLayouts must always be destroyed
766   // because they can contain DenseMaps.
767   for (llvm::DenseMap<const ObjCContainerDecl*,
768        const ASTRecordLayout*>::iterator
769        I = ObjCLayouts.begin(), E = ObjCLayouts.end(); I != E; )
770     // Increment in loop to prevent using deallocated memory.
771     if (ASTRecordLayout *R = const_cast<ASTRecordLayout*>((I++)->second))
772       R->Destroy(*this);
773 
774   for (llvm::DenseMap<const RecordDecl*, const ASTRecordLayout*>::iterator
775        I = ASTRecordLayouts.begin(), E = ASTRecordLayouts.end(); I != E; ) {
776     // Increment in loop to prevent using deallocated memory.
777     if (ASTRecordLayout *R = const_cast<ASTRecordLayout*>((I++)->second))
778       R->Destroy(*this);
779   }
780 
781   for (llvm::DenseMap<const Decl*, AttrVec*>::iterator A = DeclAttrs.begin(),
782                                                     AEnd = DeclAttrs.end();
783        A != AEnd; ++A)
784     A->second->~AttrVec();
785 
786   for (llvm::DenseMap<const DeclContext *, MangleNumberingContext *>::iterator
787            I = MangleNumberingContexts.begin(),
788            E = MangleNumberingContexts.end();
789        I != E; ++I)
790     delete I->second;
791 }
792 
793 void ASTContext::AddDeallocation(void (*Callback)(void*), void *Data) {
794   Deallocations[Callback].push_back(Data);
795 }
796 
797 void
798 ASTContext::setExternalSource(OwningPtr<ExternalASTSource> &Source) {
799   ExternalSource.reset(Source.take());
800 }
801 
802 void ASTContext::PrintStats() const {
803   llvm::errs() << "\n*** AST Context Stats:\n";
804   llvm::errs() << "  " << Types.size() << " types total.\n";
805 
806   unsigned counts[] = {
807 #define TYPE(Name, Parent) 0,
808 #define ABSTRACT_TYPE(Name, Parent)
809 #include "clang/AST/TypeNodes.def"
810     0 // Extra
811   };
812 
813   for (unsigned i = 0, e = Types.size(); i != e; ++i) {
814     Type *T = Types[i];
815     counts[(unsigned)T->getTypeClass()]++;
816   }
817 
818   unsigned Idx = 0;
819   unsigned TotalBytes = 0;
820 #define TYPE(Name, Parent)                                              \
821   if (counts[Idx])                                                      \
822     llvm::errs() << "    " << counts[Idx] << " " << #Name               \
823                  << " types\n";                                         \
824   TotalBytes += counts[Idx] * sizeof(Name##Type);                       \
825   ++Idx;
826 #define ABSTRACT_TYPE(Name, Parent)
827 #include "clang/AST/TypeNodes.def"
828 
829   llvm::errs() << "Total bytes = " << TotalBytes << "\n";
830 
831   // Implicit special member functions.
832   llvm::errs() << NumImplicitDefaultConstructorsDeclared << "/"
833                << NumImplicitDefaultConstructors
834                << " implicit default constructors created\n";
835   llvm::errs() << NumImplicitCopyConstructorsDeclared << "/"
836                << NumImplicitCopyConstructors
837                << " implicit copy constructors created\n";
838   if (getLangOpts().CPlusPlus)
839     llvm::errs() << NumImplicitMoveConstructorsDeclared << "/"
840                  << NumImplicitMoveConstructors
841                  << " implicit move constructors created\n";
842   llvm::errs() << NumImplicitCopyAssignmentOperatorsDeclared << "/"
843                << NumImplicitCopyAssignmentOperators
844                << " implicit copy assignment operators created\n";
845   if (getLangOpts().CPlusPlus)
846     llvm::errs() << NumImplicitMoveAssignmentOperatorsDeclared << "/"
847                  << NumImplicitMoveAssignmentOperators
848                  << " implicit move assignment operators created\n";
849   llvm::errs() << NumImplicitDestructorsDeclared << "/"
850                << NumImplicitDestructors
851                << " implicit destructors created\n";
852 
853   if (ExternalSource.get()) {
854     llvm::errs() << "\n";
855     ExternalSource->PrintStats();
856   }
857 
858   BumpAlloc.PrintStats();
859 }
860 
861 RecordDecl *ASTContext::buildImplicitRecord(StringRef Name,
862                                             RecordDecl::TagKind TK) const {
863   SourceLocation Loc;
864   RecordDecl *NewDecl;
865   if (getLangOpts().CPlusPlus)
866     NewDecl = CXXRecordDecl::Create(*this, TK, getTranslationUnitDecl(), Loc,
867                                     Loc, &Idents.get(Name));
868   else
869     NewDecl = RecordDecl::Create(*this, TK, getTranslationUnitDecl(), Loc, Loc,
870                                  &Idents.get(Name));
871   NewDecl->setImplicit();
872   return NewDecl;
873 }
874 
875 TypedefDecl *ASTContext::buildImplicitTypedef(QualType T,
876                                               StringRef Name) const {
877   TypeSourceInfo *TInfo = getTrivialTypeSourceInfo(T);
878   TypedefDecl *NewDecl = TypedefDecl::Create(
879       const_cast<ASTContext &>(*this), getTranslationUnitDecl(),
880       SourceLocation(), SourceLocation(), &Idents.get(Name), TInfo);
881   NewDecl->setImplicit();
882   return NewDecl;
883 }
884 
885 TypedefDecl *ASTContext::getInt128Decl() const {
886   if (!Int128Decl)
887     Int128Decl = buildImplicitTypedef(Int128Ty, "__int128_t");
888   return Int128Decl;
889 }
890 
891 TypedefDecl *ASTContext::getUInt128Decl() const {
892   if (!UInt128Decl)
893     UInt128Decl = buildImplicitTypedef(UnsignedInt128Ty, "__uint128_t");
894   return UInt128Decl;
895 }
896 
897 TypeDecl *ASTContext::getFloat128StubType() const {
898   assert(LangOpts.CPlusPlus && "should only be called for c++");
899   if (!Float128StubDecl)
900     Float128StubDecl = buildImplicitRecord("__float128");
901 
902   return Float128StubDecl;
903 }
904 
905 void ASTContext::InitBuiltinType(CanQualType &R, BuiltinType::Kind K) {
906   BuiltinType *Ty = new (*this, TypeAlignment) BuiltinType(K);
907   R = CanQualType::CreateUnsafe(QualType(Ty, 0));
908   Types.push_back(Ty);
909 }
910 
911 void ASTContext::InitBuiltinTypes(const TargetInfo &Target) {
912   assert((!this->Target || this->Target == &Target) &&
913          "Incorrect target reinitialization");
914   assert(VoidTy.isNull() && "Context reinitialized?");
915 
916   this->Target = &Target;
917 
918   ABI.reset(createCXXABI(Target));
919   AddrSpaceMap = getAddressSpaceMap(Target, LangOpts);
920   AddrSpaceMapMangling = isAddrSpaceMapManglingEnabled(Target, LangOpts);
921 
922   // C99 6.2.5p19.
923   InitBuiltinType(VoidTy,              BuiltinType::Void);
924 
925   // C99 6.2.5p2.
926   InitBuiltinType(BoolTy,              BuiltinType::Bool);
927   // C99 6.2.5p3.
928   if (LangOpts.CharIsSigned)
929     InitBuiltinType(CharTy,            BuiltinType::Char_S);
930   else
931     InitBuiltinType(CharTy,            BuiltinType::Char_U);
932   // C99 6.2.5p4.
933   InitBuiltinType(SignedCharTy,        BuiltinType::SChar);
934   InitBuiltinType(ShortTy,             BuiltinType::Short);
935   InitBuiltinType(IntTy,               BuiltinType::Int);
936   InitBuiltinType(LongTy,              BuiltinType::Long);
937   InitBuiltinType(LongLongTy,          BuiltinType::LongLong);
938 
939   // C99 6.2.5p6.
940   InitBuiltinType(UnsignedCharTy,      BuiltinType::UChar);
941   InitBuiltinType(UnsignedShortTy,     BuiltinType::UShort);
942   InitBuiltinType(UnsignedIntTy,       BuiltinType::UInt);
943   InitBuiltinType(UnsignedLongTy,      BuiltinType::ULong);
944   InitBuiltinType(UnsignedLongLongTy,  BuiltinType::ULongLong);
945 
946   // C99 6.2.5p10.
947   InitBuiltinType(FloatTy,             BuiltinType::Float);
948   InitBuiltinType(DoubleTy,            BuiltinType::Double);
949   InitBuiltinType(LongDoubleTy,        BuiltinType::LongDouble);
950 
951   // GNU extension, 128-bit integers.
952   InitBuiltinType(Int128Ty,            BuiltinType::Int128);
953   InitBuiltinType(UnsignedInt128Ty,    BuiltinType::UInt128);
954 
955   // C++ 3.9.1p5
956   if (TargetInfo::isTypeSigned(Target.getWCharType()))
957     InitBuiltinType(WCharTy,           BuiltinType::WChar_S);
958   else  // -fshort-wchar makes wchar_t be unsigned.
959     InitBuiltinType(WCharTy,           BuiltinType::WChar_U);
960   if (LangOpts.CPlusPlus && LangOpts.WChar)
961     WideCharTy = WCharTy;
962   else {
963     // C99 (or C++ using -fno-wchar).
964     WideCharTy = getFromTargetType(Target.getWCharType());
965   }
966 
967   WIntTy = getFromTargetType(Target.getWIntType());
968 
969   if (LangOpts.CPlusPlus) // C++0x 3.9.1p5, extension for C++
970     InitBuiltinType(Char16Ty,           BuiltinType::Char16);
971   else // C99
972     Char16Ty = getFromTargetType(Target.getChar16Type());
973 
974   if (LangOpts.CPlusPlus) // C++0x 3.9.1p5, extension for C++
975     InitBuiltinType(Char32Ty,           BuiltinType::Char32);
976   else // C99
977     Char32Ty = getFromTargetType(Target.getChar32Type());
978 
979   // Placeholder type for type-dependent expressions whose type is
980   // completely unknown. No code should ever check a type against
981   // DependentTy and users should never see it; however, it is here to
982   // help diagnose failures to properly check for type-dependent
983   // expressions.
984   InitBuiltinType(DependentTy,         BuiltinType::Dependent);
985 
986   // Placeholder type for functions.
987   InitBuiltinType(OverloadTy,          BuiltinType::Overload);
988 
989   // Placeholder type for bound members.
990   InitBuiltinType(BoundMemberTy,       BuiltinType::BoundMember);
991 
992   // Placeholder type for pseudo-objects.
993   InitBuiltinType(PseudoObjectTy,      BuiltinType::PseudoObject);
994 
995   // "any" type; useful for debugger-like clients.
996   InitBuiltinType(UnknownAnyTy,        BuiltinType::UnknownAny);
997 
998   // Placeholder type for unbridged ARC casts.
999   InitBuiltinType(ARCUnbridgedCastTy,  BuiltinType::ARCUnbridgedCast);
1000 
1001   // Placeholder type for builtin functions.
1002   InitBuiltinType(BuiltinFnTy,  BuiltinType::BuiltinFn);
1003 
1004   // C99 6.2.5p11.
1005   FloatComplexTy      = getComplexType(FloatTy);
1006   DoubleComplexTy     = getComplexType(DoubleTy);
1007   LongDoubleComplexTy = getComplexType(LongDoubleTy);
1008 
1009   // Builtin types for 'id', 'Class', and 'SEL'.
1010   InitBuiltinType(ObjCBuiltinIdTy, BuiltinType::ObjCId);
1011   InitBuiltinType(ObjCBuiltinClassTy, BuiltinType::ObjCClass);
1012   InitBuiltinType(ObjCBuiltinSelTy, BuiltinType::ObjCSel);
1013 
1014   if (LangOpts.OpenCL) {
1015     InitBuiltinType(OCLImage1dTy, BuiltinType::OCLImage1d);
1016     InitBuiltinType(OCLImage1dArrayTy, BuiltinType::OCLImage1dArray);
1017     InitBuiltinType(OCLImage1dBufferTy, BuiltinType::OCLImage1dBuffer);
1018     InitBuiltinType(OCLImage2dTy, BuiltinType::OCLImage2d);
1019     InitBuiltinType(OCLImage2dArrayTy, BuiltinType::OCLImage2dArray);
1020     InitBuiltinType(OCLImage3dTy, BuiltinType::OCLImage3d);
1021 
1022     InitBuiltinType(OCLSamplerTy, BuiltinType::OCLSampler);
1023     InitBuiltinType(OCLEventTy, BuiltinType::OCLEvent);
1024   }
1025 
1026   // Builtin type for __objc_yes and __objc_no
1027   ObjCBuiltinBoolTy = (Target.useSignedCharForObjCBool() ?
1028                        SignedCharTy : BoolTy);
1029 
1030   ObjCConstantStringType = QualType();
1031 
1032   ObjCSuperType = QualType();
1033 
1034   // void * type
1035   VoidPtrTy = getPointerType(VoidTy);
1036 
1037   // nullptr type (C++0x 2.14.7)
1038   InitBuiltinType(NullPtrTy,           BuiltinType::NullPtr);
1039 
1040   // half type (OpenCL 6.1.1.1) / ARM NEON __fp16
1041   InitBuiltinType(HalfTy, BuiltinType::Half);
1042 
1043   // Builtin type used to help define __builtin_va_list.
1044   VaListTagTy = QualType();
1045 }
1046 
1047 DiagnosticsEngine &ASTContext::getDiagnostics() const {
1048   return SourceMgr.getDiagnostics();
1049 }
1050 
1051 AttrVec& ASTContext::getDeclAttrs(const Decl *D) {
1052   AttrVec *&Result = DeclAttrs[D];
1053   if (!Result) {
1054     void *Mem = Allocate(sizeof(AttrVec));
1055     Result = new (Mem) AttrVec;
1056   }
1057 
1058   return *Result;
1059 }
1060 
1061 /// \brief Erase the attributes corresponding to the given declaration.
1062 void ASTContext::eraseDeclAttrs(const Decl *D) {
1063   llvm::DenseMap<const Decl*, AttrVec*>::iterator Pos = DeclAttrs.find(D);
1064   if (Pos != DeclAttrs.end()) {
1065     Pos->second->~AttrVec();
1066     DeclAttrs.erase(Pos);
1067   }
1068 }
1069 
1070 // FIXME: Remove ?
1071 MemberSpecializationInfo *
1072 ASTContext::getInstantiatedFromStaticDataMember(const VarDecl *Var) {
1073   assert(Var->isStaticDataMember() && "Not a static data member");
1074   return getTemplateOrSpecializationInfo(Var)
1075       .dyn_cast<MemberSpecializationInfo *>();
1076 }
1077 
1078 ASTContext::TemplateOrSpecializationInfo
1079 ASTContext::getTemplateOrSpecializationInfo(const VarDecl *Var) {
1080   llvm::DenseMap<const VarDecl *, TemplateOrSpecializationInfo>::iterator Pos =
1081       TemplateOrInstantiation.find(Var);
1082   if (Pos == TemplateOrInstantiation.end())
1083     return TemplateOrSpecializationInfo();
1084 
1085   return Pos->second;
1086 }
1087 
1088 void
1089 ASTContext::setInstantiatedFromStaticDataMember(VarDecl *Inst, VarDecl *Tmpl,
1090                                                 TemplateSpecializationKind TSK,
1091                                           SourceLocation PointOfInstantiation) {
1092   assert(Inst->isStaticDataMember() && "Not a static data member");
1093   assert(Tmpl->isStaticDataMember() && "Not a static data member");
1094   setTemplateOrSpecializationInfo(Inst, new (*this) MemberSpecializationInfo(
1095                                             Tmpl, TSK, PointOfInstantiation));
1096 }
1097 
1098 void
1099 ASTContext::setTemplateOrSpecializationInfo(VarDecl *Inst,
1100                                             TemplateOrSpecializationInfo TSI) {
1101   assert(!TemplateOrInstantiation[Inst] &&
1102          "Already noted what the variable was instantiated from");
1103   TemplateOrInstantiation[Inst] = TSI;
1104 }
1105 
1106 FunctionDecl *ASTContext::getClassScopeSpecializationPattern(
1107                                                      const FunctionDecl *FD){
1108   assert(FD && "Specialization is 0");
1109   llvm::DenseMap<const FunctionDecl*, FunctionDecl *>::const_iterator Pos
1110     = ClassScopeSpecializationPattern.find(FD);
1111   if (Pos == ClassScopeSpecializationPattern.end())
1112     return 0;
1113 
1114   return Pos->second;
1115 }
1116 
1117 void ASTContext::setClassScopeSpecializationPattern(FunctionDecl *FD,
1118                                         FunctionDecl *Pattern) {
1119   assert(FD && "Specialization is 0");
1120   assert(Pattern && "Class scope specialization pattern is 0");
1121   ClassScopeSpecializationPattern[FD] = Pattern;
1122 }
1123 
1124 NamedDecl *
1125 ASTContext::getInstantiatedFromUsingDecl(UsingDecl *UUD) {
1126   llvm::DenseMap<UsingDecl *, NamedDecl *>::const_iterator Pos
1127     = InstantiatedFromUsingDecl.find(UUD);
1128   if (Pos == InstantiatedFromUsingDecl.end())
1129     return 0;
1130 
1131   return Pos->second;
1132 }
1133 
1134 void
1135 ASTContext::setInstantiatedFromUsingDecl(UsingDecl *Inst, NamedDecl *Pattern) {
1136   assert((isa<UsingDecl>(Pattern) ||
1137           isa<UnresolvedUsingValueDecl>(Pattern) ||
1138           isa<UnresolvedUsingTypenameDecl>(Pattern)) &&
1139          "pattern decl is not a using decl");
1140   assert(!InstantiatedFromUsingDecl[Inst] && "pattern already exists");
1141   InstantiatedFromUsingDecl[Inst] = Pattern;
1142 }
1143 
1144 UsingShadowDecl *
1145 ASTContext::getInstantiatedFromUsingShadowDecl(UsingShadowDecl *Inst) {
1146   llvm::DenseMap<UsingShadowDecl*, UsingShadowDecl*>::const_iterator Pos
1147     = InstantiatedFromUsingShadowDecl.find(Inst);
1148   if (Pos == InstantiatedFromUsingShadowDecl.end())
1149     return 0;
1150 
1151   return Pos->second;
1152 }
1153 
1154 void
1155 ASTContext::setInstantiatedFromUsingShadowDecl(UsingShadowDecl *Inst,
1156                                                UsingShadowDecl *Pattern) {
1157   assert(!InstantiatedFromUsingShadowDecl[Inst] && "pattern already exists");
1158   InstantiatedFromUsingShadowDecl[Inst] = Pattern;
1159 }
1160 
1161 FieldDecl *ASTContext::getInstantiatedFromUnnamedFieldDecl(FieldDecl *Field) {
1162   llvm::DenseMap<FieldDecl *, FieldDecl *>::iterator Pos
1163     = InstantiatedFromUnnamedFieldDecl.find(Field);
1164   if (Pos == InstantiatedFromUnnamedFieldDecl.end())
1165     return 0;
1166 
1167   return Pos->second;
1168 }
1169 
1170 void ASTContext::setInstantiatedFromUnnamedFieldDecl(FieldDecl *Inst,
1171                                                      FieldDecl *Tmpl) {
1172   assert(!Inst->getDeclName() && "Instantiated field decl is not unnamed");
1173   assert(!Tmpl->getDeclName() && "Template field decl is not unnamed");
1174   assert(!InstantiatedFromUnnamedFieldDecl[Inst] &&
1175          "Already noted what unnamed field was instantiated from");
1176 
1177   InstantiatedFromUnnamedFieldDecl[Inst] = Tmpl;
1178 }
1179 
1180 ASTContext::overridden_cxx_method_iterator
1181 ASTContext::overridden_methods_begin(const CXXMethodDecl *Method) const {
1182   llvm::DenseMap<const CXXMethodDecl *, CXXMethodVector>::const_iterator Pos
1183     = OverriddenMethods.find(Method->getCanonicalDecl());
1184   if (Pos == OverriddenMethods.end())
1185     return 0;
1186 
1187   return Pos->second.begin();
1188 }
1189 
1190 ASTContext::overridden_cxx_method_iterator
1191 ASTContext::overridden_methods_end(const CXXMethodDecl *Method) const {
1192   llvm::DenseMap<const CXXMethodDecl *, CXXMethodVector>::const_iterator Pos
1193     = OverriddenMethods.find(Method->getCanonicalDecl());
1194   if (Pos == OverriddenMethods.end())
1195     return 0;
1196 
1197   return Pos->second.end();
1198 }
1199 
1200 unsigned
1201 ASTContext::overridden_methods_size(const CXXMethodDecl *Method) const {
1202   llvm::DenseMap<const CXXMethodDecl *, CXXMethodVector>::const_iterator Pos
1203     = OverriddenMethods.find(Method->getCanonicalDecl());
1204   if (Pos == OverriddenMethods.end())
1205     return 0;
1206 
1207   return Pos->second.size();
1208 }
1209 
1210 void ASTContext::addOverriddenMethod(const CXXMethodDecl *Method,
1211                                      const CXXMethodDecl *Overridden) {
1212   assert(Method->isCanonicalDecl() && Overridden->isCanonicalDecl());
1213   OverriddenMethods[Method].push_back(Overridden);
1214 }
1215 
1216 void ASTContext::getOverriddenMethods(
1217                       const NamedDecl *D,
1218                       SmallVectorImpl<const NamedDecl *> &Overridden) const {
1219   assert(D);
1220 
1221   if (const CXXMethodDecl *CXXMethod = dyn_cast<CXXMethodDecl>(D)) {
1222     Overridden.append(overridden_methods_begin(CXXMethod),
1223                       overridden_methods_end(CXXMethod));
1224     return;
1225   }
1226 
1227   const ObjCMethodDecl *Method = dyn_cast<ObjCMethodDecl>(D);
1228   if (!Method)
1229     return;
1230 
1231   SmallVector<const ObjCMethodDecl *, 8> OverDecls;
1232   Method->getOverriddenMethods(OverDecls);
1233   Overridden.append(OverDecls.begin(), OverDecls.end());
1234 }
1235 
1236 void ASTContext::addedLocalImportDecl(ImportDecl *Import) {
1237   assert(!Import->NextLocalImport && "Import declaration already in the chain");
1238   assert(!Import->isFromASTFile() && "Non-local import declaration");
1239   if (!FirstLocalImport) {
1240     FirstLocalImport = Import;
1241     LastLocalImport = Import;
1242     return;
1243   }
1244 
1245   LastLocalImport->NextLocalImport = Import;
1246   LastLocalImport = Import;
1247 }
1248 
1249 //===----------------------------------------------------------------------===//
1250 //                         Type Sizing and Analysis
1251 //===----------------------------------------------------------------------===//
1252 
1253 /// getFloatTypeSemantics - Return the APFloat 'semantics' for the specified
1254 /// scalar floating point type.
1255 const llvm::fltSemantics &ASTContext::getFloatTypeSemantics(QualType T) const {
1256   const BuiltinType *BT = T->getAs<BuiltinType>();
1257   assert(BT && "Not a floating point type!");
1258   switch (BT->getKind()) {
1259   default: llvm_unreachable("Not a floating point type!");
1260   case BuiltinType::Half:       return Target->getHalfFormat();
1261   case BuiltinType::Float:      return Target->getFloatFormat();
1262   case BuiltinType::Double:     return Target->getDoubleFormat();
1263   case BuiltinType::LongDouble: return Target->getLongDoubleFormat();
1264   }
1265 }
1266 
1267 CharUnits ASTContext::getDeclAlign(const Decl *D, bool ForAlignof) const {
1268   unsigned Align = Target->getCharWidth();
1269 
1270   bool UseAlignAttrOnly = false;
1271   if (unsigned AlignFromAttr = D->getMaxAlignment()) {
1272     Align = AlignFromAttr;
1273 
1274     // __attribute__((aligned)) can increase or decrease alignment
1275     // *except* on a struct or struct member, where it only increases
1276     // alignment unless 'packed' is also specified.
1277     //
1278     // It is an error for alignas to decrease alignment, so we can
1279     // ignore that possibility;  Sema should diagnose it.
1280     if (isa<FieldDecl>(D)) {
1281       UseAlignAttrOnly = D->hasAttr<PackedAttr>() ||
1282         cast<FieldDecl>(D)->getParent()->hasAttr<PackedAttr>();
1283     } else {
1284       UseAlignAttrOnly = true;
1285     }
1286   }
1287   else if (isa<FieldDecl>(D))
1288       UseAlignAttrOnly =
1289         D->hasAttr<PackedAttr>() ||
1290         cast<FieldDecl>(D)->getParent()->hasAttr<PackedAttr>();
1291 
1292   // If we're using the align attribute only, just ignore everything
1293   // else about the declaration and its type.
1294   if (UseAlignAttrOnly) {
1295     // do nothing
1296 
1297   } else if (const ValueDecl *VD = dyn_cast<ValueDecl>(D)) {
1298     QualType T = VD->getType();
1299     if (const ReferenceType* RT = T->getAs<ReferenceType>()) {
1300       if (ForAlignof)
1301         T = RT->getPointeeType();
1302       else
1303         T = getPointerType(RT->getPointeeType());
1304     }
1305     if (!T->isIncompleteType() && !T->isFunctionType()) {
1306       // Adjust alignments of declarations with array type by the
1307       // large-array alignment on the target.
1308       if (const ArrayType *arrayType = getAsArrayType(T)) {
1309         unsigned MinWidth = Target->getLargeArrayMinWidth();
1310         if (!ForAlignof && MinWidth) {
1311           if (isa<VariableArrayType>(arrayType))
1312             Align = std::max(Align, Target->getLargeArrayAlign());
1313           else if (isa<ConstantArrayType>(arrayType) &&
1314                    MinWidth <= getTypeSize(cast<ConstantArrayType>(arrayType)))
1315             Align = std::max(Align, Target->getLargeArrayAlign());
1316         }
1317 
1318         // Walk through any array types while we're at it.
1319         T = getBaseElementType(arrayType);
1320       }
1321       Align = std::max(Align, getPreferredTypeAlign(T.getTypePtr()));
1322       if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
1323         if (VD->hasGlobalStorage())
1324           Align = std::max(Align, getTargetInfo().getMinGlobalAlign());
1325       }
1326     }
1327 
1328     // Fields can be subject to extra alignment constraints, like if
1329     // the field is packed, the struct is packed, or the struct has a
1330     // a max-field-alignment constraint (#pragma pack).  So calculate
1331     // the actual alignment of the field within the struct, and then
1332     // (as we're expected to) constrain that by the alignment of the type.
1333     if (const FieldDecl *Field = dyn_cast<FieldDecl>(VD)) {
1334       const RecordDecl *Parent = Field->getParent();
1335       // We can only produce a sensible answer if the record is valid.
1336       if (!Parent->isInvalidDecl()) {
1337         const ASTRecordLayout &Layout = getASTRecordLayout(Parent);
1338 
1339         // Start with the record's overall alignment.
1340         unsigned FieldAlign = toBits(Layout.getAlignment());
1341 
1342         // Use the GCD of that and the offset within the record.
1343         uint64_t Offset = Layout.getFieldOffset(Field->getFieldIndex());
1344         if (Offset > 0) {
1345           // Alignment is always a power of 2, so the GCD will be a power of 2,
1346           // which means we get to do this crazy thing instead of Euclid's.
1347           uint64_t LowBitOfOffset = Offset & (~Offset + 1);
1348           if (LowBitOfOffset < FieldAlign)
1349             FieldAlign = static_cast<unsigned>(LowBitOfOffset);
1350         }
1351 
1352         Align = std::min(Align, FieldAlign);
1353       }
1354     }
1355   }
1356 
1357   return toCharUnitsFromBits(Align);
1358 }
1359 
1360 // getTypeInfoDataSizeInChars - Return the size of a type, in
1361 // chars. If the type is a record, its data size is returned.  This is
1362 // the size of the memcpy that's performed when assigning this type
1363 // using a trivial copy/move assignment operator.
1364 std::pair<CharUnits, CharUnits>
1365 ASTContext::getTypeInfoDataSizeInChars(QualType T) const {
1366   std::pair<CharUnits, CharUnits> sizeAndAlign = getTypeInfoInChars(T);
1367 
1368   // In C++, objects can sometimes be allocated into the tail padding
1369   // of a base-class subobject.  We decide whether that's possible
1370   // during class layout, so here we can just trust the layout results.
1371   if (getLangOpts().CPlusPlus) {
1372     if (const RecordType *RT = T->getAs<RecordType>()) {
1373       const ASTRecordLayout &layout = getASTRecordLayout(RT->getDecl());
1374       sizeAndAlign.first = layout.getDataSize();
1375     }
1376   }
1377 
1378   return sizeAndAlign;
1379 }
1380 
1381 /// getConstantArrayInfoInChars - Performing the computation in CharUnits
1382 /// instead of in bits prevents overflowing the uint64_t for some large arrays.
1383 std::pair<CharUnits, CharUnits>
1384 static getConstantArrayInfoInChars(const ASTContext &Context,
1385                                    const ConstantArrayType *CAT) {
1386   std::pair<CharUnits, CharUnits> EltInfo =
1387       Context.getTypeInfoInChars(CAT->getElementType());
1388   uint64_t Size = CAT->getSize().getZExtValue();
1389   assert((Size == 0 || static_cast<uint64_t>(EltInfo.first.getQuantity()) <=
1390               (uint64_t)(-1)/Size) &&
1391          "Overflow in array type char size evaluation");
1392   uint64_t Width = EltInfo.first.getQuantity() * Size;
1393   unsigned Align = EltInfo.second.getQuantity();
1394   if (!Context.getTargetInfo().getCXXABI().isMicrosoft() ||
1395       Context.getTargetInfo().getPointerWidth(0) == 64)
1396     Width = llvm::RoundUpToAlignment(Width, Align);
1397   return std::make_pair(CharUnits::fromQuantity(Width),
1398                         CharUnits::fromQuantity(Align));
1399 }
1400 
1401 std::pair<CharUnits, CharUnits>
1402 ASTContext::getTypeInfoInChars(const Type *T) const {
1403   if (const ConstantArrayType *CAT = dyn_cast<ConstantArrayType>(T))
1404     return getConstantArrayInfoInChars(*this, CAT);
1405   std::pair<uint64_t, unsigned> Info = getTypeInfo(T);
1406   return std::make_pair(toCharUnitsFromBits(Info.first),
1407                         toCharUnitsFromBits(Info.second));
1408 }
1409 
1410 std::pair<CharUnits, CharUnits>
1411 ASTContext::getTypeInfoInChars(QualType T) const {
1412   return getTypeInfoInChars(T.getTypePtr());
1413 }
1414 
1415 std::pair<uint64_t, unsigned> ASTContext::getTypeInfo(const Type *T) const {
1416   TypeInfoMap::iterator it = MemoizedTypeInfo.find(T);
1417   if (it != MemoizedTypeInfo.end())
1418     return it->second;
1419 
1420   std::pair<uint64_t, unsigned> Info = getTypeInfoImpl(T);
1421   MemoizedTypeInfo.insert(std::make_pair(T, Info));
1422   return Info;
1423 }
1424 
1425 /// getTypeInfoImpl - Return the size of the specified type, in bits.  This
1426 /// method does not work on incomplete types.
1427 ///
1428 /// FIXME: Pointers into different addr spaces could have different sizes and
1429 /// alignment requirements: getPointerInfo should take an AddrSpace, this
1430 /// should take a QualType, &c.
1431 std::pair<uint64_t, unsigned>
1432 ASTContext::getTypeInfoImpl(const Type *T) const {
1433   uint64_t Width=0;
1434   unsigned Align=8;
1435   switch (T->getTypeClass()) {
1436 #define TYPE(Class, Base)
1437 #define ABSTRACT_TYPE(Class, Base)
1438 #define NON_CANONICAL_TYPE(Class, Base)
1439 #define DEPENDENT_TYPE(Class, Base) case Type::Class:
1440 #define NON_CANONICAL_UNLESS_DEPENDENT_TYPE(Class, Base)                       \
1441   case Type::Class:                                                            \
1442   assert(!T->isDependentType() && "should not see dependent types here");      \
1443   return getTypeInfo(cast<Class##Type>(T)->desugar().getTypePtr());
1444 #include "clang/AST/TypeNodes.def"
1445     llvm_unreachable("Should not see dependent types");
1446 
1447   case Type::FunctionNoProto:
1448   case Type::FunctionProto:
1449     // GCC extension: alignof(function) = 32 bits
1450     Width = 0;
1451     Align = 32;
1452     break;
1453 
1454   case Type::IncompleteArray:
1455   case Type::VariableArray:
1456     Width = 0;
1457     Align = getTypeAlign(cast<ArrayType>(T)->getElementType());
1458     break;
1459 
1460   case Type::ConstantArray: {
1461     const ConstantArrayType *CAT = cast<ConstantArrayType>(T);
1462 
1463     std::pair<uint64_t, unsigned> EltInfo = getTypeInfo(CAT->getElementType());
1464     uint64_t Size = CAT->getSize().getZExtValue();
1465     assert((Size == 0 || EltInfo.first <= (uint64_t)(-1)/Size) &&
1466            "Overflow in array type bit size evaluation");
1467     Width = EltInfo.first*Size;
1468     Align = EltInfo.second;
1469     if (!getTargetInfo().getCXXABI().isMicrosoft() ||
1470         getTargetInfo().getPointerWidth(0) == 64)
1471       Width = llvm::RoundUpToAlignment(Width, Align);
1472     break;
1473   }
1474   case Type::ExtVector:
1475   case Type::Vector: {
1476     const VectorType *VT = cast<VectorType>(T);
1477     std::pair<uint64_t, unsigned> EltInfo = getTypeInfo(VT->getElementType());
1478     Width = EltInfo.first*VT->getNumElements();
1479     Align = Width;
1480     // If the alignment is not a power of 2, round up to the next power of 2.
1481     // This happens for non-power-of-2 length vectors.
1482     if (Align & (Align-1)) {
1483       Align = llvm::NextPowerOf2(Align);
1484       Width = llvm::RoundUpToAlignment(Width, Align);
1485     }
1486     // Adjust the alignment based on the target max.
1487     uint64_t TargetVectorAlign = Target->getMaxVectorAlign();
1488     if (TargetVectorAlign && TargetVectorAlign < Align)
1489       Align = TargetVectorAlign;
1490     break;
1491   }
1492 
1493   case Type::Builtin:
1494     switch (cast<BuiltinType>(T)->getKind()) {
1495     default: llvm_unreachable("Unknown builtin type!");
1496     case BuiltinType::Void:
1497       // GCC extension: alignof(void) = 8 bits.
1498       Width = 0;
1499       Align = 8;
1500       break;
1501 
1502     case BuiltinType::Bool:
1503       Width = Target->getBoolWidth();
1504       Align = Target->getBoolAlign();
1505       break;
1506     case BuiltinType::Char_S:
1507     case BuiltinType::Char_U:
1508     case BuiltinType::UChar:
1509     case BuiltinType::SChar:
1510       Width = Target->getCharWidth();
1511       Align = Target->getCharAlign();
1512       break;
1513     case BuiltinType::WChar_S:
1514     case BuiltinType::WChar_U:
1515       Width = Target->getWCharWidth();
1516       Align = Target->getWCharAlign();
1517       break;
1518     case BuiltinType::Char16:
1519       Width = Target->getChar16Width();
1520       Align = Target->getChar16Align();
1521       break;
1522     case BuiltinType::Char32:
1523       Width = Target->getChar32Width();
1524       Align = Target->getChar32Align();
1525       break;
1526     case BuiltinType::UShort:
1527     case BuiltinType::Short:
1528       Width = Target->getShortWidth();
1529       Align = Target->getShortAlign();
1530       break;
1531     case BuiltinType::UInt:
1532     case BuiltinType::Int:
1533       Width = Target->getIntWidth();
1534       Align = Target->getIntAlign();
1535       break;
1536     case BuiltinType::ULong:
1537     case BuiltinType::Long:
1538       Width = Target->getLongWidth();
1539       Align = Target->getLongAlign();
1540       break;
1541     case BuiltinType::ULongLong:
1542     case BuiltinType::LongLong:
1543       Width = Target->getLongLongWidth();
1544       Align = Target->getLongLongAlign();
1545       break;
1546     case BuiltinType::Int128:
1547     case BuiltinType::UInt128:
1548       Width = 128;
1549       Align = 128; // int128_t is 128-bit aligned on all targets.
1550       break;
1551     case BuiltinType::Half:
1552       Width = Target->getHalfWidth();
1553       Align = Target->getHalfAlign();
1554       break;
1555     case BuiltinType::Float:
1556       Width = Target->getFloatWidth();
1557       Align = Target->getFloatAlign();
1558       break;
1559     case BuiltinType::Double:
1560       Width = Target->getDoubleWidth();
1561       Align = Target->getDoubleAlign();
1562       break;
1563     case BuiltinType::LongDouble:
1564       Width = Target->getLongDoubleWidth();
1565       Align = Target->getLongDoubleAlign();
1566       break;
1567     case BuiltinType::NullPtr:
1568       Width = Target->getPointerWidth(0); // C++ 3.9.1p11: sizeof(nullptr_t)
1569       Align = Target->getPointerAlign(0); //   == sizeof(void*)
1570       break;
1571     case BuiltinType::ObjCId:
1572     case BuiltinType::ObjCClass:
1573     case BuiltinType::ObjCSel:
1574       Width = Target->getPointerWidth(0);
1575       Align = Target->getPointerAlign(0);
1576       break;
1577     case BuiltinType::OCLSampler:
1578       // Samplers are modeled as integers.
1579       Width = Target->getIntWidth();
1580       Align = Target->getIntAlign();
1581       break;
1582     case BuiltinType::OCLEvent:
1583     case BuiltinType::OCLImage1d:
1584     case BuiltinType::OCLImage1dArray:
1585     case BuiltinType::OCLImage1dBuffer:
1586     case BuiltinType::OCLImage2d:
1587     case BuiltinType::OCLImage2dArray:
1588     case BuiltinType::OCLImage3d:
1589       // Currently these types are pointers to opaque types.
1590       Width = Target->getPointerWidth(0);
1591       Align = Target->getPointerAlign(0);
1592       break;
1593     }
1594     break;
1595   case Type::ObjCObjectPointer:
1596     Width = Target->getPointerWidth(0);
1597     Align = Target->getPointerAlign(0);
1598     break;
1599   case Type::BlockPointer: {
1600     unsigned AS = getTargetAddressSpace(
1601         cast<BlockPointerType>(T)->getPointeeType());
1602     Width = Target->getPointerWidth(AS);
1603     Align = Target->getPointerAlign(AS);
1604     break;
1605   }
1606   case Type::LValueReference:
1607   case Type::RValueReference: {
1608     // alignof and sizeof should never enter this code path here, so we go
1609     // the pointer route.
1610     unsigned AS = getTargetAddressSpace(
1611         cast<ReferenceType>(T)->getPointeeType());
1612     Width = Target->getPointerWidth(AS);
1613     Align = Target->getPointerAlign(AS);
1614     break;
1615   }
1616   case Type::Pointer: {
1617     unsigned AS = getTargetAddressSpace(cast<PointerType>(T)->getPointeeType());
1618     Width = Target->getPointerWidth(AS);
1619     Align = Target->getPointerAlign(AS);
1620     break;
1621   }
1622   case Type::MemberPointer: {
1623     const MemberPointerType *MPT = cast<MemberPointerType>(T);
1624     llvm::tie(Width, Align) = ABI->getMemberPointerWidthAndAlign(MPT);
1625     break;
1626   }
1627   case Type::Complex: {
1628     // Complex types have the same alignment as their elements, but twice the
1629     // size.
1630     std::pair<uint64_t, unsigned> EltInfo =
1631       getTypeInfo(cast<ComplexType>(T)->getElementType());
1632     Width = EltInfo.first*2;
1633     Align = EltInfo.second;
1634     break;
1635   }
1636   case Type::ObjCObject:
1637     return getTypeInfo(cast<ObjCObjectType>(T)->getBaseType().getTypePtr());
1638   case Type::Adjusted:
1639   case Type::Decayed:
1640     return getTypeInfo(cast<AdjustedType>(T)->getAdjustedType().getTypePtr());
1641   case Type::ObjCInterface: {
1642     const ObjCInterfaceType *ObjCI = cast<ObjCInterfaceType>(T);
1643     const ASTRecordLayout &Layout = getASTObjCInterfaceLayout(ObjCI->getDecl());
1644     Width = toBits(Layout.getSize());
1645     Align = toBits(Layout.getAlignment());
1646     break;
1647   }
1648   case Type::Record:
1649   case Type::Enum: {
1650     const TagType *TT = cast<TagType>(T);
1651 
1652     if (TT->getDecl()->isInvalidDecl()) {
1653       Width = 8;
1654       Align = 8;
1655       break;
1656     }
1657 
1658     if (const EnumType *ET = dyn_cast<EnumType>(TT))
1659       return getTypeInfo(ET->getDecl()->getIntegerType());
1660 
1661     const RecordType *RT = cast<RecordType>(TT);
1662     const ASTRecordLayout &Layout = getASTRecordLayout(RT->getDecl());
1663     Width = toBits(Layout.getSize());
1664     Align = toBits(Layout.getAlignment());
1665     break;
1666   }
1667 
1668   case Type::SubstTemplateTypeParm:
1669     return getTypeInfo(cast<SubstTemplateTypeParmType>(T)->
1670                        getReplacementType().getTypePtr());
1671 
1672   case Type::Auto: {
1673     const AutoType *A = cast<AutoType>(T);
1674     assert(!A->getDeducedType().isNull() &&
1675            "cannot request the size of an undeduced or dependent auto type");
1676     return getTypeInfo(A->getDeducedType().getTypePtr());
1677   }
1678 
1679   case Type::Paren:
1680     return getTypeInfo(cast<ParenType>(T)->getInnerType().getTypePtr());
1681 
1682   case Type::Typedef: {
1683     const TypedefNameDecl *Typedef = cast<TypedefType>(T)->getDecl();
1684     std::pair<uint64_t, unsigned> Info
1685       = getTypeInfo(Typedef->getUnderlyingType().getTypePtr());
1686     // If the typedef has an aligned attribute on it, it overrides any computed
1687     // alignment we have.  This violates the GCC documentation (which says that
1688     // attribute(aligned) can only round up) but matches its implementation.
1689     if (unsigned AttrAlign = Typedef->getMaxAlignment())
1690       Align = AttrAlign;
1691     else
1692       Align = Info.second;
1693     Width = Info.first;
1694     break;
1695   }
1696 
1697   case Type::Elaborated:
1698     return getTypeInfo(cast<ElaboratedType>(T)->getNamedType().getTypePtr());
1699 
1700   case Type::Attributed:
1701     return getTypeInfo(
1702                   cast<AttributedType>(T)->getEquivalentType().getTypePtr());
1703 
1704   case Type::Atomic: {
1705     // Start with the base type information.
1706     std::pair<uint64_t, unsigned> Info
1707       = getTypeInfo(cast<AtomicType>(T)->getValueType());
1708     Width = Info.first;
1709     Align = Info.second;
1710 
1711     // If the size of the type doesn't exceed the platform's max
1712     // atomic promotion width, make the size and alignment more
1713     // favorable to atomic operations:
1714     if (Width != 0 && Width <= Target->getMaxAtomicPromoteWidth()) {
1715       // Round the size up to a power of 2.
1716       if (!llvm::isPowerOf2_64(Width))
1717         Width = llvm::NextPowerOf2(Width);
1718 
1719       // Set the alignment equal to the size.
1720       Align = static_cast<unsigned>(Width);
1721     }
1722   }
1723 
1724   }
1725 
1726   assert(llvm::isPowerOf2_32(Align) && "Alignment must be power of 2");
1727   return std::make_pair(Width, Align);
1728 }
1729 
1730 /// toCharUnitsFromBits - Convert a size in bits to a size in characters.
1731 CharUnits ASTContext::toCharUnitsFromBits(int64_t BitSize) const {
1732   return CharUnits::fromQuantity(BitSize / getCharWidth());
1733 }
1734 
1735 /// toBits - Convert a size in characters to a size in characters.
1736 int64_t ASTContext::toBits(CharUnits CharSize) const {
1737   return CharSize.getQuantity() * getCharWidth();
1738 }
1739 
1740 /// getTypeSizeInChars - Return the size of the specified type, in characters.
1741 /// This method does not work on incomplete types.
1742 CharUnits ASTContext::getTypeSizeInChars(QualType T) const {
1743   return getTypeInfoInChars(T).first;
1744 }
1745 CharUnits ASTContext::getTypeSizeInChars(const Type *T) const {
1746   return getTypeInfoInChars(T).first;
1747 }
1748 
1749 /// getTypeAlignInChars - Return the ABI-specified alignment of a type, in
1750 /// characters. This method does not work on incomplete types.
1751 CharUnits ASTContext::getTypeAlignInChars(QualType T) const {
1752   return toCharUnitsFromBits(getTypeAlign(T));
1753 }
1754 CharUnits ASTContext::getTypeAlignInChars(const Type *T) const {
1755   return toCharUnitsFromBits(getTypeAlign(T));
1756 }
1757 
1758 /// getPreferredTypeAlign - Return the "preferred" alignment of the specified
1759 /// type for the current target in bits.  This can be different than the ABI
1760 /// alignment in cases where it is beneficial for performance to overalign
1761 /// a data type.
1762 unsigned ASTContext::getPreferredTypeAlign(const Type *T) const {
1763   unsigned ABIAlign = getTypeAlign(T);
1764 
1765   if (Target->getTriple().getArch() == llvm::Triple::xcore)
1766     return ABIAlign;  // Never overalign on XCore.
1767 
1768   // Double and long long should be naturally aligned if possible.
1769   if (const ComplexType* CT = T->getAs<ComplexType>())
1770     T = CT->getElementType().getTypePtr();
1771   if (T->isSpecificBuiltinType(BuiltinType::Double) ||
1772       T->isSpecificBuiltinType(BuiltinType::LongLong) ||
1773       T->isSpecificBuiltinType(BuiltinType::ULongLong))
1774     return std::max(ABIAlign, (unsigned)getTypeSize(T));
1775 
1776   return ABIAlign;
1777 }
1778 
1779 /// getAlignOfGlobalVar - Return the alignment in bits that should be given
1780 /// to a global variable of the specified type.
1781 unsigned ASTContext::getAlignOfGlobalVar(QualType T) const {
1782   return std::max(getTypeAlign(T), getTargetInfo().getMinGlobalAlign());
1783 }
1784 
1785 /// getAlignOfGlobalVarInChars - Return the alignment in characters that
1786 /// should be given to a global variable of the specified type.
1787 CharUnits ASTContext::getAlignOfGlobalVarInChars(QualType T) const {
1788   return toCharUnitsFromBits(getAlignOfGlobalVar(T));
1789 }
1790 
1791 /// DeepCollectObjCIvars -
1792 /// This routine first collects all declared, but not synthesized, ivars in
1793 /// super class and then collects all ivars, including those synthesized for
1794 /// current class. This routine is used for implementation of current class
1795 /// when all ivars, declared and synthesized are known.
1796 ///
1797 void ASTContext::DeepCollectObjCIvars(const ObjCInterfaceDecl *OI,
1798                                       bool leafClass,
1799                             SmallVectorImpl<const ObjCIvarDecl*> &Ivars) const {
1800   if (const ObjCInterfaceDecl *SuperClass = OI->getSuperClass())
1801     DeepCollectObjCIvars(SuperClass, false, Ivars);
1802   if (!leafClass) {
1803     for (ObjCInterfaceDecl::ivar_iterator I = OI->ivar_begin(),
1804          E = OI->ivar_end(); I != E; ++I)
1805       Ivars.push_back(*I);
1806   } else {
1807     ObjCInterfaceDecl *IDecl = const_cast<ObjCInterfaceDecl *>(OI);
1808     for (const ObjCIvarDecl *Iv = IDecl->all_declared_ivar_begin(); Iv;
1809          Iv= Iv->getNextIvar())
1810       Ivars.push_back(Iv);
1811   }
1812 }
1813 
1814 /// CollectInheritedProtocols - Collect all protocols in current class and
1815 /// those inherited by it.
1816 void ASTContext::CollectInheritedProtocols(const Decl *CDecl,
1817                           llvm::SmallPtrSet<ObjCProtocolDecl*, 8> &Protocols) {
1818   if (const ObjCInterfaceDecl *OI = dyn_cast<ObjCInterfaceDecl>(CDecl)) {
1819     // We can use protocol_iterator here instead of
1820     // all_referenced_protocol_iterator since we are walking all categories.
1821     for (ObjCInterfaceDecl::all_protocol_iterator P = OI->all_referenced_protocol_begin(),
1822          PE = OI->all_referenced_protocol_end(); P != PE; ++P) {
1823       ObjCProtocolDecl *Proto = (*P);
1824       Protocols.insert(Proto->getCanonicalDecl());
1825       for (ObjCProtocolDecl::protocol_iterator P = Proto->protocol_begin(),
1826            PE = Proto->protocol_end(); P != PE; ++P) {
1827         Protocols.insert((*P)->getCanonicalDecl());
1828         CollectInheritedProtocols(*P, Protocols);
1829       }
1830     }
1831 
1832     // Categories of this Interface.
1833     for (ObjCInterfaceDecl::visible_categories_iterator
1834            Cat = OI->visible_categories_begin(),
1835            CatEnd = OI->visible_categories_end();
1836          Cat != CatEnd; ++Cat) {
1837       CollectInheritedProtocols(*Cat, Protocols);
1838     }
1839 
1840     if (ObjCInterfaceDecl *SD = OI->getSuperClass())
1841       while (SD) {
1842         CollectInheritedProtocols(SD, Protocols);
1843         SD = SD->getSuperClass();
1844       }
1845   } else if (const ObjCCategoryDecl *OC = dyn_cast<ObjCCategoryDecl>(CDecl)) {
1846     for (ObjCCategoryDecl::protocol_iterator P = OC->protocol_begin(),
1847          PE = OC->protocol_end(); P != PE; ++P) {
1848       ObjCProtocolDecl *Proto = (*P);
1849       Protocols.insert(Proto->getCanonicalDecl());
1850       for (ObjCProtocolDecl::protocol_iterator P = Proto->protocol_begin(),
1851            PE = Proto->protocol_end(); P != PE; ++P)
1852         CollectInheritedProtocols(*P, Protocols);
1853     }
1854   } else if (const ObjCProtocolDecl *OP = dyn_cast<ObjCProtocolDecl>(CDecl)) {
1855     for (ObjCProtocolDecl::protocol_iterator P = OP->protocol_begin(),
1856          PE = OP->protocol_end(); P != PE; ++P) {
1857       ObjCProtocolDecl *Proto = (*P);
1858       Protocols.insert(Proto->getCanonicalDecl());
1859       for (ObjCProtocolDecl::protocol_iterator P = Proto->protocol_begin(),
1860            PE = Proto->protocol_end(); P != PE; ++P)
1861         CollectInheritedProtocols(*P, Protocols);
1862     }
1863   }
1864 }
1865 
1866 unsigned ASTContext::CountNonClassIvars(const ObjCInterfaceDecl *OI) const {
1867   unsigned count = 0;
1868   // Count ivars declared in class extension.
1869   for (ObjCInterfaceDecl::known_extensions_iterator
1870          Ext = OI->known_extensions_begin(),
1871          ExtEnd = OI->known_extensions_end();
1872        Ext != ExtEnd; ++Ext) {
1873     count += Ext->ivar_size();
1874   }
1875 
1876   // Count ivar defined in this class's implementation.  This
1877   // includes synthesized ivars.
1878   if (ObjCImplementationDecl *ImplDecl = OI->getImplementation())
1879     count += ImplDecl->ivar_size();
1880 
1881   return count;
1882 }
1883 
1884 bool ASTContext::isSentinelNullExpr(const Expr *E) {
1885   if (!E)
1886     return false;
1887 
1888   // nullptr_t is always treated as null.
1889   if (E->getType()->isNullPtrType()) return true;
1890 
1891   if (E->getType()->isAnyPointerType() &&
1892       E->IgnoreParenCasts()->isNullPointerConstant(*this,
1893                                                 Expr::NPC_ValueDependentIsNull))
1894     return true;
1895 
1896   // Unfortunately, __null has type 'int'.
1897   if (isa<GNUNullExpr>(E)) return true;
1898 
1899   return false;
1900 }
1901 
1902 /// \brief Get the implementation of ObjCInterfaceDecl,or NULL if none exists.
1903 ObjCImplementationDecl *ASTContext::getObjCImplementation(ObjCInterfaceDecl *D) {
1904   llvm::DenseMap<ObjCContainerDecl*, ObjCImplDecl*>::iterator
1905     I = ObjCImpls.find(D);
1906   if (I != ObjCImpls.end())
1907     return cast<ObjCImplementationDecl>(I->second);
1908   return 0;
1909 }
1910 /// \brief Get the implementation of ObjCCategoryDecl, or NULL if none exists.
1911 ObjCCategoryImplDecl *ASTContext::getObjCImplementation(ObjCCategoryDecl *D) {
1912   llvm::DenseMap<ObjCContainerDecl*, ObjCImplDecl*>::iterator
1913     I = ObjCImpls.find(D);
1914   if (I != ObjCImpls.end())
1915     return cast<ObjCCategoryImplDecl>(I->second);
1916   return 0;
1917 }
1918 
1919 /// \brief Set the implementation of ObjCInterfaceDecl.
1920 void ASTContext::setObjCImplementation(ObjCInterfaceDecl *IFaceD,
1921                            ObjCImplementationDecl *ImplD) {
1922   assert(IFaceD && ImplD && "Passed null params");
1923   ObjCImpls[IFaceD] = ImplD;
1924 }
1925 /// \brief Set the implementation of ObjCCategoryDecl.
1926 void ASTContext::setObjCImplementation(ObjCCategoryDecl *CatD,
1927                            ObjCCategoryImplDecl *ImplD) {
1928   assert(CatD && ImplD && "Passed null params");
1929   ObjCImpls[CatD] = ImplD;
1930 }
1931 
1932 const ObjCInterfaceDecl *ASTContext::getObjContainingInterface(
1933                                               const NamedDecl *ND) const {
1934   if (const ObjCInterfaceDecl *ID =
1935           dyn_cast<ObjCInterfaceDecl>(ND->getDeclContext()))
1936     return ID;
1937   if (const ObjCCategoryDecl *CD =
1938           dyn_cast<ObjCCategoryDecl>(ND->getDeclContext()))
1939     return CD->getClassInterface();
1940   if (const ObjCImplDecl *IMD =
1941           dyn_cast<ObjCImplDecl>(ND->getDeclContext()))
1942     return IMD->getClassInterface();
1943 
1944   return 0;
1945 }
1946 
1947 /// \brief Get the copy initialization expression of VarDecl,or NULL if
1948 /// none exists.
1949 Expr *ASTContext::getBlockVarCopyInits(const VarDecl*VD) {
1950   assert(VD && "Passed null params");
1951   assert(VD->hasAttr<BlocksAttr>() &&
1952          "getBlockVarCopyInits - not __block var");
1953   llvm::DenseMap<const VarDecl*, Expr*>::iterator
1954     I = BlockVarCopyInits.find(VD);
1955   return (I != BlockVarCopyInits.end()) ? cast<Expr>(I->second) : 0;
1956 }
1957 
1958 /// \brief Set the copy inialization expression of a block var decl.
1959 void ASTContext::setBlockVarCopyInits(VarDecl*VD, Expr* Init) {
1960   assert(VD && Init && "Passed null params");
1961   assert(VD->hasAttr<BlocksAttr>() &&
1962          "setBlockVarCopyInits - not __block var");
1963   BlockVarCopyInits[VD] = Init;
1964 }
1965 
1966 TypeSourceInfo *ASTContext::CreateTypeSourceInfo(QualType T,
1967                                                  unsigned DataSize) const {
1968   if (!DataSize)
1969     DataSize = TypeLoc::getFullDataSizeForType(T);
1970   else
1971     assert(DataSize == TypeLoc::getFullDataSizeForType(T) &&
1972            "incorrect data size provided to CreateTypeSourceInfo!");
1973 
1974   TypeSourceInfo *TInfo =
1975     (TypeSourceInfo*)BumpAlloc.Allocate(sizeof(TypeSourceInfo) + DataSize, 8);
1976   new (TInfo) TypeSourceInfo(T);
1977   return TInfo;
1978 }
1979 
1980 TypeSourceInfo *ASTContext::getTrivialTypeSourceInfo(QualType T,
1981                                                      SourceLocation L) const {
1982   TypeSourceInfo *DI = CreateTypeSourceInfo(T);
1983   DI->getTypeLoc().initialize(const_cast<ASTContext &>(*this), L);
1984   return DI;
1985 }
1986 
1987 const ASTRecordLayout &
1988 ASTContext::getASTObjCInterfaceLayout(const ObjCInterfaceDecl *D) const {
1989   return getObjCLayout(D, 0);
1990 }
1991 
1992 const ASTRecordLayout &
1993 ASTContext::getASTObjCImplementationLayout(
1994                                         const ObjCImplementationDecl *D) const {
1995   return getObjCLayout(D->getClassInterface(), D);
1996 }
1997 
1998 //===----------------------------------------------------------------------===//
1999 //                   Type creation/memoization methods
2000 //===----------------------------------------------------------------------===//
2001 
2002 QualType
2003 ASTContext::getExtQualType(const Type *baseType, Qualifiers quals) const {
2004   unsigned fastQuals = quals.getFastQualifiers();
2005   quals.removeFastQualifiers();
2006 
2007   // Check if we've already instantiated this type.
2008   llvm::FoldingSetNodeID ID;
2009   ExtQuals::Profile(ID, baseType, quals);
2010   void *insertPos = 0;
2011   if (ExtQuals *eq = ExtQualNodes.FindNodeOrInsertPos(ID, insertPos)) {
2012     assert(eq->getQualifiers() == quals);
2013     return QualType(eq, fastQuals);
2014   }
2015 
2016   // If the base type is not canonical, make the appropriate canonical type.
2017   QualType canon;
2018   if (!baseType->isCanonicalUnqualified()) {
2019     SplitQualType canonSplit = baseType->getCanonicalTypeInternal().split();
2020     canonSplit.Quals.addConsistentQualifiers(quals);
2021     canon = getExtQualType(canonSplit.Ty, canonSplit.Quals);
2022 
2023     // Re-find the insert position.
2024     (void) ExtQualNodes.FindNodeOrInsertPos(ID, insertPos);
2025   }
2026 
2027   ExtQuals *eq = new (*this, TypeAlignment) ExtQuals(baseType, canon, quals);
2028   ExtQualNodes.InsertNode(eq, insertPos);
2029   return QualType(eq, fastQuals);
2030 }
2031 
2032 QualType
2033 ASTContext::getAddrSpaceQualType(QualType T, unsigned AddressSpace) const {
2034   QualType CanT = getCanonicalType(T);
2035   if (CanT.getAddressSpace() == AddressSpace)
2036     return T;
2037 
2038   // If we are composing extended qualifiers together, merge together
2039   // into one ExtQuals node.
2040   QualifierCollector Quals;
2041   const Type *TypeNode = Quals.strip(T);
2042 
2043   // If this type already has an address space specified, it cannot get
2044   // another one.
2045   assert(!Quals.hasAddressSpace() &&
2046          "Type cannot be in multiple addr spaces!");
2047   Quals.addAddressSpace(AddressSpace);
2048 
2049   return getExtQualType(TypeNode, Quals);
2050 }
2051 
2052 QualType ASTContext::getObjCGCQualType(QualType T,
2053                                        Qualifiers::GC GCAttr) const {
2054   QualType CanT = getCanonicalType(T);
2055   if (CanT.getObjCGCAttr() == GCAttr)
2056     return T;
2057 
2058   if (const PointerType *ptr = T->getAs<PointerType>()) {
2059     QualType Pointee = ptr->getPointeeType();
2060     if (Pointee->isAnyPointerType()) {
2061       QualType ResultType = getObjCGCQualType(Pointee, GCAttr);
2062       return getPointerType(ResultType);
2063     }
2064   }
2065 
2066   // If we are composing extended qualifiers together, merge together
2067   // into one ExtQuals node.
2068   QualifierCollector Quals;
2069   const Type *TypeNode = Quals.strip(T);
2070 
2071   // If this type already has an ObjCGC specified, it cannot get
2072   // another one.
2073   assert(!Quals.hasObjCGCAttr() &&
2074          "Type cannot have multiple ObjCGCs!");
2075   Quals.addObjCGCAttr(GCAttr);
2076 
2077   return getExtQualType(TypeNode, Quals);
2078 }
2079 
2080 const FunctionType *ASTContext::adjustFunctionType(const FunctionType *T,
2081                                                    FunctionType::ExtInfo Info) {
2082   if (T->getExtInfo() == Info)
2083     return T;
2084 
2085   QualType Result;
2086   if (const FunctionNoProtoType *FNPT = dyn_cast<FunctionNoProtoType>(T)) {
2087     Result = getFunctionNoProtoType(FNPT->getReturnType(), Info);
2088   } else {
2089     const FunctionProtoType *FPT = cast<FunctionProtoType>(T);
2090     FunctionProtoType::ExtProtoInfo EPI = FPT->getExtProtoInfo();
2091     EPI.ExtInfo = Info;
2092     Result = getFunctionType(FPT->getReturnType(), FPT->getParamTypes(), EPI);
2093   }
2094 
2095   return cast<FunctionType>(Result.getTypePtr());
2096 }
2097 
2098 void ASTContext::adjustDeducedFunctionResultType(FunctionDecl *FD,
2099                                                  QualType ResultType) {
2100   FD = FD->getMostRecentDecl();
2101   while (true) {
2102     const FunctionProtoType *FPT = FD->getType()->castAs<FunctionProtoType>();
2103     FunctionProtoType::ExtProtoInfo EPI = FPT->getExtProtoInfo();
2104     FD->setType(getFunctionType(ResultType, FPT->getParamTypes(), EPI));
2105     if (FunctionDecl *Next = FD->getPreviousDecl())
2106       FD = Next;
2107     else
2108       break;
2109   }
2110   if (ASTMutationListener *L = getASTMutationListener())
2111     L->DeducedReturnType(FD, ResultType);
2112 }
2113 
2114 /// getComplexType - Return the uniqued reference to the type for a complex
2115 /// number with the specified element type.
2116 QualType ASTContext::getComplexType(QualType T) const {
2117   // Unique pointers, to guarantee there is only one pointer of a particular
2118   // structure.
2119   llvm::FoldingSetNodeID ID;
2120   ComplexType::Profile(ID, T);
2121 
2122   void *InsertPos = 0;
2123   if (ComplexType *CT = ComplexTypes.FindNodeOrInsertPos(ID, InsertPos))
2124     return QualType(CT, 0);
2125 
2126   // If the pointee type isn't canonical, this won't be a canonical type either,
2127   // so fill in the canonical type field.
2128   QualType Canonical;
2129   if (!T.isCanonical()) {
2130     Canonical = getComplexType(getCanonicalType(T));
2131 
2132     // Get the new insert position for the node we care about.
2133     ComplexType *NewIP = ComplexTypes.FindNodeOrInsertPos(ID, InsertPos);
2134     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2135   }
2136   ComplexType *New = new (*this, TypeAlignment) ComplexType(T, Canonical);
2137   Types.push_back(New);
2138   ComplexTypes.InsertNode(New, InsertPos);
2139   return QualType(New, 0);
2140 }
2141 
2142 /// getPointerType - Return the uniqued reference to the type for a pointer to
2143 /// the specified type.
2144 QualType ASTContext::getPointerType(QualType T) const {
2145   // Unique pointers, to guarantee there is only one pointer of a particular
2146   // structure.
2147   llvm::FoldingSetNodeID ID;
2148   PointerType::Profile(ID, T);
2149 
2150   void *InsertPos = 0;
2151   if (PointerType *PT = PointerTypes.FindNodeOrInsertPos(ID, InsertPos))
2152     return QualType(PT, 0);
2153 
2154   // If the pointee type isn't canonical, this won't be a canonical type either,
2155   // so fill in the canonical type field.
2156   QualType Canonical;
2157   if (!T.isCanonical()) {
2158     Canonical = getPointerType(getCanonicalType(T));
2159 
2160     // Get the new insert position for the node we care about.
2161     PointerType *NewIP = PointerTypes.FindNodeOrInsertPos(ID, InsertPos);
2162     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2163   }
2164   PointerType *New = new (*this, TypeAlignment) PointerType(T, Canonical);
2165   Types.push_back(New);
2166   PointerTypes.InsertNode(New, InsertPos);
2167   return QualType(New, 0);
2168 }
2169 
2170 QualType ASTContext::getAdjustedType(QualType Orig, QualType New) const {
2171   llvm::FoldingSetNodeID ID;
2172   AdjustedType::Profile(ID, Orig, New);
2173   void *InsertPos = 0;
2174   AdjustedType *AT = AdjustedTypes.FindNodeOrInsertPos(ID, InsertPos);
2175   if (AT)
2176     return QualType(AT, 0);
2177 
2178   QualType Canonical = getCanonicalType(New);
2179 
2180   // Get the new insert position for the node we care about.
2181   AT = AdjustedTypes.FindNodeOrInsertPos(ID, InsertPos);
2182   assert(AT == 0 && "Shouldn't be in the map!");
2183 
2184   AT = new (*this, TypeAlignment)
2185       AdjustedType(Type::Adjusted, Orig, New, Canonical);
2186   Types.push_back(AT);
2187   AdjustedTypes.InsertNode(AT, InsertPos);
2188   return QualType(AT, 0);
2189 }
2190 
2191 QualType ASTContext::getDecayedType(QualType T) const {
2192   assert((T->isArrayType() || T->isFunctionType()) && "T does not decay");
2193 
2194   QualType Decayed;
2195 
2196   // C99 6.7.5.3p7:
2197   //   A declaration of a parameter as "array of type" shall be
2198   //   adjusted to "qualified pointer to type", where the type
2199   //   qualifiers (if any) are those specified within the [ and ] of
2200   //   the array type derivation.
2201   if (T->isArrayType())
2202     Decayed = getArrayDecayedType(T);
2203 
2204   // C99 6.7.5.3p8:
2205   //   A declaration of a parameter as "function returning type"
2206   //   shall be adjusted to "pointer to function returning type", as
2207   //   in 6.3.2.1.
2208   if (T->isFunctionType())
2209     Decayed = getPointerType(T);
2210 
2211   llvm::FoldingSetNodeID ID;
2212   AdjustedType::Profile(ID, T, Decayed);
2213   void *InsertPos = 0;
2214   AdjustedType *AT = AdjustedTypes.FindNodeOrInsertPos(ID, InsertPos);
2215   if (AT)
2216     return QualType(AT, 0);
2217 
2218   QualType Canonical = getCanonicalType(Decayed);
2219 
2220   // Get the new insert position for the node we care about.
2221   AT = AdjustedTypes.FindNodeOrInsertPos(ID, InsertPos);
2222   assert(AT == 0 && "Shouldn't be in the map!");
2223 
2224   AT = new (*this, TypeAlignment) DecayedType(T, Decayed, Canonical);
2225   Types.push_back(AT);
2226   AdjustedTypes.InsertNode(AT, InsertPos);
2227   return QualType(AT, 0);
2228 }
2229 
2230 /// getBlockPointerType - Return the uniqued reference to the type for
2231 /// a pointer to the specified block.
2232 QualType ASTContext::getBlockPointerType(QualType T) const {
2233   assert(T->isFunctionType() && "block of function types only");
2234   // Unique pointers, to guarantee there is only one block of a particular
2235   // structure.
2236   llvm::FoldingSetNodeID ID;
2237   BlockPointerType::Profile(ID, T);
2238 
2239   void *InsertPos = 0;
2240   if (BlockPointerType *PT =
2241         BlockPointerTypes.FindNodeOrInsertPos(ID, InsertPos))
2242     return QualType(PT, 0);
2243 
2244   // If the block pointee type isn't canonical, this won't be a canonical
2245   // type either so fill in the canonical type field.
2246   QualType Canonical;
2247   if (!T.isCanonical()) {
2248     Canonical = getBlockPointerType(getCanonicalType(T));
2249 
2250     // Get the new insert position for the node we care about.
2251     BlockPointerType *NewIP =
2252       BlockPointerTypes.FindNodeOrInsertPos(ID, InsertPos);
2253     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2254   }
2255   BlockPointerType *New
2256     = new (*this, TypeAlignment) BlockPointerType(T, Canonical);
2257   Types.push_back(New);
2258   BlockPointerTypes.InsertNode(New, InsertPos);
2259   return QualType(New, 0);
2260 }
2261 
2262 /// getLValueReferenceType - Return the uniqued reference to the type for an
2263 /// lvalue reference to the specified type.
2264 QualType
2265 ASTContext::getLValueReferenceType(QualType T, bool SpelledAsLValue) const {
2266   assert(getCanonicalType(T) != OverloadTy &&
2267          "Unresolved overloaded function type");
2268 
2269   // Unique pointers, to guarantee there is only one pointer of a particular
2270   // structure.
2271   llvm::FoldingSetNodeID ID;
2272   ReferenceType::Profile(ID, T, SpelledAsLValue);
2273 
2274   void *InsertPos = 0;
2275   if (LValueReferenceType *RT =
2276         LValueReferenceTypes.FindNodeOrInsertPos(ID, InsertPos))
2277     return QualType(RT, 0);
2278 
2279   const ReferenceType *InnerRef = T->getAs<ReferenceType>();
2280 
2281   // If the referencee type isn't canonical, this won't be a canonical type
2282   // either, so fill in the canonical type field.
2283   QualType Canonical;
2284   if (!SpelledAsLValue || InnerRef || !T.isCanonical()) {
2285     QualType PointeeType = (InnerRef ? InnerRef->getPointeeType() : T);
2286     Canonical = getLValueReferenceType(getCanonicalType(PointeeType));
2287 
2288     // Get the new insert position for the node we care about.
2289     LValueReferenceType *NewIP =
2290       LValueReferenceTypes.FindNodeOrInsertPos(ID, InsertPos);
2291     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2292   }
2293 
2294   LValueReferenceType *New
2295     = new (*this, TypeAlignment) LValueReferenceType(T, Canonical,
2296                                                      SpelledAsLValue);
2297   Types.push_back(New);
2298   LValueReferenceTypes.InsertNode(New, InsertPos);
2299 
2300   return QualType(New, 0);
2301 }
2302 
2303 /// getRValueReferenceType - Return the uniqued reference to the type for an
2304 /// rvalue reference to the specified type.
2305 QualType ASTContext::getRValueReferenceType(QualType T) const {
2306   // Unique pointers, to guarantee there is only one pointer of a particular
2307   // structure.
2308   llvm::FoldingSetNodeID ID;
2309   ReferenceType::Profile(ID, T, false);
2310 
2311   void *InsertPos = 0;
2312   if (RValueReferenceType *RT =
2313         RValueReferenceTypes.FindNodeOrInsertPos(ID, InsertPos))
2314     return QualType(RT, 0);
2315 
2316   const ReferenceType *InnerRef = T->getAs<ReferenceType>();
2317 
2318   // If the referencee type isn't canonical, this won't be a canonical type
2319   // either, so fill in the canonical type field.
2320   QualType Canonical;
2321   if (InnerRef || !T.isCanonical()) {
2322     QualType PointeeType = (InnerRef ? InnerRef->getPointeeType() : T);
2323     Canonical = getRValueReferenceType(getCanonicalType(PointeeType));
2324 
2325     // Get the new insert position for the node we care about.
2326     RValueReferenceType *NewIP =
2327       RValueReferenceTypes.FindNodeOrInsertPos(ID, InsertPos);
2328     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2329   }
2330 
2331   RValueReferenceType *New
2332     = new (*this, TypeAlignment) RValueReferenceType(T, Canonical);
2333   Types.push_back(New);
2334   RValueReferenceTypes.InsertNode(New, InsertPos);
2335   return QualType(New, 0);
2336 }
2337 
2338 /// getMemberPointerType - Return the uniqued reference to the type for a
2339 /// member pointer to the specified type, in the specified class.
2340 QualType ASTContext::getMemberPointerType(QualType T, const Type *Cls) const {
2341   // Unique pointers, to guarantee there is only one pointer of a particular
2342   // structure.
2343   llvm::FoldingSetNodeID ID;
2344   MemberPointerType::Profile(ID, T, Cls);
2345 
2346   void *InsertPos = 0;
2347   if (MemberPointerType *PT =
2348       MemberPointerTypes.FindNodeOrInsertPos(ID, InsertPos))
2349     return QualType(PT, 0);
2350 
2351   // If the pointee or class type isn't canonical, this won't be a canonical
2352   // type either, so fill in the canonical type field.
2353   QualType Canonical;
2354   if (!T.isCanonical() || !Cls->isCanonicalUnqualified()) {
2355     Canonical = getMemberPointerType(getCanonicalType(T),getCanonicalType(Cls));
2356 
2357     // Get the new insert position for the node we care about.
2358     MemberPointerType *NewIP =
2359       MemberPointerTypes.FindNodeOrInsertPos(ID, InsertPos);
2360     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2361   }
2362   MemberPointerType *New
2363     = new (*this, TypeAlignment) MemberPointerType(T, Cls, Canonical);
2364   Types.push_back(New);
2365   MemberPointerTypes.InsertNode(New, InsertPos);
2366   return QualType(New, 0);
2367 }
2368 
2369 /// getConstantArrayType - Return the unique reference to the type for an
2370 /// array of the specified element type.
2371 QualType ASTContext::getConstantArrayType(QualType EltTy,
2372                                           const llvm::APInt &ArySizeIn,
2373                                           ArrayType::ArraySizeModifier ASM,
2374                                           unsigned IndexTypeQuals) const {
2375   assert((EltTy->isDependentType() ||
2376           EltTy->isIncompleteType() || EltTy->isConstantSizeType()) &&
2377          "Constant array of VLAs is illegal!");
2378 
2379   // Convert the array size into a canonical width matching the pointer size for
2380   // the target.
2381   llvm::APInt ArySize(ArySizeIn);
2382   ArySize =
2383     ArySize.zextOrTrunc(Target->getPointerWidth(getTargetAddressSpace(EltTy)));
2384 
2385   llvm::FoldingSetNodeID ID;
2386   ConstantArrayType::Profile(ID, EltTy, ArySize, ASM, IndexTypeQuals);
2387 
2388   void *InsertPos = 0;
2389   if (ConstantArrayType *ATP =
2390       ConstantArrayTypes.FindNodeOrInsertPos(ID, InsertPos))
2391     return QualType(ATP, 0);
2392 
2393   // If the element type isn't canonical or has qualifiers, this won't
2394   // be a canonical type either, so fill in the canonical type field.
2395   QualType Canon;
2396   if (!EltTy.isCanonical() || EltTy.hasLocalQualifiers()) {
2397     SplitQualType canonSplit = getCanonicalType(EltTy).split();
2398     Canon = getConstantArrayType(QualType(canonSplit.Ty, 0), ArySize,
2399                                  ASM, IndexTypeQuals);
2400     Canon = getQualifiedType(Canon, canonSplit.Quals);
2401 
2402     // Get the new insert position for the node we care about.
2403     ConstantArrayType *NewIP =
2404       ConstantArrayTypes.FindNodeOrInsertPos(ID, InsertPos);
2405     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2406   }
2407 
2408   ConstantArrayType *New = new(*this,TypeAlignment)
2409     ConstantArrayType(EltTy, Canon, ArySize, ASM, IndexTypeQuals);
2410   ConstantArrayTypes.InsertNode(New, InsertPos);
2411   Types.push_back(New);
2412   return QualType(New, 0);
2413 }
2414 
2415 /// getVariableArrayDecayedType - Turns the given type, which may be
2416 /// variably-modified, into the corresponding type with all the known
2417 /// sizes replaced with [*].
2418 QualType ASTContext::getVariableArrayDecayedType(QualType type) const {
2419   // Vastly most common case.
2420   if (!type->isVariablyModifiedType()) return type;
2421 
2422   QualType result;
2423 
2424   SplitQualType split = type.getSplitDesugaredType();
2425   const Type *ty = split.Ty;
2426   switch (ty->getTypeClass()) {
2427 #define TYPE(Class, Base)
2428 #define ABSTRACT_TYPE(Class, Base)
2429 #define NON_CANONICAL_TYPE(Class, Base) case Type::Class:
2430 #include "clang/AST/TypeNodes.def"
2431     llvm_unreachable("didn't desugar past all non-canonical types?");
2432 
2433   // These types should never be variably-modified.
2434   case Type::Builtin:
2435   case Type::Complex:
2436   case Type::Vector:
2437   case Type::ExtVector:
2438   case Type::DependentSizedExtVector:
2439   case Type::ObjCObject:
2440   case Type::ObjCInterface:
2441   case Type::ObjCObjectPointer:
2442   case Type::Record:
2443   case Type::Enum:
2444   case Type::UnresolvedUsing:
2445   case Type::TypeOfExpr:
2446   case Type::TypeOf:
2447   case Type::Decltype:
2448   case Type::UnaryTransform:
2449   case Type::DependentName:
2450   case Type::InjectedClassName:
2451   case Type::TemplateSpecialization:
2452   case Type::DependentTemplateSpecialization:
2453   case Type::TemplateTypeParm:
2454   case Type::SubstTemplateTypeParmPack:
2455   case Type::Auto:
2456   case Type::PackExpansion:
2457     llvm_unreachable("type should never be variably-modified");
2458 
2459   // These types can be variably-modified but should never need to
2460   // further decay.
2461   case Type::FunctionNoProto:
2462   case Type::FunctionProto:
2463   case Type::BlockPointer:
2464   case Type::MemberPointer:
2465     return type;
2466 
2467   // These types can be variably-modified.  All these modifications
2468   // preserve structure except as noted by comments.
2469   // TODO: if we ever care about optimizing VLAs, there are no-op
2470   // optimizations available here.
2471   case Type::Pointer:
2472     result = getPointerType(getVariableArrayDecayedType(
2473                               cast<PointerType>(ty)->getPointeeType()));
2474     break;
2475 
2476   case Type::LValueReference: {
2477     const LValueReferenceType *lv = cast<LValueReferenceType>(ty);
2478     result = getLValueReferenceType(
2479                  getVariableArrayDecayedType(lv->getPointeeType()),
2480                                     lv->isSpelledAsLValue());
2481     break;
2482   }
2483 
2484   case Type::RValueReference: {
2485     const RValueReferenceType *lv = cast<RValueReferenceType>(ty);
2486     result = getRValueReferenceType(
2487                  getVariableArrayDecayedType(lv->getPointeeType()));
2488     break;
2489   }
2490 
2491   case Type::Atomic: {
2492     const AtomicType *at = cast<AtomicType>(ty);
2493     result = getAtomicType(getVariableArrayDecayedType(at->getValueType()));
2494     break;
2495   }
2496 
2497   case Type::ConstantArray: {
2498     const ConstantArrayType *cat = cast<ConstantArrayType>(ty);
2499     result = getConstantArrayType(
2500                  getVariableArrayDecayedType(cat->getElementType()),
2501                                   cat->getSize(),
2502                                   cat->getSizeModifier(),
2503                                   cat->getIndexTypeCVRQualifiers());
2504     break;
2505   }
2506 
2507   case Type::DependentSizedArray: {
2508     const DependentSizedArrayType *dat = cast<DependentSizedArrayType>(ty);
2509     result = getDependentSizedArrayType(
2510                  getVariableArrayDecayedType(dat->getElementType()),
2511                                         dat->getSizeExpr(),
2512                                         dat->getSizeModifier(),
2513                                         dat->getIndexTypeCVRQualifiers(),
2514                                         dat->getBracketsRange());
2515     break;
2516   }
2517 
2518   // Turn incomplete types into [*] types.
2519   case Type::IncompleteArray: {
2520     const IncompleteArrayType *iat = cast<IncompleteArrayType>(ty);
2521     result = getVariableArrayType(
2522                  getVariableArrayDecayedType(iat->getElementType()),
2523                                   /*size*/ 0,
2524                                   ArrayType::Normal,
2525                                   iat->getIndexTypeCVRQualifiers(),
2526                                   SourceRange());
2527     break;
2528   }
2529 
2530   // Turn VLA types into [*] types.
2531   case Type::VariableArray: {
2532     const VariableArrayType *vat = cast<VariableArrayType>(ty);
2533     result = getVariableArrayType(
2534                  getVariableArrayDecayedType(vat->getElementType()),
2535                                   /*size*/ 0,
2536                                   ArrayType::Star,
2537                                   vat->getIndexTypeCVRQualifiers(),
2538                                   vat->getBracketsRange());
2539     break;
2540   }
2541   }
2542 
2543   // Apply the top-level qualifiers from the original.
2544   return getQualifiedType(result, split.Quals);
2545 }
2546 
2547 /// getVariableArrayType - Returns a non-unique reference to the type for a
2548 /// variable array of the specified element type.
2549 QualType ASTContext::getVariableArrayType(QualType EltTy,
2550                                           Expr *NumElts,
2551                                           ArrayType::ArraySizeModifier ASM,
2552                                           unsigned IndexTypeQuals,
2553                                           SourceRange Brackets) const {
2554   // Since we don't unique expressions, it isn't possible to unique VLA's
2555   // that have an expression provided for their size.
2556   QualType Canon;
2557 
2558   // Be sure to pull qualifiers off the element type.
2559   if (!EltTy.isCanonical() || EltTy.hasLocalQualifiers()) {
2560     SplitQualType canonSplit = getCanonicalType(EltTy).split();
2561     Canon = getVariableArrayType(QualType(canonSplit.Ty, 0), NumElts, ASM,
2562                                  IndexTypeQuals, Brackets);
2563     Canon = getQualifiedType(Canon, canonSplit.Quals);
2564   }
2565 
2566   VariableArrayType *New = new(*this, TypeAlignment)
2567     VariableArrayType(EltTy, Canon, NumElts, ASM, IndexTypeQuals, Brackets);
2568 
2569   VariableArrayTypes.push_back(New);
2570   Types.push_back(New);
2571   return QualType(New, 0);
2572 }
2573 
2574 /// getDependentSizedArrayType - Returns a non-unique reference to
2575 /// the type for a dependently-sized array of the specified element
2576 /// type.
2577 QualType ASTContext::getDependentSizedArrayType(QualType elementType,
2578                                                 Expr *numElements,
2579                                                 ArrayType::ArraySizeModifier ASM,
2580                                                 unsigned elementTypeQuals,
2581                                                 SourceRange brackets) const {
2582   assert((!numElements || numElements->isTypeDependent() ||
2583           numElements->isValueDependent()) &&
2584          "Size must be type- or value-dependent!");
2585 
2586   // Dependently-sized array types that do not have a specified number
2587   // of elements will have their sizes deduced from a dependent
2588   // initializer.  We do no canonicalization here at all, which is okay
2589   // because they can't be used in most locations.
2590   if (!numElements) {
2591     DependentSizedArrayType *newType
2592       = new (*this, TypeAlignment)
2593           DependentSizedArrayType(*this, elementType, QualType(),
2594                                   numElements, ASM, elementTypeQuals,
2595                                   brackets);
2596     Types.push_back(newType);
2597     return QualType(newType, 0);
2598   }
2599 
2600   // Otherwise, we actually build a new type every time, but we
2601   // also build a canonical type.
2602 
2603   SplitQualType canonElementType = getCanonicalType(elementType).split();
2604 
2605   void *insertPos = 0;
2606   llvm::FoldingSetNodeID ID;
2607   DependentSizedArrayType::Profile(ID, *this,
2608                                    QualType(canonElementType.Ty, 0),
2609                                    ASM, elementTypeQuals, numElements);
2610 
2611   // Look for an existing type with these properties.
2612   DependentSizedArrayType *canonTy =
2613     DependentSizedArrayTypes.FindNodeOrInsertPos(ID, insertPos);
2614 
2615   // If we don't have one, build one.
2616   if (!canonTy) {
2617     canonTy = new (*this, TypeAlignment)
2618       DependentSizedArrayType(*this, QualType(canonElementType.Ty, 0),
2619                               QualType(), numElements, ASM, elementTypeQuals,
2620                               brackets);
2621     DependentSizedArrayTypes.InsertNode(canonTy, insertPos);
2622     Types.push_back(canonTy);
2623   }
2624 
2625   // Apply qualifiers from the element type to the array.
2626   QualType canon = getQualifiedType(QualType(canonTy,0),
2627                                     canonElementType.Quals);
2628 
2629   // If we didn't need extra canonicalization for the element type,
2630   // then just use that as our result.
2631   if (QualType(canonElementType.Ty, 0) == elementType)
2632     return canon;
2633 
2634   // Otherwise, we need to build a type which follows the spelling
2635   // of the element type.
2636   DependentSizedArrayType *sugaredType
2637     = new (*this, TypeAlignment)
2638         DependentSizedArrayType(*this, elementType, canon, numElements,
2639                                 ASM, elementTypeQuals, brackets);
2640   Types.push_back(sugaredType);
2641   return QualType(sugaredType, 0);
2642 }
2643 
2644 QualType ASTContext::getIncompleteArrayType(QualType elementType,
2645                                             ArrayType::ArraySizeModifier ASM,
2646                                             unsigned elementTypeQuals) const {
2647   llvm::FoldingSetNodeID ID;
2648   IncompleteArrayType::Profile(ID, elementType, ASM, elementTypeQuals);
2649 
2650   void *insertPos = 0;
2651   if (IncompleteArrayType *iat =
2652        IncompleteArrayTypes.FindNodeOrInsertPos(ID, insertPos))
2653     return QualType(iat, 0);
2654 
2655   // If the element type isn't canonical, this won't be a canonical type
2656   // either, so fill in the canonical type field.  We also have to pull
2657   // qualifiers off the element type.
2658   QualType canon;
2659 
2660   if (!elementType.isCanonical() || elementType.hasLocalQualifiers()) {
2661     SplitQualType canonSplit = getCanonicalType(elementType).split();
2662     canon = getIncompleteArrayType(QualType(canonSplit.Ty, 0),
2663                                    ASM, elementTypeQuals);
2664     canon = getQualifiedType(canon, canonSplit.Quals);
2665 
2666     // Get the new insert position for the node we care about.
2667     IncompleteArrayType *existing =
2668       IncompleteArrayTypes.FindNodeOrInsertPos(ID, insertPos);
2669     assert(!existing && "Shouldn't be in the map!"); (void) existing;
2670   }
2671 
2672   IncompleteArrayType *newType = new (*this, TypeAlignment)
2673     IncompleteArrayType(elementType, canon, ASM, elementTypeQuals);
2674 
2675   IncompleteArrayTypes.InsertNode(newType, insertPos);
2676   Types.push_back(newType);
2677   return QualType(newType, 0);
2678 }
2679 
2680 /// getVectorType - Return the unique reference to a vector type of
2681 /// the specified element type and size. VectorType must be a built-in type.
2682 QualType ASTContext::getVectorType(QualType vecType, unsigned NumElts,
2683                                    VectorType::VectorKind VecKind) const {
2684   assert(vecType->isBuiltinType());
2685 
2686   // Check if we've already instantiated a vector of this type.
2687   llvm::FoldingSetNodeID ID;
2688   VectorType::Profile(ID, vecType, NumElts, Type::Vector, VecKind);
2689 
2690   void *InsertPos = 0;
2691   if (VectorType *VTP = VectorTypes.FindNodeOrInsertPos(ID, InsertPos))
2692     return QualType(VTP, 0);
2693 
2694   // If the element type isn't canonical, this won't be a canonical type either,
2695   // so fill in the canonical type field.
2696   QualType Canonical;
2697   if (!vecType.isCanonical()) {
2698     Canonical = getVectorType(getCanonicalType(vecType), NumElts, VecKind);
2699 
2700     // Get the new insert position for the node we care about.
2701     VectorType *NewIP = VectorTypes.FindNodeOrInsertPos(ID, InsertPos);
2702     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2703   }
2704   VectorType *New = new (*this, TypeAlignment)
2705     VectorType(vecType, NumElts, Canonical, VecKind);
2706   VectorTypes.InsertNode(New, InsertPos);
2707   Types.push_back(New);
2708   return QualType(New, 0);
2709 }
2710 
2711 /// getExtVectorType - Return the unique reference to an extended vector type of
2712 /// the specified element type and size. VectorType must be a built-in type.
2713 QualType
2714 ASTContext::getExtVectorType(QualType vecType, unsigned NumElts) const {
2715   assert(vecType->isBuiltinType() || vecType->isDependentType());
2716 
2717   // Check if we've already instantiated a vector of this type.
2718   llvm::FoldingSetNodeID ID;
2719   VectorType::Profile(ID, vecType, NumElts, Type::ExtVector,
2720                       VectorType::GenericVector);
2721   void *InsertPos = 0;
2722   if (VectorType *VTP = VectorTypes.FindNodeOrInsertPos(ID, InsertPos))
2723     return QualType(VTP, 0);
2724 
2725   // If the element type isn't canonical, this won't be a canonical type either,
2726   // so fill in the canonical type field.
2727   QualType Canonical;
2728   if (!vecType.isCanonical()) {
2729     Canonical = getExtVectorType(getCanonicalType(vecType), NumElts);
2730 
2731     // Get the new insert position for the node we care about.
2732     VectorType *NewIP = VectorTypes.FindNodeOrInsertPos(ID, InsertPos);
2733     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2734   }
2735   ExtVectorType *New = new (*this, TypeAlignment)
2736     ExtVectorType(vecType, NumElts, Canonical);
2737   VectorTypes.InsertNode(New, InsertPos);
2738   Types.push_back(New);
2739   return QualType(New, 0);
2740 }
2741 
2742 QualType
2743 ASTContext::getDependentSizedExtVectorType(QualType vecType,
2744                                            Expr *SizeExpr,
2745                                            SourceLocation AttrLoc) const {
2746   llvm::FoldingSetNodeID ID;
2747   DependentSizedExtVectorType::Profile(ID, *this, getCanonicalType(vecType),
2748                                        SizeExpr);
2749 
2750   void *InsertPos = 0;
2751   DependentSizedExtVectorType *Canon
2752     = DependentSizedExtVectorTypes.FindNodeOrInsertPos(ID, InsertPos);
2753   DependentSizedExtVectorType *New;
2754   if (Canon) {
2755     // We already have a canonical version of this array type; use it as
2756     // the canonical type for a newly-built type.
2757     New = new (*this, TypeAlignment)
2758       DependentSizedExtVectorType(*this, vecType, QualType(Canon, 0),
2759                                   SizeExpr, AttrLoc);
2760   } else {
2761     QualType CanonVecTy = getCanonicalType(vecType);
2762     if (CanonVecTy == vecType) {
2763       New = new (*this, TypeAlignment)
2764         DependentSizedExtVectorType(*this, vecType, QualType(), SizeExpr,
2765                                     AttrLoc);
2766 
2767       DependentSizedExtVectorType *CanonCheck
2768         = DependentSizedExtVectorTypes.FindNodeOrInsertPos(ID, InsertPos);
2769       assert(!CanonCheck && "Dependent-sized ext_vector canonical type broken");
2770       (void)CanonCheck;
2771       DependentSizedExtVectorTypes.InsertNode(New, InsertPos);
2772     } else {
2773       QualType Canon = getDependentSizedExtVectorType(CanonVecTy, SizeExpr,
2774                                                       SourceLocation());
2775       New = new (*this, TypeAlignment)
2776         DependentSizedExtVectorType(*this, vecType, Canon, SizeExpr, AttrLoc);
2777     }
2778   }
2779 
2780   Types.push_back(New);
2781   return QualType(New, 0);
2782 }
2783 
2784 /// getFunctionNoProtoType - Return a K&R style C function type like 'int()'.
2785 ///
2786 QualType
2787 ASTContext::getFunctionNoProtoType(QualType ResultTy,
2788                                    const FunctionType::ExtInfo &Info) const {
2789   const CallingConv CallConv = Info.getCC();
2790 
2791   // Unique functions, to guarantee there is only one function of a particular
2792   // structure.
2793   llvm::FoldingSetNodeID ID;
2794   FunctionNoProtoType::Profile(ID, ResultTy, Info);
2795 
2796   void *InsertPos = 0;
2797   if (FunctionNoProtoType *FT =
2798         FunctionNoProtoTypes.FindNodeOrInsertPos(ID, InsertPos))
2799     return QualType(FT, 0);
2800 
2801   QualType Canonical;
2802   if (!ResultTy.isCanonical()) {
2803     Canonical = getFunctionNoProtoType(getCanonicalType(ResultTy), Info);
2804 
2805     // Get the new insert position for the node we care about.
2806     FunctionNoProtoType *NewIP =
2807       FunctionNoProtoTypes.FindNodeOrInsertPos(ID, InsertPos);
2808     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2809   }
2810 
2811   FunctionProtoType::ExtInfo newInfo = Info.withCallingConv(CallConv);
2812   FunctionNoProtoType *New = new (*this, TypeAlignment)
2813     FunctionNoProtoType(ResultTy, Canonical, newInfo);
2814   Types.push_back(New);
2815   FunctionNoProtoTypes.InsertNode(New, InsertPos);
2816   return QualType(New, 0);
2817 }
2818 
2819 /// \brief Determine whether \p T is canonical as the result type of a function.
2820 static bool isCanonicalResultType(QualType T) {
2821   return T.isCanonical() &&
2822          (T.getObjCLifetime() == Qualifiers::OCL_None ||
2823           T.getObjCLifetime() == Qualifiers::OCL_ExplicitNone);
2824 }
2825 
2826 QualType
2827 ASTContext::getFunctionType(QualType ResultTy, ArrayRef<QualType> ArgArray,
2828                             const FunctionProtoType::ExtProtoInfo &EPI) const {
2829   size_t NumArgs = ArgArray.size();
2830 
2831   // Unique functions, to guarantee there is only one function of a particular
2832   // structure.
2833   llvm::FoldingSetNodeID ID;
2834   FunctionProtoType::Profile(ID, ResultTy, ArgArray.begin(), NumArgs, EPI,
2835                              *this);
2836 
2837   void *InsertPos = 0;
2838   if (FunctionProtoType *FTP =
2839         FunctionProtoTypes.FindNodeOrInsertPos(ID, InsertPos))
2840     return QualType(FTP, 0);
2841 
2842   // Determine whether the type being created is already canonical or not.
2843   bool isCanonical =
2844     EPI.ExceptionSpecType == EST_None && isCanonicalResultType(ResultTy) &&
2845     !EPI.HasTrailingReturn;
2846   for (unsigned i = 0; i != NumArgs && isCanonical; ++i)
2847     if (!ArgArray[i].isCanonicalAsParam())
2848       isCanonical = false;
2849 
2850   // If this type isn't canonical, get the canonical version of it.
2851   // The exception spec is not part of the canonical type.
2852   QualType Canonical;
2853   if (!isCanonical) {
2854     SmallVector<QualType, 16> CanonicalArgs;
2855     CanonicalArgs.reserve(NumArgs);
2856     for (unsigned i = 0; i != NumArgs; ++i)
2857       CanonicalArgs.push_back(getCanonicalParamType(ArgArray[i]));
2858 
2859     FunctionProtoType::ExtProtoInfo CanonicalEPI = EPI;
2860     CanonicalEPI.HasTrailingReturn = false;
2861     CanonicalEPI.ExceptionSpecType = EST_None;
2862     CanonicalEPI.NumExceptions = 0;
2863 
2864     // Result types do not have ARC lifetime qualifiers.
2865     QualType CanResultTy = getCanonicalType(ResultTy);
2866     if (ResultTy.getQualifiers().hasObjCLifetime()) {
2867       Qualifiers Qs = CanResultTy.getQualifiers();
2868       Qs.removeObjCLifetime();
2869       CanResultTy = getQualifiedType(CanResultTy.getUnqualifiedType(), Qs);
2870     }
2871 
2872     Canonical = getFunctionType(CanResultTy, CanonicalArgs, CanonicalEPI);
2873 
2874     // Get the new insert position for the node we care about.
2875     FunctionProtoType *NewIP =
2876       FunctionProtoTypes.FindNodeOrInsertPos(ID, InsertPos);
2877     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
2878   }
2879 
2880   // FunctionProtoType objects are allocated with extra bytes after
2881   // them for three variable size arrays at the end:
2882   //  - parameter types
2883   //  - exception types
2884   //  - consumed-arguments flags
2885   // Instead of the exception types, there could be a noexcept
2886   // expression, or information used to resolve the exception
2887   // specification.
2888   size_t Size = sizeof(FunctionProtoType) +
2889                 NumArgs * sizeof(QualType);
2890   if (EPI.ExceptionSpecType == EST_Dynamic) {
2891     Size += EPI.NumExceptions * sizeof(QualType);
2892   } else if (EPI.ExceptionSpecType == EST_ComputedNoexcept) {
2893     Size += sizeof(Expr*);
2894   } else if (EPI.ExceptionSpecType == EST_Uninstantiated) {
2895     Size += 2 * sizeof(FunctionDecl*);
2896   } else if (EPI.ExceptionSpecType == EST_Unevaluated) {
2897     Size += sizeof(FunctionDecl*);
2898   }
2899   if (EPI.ConsumedParameters)
2900     Size += NumArgs * sizeof(bool);
2901 
2902   FunctionProtoType *FTP = (FunctionProtoType*) Allocate(Size, TypeAlignment);
2903   FunctionProtoType::ExtProtoInfo newEPI = EPI;
2904   new (FTP) FunctionProtoType(ResultTy, ArgArray, Canonical, newEPI);
2905   Types.push_back(FTP);
2906   FunctionProtoTypes.InsertNode(FTP, InsertPos);
2907   return QualType(FTP, 0);
2908 }
2909 
2910 #ifndef NDEBUG
2911 static bool NeedsInjectedClassNameType(const RecordDecl *D) {
2912   if (!isa<CXXRecordDecl>(D)) return false;
2913   const CXXRecordDecl *RD = cast<CXXRecordDecl>(D);
2914   if (isa<ClassTemplatePartialSpecializationDecl>(RD))
2915     return true;
2916   if (RD->getDescribedClassTemplate() &&
2917       !isa<ClassTemplateSpecializationDecl>(RD))
2918     return true;
2919   return false;
2920 }
2921 #endif
2922 
2923 /// getInjectedClassNameType - Return the unique reference to the
2924 /// injected class name type for the specified templated declaration.
2925 QualType ASTContext::getInjectedClassNameType(CXXRecordDecl *Decl,
2926                                               QualType TST) const {
2927   assert(NeedsInjectedClassNameType(Decl));
2928   if (Decl->TypeForDecl) {
2929     assert(isa<InjectedClassNameType>(Decl->TypeForDecl));
2930   } else if (CXXRecordDecl *PrevDecl = Decl->getPreviousDecl()) {
2931     assert(PrevDecl->TypeForDecl && "previous declaration has no type");
2932     Decl->TypeForDecl = PrevDecl->TypeForDecl;
2933     assert(isa<InjectedClassNameType>(Decl->TypeForDecl));
2934   } else {
2935     Type *newType =
2936       new (*this, TypeAlignment) InjectedClassNameType(Decl, TST);
2937     Decl->TypeForDecl = newType;
2938     Types.push_back(newType);
2939   }
2940   return QualType(Decl->TypeForDecl, 0);
2941 }
2942 
2943 /// getTypeDeclType - Return the unique reference to the type for the
2944 /// specified type declaration.
2945 QualType ASTContext::getTypeDeclTypeSlow(const TypeDecl *Decl) const {
2946   assert(Decl && "Passed null for Decl param");
2947   assert(!Decl->TypeForDecl && "TypeForDecl present in slow case");
2948 
2949   if (const TypedefNameDecl *Typedef = dyn_cast<TypedefNameDecl>(Decl))
2950     return getTypedefType(Typedef);
2951 
2952   assert(!isa<TemplateTypeParmDecl>(Decl) &&
2953          "Template type parameter types are always available.");
2954 
2955   if (const RecordDecl *Record = dyn_cast<RecordDecl>(Decl)) {
2956     assert(Record->isFirstDecl() && "struct/union has previous declaration");
2957     assert(!NeedsInjectedClassNameType(Record));
2958     return getRecordType(Record);
2959   } else if (const EnumDecl *Enum = dyn_cast<EnumDecl>(Decl)) {
2960     assert(Enum->isFirstDecl() && "enum has previous declaration");
2961     return getEnumType(Enum);
2962   } else if (const UnresolvedUsingTypenameDecl *Using =
2963                dyn_cast<UnresolvedUsingTypenameDecl>(Decl)) {
2964     Type *newType = new (*this, TypeAlignment) UnresolvedUsingType(Using);
2965     Decl->TypeForDecl = newType;
2966     Types.push_back(newType);
2967   } else
2968     llvm_unreachable("TypeDecl without a type?");
2969 
2970   return QualType(Decl->TypeForDecl, 0);
2971 }
2972 
2973 /// getTypedefType - Return the unique reference to the type for the
2974 /// specified typedef name decl.
2975 QualType
2976 ASTContext::getTypedefType(const TypedefNameDecl *Decl,
2977                            QualType Canonical) const {
2978   if (Decl->TypeForDecl) return QualType(Decl->TypeForDecl, 0);
2979 
2980   if (Canonical.isNull())
2981     Canonical = getCanonicalType(Decl->getUnderlyingType());
2982   TypedefType *newType = new(*this, TypeAlignment)
2983     TypedefType(Type::Typedef, Decl, Canonical);
2984   Decl->TypeForDecl = newType;
2985   Types.push_back(newType);
2986   return QualType(newType, 0);
2987 }
2988 
2989 QualType ASTContext::getRecordType(const RecordDecl *Decl) const {
2990   if (Decl->TypeForDecl) return QualType(Decl->TypeForDecl, 0);
2991 
2992   if (const RecordDecl *PrevDecl = Decl->getPreviousDecl())
2993     if (PrevDecl->TypeForDecl)
2994       return QualType(Decl->TypeForDecl = PrevDecl->TypeForDecl, 0);
2995 
2996   RecordType *newType = new (*this, TypeAlignment) RecordType(Decl);
2997   Decl->TypeForDecl = newType;
2998   Types.push_back(newType);
2999   return QualType(newType, 0);
3000 }
3001 
3002 QualType ASTContext::getEnumType(const EnumDecl *Decl) const {
3003   if (Decl->TypeForDecl) return QualType(Decl->TypeForDecl, 0);
3004 
3005   if (const EnumDecl *PrevDecl = Decl->getPreviousDecl())
3006     if (PrevDecl->TypeForDecl)
3007       return QualType(Decl->TypeForDecl = PrevDecl->TypeForDecl, 0);
3008 
3009   EnumType *newType = new (*this, TypeAlignment) EnumType(Decl);
3010   Decl->TypeForDecl = newType;
3011   Types.push_back(newType);
3012   return QualType(newType, 0);
3013 }
3014 
3015 QualType ASTContext::getAttributedType(AttributedType::Kind attrKind,
3016                                        QualType modifiedType,
3017                                        QualType equivalentType) {
3018   llvm::FoldingSetNodeID id;
3019   AttributedType::Profile(id, attrKind, modifiedType, equivalentType);
3020 
3021   void *insertPos = 0;
3022   AttributedType *type = AttributedTypes.FindNodeOrInsertPos(id, insertPos);
3023   if (type) return QualType(type, 0);
3024 
3025   QualType canon = getCanonicalType(equivalentType);
3026   type = new (*this, TypeAlignment)
3027            AttributedType(canon, attrKind, modifiedType, equivalentType);
3028 
3029   Types.push_back(type);
3030   AttributedTypes.InsertNode(type, insertPos);
3031 
3032   return QualType(type, 0);
3033 }
3034 
3035 
3036 /// \brief Retrieve a substitution-result type.
3037 QualType
3038 ASTContext::getSubstTemplateTypeParmType(const TemplateTypeParmType *Parm,
3039                                          QualType Replacement) const {
3040   assert(Replacement.isCanonical()
3041          && "replacement types must always be canonical");
3042 
3043   llvm::FoldingSetNodeID ID;
3044   SubstTemplateTypeParmType::Profile(ID, Parm, Replacement);
3045   void *InsertPos = 0;
3046   SubstTemplateTypeParmType *SubstParm
3047     = SubstTemplateTypeParmTypes.FindNodeOrInsertPos(ID, InsertPos);
3048 
3049   if (!SubstParm) {
3050     SubstParm = new (*this, TypeAlignment)
3051       SubstTemplateTypeParmType(Parm, Replacement);
3052     Types.push_back(SubstParm);
3053     SubstTemplateTypeParmTypes.InsertNode(SubstParm, InsertPos);
3054   }
3055 
3056   return QualType(SubstParm, 0);
3057 }
3058 
3059 /// \brief Retrieve a
3060 QualType ASTContext::getSubstTemplateTypeParmPackType(
3061                                           const TemplateTypeParmType *Parm,
3062                                               const TemplateArgument &ArgPack) {
3063 #ifndef NDEBUG
3064   for (TemplateArgument::pack_iterator P = ArgPack.pack_begin(),
3065                                     PEnd = ArgPack.pack_end();
3066        P != PEnd; ++P) {
3067     assert(P->getKind() == TemplateArgument::Type &&"Pack contains a non-type");
3068     assert(P->getAsType().isCanonical() && "Pack contains non-canonical type");
3069   }
3070 #endif
3071 
3072   llvm::FoldingSetNodeID ID;
3073   SubstTemplateTypeParmPackType::Profile(ID, Parm, ArgPack);
3074   void *InsertPos = 0;
3075   if (SubstTemplateTypeParmPackType *SubstParm
3076         = SubstTemplateTypeParmPackTypes.FindNodeOrInsertPos(ID, InsertPos))
3077     return QualType(SubstParm, 0);
3078 
3079   QualType Canon;
3080   if (!Parm->isCanonicalUnqualified()) {
3081     Canon = getCanonicalType(QualType(Parm, 0));
3082     Canon = getSubstTemplateTypeParmPackType(cast<TemplateTypeParmType>(Canon),
3083                                              ArgPack);
3084     SubstTemplateTypeParmPackTypes.FindNodeOrInsertPos(ID, InsertPos);
3085   }
3086 
3087   SubstTemplateTypeParmPackType *SubstParm
3088     = new (*this, TypeAlignment) SubstTemplateTypeParmPackType(Parm, Canon,
3089                                                                ArgPack);
3090   Types.push_back(SubstParm);
3091   SubstTemplateTypeParmTypes.InsertNode(SubstParm, InsertPos);
3092   return QualType(SubstParm, 0);
3093 }
3094 
3095 /// \brief Retrieve the template type parameter type for a template
3096 /// parameter or parameter pack with the given depth, index, and (optionally)
3097 /// name.
3098 QualType ASTContext::getTemplateTypeParmType(unsigned Depth, unsigned Index,
3099                                              bool ParameterPack,
3100                                              TemplateTypeParmDecl *TTPDecl) const {
3101   llvm::FoldingSetNodeID ID;
3102   TemplateTypeParmType::Profile(ID, Depth, Index, ParameterPack, TTPDecl);
3103   void *InsertPos = 0;
3104   TemplateTypeParmType *TypeParm
3105     = TemplateTypeParmTypes.FindNodeOrInsertPos(ID, InsertPos);
3106 
3107   if (TypeParm)
3108     return QualType(TypeParm, 0);
3109 
3110   if (TTPDecl) {
3111     QualType Canon = getTemplateTypeParmType(Depth, Index, ParameterPack);
3112     TypeParm = new (*this, TypeAlignment) TemplateTypeParmType(TTPDecl, Canon);
3113 
3114     TemplateTypeParmType *TypeCheck
3115       = TemplateTypeParmTypes.FindNodeOrInsertPos(ID, InsertPos);
3116     assert(!TypeCheck && "Template type parameter canonical type broken");
3117     (void)TypeCheck;
3118   } else
3119     TypeParm = new (*this, TypeAlignment)
3120       TemplateTypeParmType(Depth, Index, ParameterPack);
3121 
3122   Types.push_back(TypeParm);
3123   TemplateTypeParmTypes.InsertNode(TypeParm, InsertPos);
3124 
3125   return QualType(TypeParm, 0);
3126 }
3127 
3128 TypeSourceInfo *
3129 ASTContext::getTemplateSpecializationTypeInfo(TemplateName Name,
3130                                               SourceLocation NameLoc,
3131                                         const TemplateArgumentListInfo &Args,
3132                                               QualType Underlying) const {
3133   assert(!Name.getAsDependentTemplateName() &&
3134          "No dependent template names here!");
3135   QualType TST = getTemplateSpecializationType(Name, Args, Underlying);
3136 
3137   TypeSourceInfo *DI = CreateTypeSourceInfo(TST);
3138   TemplateSpecializationTypeLoc TL =
3139       DI->getTypeLoc().castAs<TemplateSpecializationTypeLoc>();
3140   TL.setTemplateKeywordLoc(SourceLocation());
3141   TL.setTemplateNameLoc(NameLoc);
3142   TL.setLAngleLoc(Args.getLAngleLoc());
3143   TL.setRAngleLoc(Args.getRAngleLoc());
3144   for (unsigned i = 0, e = TL.getNumArgs(); i != e; ++i)
3145     TL.setArgLocInfo(i, Args[i].getLocInfo());
3146   return DI;
3147 }
3148 
3149 QualType
3150 ASTContext::getTemplateSpecializationType(TemplateName Template,
3151                                           const TemplateArgumentListInfo &Args,
3152                                           QualType Underlying) const {
3153   assert(!Template.getAsDependentTemplateName() &&
3154          "No dependent template names here!");
3155 
3156   unsigned NumArgs = Args.size();
3157 
3158   SmallVector<TemplateArgument, 4> ArgVec;
3159   ArgVec.reserve(NumArgs);
3160   for (unsigned i = 0; i != NumArgs; ++i)
3161     ArgVec.push_back(Args[i].getArgument());
3162 
3163   return getTemplateSpecializationType(Template, ArgVec.data(), NumArgs,
3164                                        Underlying);
3165 }
3166 
3167 #ifndef NDEBUG
3168 static bool hasAnyPackExpansions(const TemplateArgument *Args,
3169                                  unsigned NumArgs) {
3170   for (unsigned I = 0; I != NumArgs; ++I)
3171     if (Args[I].isPackExpansion())
3172       return true;
3173 
3174   return true;
3175 }
3176 #endif
3177 
3178 QualType
3179 ASTContext::getTemplateSpecializationType(TemplateName Template,
3180                                           const TemplateArgument *Args,
3181                                           unsigned NumArgs,
3182                                           QualType Underlying) const {
3183   assert(!Template.getAsDependentTemplateName() &&
3184          "No dependent template names here!");
3185   // Look through qualified template names.
3186   if (QualifiedTemplateName *QTN = Template.getAsQualifiedTemplateName())
3187     Template = TemplateName(QTN->getTemplateDecl());
3188 
3189   bool IsTypeAlias =
3190     Template.getAsTemplateDecl() &&
3191     isa<TypeAliasTemplateDecl>(Template.getAsTemplateDecl());
3192   QualType CanonType;
3193   if (!Underlying.isNull())
3194     CanonType = getCanonicalType(Underlying);
3195   else {
3196     // We can get here with an alias template when the specialization contains
3197     // a pack expansion that does not match up with a parameter pack.
3198     assert((!IsTypeAlias || hasAnyPackExpansions(Args, NumArgs)) &&
3199            "Caller must compute aliased type");
3200     IsTypeAlias = false;
3201     CanonType = getCanonicalTemplateSpecializationType(Template, Args,
3202                                                        NumArgs);
3203   }
3204 
3205   // Allocate the (non-canonical) template specialization type, but don't
3206   // try to unique it: these types typically have location information that
3207   // we don't unique and don't want to lose.
3208   void *Mem = Allocate(sizeof(TemplateSpecializationType) +
3209                        sizeof(TemplateArgument) * NumArgs +
3210                        (IsTypeAlias? sizeof(QualType) : 0),
3211                        TypeAlignment);
3212   TemplateSpecializationType *Spec
3213     = new (Mem) TemplateSpecializationType(Template, Args, NumArgs, CanonType,
3214                                          IsTypeAlias ? Underlying : QualType());
3215 
3216   Types.push_back(Spec);
3217   return QualType(Spec, 0);
3218 }
3219 
3220 QualType
3221 ASTContext::getCanonicalTemplateSpecializationType(TemplateName Template,
3222                                                    const TemplateArgument *Args,
3223                                                    unsigned NumArgs) const {
3224   assert(!Template.getAsDependentTemplateName() &&
3225          "No dependent template names here!");
3226 
3227   // Look through qualified template names.
3228   if (QualifiedTemplateName *QTN = Template.getAsQualifiedTemplateName())
3229     Template = TemplateName(QTN->getTemplateDecl());
3230 
3231   // Build the canonical template specialization type.
3232   TemplateName CanonTemplate = getCanonicalTemplateName(Template);
3233   SmallVector<TemplateArgument, 4> CanonArgs;
3234   CanonArgs.reserve(NumArgs);
3235   for (unsigned I = 0; I != NumArgs; ++I)
3236     CanonArgs.push_back(getCanonicalTemplateArgument(Args[I]));
3237 
3238   // Determine whether this canonical template specialization type already
3239   // exists.
3240   llvm::FoldingSetNodeID ID;
3241   TemplateSpecializationType::Profile(ID, CanonTemplate,
3242                                       CanonArgs.data(), NumArgs, *this);
3243 
3244   void *InsertPos = 0;
3245   TemplateSpecializationType *Spec
3246     = TemplateSpecializationTypes.FindNodeOrInsertPos(ID, InsertPos);
3247 
3248   if (!Spec) {
3249     // Allocate a new canonical template specialization type.
3250     void *Mem = Allocate((sizeof(TemplateSpecializationType) +
3251                           sizeof(TemplateArgument) * NumArgs),
3252                          TypeAlignment);
3253     Spec = new (Mem) TemplateSpecializationType(CanonTemplate,
3254                                                 CanonArgs.data(), NumArgs,
3255                                                 QualType(), QualType());
3256     Types.push_back(Spec);
3257     TemplateSpecializationTypes.InsertNode(Spec, InsertPos);
3258   }
3259 
3260   assert(Spec->isDependentType() &&
3261          "Non-dependent template-id type must have a canonical type");
3262   return QualType(Spec, 0);
3263 }
3264 
3265 QualType
3266 ASTContext::getElaboratedType(ElaboratedTypeKeyword Keyword,
3267                               NestedNameSpecifier *NNS,
3268                               QualType NamedType) const {
3269   llvm::FoldingSetNodeID ID;
3270   ElaboratedType::Profile(ID, Keyword, NNS, NamedType);
3271 
3272   void *InsertPos = 0;
3273   ElaboratedType *T = ElaboratedTypes.FindNodeOrInsertPos(ID, InsertPos);
3274   if (T)
3275     return QualType(T, 0);
3276 
3277   QualType Canon = NamedType;
3278   if (!Canon.isCanonical()) {
3279     Canon = getCanonicalType(NamedType);
3280     ElaboratedType *CheckT = ElaboratedTypes.FindNodeOrInsertPos(ID, InsertPos);
3281     assert(!CheckT && "Elaborated canonical type broken");
3282     (void)CheckT;
3283   }
3284 
3285   T = new (*this) ElaboratedType(Keyword, NNS, NamedType, Canon);
3286   Types.push_back(T);
3287   ElaboratedTypes.InsertNode(T, InsertPos);
3288   return QualType(T, 0);
3289 }
3290 
3291 QualType
3292 ASTContext::getParenType(QualType InnerType) const {
3293   llvm::FoldingSetNodeID ID;
3294   ParenType::Profile(ID, InnerType);
3295 
3296   void *InsertPos = 0;
3297   ParenType *T = ParenTypes.FindNodeOrInsertPos(ID, InsertPos);
3298   if (T)
3299     return QualType(T, 0);
3300 
3301   QualType Canon = InnerType;
3302   if (!Canon.isCanonical()) {
3303     Canon = getCanonicalType(InnerType);
3304     ParenType *CheckT = ParenTypes.FindNodeOrInsertPos(ID, InsertPos);
3305     assert(!CheckT && "Paren canonical type broken");
3306     (void)CheckT;
3307   }
3308 
3309   T = new (*this) ParenType(InnerType, Canon);
3310   Types.push_back(T);
3311   ParenTypes.InsertNode(T, InsertPos);
3312   return QualType(T, 0);
3313 }
3314 
3315 QualType ASTContext::getDependentNameType(ElaboratedTypeKeyword Keyword,
3316                                           NestedNameSpecifier *NNS,
3317                                           const IdentifierInfo *Name,
3318                                           QualType Canon) const {
3319   assert(NNS->isDependent() && "nested-name-specifier must be dependent");
3320 
3321   if (Canon.isNull()) {
3322     NestedNameSpecifier *CanonNNS = getCanonicalNestedNameSpecifier(NNS);
3323     ElaboratedTypeKeyword CanonKeyword = Keyword;
3324     if (Keyword == ETK_None)
3325       CanonKeyword = ETK_Typename;
3326 
3327     if (CanonNNS != NNS || CanonKeyword != Keyword)
3328       Canon = getDependentNameType(CanonKeyword, CanonNNS, Name);
3329   }
3330 
3331   llvm::FoldingSetNodeID ID;
3332   DependentNameType::Profile(ID, Keyword, NNS, Name);
3333 
3334   void *InsertPos = 0;
3335   DependentNameType *T
3336     = DependentNameTypes.FindNodeOrInsertPos(ID, InsertPos);
3337   if (T)
3338     return QualType(T, 0);
3339 
3340   T = new (*this) DependentNameType(Keyword, NNS, Name, Canon);
3341   Types.push_back(T);
3342   DependentNameTypes.InsertNode(T, InsertPos);
3343   return QualType(T, 0);
3344 }
3345 
3346 QualType
3347 ASTContext::getDependentTemplateSpecializationType(
3348                                  ElaboratedTypeKeyword Keyword,
3349                                  NestedNameSpecifier *NNS,
3350                                  const IdentifierInfo *Name,
3351                                  const TemplateArgumentListInfo &Args) const {
3352   // TODO: avoid this copy
3353   SmallVector<TemplateArgument, 16> ArgCopy;
3354   for (unsigned I = 0, E = Args.size(); I != E; ++I)
3355     ArgCopy.push_back(Args[I].getArgument());
3356   return getDependentTemplateSpecializationType(Keyword, NNS, Name,
3357                                                 ArgCopy.size(),
3358                                                 ArgCopy.data());
3359 }
3360 
3361 QualType
3362 ASTContext::getDependentTemplateSpecializationType(
3363                                  ElaboratedTypeKeyword Keyword,
3364                                  NestedNameSpecifier *NNS,
3365                                  const IdentifierInfo *Name,
3366                                  unsigned NumArgs,
3367                                  const TemplateArgument *Args) const {
3368   assert((!NNS || NNS->isDependent()) &&
3369          "nested-name-specifier must be dependent");
3370 
3371   llvm::FoldingSetNodeID ID;
3372   DependentTemplateSpecializationType::Profile(ID, *this, Keyword, NNS,
3373                                                Name, NumArgs, Args);
3374 
3375   void *InsertPos = 0;
3376   DependentTemplateSpecializationType *T
3377     = DependentTemplateSpecializationTypes.FindNodeOrInsertPos(ID, InsertPos);
3378   if (T)
3379     return QualType(T, 0);
3380 
3381   NestedNameSpecifier *CanonNNS = getCanonicalNestedNameSpecifier(NNS);
3382 
3383   ElaboratedTypeKeyword CanonKeyword = Keyword;
3384   if (Keyword == ETK_None) CanonKeyword = ETK_Typename;
3385 
3386   bool AnyNonCanonArgs = false;
3387   SmallVector<TemplateArgument, 16> CanonArgs(NumArgs);
3388   for (unsigned I = 0; I != NumArgs; ++I) {
3389     CanonArgs[I] = getCanonicalTemplateArgument(Args[I]);
3390     if (!CanonArgs[I].structurallyEquals(Args[I]))
3391       AnyNonCanonArgs = true;
3392   }
3393 
3394   QualType Canon;
3395   if (AnyNonCanonArgs || CanonNNS != NNS || CanonKeyword != Keyword) {
3396     Canon = getDependentTemplateSpecializationType(CanonKeyword, CanonNNS,
3397                                                    Name, NumArgs,
3398                                                    CanonArgs.data());
3399 
3400     // Find the insert position again.
3401     DependentTemplateSpecializationTypes.FindNodeOrInsertPos(ID, InsertPos);
3402   }
3403 
3404   void *Mem = Allocate((sizeof(DependentTemplateSpecializationType) +
3405                         sizeof(TemplateArgument) * NumArgs),
3406                        TypeAlignment);
3407   T = new (Mem) DependentTemplateSpecializationType(Keyword, NNS,
3408                                                     Name, NumArgs, Args, Canon);
3409   Types.push_back(T);
3410   DependentTemplateSpecializationTypes.InsertNode(T, InsertPos);
3411   return QualType(T, 0);
3412 }
3413 
3414 QualType ASTContext::getPackExpansionType(QualType Pattern,
3415                                           Optional<unsigned> NumExpansions) {
3416   llvm::FoldingSetNodeID ID;
3417   PackExpansionType::Profile(ID, Pattern, NumExpansions);
3418 
3419   assert(Pattern->containsUnexpandedParameterPack() &&
3420          "Pack expansions must expand one or more parameter packs");
3421   void *InsertPos = 0;
3422   PackExpansionType *T
3423     = PackExpansionTypes.FindNodeOrInsertPos(ID, InsertPos);
3424   if (T)
3425     return QualType(T, 0);
3426 
3427   QualType Canon;
3428   if (!Pattern.isCanonical()) {
3429     Canon = getCanonicalType(Pattern);
3430     // The canonical type might not contain an unexpanded parameter pack, if it
3431     // contains an alias template specialization which ignores one of its
3432     // parameters.
3433     if (Canon->containsUnexpandedParameterPack()) {
3434       Canon = getPackExpansionType(getCanonicalType(Pattern), NumExpansions);
3435 
3436       // Find the insert position again, in case we inserted an element into
3437       // PackExpansionTypes and invalidated our insert position.
3438       PackExpansionTypes.FindNodeOrInsertPos(ID, InsertPos);
3439     }
3440   }
3441 
3442   T = new (*this) PackExpansionType(Pattern, Canon, NumExpansions);
3443   Types.push_back(T);
3444   PackExpansionTypes.InsertNode(T, InsertPos);
3445   return QualType(T, 0);
3446 }
3447 
3448 /// CmpProtocolNames - Comparison predicate for sorting protocols
3449 /// alphabetically.
3450 static bool CmpProtocolNames(const ObjCProtocolDecl *LHS,
3451                             const ObjCProtocolDecl *RHS) {
3452   return LHS->getDeclName() < RHS->getDeclName();
3453 }
3454 
3455 static bool areSortedAndUniqued(ObjCProtocolDecl * const *Protocols,
3456                                 unsigned NumProtocols) {
3457   if (NumProtocols == 0) return true;
3458 
3459   if (Protocols[0]->getCanonicalDecl() != Protocols[0])
3460     return false;
3461 
3462   for (unsigned i = 1; i != NumProtocols; ++i)
3463     if (!CmpProtocolNames(Protocols[i-1], Protocols[i]) ||
3464         Protocols[i]->getCanonicalDecl() != Protocols[i])
3465       return false;
3466   return true;
3467 }
3468 
3469 static void SortAndUniqueProtocols(ObjCProtocolDecl **Protocols,
3470                                    unsigned &NumProtocols) {
3471   ObjCProtocolDecl **ProtocolsEnd = Protocols+NumProtocols;
3472 
3473   // Sort protocols, keyed by name.
3474   std::sort(Protocols, Protocols+NumProtocols, CmpProtocolNames);
3475 
3476   // Canonicalize.
3477   for (unsigned I = 0, N = NumProtocols; I != N; ++I)
3478     Protocols[I] = Protocols[I]->getCanonicalDecl();
3479 
3480   // Remove duplicates.
3481   ProtocolsEnd = std::unique(Protocols, ProtocolsEnd);
3482   NumProtocols = ProtocolsEnd-Protocols;
3483 }
3484 
3485 QualType ASTContext::getObjCObjectType(QualType BaseType,
3486                                        ObjCProtocolDecl * const *Protocols,
3487                                        unsigned NumProtocols) const {
3488   // If the base type is an interface and there aren't any protocols
3489   // to add, then the interface type will do just fine.
3490   if (!NumProtocols && isa<ObjCInterfaceType>(BaseType))
3491     return BaseType;
3492 
3493   // Look in the folding set for an existing type.
3494   llvm::FoldingSetNodeID ID;
3495   ObjCObjectTypeImpl::Profile(ID, BaseType, Protocols, NumProtocols);
3496   void *InsertPos = 0;
3497   if (ObjCObjectType *QT = ObjCObjectTypes.FindNodeOrInsertPos(ID, InsertPos))
3498     return QualType(QT, 0);
3499 
3500   // Build the canonical type, which has the canonical base type and
3501   // a sorted-and-uniqued list of protocols.
3502   QualType Canonical;
3503   bool ProtocolsSorted = areSortedAndUniqued(Protocols, NumProtocols);
3504   if (!ProtocolsSorted || !BaseType.isCanonical()) {
3505     if (!ProtocolsSorted) {
3506       SmallVector<ObjCProtocolDecl*, 8> Sorted(Protocols,
3507                                                      Protocols + NumProtocols);
3508       unsigned UniqueCount = NumProtocols;
3509 
3510       SortAndUniqueProtocols(&Sorted[0], UniqueCount);
3511       Canonical = getObjCObjectType(getCanonicalType(BaseType),
3512                                     &Sorted[0], UniqueCount);
3513     } else {
3514       Canonical = getObjCObjectType(getCanonicalType(BaseType),
3515                                     Protocols, NumProtocols);
3516     }
3517 
3518     // Regenerate InsertPos.
3519     ObjCObjectTypes.FindNodeOrInsertPos(ID, InsertPos);
3520   }
3521 
3522   unsigned Size = sizeof(ObjCObjectTypeImpl);
3523   Size += NumProtocols * sizeof(ObjCProtocolDecl *);
3524   void *Mem = Allocate(Size, TypeAlignment);
3525   ObjCObjectTypeImpl *T =
3526     new (Mem) ObjCObjectTypeImpl(Canonical, BaseType, Protocols, NumProtocols);
3527 
3528   Types.push_back(T);
3529   ObjCObjectTypes.InsertNode(T, InsertPos);
3530   return QualType(T, 0);
3531 }
3532 
3533 /// ObjCObjectAdoptsQTypeProtocols - Checks that protocols in IC's
3534 /// protocol list adopt all protocols in QT's qualified-id protocol
3535 /// list.
3536 bool ASTContext::ObjCObjectAdoptsQTypeProtocols(QualType QT,
3537                                                 ObjCInterfaceDecl *IC) {
3538   if (!QT->isObjCQualifiedIdType())
3539     return false;
3540 
3541   if (const ObjCObjectPointerType *OPT = QT->getAs<ObjCObjectPointerType>()) {
3542     // If both the right and left sides have qualifiers.
3543     for (ObjCObjectPointerType::qual_iterator I = OPT->qual_begin(),
3544          E = OPT->qual_end(); I != E; ++I) {
3545       ObjCProtocolDecl *Proto = *I;
3546       if (!IC->ClassImplementsProtocol(Proto, false))
3547         return false;
3548     }
3549     return true;
3550   }
3551   return false;
3552 }
3553 
3554 /// QIdProtocolsAdoptObjCObjectProtocols - Checks that protocols in
3555 /// QT's qualified-id protocol list adopt all protocols in IDecl's list
3556 /// of protocols.
3557 bool ASTContext::QIdProtocolsAdoptObjCObjectProtocols(QualType QT,
3558                                                 ObjCInterfaceDecl *IDecl) {
3559   if (!QT->isObjCQualifiedIdType())
3560     return false;
3561   const ObjCObjectPointerType *OPT = QT->getAs<ObjCObjectPointerType>();
3562   if (!OPT)
3563     return false;
3564   if (!IDecl->hasDefinition())
3565     return false;
3566   llvm::SmallPtrSet<ObjCProtocolDecl *, 8> InheritedProtocols;
3567   CollectInheritedProtocols(IDecl, InheritedProtocols);
3568   if (InheritedProtocols.empty())
3569     return false;
3570 
3571   for (llvm::SmallPtrSet<ObjCProtocolDecl*,8>::iterator PI =
3572        InheritedProtocols.begin(),
3573        E = InheritedProtocols.end(); PI != E; ++PI) {
3574     // If both the right and left sides have qualifiers.
3575     bool Adopts = false;
3576     for (ObjCObjectPointerType::qual_iterator I = OPT->qual_begin(),
3577          E = OPT->qual_end(); I != E; ++I) {
3578       ObjCProtocolDecl *Proto = *I;
3579       // return 'true' if '*PI' is in the inheritance hierarchy of Proto
3580       if ((Adopts = ProtocolCompatibleWithProtocol(*PI, Proto)))
3581         break;
3582     }
3583     if (!Adopts)
3584       return false;
3585   }
3586   return true;
3587 }
3588 
3589 /// getObjCObjectPointerType - Return a ObjCObjectPointerType type for
3590 /// the given object type.
3591 QualType ASTContext::getObjCObjectPointerType(QualType ObjectT) const {
3592   llvm::FoldingSetNodeID ID;
3593   ObjCObjectPointerType::Profile(ID, ObjectT);
3594 
3595   void *InsertPos = 0;
3596   if (ObjCObjectPointerType *QT =
3597               ObjCObjectPointerTypes.FindNodeOrInsertPos(ID, InsertPos))
3598     return QualType(QT, 0);
3599 
3600   // Find the canonical object type.
3601   QualType Canonical;
3602   if (!ObjectT.isCanonical()) {
3603     Canonical = getObjCObjectPointerType(getCanonicalType(ObjectT));
3604 
3605     // Regenerate InsertPos.
3606     ObjCObjectPointerTypes.FindNodeOrInsertPos(ID, InsertPos);
3607   }
3608 
3609   // No match.
3610   void *Mem = Allocate(sizeof(ObjCObjectPointerType), TypeAlignment);
3611   ObjCObjectPointerType *QType =
3612     new (Mem) ObjCObjectPointerType(Canonical, ObjectT);
3613 
3614   Types.push_back(QType);
3615   ObjCObjectPointerTypes.InsertNode(QType, InsertPos);
3616   return QualType(QType, 0);
3617 }
3618 
3619 /// getObjCInterfaceType - Return the unique reference to the type for the
3620 /// specified ObjC interface decl. The list of protocols is optional.
3621 QualType ASTContext::getObjCInterfaceType(const ObjCInterfaceDecl *Decl,
3622                                           ObjCInterfaceDecl *PrevDecl) const {
3623   if (Decl->TypeForDecl)
3624     return QualType(Decl->TypeForDecl, 0);
3625 
3626   if (PrevDecl) {
3627     assert(PrevDecl->TypeForDecl && "previous decl has no TypeForDecl");
3628     Decl->TypeForDecl = PrevDecl->TypeForDecl;
3629     return QualType(PrevDecl->TypeForDecl, 0);
3630   }
3631 
3632   // Prefer the definition, if there is one.
3633   if (const ObjCInterfaceDecl *Def = Decl->getDefinition())
3634     Decl = Def;
3635 
3636   void *Mem = Allocate(sizeof(ObjCInterfaceType), TypeAlignment);
3637   ObjCInterfaceType *T = new (Mem) ObjCInterfaceType(Decl);
3638   Decl->TypeForDecl = T;
3639   Types.push_back(T);
3640   return QualType(T, 0);
3641 }
3642 
3643 /// getTypeOfExprType - Unlike many "get<Type>" functions, we can't unique
3644 /// TypeOfExprType AST's (since expression's are never shared). For example,
3645 /// multiple declarations that refer to "typeof(x)" all contain different
3646 /// DeclRefExpr's. This doesn't effect the type checker, since it operates
3647 /// on canonical type's (which are always unique).
3648 QualType ASTContext::getTypeOfExprType(Expr *tofExpr) const {
3649   TypeOfExprType *toe;
3650   if (tofExpr->isTypeDependent()) {
3651     llvm::FoldingSetNodeID ID;
3652     DependentTypeOfExprType::Profile(ID, *this, tofExpr);
3653 
3654     void *InsertPos = 0;
3655     DependentTypeOfExprType *Canon
3656       = DependentTypeOfExprTypes.FindNodeOrInsertPos(ID, InsertPos);
3657     if (Canon) {
3658       // We already have a "canonical" version of an identical, dependent
3659       // typeof(expr) type. Use that as our canonical type.
3660       toe = new (*this, TypeAlignment) TypeOfExprType(tofExpr,
3661                                           QualType((TypeOfExprType*)Canon, 0));
3662     } else {
3663       // Build a new, canonical typeof(expr) type.
3664       Canon
3665         = new (*this, TypeAlignment) DependentTypeOfExprType(*this, tofExpr);
3666       DependentTypeOfExprTypes.InsertNode(Canon, InsertPos);
3667       toe = Canon;
3668     }
3669   } else {
3670     QualType Canonical = getCanonicalType(tofExpr->getType());
3671     toe = new (*this, TypeAlignment) TypeOfExprType(tofExpr, Canonical);
3672   }
3673   Types.push_back(toe);
3674   return QualType(toe, 0);
3675 }
3676 
3677 /// getTypeOfType -  Unlike many "get<Type>" functions, we don't unique
3678 /// TypeOfType AST's. The only motivation to unique these nodes would be
3679 /// memory savings. Since typeof(t) is fairly uncommon, space shouldn't be
3680 /// an issue. This doesn't effect the type checker, since it operates
3681 /// on canonical type's (which are always unique).
3682 QualType ASTContext::getTypeOfType(QualType tofType) const {
3683   QualType Canonical = getCanonicalType(tofType);
3684   TypeOfType *tot = new (*this, TypeAlignment) TypeOfType(tofType, Canonical);
3685   Types.push_back(tot);
3686   return QualType(tot, 0);
3687 }
3688 
3689 
3690 /// getDecltypeType -  Unlike many "get<Type>" functions, we don't unique
3691 /// DecltypeType AST's. The only motivation to unique these nodes would be
3692 /// memory savings. Since decltype(t) is fairly uncommon, space shouldn't be
3693 /// an issue. This doesn't effect the type checker, since it operates
3694 /// on canonical types (which are always unique).
3695 QualType ASTContext::getDecltypeType(Expr *e, QualType UnderlyingType) const {
3696   DecltypeType *dt;
3697 
3698   // C++0x [temp.type]p2:
3699   //   If an expression e involves a template parameter, decltype(e) denotes a
3700   //   unique dependent type. Two such decltype-specifiers refer to the same
3701   //   type only if their expressions are equivalent (14.5.6.1).
3702   if (e->isInstantiationDependent()) {
3703     llvm::FoldingSetNodeID ID;
3704     DependentDecltypeType::Profile(ID, *this, e);
3705 
3706     void *InsertPos = 0;
3707     DependentDecltypeType *Canon
3708       = DependentDecltypeTypes.FindNodeOrInsertPos(ID, InsertPos);
3709     if (Canon) {
3710       // We already have a "canonical" version of an equivalent, dependent
3711       // decltype type. Use that as our canonical type.
3712       dt = new (*this, TypeAlignment) DecltypeType(e, UnderlyingType,
3713                                        QualType((DecltypeType*)Canon, 0));
3714     } else {
3715       // Build a new, canonical typeof(expr) type.
3716       Canon = new (*this, TypeAlignment) DependentDecltypeType(*this, e);
3717       DependentDecltypeTypes.InsertNode(Canon, InsertPos);
3718       dt = Canon;
3719     }
3720   } else {
3721     dt = new (*this, TypeAlignment) DecltypeType(e, UnderlyingType,
3722                                       getCanonicalType(UnderlyingType));
3723   }
3724   Types.push_back(dt);
3725   return QualType(dt, 0);
3726 }
3727 
3728 /// getUnaryTransformationType - We don't unique these, since the memory
3729 /// savings are minimal and these are rare.
3730 QualType ASTContext::getUnaryTransformType(QualType BaseType,
3731                                            QualType UnderlyingType,
3732                                            UnaryTransformType::UTTKind Kind)
3733     const {
3734   UnaryTransformType *Ty =
3735     new (*this, TypeAlignment) UnaryTransformType (BaseType, UnderlyingType,
3736                                                    Kind,
3737                                  UnderlyingType->isDependentType() ?
3738                                  QualType() : getCanonicalType(UnderlyingType));
3739   Types.push_back(Ty);
3740   return QualType(Ty, 0);
3741 }
3742 
3743 /// getAutoType - Return the uniqued reference to the 'auto' type which has been
3744 /// deduced to the given type, or to the canonical undeduced 'auto' type, or the
3745 /// canonical deduced-but-dependent 'auto' type.
3746 QualType ASTContext::getAutoType(QualType DeducedType, bool IsDecltypeAuto,
3747                                  bool IsDependent) const {
3748   if (DeducedType.isNull() && !IsDecltypeAuto && !IsDependent)
3749     return getAutoDeductType();
3750 
3751   // Look in the folding set for an existing type.
3752   void *InsertPos = 0;
3753   llvm::FoldingSetNodeID ID;
3754   AutoType::Profile(ID, DeducedType, IsDecltypeAuto, IsDependent);
3755   if (AutoType *AT = AutoTypes.FindNodeOrInsertPos(ID, InsertPos))
3756     return QualType(AT, 0);
3757 
3758   AutoType *AT = new (*this, TypeAlignment) AutoType(DeducedType,
3759                                                      IsDecltypeAuto,
3760                                                      IsDependent);
3761   Types.push_back(AT);
3762   if (InsertPos)
3763     AutoTypes.InsertNode(AT, InsertPos);
3764   return QualType(AT, 0);
3765 }
3766 
3767 /// getAtomicType - Return the uniqued reference to the atomic type for
3768 /// the given value type.
3769 QualType ASTContext::getAtomicType(QualType T) const {
3770   // Unique pointers, to guarantee there is only one pointer of a particular
3771   // structure.
3772   llvm::FoldingSetNodeID ID;
3773   AtomicType::Profile(ID, T);
3774 
3775   void *InsertPos = 0;
3776   if (AtomicType *AT = AtomicTypes.FindNodeOrInsertPos(ID, InsertPos))
3777     return QualType(AT, 0);
3778 
3779   // If the atomic value type isn't canonical, this won't be a canonical type
3780   // either, so fill in the canonical type field.
3781   QualType Canonical;
3782   if (!T.isCanonical()) {
3783     Canonical = getAtomicType(getCanonicalType(T));
3784 
3785     // Get the new insert position for the node we care about.
3786     AtomicType *NewIP = AtomicTypes.FindNodeOrInsertPos(ID, InsertPos);
3787     assert(NewIP == 0 && "Shouldn't be in the map!"); (void)NewIP;
3788   }
3789   AtomicType *New = new (*this, TypeAlignment) AtomicType(T, Canonical);
3790   Types.push_back(New);
3791   AtomicTypes.InsertNode(New, InsertPos);
3792   return QualType(New, 0);
3793 }
3794 
3795 /// getAutoDeductType - Get type pattern for deducing against 'auto'.
3796 QualType ASTContext::getAutoDeductType() const {
3797   if (AutoDeductTy.isNull())
3798     AutoDeductTy = QualType(
3799       new (*this, TypeAlignment) AutoType(QualType(), /*decltype(auto)*/false,
3800                                           /*dependent*/false),
3801       0);
3802   return AutoDeductTy;
3803 }
3804 
3805 /// getAutoRRefDeductType - Get type pattern for deducing against 'auto &&'.
3806 QualType ASTContext::getAutoRRefDeductType() const {
3807   if (AutoRRefDeductTy.isNull())
3808     AutoRRefDeductTy = getRValueReferenceType(getAutoDeductType());
3809   assert(!AutoRRefDeductTy.isNull() && "can't build 'auto &&' pattern");
3810   return AutoRRefDeductTy;
3811 }
3812 
3813 /// getTagDeclType - Return the unique reference to the type for the
3814 /// specified TagDecl (struct/union/class/enum) decl.
3815 QualType ASTContext::getTagDeclType(const TagDecl *Decl) const {
3816   assert (Decl);
3817   // FIXME: What is the design on getTagDeclType when it requires casting
3818   // away const?  mutable?
3819   return getTypeDeclType(const_cast<TagDecl*>(Decl));
3820 }
3821 
3822 /// getSizeType - Return the unique type for "size_t" (C99 7.17), the result
3823 /// of the sizeof operator (C99 6.5.3.4p4). The value is target dependent and
3824 /// needs to agree with the definition in <stddef.h>.
3825 CanQualType ASTContext::getSizeType() const {
3826   return getFromTargetType(Target->getSizeType());
3827 }
3828 
3829 /// getIntMaxType - Return the unique type for "intmax_t" (C99 7.18.1.5).
3830 CanQualType ASTContext::getIntMaxType() const {
3831   return getFromTargetType(Target->getIntMaxType());
3832 }
3833 
3834 /// getUIntMaxType - Return the unique type for "uintmax_t" (C99 7.18.1.5).
3835 CanQualType ASTContext::getUIntMaxType() const {
3836   return getFromTargetType(Target->getUIntMaxType());
3837 }
3838 
3839 /// getSignedWCharType - Return the type of "signed wchar_t".
3840 /// Used when in C++, as a GCC extension.
3841 QualType ASTContext::getSignedWCharType() const {
3842   // FIXME: derive from "Target" ?
3843   return WCharTy;
3844 }
3845 
3846 /// getUnsignedWCharType - Return the type of "unsigned wchar_t".
3847 /// Used when in C++, as a GCC extension.
3848 QualType ASTContext::getUnsignedWCharType() const {
3849   // FIXME: derive from "Target" ?
3850   return UnsignedIntTy;
3851 }
3852 
3853 QualType ASTContext::getIntPtrType() const {
3854   return getFromTargetType(Target->getIntPtrType());
3855 }
3856 
3857 QualType ASTContext::getUIntPtrType() const {
3858   return getCorrespondingUnsignedType(getIntPtrType());
3859 }
3860 
3861 /// getPointerDiffType - Return the unique type for "ptrdiff_t" (C99 7.17)
3862 /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9).
3863 QualType ASTContext::getPointerDiffType() const {
3864   return getFromTargetType(Target->getPtrDiffType(0));
3865 }
3866 
3867 /// \brief Return the unique type for "pid_t" defined in
3868 /// <sys/types.h>. We need this to compute the correct type for vfork().
3869 QualType ASTContext::getProcessIDType() const {
3870   return getFromTargetType(Target->getProcessIDType());
3871 }
3872 
3873 //===----------------------------------------------------------------------===//
3874 //                              Type Operators
3875 //===----------------------------------------------------------------------===//
3876 
3877 CanQualType ASTContext::getCanonicalParamType(QualType T) const {
3878   // Push qualifiers into arrays, and then discard any remaining
3879   // qualifiers.
3880   T = getCanonicalType(T);
3881   T = getVariableArrayDecayedType(T);
3882   const Type *Ty = T.getTypePtr();
3883   QualType Result;
3884   if (isa<ArrayType>(Ty)) {
3885     Result = getArrayDecayedType(QualType(Ty,0));
3886   } else if (isa<FunctionType>(Ty)) {
3887     Result = getPointerType(QualType(Ty, 0));
3888   } else {
3889     Result = QualType(Ty, 0);
3890   }
3891 
3892   return CanQualType::CreateUnsafe(Result);
3893 }
3894 
3895 QualType ASTContext::getUnqualifiedArrayType(QualType type,
3896                                              Qualifiers &quals) {
3897   SplitQualType splitType = type.getSplitUnqualifiedType();
3898 
3899   // FIXME: getSplitUnqualifiedType() actually walks all the way to
3900   // the unqualified desugared type and then drops it on the floor.
3901   // We then have to strip that sugar back off with
3902   // getUnqualifiedDesugaredType(), which is silly.
3903   const ArrayType *AT =
3904     dyn_cast<ArrayType>(splitType.Ty->getUnqualifiedDesugaredType());
3905 
3906   // If we don't have an array, just use the results in splitType.
3907   if (!AT) {
3908     quals = splitType.Quals;
3909     return QualType(splitType.Ty, 0);
3910   }
3911 
3912   // Otherwise, recurse on the array's element type.
3913   QualType elementType = AT->getElementType();
3914   QualType unqualElementType = getUnqualifiedArrayType(elementType, quals);
3915 
3916   // If that didn't change the element type, AT has no qualifiers, so we
3917   // can just use the results in splitType.
3918   if (elementType == unqualElementType) {
3919     assert(quals.empty()); // from the recursive call
3920     quals = splitType.Quals;
3921     return QualType(splitType.Ty, 0);
3922   }
3923 
3924   // Otherwise, add in the qualifiers from the outermost type, then
3925   // build the type back up.
3926   quals.addConsistentQualifiers(splitType.Quals);
3927 
3928   if (const ConstantArrayType *CAT = dyn_cast<ConstantArrayType>(AT)) {
3929     return getConstantArrayType(unqualElementType, CAT->getSize(),
3930                                 CAT->getSizeModifier(), 0);
3931   }
3932 
3933   if (const IncompleteArrayType *IAT = dyn_cast<IncompleteArrayType>(AT)) {
3934     return getIncompleteArrayType(unqualElementType, IAT->getSizeModifier(), 0);
3935   }
3936 
3937   if (const VariableArrayType *VAT = dyn_cast<VariableArrayType>(AT)) {
3938     return getVariableArrayType(unqualElementType,
3939                                 VAT->getSizeExpr(),
3940                                 VAT->getSizeModifier(),
3941                                 VAT->getIndexTypeCVRQualifiers(),
3942                                 VAT->getBracketsRange());
3943   }
3944 
3945   const DependentSizedArrayType *DSAT = cast<DependentSizedArrayType>(AT);
3946   return getDependentSizedArrayType(unqualElementType, DSAT->getSizeExpr(),
3947                                     DSAT->getSizeModifier(), 0,
3948                                     SourceRange());
3949 }
3950 
3951 /// UnwrapSimilarPointerTypes - If T1 and T2 are pointer types  that
3952 /// may be similar (C++ 4.4), replaces T1 and T2 with the type that
3953 /// they point to and return true. If T1 and T2 aren't pointer types
3954 /// or pointer-to-member types, or if they are not similar at this
3955 /// level, returns false and leaves T1 and T2 unchanged. Top-level
3956 /// qualifiers on T1 and T2 are ignored. This function will typically
3957 /// be called in a loop that successively "unwraps" pointer and
3958 /// pointer-to-member types to compare them at each level.
3959 bool ASTContext::UnwrapSimilarPointerTypes(QualType &T1, QualType &T2) {
3960   const PointerType *T1PtrType = T1->getAs<PointerType>(),
3961                     *T2PtrType = T2->getAs<PointerType>();
3962   if (T1PtrType && T2PtrType) {
3963     T1 = T1PtrType->getPointeeType();
3964     T2 = T2PtrType->getPointeeType();
3965     return true;
3966   }
3967 
3968   const MemberPointerType *T1MPType = T1->getAs<MemberPointerType>(),
3969                           *T2MPType = T2->getAs<MemberPointerType>();
3970   if (T1MPType && T2MPType &&
3971       hasSameUnqualifiedType(QualType(T1MPType->getClass(), 0),
3972                              QualType(T2MPType->getClass(), 0))) {
3973     T1 = T1MPType->getPointeeType();
3974     T2 = T2MPType->getPointeeType();
3975     return true;
3976   }
3977 
3978   if (getLangOpts().ObjC1) {
3979     const ObjCObjectPointerType *T1OPType = T1->getAs<ObjCObjectPointerType>(),
3980                                 *T2OPType = T2->getAs<ObjCObjectPointerType>();
3981     if (T1OPType && T2OPType) {
3982       T1 = T1OPType->getPointeeType();
3983       T2 = T2OPType->getPointeeType();
3984       return true;
3985     }
3986   }
3987 
3988   // FIXME: Block pointers, too?
3989 
3990   return false;
3991 }
3992 
3993 DeclarationNameInfo
3994 ASTContext::getNameForTemplate(TemplateName Name,
3995                                SourceLocation NameLoc) const {
3996   switch (Name.getKind()) {
3997   case TemplateName::QualifiedTemplate:
3998   case TemplateName::Template:
3999     // DNInfo work in progress: CHECKME: what about DNLoc?
4000     return DeclarationNameInfo(Name.getAsTemplateDecl()->getDeclName(),
4001                                NameLoc);
4002 
4003   case TemplateName::OverloadedTemplate: {
4004     OverloadedTemplateStorage *Storage = Name.getAsOverloadedTemplate();
4005     // DNInfo work in progress: CHECKME: what about DNLoc?
4006     return DeclarationNameInfo((*Storage->begin())->getDeclName(), NameLoc);
4007   }
4008 
4009   case TemplateName::DependentTemplate: {
4010     DependentTemplateName *DTN = Name.getAsDependentTemplateName();
4011     DeclarationName DName;
4012     if (DTN->isIdentifier()) {
4013       DName = DeclarationNames.getIdentifier(DTN->getIdentifier());
4014       return DeclarationNameInfo(DName, NameLoc);
4015     } else {
4016       DName = DeclarationNames.getCXXOperatorName(DTN->getOperator());
4017       // DNInfo work in progress: FIXME: source locations?
4018       DeclarationNameLoc DNLoc;
4019       DNLoc.CXXOperatorName.BeginOpNameLoc = SourceLocation().getRawEncoding();
4020       DNLoc.CXXOperatorName.EndOpNameLoc = SourceLocation().getRawEncoding();
4021       return DeclarationNameInfo(DName, NameLoc, DNLoc);
4022     }
4023   }
4024 
4025   case TemplateName::SubstTemplateTemplateParm: {
4026     SubstTemplateTemplateParmStorage *subst
4027       = Name.getAsSubstTemplateTemplateParm();
4028     return DeclarationNameInfo(subst->getParameter()->getDeclName(),
4029                                NameLoc);
4030   }
4031 
4032   case TemplateName::SubstTemplateTemplateParmPack: {
4033     SubstTemplateTemplateParmPackStorage *subst
4034       = Name.getAsSubstTemplateTemplateParmPack();
4035     return DeclarationNameInfo(subst->getParameterPack()->getDeclName(),
4036                                NameLoc);
4037   }
4038   }
4039 
4040   llvm_unreachable("bad template name kind!");
4041 }
4042 
4043 TemplateName ASTContext::getCanonicalTemplateName(TemplateName Name) const {
4044   switch (Name.getKind()) {
4045   case TemplateName::QualifiedTemplate:
4046   case TemplateName::Template: {
4047     TemplateDecl *Template = Name.getAsTemplateDecl();
4048     if (TemplateTemplateParmDecl *TTP
4049           = dyn_cast<TemplateTemplateParmDecl>(Template))
4050       Template = getCanonicalTemplateTemplateParmDecl(TTP);
4051 
4052     // The canonical template name is the canonical template declaration.
4053     return TemplateName(cast<TemplateDecl>(Template->getCanonicalDecl()));
4054   }
4055 
4056   case TemplateName::OverloadedTemplate:
4057     llvm_unreachable("cannot canonicalize overloaded template");
4058 
4059   case TemplateName::DependentTemplate: {
4060     DependentTemplateName *DTN = Name.getAsDependentTemplateName();
4061     assert(DTN && "Non-dependent template names must refer to template decls.");
4062     return DTN->CanonicalTemplateName;
4063   }
4064 
4065   case TemplateName::SubstTemplateTemplateParm: {
4066     SubstTemplateTemplateParmStorage *subst
4067       = Name.getAsSubstTemplateTemplateParm();
4068     return getCanonicalTemplateName(subst->getReplacement());
4069   }
4070 
4071   case TemplateName::SubstTemplateTemplateParmPack: {
4072     SubstTemplateTemplateParmPackStorage *subst
4073                                   = Name.getAsSubstTemplateTemplateParmPack();
4074     TemplateTemplateParmDecl *canonParameter
4075       = getCanonicalTemplateTemplateParmDecl(subst->getParameterPack());
4076     TemplateArgument canonArgPack
4077       = getCanonicalTemplateArgument(subst->getArgumentPack());
4078     return getSubstTemplateTemplateParmPack(canonParameter, canonArgPack);
4079   }
4080   }
4081 
4082   llvm_unreachable("bad template name!");
4083 }
4084 
4085 bool ASTContext::hasSameTemplateName(TemplateName X, TemplateName Y) {
4086   X = getCanonicalTemplateName(X);
4087   Y = getCanonicalTemplateName(Y);
4088   return X.getAsVoidPointer() == Y.getAsVoidPointer();
4089 }
4090 
4091 TemplateArgument
4092 ASTContext::getCanonicalTemplateArgument(const TemplateArgument &Arg) const {
4093   switch (Arg.getKind()) {
4094     case TemplateArgument::Null:
4095       return Arg;
4096 
4097     case TemplateArgument::Expression:
4098       return Arg;
4099 
4100     case TemplateArgument::Declaration: {
4101       ValueDecl *D = cast<ValueDecl>(Arg.getAsDecl()->getCanonicalDecl());
4102       return TemplateArgument(D, Arg.isDeclForReferenceParam());
4103     }
4104 
4105     case TemplateArgument::NullPtr:
4106       return TemplateArgument(getCanonicalType(Arg.getNullPtrType()),
4107                               /*isNullPtr*/true);
4108 
4109     case TemplateArgument::Template:
4110       return TemplateArgument(getCanonicalTemplateName(Arg.getAsTemplate()));
4111 
4112     case TemplateArgument::TemplateExpansion:
4113       return TemplateArgument(getCanonicalTemplateName(
4114                                          Arg.getAsTemplateOrTemplatePattern()),
4115                               Arg.getNumTemplateExpansions());
4116 
4117     case TemplateArgument::Integral:
4118       return TemplateArgument(Arg, getCanonicalType(Arg.getIntegralType()));
4119 
4120     case TemplateArgument::Type:
4121       return TemplateArgument(getCanonicalType(Arg.getAsType()));
4122 
4123     case TemplateArgument::Pack: {
4124       if (Arg.pack_size() == 0)
4125         return Arg;
4126 
4127       TemplateArgument *CanonArgs
4128         = new (*this) TemplateArgument[Arg.pack_size()];
4129       unsigned Idx = 0;
4130       for (TemplateArgument::pack_iterator A = Arg.pack_begin(),
4131                                         AEnd = Arg.pack_end();
4132            A != AEnd; (void)++A, ++Idx)
4133         CanonArgs[Idx] = getCanonicalTemplateArgument(*A);
4134 
4135       return TemplateArgument(CanonArgs, Arg.pack_size());
4136     }
4137   }
4138 
4139   // Silence GCC warning
4140   llvm_unreachable("Unhandled template argument kind");
4141 }
4142 
4143 NestedNameSpecifier *
4144 ASTContext::getCanonicalNestedNameSpecifier(NestedNameSpecifier *NNS) const {
4145   if (!NNS)
4146     return 0;
4147 
4148   switch (NNS->getKind()) {
4149   case NestedNameSpecifier::Identifier:
4150     // Canonicalize the prefix but keep the identifier the same.
4151     return NestedNameSpecifier::Create(*this,
4152                          getCanonicalNestedNameSpecifier(NNS->getPrefix()),
4153                                        NNS->getAsIdentifier());
4154 
4155   case NestedNameSpecifier::Namespace:
4156     // A namespace is canonical; build a nested-name-specifier with
4157     // this namespace and no prefix.
4158     return NestedNameSpecifier::Create(*this, 0,
4159                                  NNS->getAsNamespace()->getOriginalNamespace());
4160 
4161   case NestedNameSpecifier::NamespaceAlias:
4162     // A namespace is canonical; build a nested-name-specifier with
4163     // this namespace and no prefix.
4164     return NestedNameSpecifier::Create(*this, 0,
4165                                     NNS->getAsNamespaceAlias()->getNamespace()
4166                                                       ->getOriginalNamespace());
4167 
4168   case NestedNameSpecifier::TypeSpec:
4169   case NestedNameSpecifier::TypeSpecWithTemplate: {
4170     QualType T = getCanonicalType(QualType(NNS->getAsType(), 0));
4171 
4172     // If we have some kind of dependent-named type (e.g., "typename T::type"),
4173     // break it apart into its prefix and identifier, then reconsititute those
4174     // as the canonical nested-name-specifier. This is required to canonicalize
4175     // a dependent nested-name-specifier involving typedefs of dependent-name
4176     // types, e.g.,
4177     //   typedef typename T::type T1;
4178     //   typedef typename T1::type T2;
4179     if (const DependentNameType *DNT = T->getAs<DependentNameType>())
4180       return NestedNameSpecifier::Create(*this, DNT->getQualifier(),
4181                            const_cast<IdentifierInfo *>(DNT->getIdentifier()));
4182 
4183     // Otherwise, just canonicalize the type, and force it to be a TypeSpec.
4184     // FIXME: Why are TypeSpec and TypeSpecWithTemplate distinct in the
4185     // first place?
4186     return NestedNameSpecifier::Create(*this, 0, false,
4187                                        const_cast<Type*>(T.getTypePtr()));
4188   }
4189 
4190   case NestedNameSpecifier::Global:
4191     // The global specifier is canonical and unique.
4192     return NNS;
4193   }
4194 
4195   llvm_unreachable("Invalid NestedNameSpecifier::Kind!");
4196 }
4197 
4198 
4199 const ArrayType *ASTContext::getAsArrayType(QualType T) const {
4200   // Handle the non-qualified case efficiently.
4201   if (!T.hasLocalQualifiers()) {
4202     // Handle the common positive case fast.
4203     if (const ArrayType *AT = dyn_cast<ArrayType>(T))
4204       return AT;
4205   }
4206 
4207   // Handle the common negative case fast.
4208   if (!isa<ArrayType>(T.getCanonicalType()))
4209     return 0;
4210 
4211   // Apply any qualifiers from the array type to the element type.  This
4212   // implements C99 6.7.3p8: "If the specification of an array type includes
4213   // any type qualifiers, the element type is so qualified, not the array type."
4214 
4215   // If we get here, we either have type qualifiers on the type, or we have
4216   // sugar such as a typedef in the way.  If we have type qualifiers on the type
4217   // we must propagate them down into the element type.
4218 
4219   SplitQualType split = T.getSplitDesugaredType();
4220   Qualifiers qs = split.Quals;
4221 
4222   // If we have a simple case, just return now.
4223   const ArrayType *ATy = dyn_cast<ArrayType>(split.Ty);
4224   if (ATy == 0 || qs.empty())
4225     return ATy;
4226 
4227   // Otherwise, we have an array and we have qualifiers on it.  Push the
4228   // qualifiers into the array element type and return a new array type.
4229   QualType NewEltTy = getQualifiedType(ATy->getElementType(), qs);
4230 
4231   if (const ConstantArrayType *CAT = dyn_cast<ConstantArrayType>(ATy))
4232     return cast<ArrayType>(getConstantArrayType(NewEltTy, CAT->getSize(),
4233                                                 CAT->getSizeModifier(),
4234                                            CAT->getIndexTypeCVRQualifiers()));
4235   if (const IncompleteArrayType *IAT = dyn_cast<IncompleteArrayType>(ATy))
4236     return cast<ArrayType>(getIncompleteArrayType(NewEltTy,
4237                                                   IAT->getSizeModifier(),
4238                                            IAT->getIndexTypeCVRQualifiers()));
4239 
4240   if (const DependentSizedArrayType *DSAT
4241         = dyn_cast<DependentSizedArrayType>(ATy))
4242     return cast<ArrayType>(
4243                      getDependentSizedArrayType(NewEltTy,
4244                                                 DSAT->getSizeExpr(),
4245                                                 DSAT->getSizeModifier(),
4246                                               DSAT->getIndexTypeCVRQualifiers(),
4247                                                 DSAT->getBracketsRange()));
4248 
4249   const VariableArrayType *VAT = cast<VariableArrayType>(ATy);
4250   return cast<ArrayType>(getVariableArrayType(NewEltTy,
4251                                               VAT->getSizeExpr(),
4252                                               VAT->getSizeModifier(),
4253                                               VAT->getIndexTypeCVRQualifiers(),
4254                                               VAT->getBracketsRange()));
4255 }
4256 
4257 QualType ASTContext::getAdjustedParameterType(QualType T) const {
4258   if (T->isArrayType() || T->isFunctionType())
4259     return getDecayedType(T);
4260   return T;
4261 }
4262 
4263 QualType ASTContext::getSignatureParameterType(QualType T) const {
4264   T = getVariableArrayDecayedType(T);
4265   T = getAdjustedParameterType(T);
4266   return T.getUnqualifiedType();
4267 }
4268 
4269 /// getArrayDecayedType - Return the properly qualified result of decaying the
4270 /// specified array type to a pointer.  This operation is non-trivial when
4271 /// handling typedefs etc.  The canonical type of "T" must be an array type,
4272 /// this returns a pointer to a properly qualified element of the array.
4273 ///
4274 /// See C99 6.7.5.3p7 and C99 6.3.2.1p3.
4275 QualType ASTContext::getArrayDecayedType(QualType Ty) const {
4276   // Get the element type with 'getAsArrayType' so that we don't lose any
4277   // typedefs in the element type of the array.  This also handles propagation
4278   // of type qualifiers from the array type into the element type if present
4279   // (C99 6.7.3p8).
4280   const ArrayType *PrettyArrayType = getAsArrayType(Ty);
4281   assert(PrettyArrayType && "Not an array type!");
4282 
4283   QualType PtrTy = getPointerType(PrettyArrayType->getElementType());
4284 
4285   // int x[restrict 4] ->  int *restrict
4286   return getQualifiedType(PtrTy, PrettyArrayType->getIndexTypeQualifiers());
4287 }
4288 
4289 QualType ASTContext::getBaseElementType(const ArrayType *array) const {
4290   return getBaseElementType(array->getElementType());
4291 }
4292 
4293 QualType ASTContext::getBaseElementType(QualType type) const {
4294   Qualifiers qs;
4295   while (true) {
4296     SplitQualType split = type.getSplitDesugaredType();
4297     const ArrayType *array = split.Ty->getAsArrayTypeUnsafe();
4298     if (!array) break;
4299 
4300     type = array->getElementType();
4301     qs.addConsistentQualifiers(split.Quals);
4302   }
4303 
4304   return getQualifiedType(type, qs);
4305 }
4306 
4307 /// getConstantArrayElementCount - Returns number of constant array elements.
4308 uint64_t
4309 ASTContext::getConstantArrayElementCount(const ConstantArrayType *CA)  const {
4310   uint64_t ElementCount = 1;
4311   do {
4312     ElementCount *= CA->getSize().getZExtValue();
4313     CA = dyn_cast_or_null<ConstantArrayType>(
4314       CA->getElementType()->getAsArrayTypeUnsafe());
4315   } while (CA);
4316   return ElementCount;
4317 }
4318 
4319 /// getFloatingRank - Return a relative rank for floating point types.
4320 /// This routine will assert if passed a built-in type that isn't a float.
4321 static FloatingRank getFloatingRank(QualType T) {
4322   if (const ComplexType *CT = T->getAs<ComplexType>())
4323     return getFloatingRank(CT->getElementType());
4324 
4325   assert(T->getAs<BuiltinType>() && "getFloatingRank(): not a floating type");
4326   switch (T->getAs<BuiltinType>()->getKind()) {
4327   default: llvm_unreachable("getFloatingRank(): not a floating type");
4328   case BuiltinType::Half:       return HalfRank;
4329   case BuiltinType::Float:      return FloatRank;
4330   case BuiltinType::Double:     return DoubleRank;
4331   case BuiltinType::LongDouble: return LongDoubleRank;
4332   }
4333 }
4334 
4335 /// getFloatingTypeOfSizeWithinDomain - Returns a real floating
4336 /// point or a complex type (based on typeDomain/typeSize).
4337 /// 'typeDomain' is a real floating point or complex type.
4338 /// 'typeSize' is a real floating point or complex type.
4339 QualType ASTContext::getFloatingTypeOfSizeWithinDomain(QualType Size,
4340                                                        QualType Domain) const {
4341   FloatingRank EltRank = getFloatingRank(Size);
4342   if (Domain->isComplexType()) {
4343     switch (EltRank) {
4344     case HalfRank: llvm_unreachable("Complex half is not supported");
4345     case FloatRank:      return FloatComplexTy;
4346     case DoubleRank:     return DoubleComplexTy;
4347     case LongDoubleRank: return LongDoubleComplexTy;
4348     }
4349   }
4350 
4351   assert(Domain->isRealFloatingType() && "Unknown domain!");
4352   switch (EltRank) {
4353   case HalfRank:       return HalfTy;
4354   case FloatRank:      return FloatTy;
4355   case DoubleRank:     return DoubleTy;
4356   case LongDoubleRank: return LongDoubleTy;
4357   }
4358   llvm_unreachable("getFloatingRank(): illegal value for rank");
4359 }
4360 
4361 /// getFloatingTypeOrder - Compare the rank of the two specified floating
4362 /// point types, ignoring the domain of the type (i.e. 'double' ==
4363 /// '_Complex double').  If LHS > RHS, return 1.  If LHS == RHS, return 0. If
4364 /// LHS < RHS, return -1.
4365 int ASTContext::getFloatingTypeOrder(QualType LHS, QualType RHS) const {
4366   FloatingRank LHSR = getFloatingRank(LHS);
4367   FloatingRank RHSR = getFloatingRank(RHS);
4368 
4369   if (LHSR == RHSR)
4370     return 0;
4371   if (LHSR > RHSR)
4372     return 1;
4373   return -1;
4374 }
4375 
4376 /// getIntegerRank - Return an integer conversion rank (C99 6.3.1.1p1). This
4377 /// routine will assert if passed a built-in type that isn't an integer or enum,
4378 /// or if it is not canonicalized.
4379 unsigned ASTContext::getIntegerRank(const Type *T) const {
4380   assert(T->isCanonicalUnqualified() && "T should be canonicalized");
4381 
4382   switch (cast<BuiltinType>(T)->getKind()) {
4383   default: llvm_unreachable("getIntegerRank(): not a built-in integer");
4384   case BuiltinType::Bool:
4385     return 1 + (getIntWidth(BoolTy) << 3);
4386   case BuiltinType::Char_S:
4387   case BuiltinType::Char_U:
4388   case BuiltinType::SChar:
4389   case BuiltinType::UChar:
4390     return 2 + (getIntWidth(CharTy) << 3);
4391   case BuiltinType::Short:
4392   case BuiltinType::UShort:
4393     return 3 + (getIntWidth(ShortTy) << 3);
4394   case BuiltinType::Int:
4395   case BuiltinType::UInt:
4396     return 4 + (getIntWidth(IntTy) << 3);
4397   case BuiltinType::Long:
4398   case BuiltinType::ULong:
4399     return 5 + (getIntWidth(LongTy) << 3);
4400   case BuiltinType::LongLong:
4401   case BuiltinType::ULongLong:
4402     return 6 + (getIntWidth(LongLongTy) << 3);
4403   case BuiltinType::Int128:
4404   case BuiltinType::UInt128:
4405     return 7 + (getIntWidth(Int128Ty) << 3);
4406   }
4407 }
4408 
4409 /// \brief Whether this is a promotable bitfield reference according
4410 /// to C99 6.3.1.1p2, bullet 2 (and GCC extensions).
4411 ///
4412 /// \returns the type this bit-field will promote to, or NULL if no
4413 /// promotion occurs.
4414 QualType ASTContext::isPromotableBitField(Expr *E) const {
4415   if (E->isTypeDependent() || E->isValueDependent())
4416     return QualType();
4417 
4418   FieldDecl *Field = E->getSourceBitField(); // FIXME: conditional bit-fields?
4419   if (!Field)
4420     return QualType();
4421 
4422   QualType FT = Field->getType();
4423 
4424   uint64_t BitWidth = Field->getBitWidthValue(*this);
4425   uint64_t IntSize = getTypeSize(IntTy);
4426   // GCC extension compatibility: if the bit-field size is less than or equal
4427   // to the size of int, it gets promoted no matter what its type is.
4428   // For instance, unsigned long bf : 4 gets promoted to signed int.
4429   if (BitWidth < IntSize)
4430     return IntTy;
4431 
4432   if (BitWidth == IntSize)
4433     return FT->isSignedIntegerType() ? IntTy : UnsignedIntTy;
4434 
4435   // Types bigger than int are not subject to promotions, and therefore act
4436   // like the base type.
4437   // FIXME: This doesn't quite match what gcc does, but what gcc does here
4438   // is ridiculous.
4439   return QualType();
4440 }
4441 
4442 /// getPromotedIntegerType - Returns the type that Promotable will
4443 /// promote to: C99 6.3.1.1p2, assuming that Promotable is a promotable
4444 /// integer type.
4445 QualType ASTContext::getPromotedIntegerType(QualType Promotable) const {
4446   assert(!Promotable.isNull());
4447   assert(Promotable->isPromotableIntegerType());
4448   if (const EnumType *ET = Promotable->getAs<EnumType>())
4449     return ET->getDecl()->getPromotionType();
4450 
4451   if (const BuiltinType *BT = Promotable->getAs<BuiltinType>()) {
4452     // C++ [conv.prom]: A prvalue of type char16_t, char32_t, or wchar_t
4453     // (3.9.1) can be converted to a prvalue of the first of the following
4454     // types that can represent all the values of its underlying type:
4455     // int, unsigned int, long int, unsigned long int, long long int, or
4456     // unsigned long long int [...]
4457     // FIXME: Is there some better way to compute this?
4458     if (BT->getKind() == BuiltinType::WChar_S ||
4459         BT->getKind() == BuiltinType::WChar_U ||
4460         BT->getKind() == BuiltinType::Char16 ||
4461         BT->getKind() == BuiltinType::Char32) {
4462       bool FromIsSigned = BT->getKind() == BuiltinType::WChar_S;
4463       uint64_t FromSize = getTypeSize(BT);
4464       QualType PromoteTypes[] = { IntTy, UnsignedIntTy, LongTy, UnsignedLongTy,
4465                                   LongLongTy, UnsignedLongLongTy };
4466       for (size_t Idx = 0; Idx < llvm::array_lengthof(PromoteTypes); ++Idx) {
4467         uint64_t ToSize = getTypeSize(PromoteTypes[Idx]);
4468         if (FromSize < ToSize ||
4469             (FromSize == ToSize &&
4470              FromIsSigned == PromoteTypes[Idx]->isSignedIntegerType()))
4471           return PromoteTypes[Idx];
4472       }
4473       llvm_unreachable("char type should fit into long long");
4474     }
4475   }
4476 
4477   // At this point, we should have a signed or unsigned integer type.
4478   if (Promotable->isSignedIntegerType())
4479     return IntTy;
4480   uint64_t PromotableSize = getIntWidth(Promotable);
4481   uint64_t IntSize = getIntWidth(IntTy);
4482   assert(Promotable->isUnsignedIntegerType() && PromotableSize <= IntSize);
4483   return (PromotableSize != IntSize) ? IntTy : UnsignedIntTy;
4484 }
4485 
4486 /// \brief Recurses in pointer/array types until it finds an objc retainable
4487 /// type and returns its ownership.
4488 Qualifiers::ObjCLifetime ASTContext::getInnerObjCOwnership(QualType T) const {
4489   while (!T.isNull()) {
4490     if (T.getObjCLifetime() != Qualifiers::OCL_None)
4491       return T.getObjCLifetime();
4492     if (T->isArrayType())
4493       T = getBaseElementType(T);
4494     else if (const PointerType *PT = T->getAs<PointerType>())
4495       T = PT->getPointeeType();
4496     else if (const ReferenceType *RT = T->getAs<ReferenceType>())
4497       T = RT->getPointeeType();
4498     else
4499       break;
4500   }
4501 
4502   return Qualifiers::OCL_None;
4503 }
4504 
4505 static const Type *getIntegerTypeForEnum(const EnumType *ET) {
4506   // Incomplete enum types are not treated as integer types.
4507   // FIXME: In C++, enum types are never integer types.
4508   if (ET->getDecl()->isComplete() && !ET->getDecl()->isScoped())
4509     return ET->getDecl()->getIntegerType().getTypePtr();
4510   return NULL;
4511 }
4512 
4513 /// getIntegerTypeOrder - Returns the highest ranked integer type:
4514 /// C99 6.3.1.8p1.  If LHS > RHS, return 1.  If LHS == RHS, return 0. If
4515 /// LHS < RHS, return -1.
4516 int ASTContext::getIntegerTypeOrder(QualType LHS, QualType RHS) const {
4517   const Type *LHSC = getCanonicalType(LHS).getTypePtr();
4518   const Type *RHSC = getCanonicalType(RHS).getTypePtr();
4519 
4520   // Unwrap enums to their underlying type.
4521   if (const EnumType *ET = dyn_cast<EnumType>(LHSC))
4522     LHSC = getIntegerTypeForEnum(ET);
4523   if (const EnumType *ET = dyn_cast<EnumType>(RHSC))
4524     RHSC = getIntegerTypeForEnum(ET);
4525 
4526   if (LHSC == RHSC) return 0;
4527 
4528   bool LHSUnsigned = LHSC->isUnsignedIntegerType();
4529   bool RHSUnsigned = RHSC->isUnsignedIntegerType();
4530 
4531   unsigned LHSRank = getIntegerRank(LHSC);
4532   unsigned RHSRank = getIntegerRank(RHSC);
4533 
4534   if (LHSUnsigned == RHSUnsigned) {  // Both signed or both unsigned.
4535     if (LHSRank == RHSRank) return 0;
4536     return LHSRank > RHSRank ? 1 : -1;
4537   }
4538 
4539   // Otherwise, the LHS is signed and the RHS is unsigned or visa versa.
4540   if (LHSUnsigned) {
4541     // If the unsigned [LHS] type is larger, return it.
4542     if (LHSRank >= RHSRank)
4543       return 1;
4544 
4545     // If the signed type can represent all values of the unsigned type, it
4546     // wins.  Because we are dealing with 2's complement and types that are
4547     // powers of two larger than each other, this is always safe.
4548     return -1;
4549   }
4550 
4551   // If the unsigned [RHS] type is larger, return it.
4552   if (RHSRank >= LHSRank)
4553     return -1;
4554 
4555   // If the signed type can represent all values of the unsigned type, it
4556   // wins.  Because we are dealing with 2's complement and types that are
4557   // powers of two larger than each other, this is always safe.
4558   return 1;
4559 }
4560 
4561 // getCFConstantStringType - Return the type used for constant CFStrings.
4562 QualType ASTContext::getCFConstantStringType() const {
4563   if (!CFConstantStringTypeDecl) {
4564     CFConstantStringTypeDecl = buildImplicitRecord("NSConstantString");
4565     CFConstantStringTypeDecl->startDefinition();
4566 
4567     QualType FieldTypes[4];
4568 
4569     // const int *isa;
4570     FieldTypes[0] = getPointerType(IntTy.withConst());
4571     // int flags;
4572     FieldTypes[1] = IntTy;
4573     // const char *str;
4574     FieldTypes[2] = getPointerType(CharTy.withConst());
4575     // long length;
4576     FieldTypes[3] = LongTy;
4577 
4578     // Create fields
4579     for (unsigned i = 0; i < 4; ++i) {
4580       FieldDecl *Field = FieldDecl::Create(*this, CFConstantStringTypeDecl,
4581                                            SourceLocation(),
4582                                            SourceLocation(), 0,
4583                                            FieldTypes[i], /*TInfo=*/0,
4584                                            /*BitWidth=*/0,
4585                                            /*Mutable=*/false,
4586                                            ICIS_NoInit);
4587       Field->setAccess(AS_public);
4588       CFConstantStringTypeDecl->addDecl(Field);
4589     }
4590 
4591     CFConstantStringTypeDecl->completeDefinition();
4592   }
4593 
4594   return getTagDeclType(CFConstantStringTypeDecl);
4595 }
4596 
4597 QualType ASTContext::getObjCSuperType() const {
4598   if (ObjCSuperType.isNull()) {
4599     RecordDecl *ObjCSuperTypeDecl = buildImplicitRecord("objc_super");
4600     TUDecl->addDecl(ObjCSuperTypeDecl);
4601     ObjCSuperType = getTagDeclType(ObjCSuperTypeDecl);
4602   }
4603   return ObjCSuperType;
4604 }
4605 
4606 void ASTContext::setCFConstantStringType(QualType T) {
4607   const RecordType *Rec = T->getAs<RecordType>();
4608   assert(Rec && "Invalid CFConstantStringType");
4609   CFConstantStringTypeDecl = Rec->getDecl();
4610 }
4611 
4612 QualType ASTContext::getBlockDescriptorType() const {
4613   if (BlockDescriptorType)
4614     return getTagDeclType(BlockDescriptorType);
4615 
4616   RecordDecl *RD;
4617   // FIXME: Needs the FlagAppleBlock bit.
4618   RD = buildImplicitRecord("__block_descriptor");
4619   RD->startDefinition();
4620 
4621   QualType FieldTypes[] = {
4622     UnsignedLongTy,
4623     UnsignedLongTy,
4624   };
4625 
4626   static const char *const FieldNames[] = {
4627     "reserved",
4628     "Size"
4629   };
4630 
4631   for (size_t i = 0; i < 2; ++i) {
4632     FieldDecl *Field = FieldDecl::Create(
4633         *this, RD, SourceLocation(), SourceLocation(),
4634         &Idents.get(FieldNames[i]), FieldTypes[i], /*TInfo=*/0,
4635         /*BitWidth=*/0, /*Mutable=*/false, ICIS_NoInit);
4636     Field->setAccess(AS_public);
4637     RD->addDecl(Field);
4638   }
4639 
4640   RD->completeDefinition();
4641 
4642   BlockDescriptorType = RD;
4643 
4644   return getTagDeclType(BlockDescriptorType);
4645 }
4646 
4647 QualType ASTContext::getBlockDescriptorExtendedType() const {
4648   if (BlockDescriptorExtendedType)
4649     return getTagDeclType(BlockDescriptorExtendedType);
4650 
4651   RecordDecl *RD;
4652   // FIXME: Needs the FlagAppleBlock bit.
4653   RD = buildImplicitRecord("__block_descriptor_withcopydispose");
4654   RD->startDefinition();
4655 
4656   QualType FieldTypes[] = {
4657     UnsignedLongTy,
4658     UnsignedLongTy,
4659     getPointerType(VoidPtrTy),
4660     getPointerType(VoidPtrTy)
4661   };
4662 
4663   static const char *const FieldNames[] = {
4664     "reserved",
4665     "Size",
4666     "CopyFuncPtr",
4667     "DestroyFuncPtr"
4668   };
4669 
4670   for (size_t i = 0; i < 4; ++i) {
4671     FieldDecl *Field = FieldDecl::Create(
4672         *this, RD, SourceLocation(), SourceLocation(),
4673         &Idents.get(FieldNames[i]), FieldTypes[i], /*TInfo=*/0,
4674         /*BitWidth=*/0,
4675         /*Mutable=*/false, ICIS_NoInit);
4676     Field->setAccess(AS_public);
4677     RD->addDecl(Field);
4678   }
4679 
4680   RD->completeDefinition();
4681 
4682   BlockDescriptorExtendedType = RD;
4683   return getTagDeclType(BlockDescriptorExtendedType);
4684 }
4685 
4686 /// BlockRequiresCopying - Returns true if byref variable "D" of type "Ty"
4687 /// requires copy/dispose. Note that this must match the logic
4688 /// in buildByrefHelpers.
4689 bool ASTContext::BlockRequiresCopying(QualType Ty,
4690                                       const VarDecl *D) {
4691   if (const CXXRecordDecl *record = Ty->getAsCXXRecordDecl()) {
4692     const Expr *copyExpr = getBlockVarCopyInits(D);
4693     if (!copyExpr && record->hasTrivialDestructor()) return false;
4694 
4695     return true;
4696   }
4697 
4698   if (!Ty->isObjCRetainableType()) return false;
4699 
4700   Qualifiers qs = Ty.getQualifiers();
4701 
4702   // If we have lifetime, that dominates.
4703   if (Qualifiers::ObjCLifetime lifetime = qs.getObjCLifetime()) {
4704     assert(getLangOpts().ObjCAutoRefCount);
4705 
4706     switch (lifetime) {
4707       case Qualifiers::OCL_None: llvm_unreachable("impossible");
4708 
4709       // These are just bits as far as the runtime is concerned.
4710       case Qualifiers::OCL_ExplicitNone:
4711       case Qualifiers::OCL_Autoreleasing:
4712         return false;
4713 
4714       // Tell the runtime that this is ARC __weak, called by the
4715       // byref routines.
4716       case Qualifiers::OCL_Weak:
4717       // ARC __strong __block variables need to be retained.
4718       case Qualifiers::OCL_Strong:
4719         return true;
4720     }
4721     llvm_unreachable("fell out of lifetime switch!");
4722   }
4723   return (Ty->isBlockPointerType() || isObjCNSObjectType(Ty) ||
4724           Ty->isObjCObjectPointerType());
4725 }
4726 
4727 bool ASTContext::getByrefLifetime(QualType Ty,
4728                               Qualifiers::ObjCLifetime &LifeTime,
4729                               bool &HasByrefExtendedLayout) const {
4730 
4731   if (!getLangOpts().ObjC1 ||
4732       getLangOpts().getGC() != LangOptions::NonGC)
4733     return false;
4734 
4735   HasByrefExtendedLayout = false;
4736   if (Ty->isRecordType()) {
4737     HasByrefExtendedLayout = true;
4738     LifeTime = Qualifiers::OCL_None;
4739   }
4740   else if (getLangOpts().ObjCAutoRefCount)
4741     LifeTime = Ty.getObjCLifetime();
4742   // MRR.
4743   else if (Ty->isObjCObjectPointerType() || Ty->isBlockPointerType())
4744     LifeTime = Qualifiers::OCL_ExplicitNone;
4745   else
4746     LifeTime = Qualifiers::OCL_None;
4747   return true;
4748 }
4749 
4750 TypedefDecl *ASTContext::getObjCInstanceTypeDecl() {
4751   if (!ObjCInstanceTypeDecl)
4752     ObjCInstanceTypeDecl =
4753         buildImplicitTypedef(getObjCIdType(), "instancetype");
4754   return ObjCInstanceTypeDecl;
4755 }
4756 
4757 // This returns true if a type has been typedefed to BOOL:
4758 // typedef <type> BOOL;
4759 static bool isTypeTypedefedAsBOOL(QualType T) {
4760   if (const TypedefType *TT = dyn_cast<TypedefType>(T))
4761     if (IdentifierInfo *II = TT->getDecl()->getIdentifier())
4762       return II->isStr("BOOL");
4763 
4764   return false;
4765 }
4766 
4767 /// getObjCEncodingTypeSize returns size of type for objective-c encoding
4768 /// purpose.
4769 CharUnits ASTContext::getObjCEncodingTypeSize(QualType type) const {
4770   if (!type->isIncompleteArrayType() && type->isIncompleteType())
4771     return CharUnits::Zero();
4772 
4773   CharUnits sz = getTypeSizeInChars(type);
4774 
4775   // Make all integer and enum types at least as large as an int
4776   if (sz.isPositive() && type->isIntegralOrEnumerationType())
4777     sz = std::max(sz, getTypeSizeInChars(IntTy));
4778   // Treat arrays as pointers, since that's how they're passed in.
4779   else if (type->isArrayType())
4780     sz = getTypeSizeInChars(VoidPtrTy);
4781   return sz;
4782 }
4783 
4784 static inline
4785 std::string charUnitsToString(const CharUnits &CU) {
4786   return llvm::itostr(CU.getQuantity());
4787 }
4788 
4789 /// getObjCEncodingForBlock - Return the encoded type for this block
4790 /// declaration.
4791 std::string ASTContext::getObjCEncodingForBlock(const BlockExpr *Expr) const {
4792   std::string S;
4793 
4794   const BlockDecl *Decl = Expr->getBlockDecl();
4795   QualType BlockTy =
4796       Expr->getType()->getAs<BlockPointerType>()->getPointeeType();
4797   // Encode result type.
4798   if (getLangOpts().EncodeExtendedBlockSig)
4799     getObjCEncodingForMethodParameter(
4800         Decl::OBJC_TQ_None, BlockTy->getAs<FunctionType>()->getReturnType(), S,
4801         true /*Extended*/);
4802   else
4803     getObjCEncodingForType(BlockTy->getAs<FunctionType>()->getReturnType(), S);
4804   // Compute size of all parameters.
4805   // Start with computing size of a pointer in number of bytes.
4806   // FIXME: There might(should) be a better way of doing this computation!
4807   SourceLocation Loc;
4808   CharUnits PtrSize = getTypeSizeInChars(VoidPtrTy);
4809   CharUnits ParmOffset = PtrSize;
4810   for (BlockDecl::param_const_iterator PI = Decl->param_begin(),
4811        E = Decl->param_end(); PI != E; ++PI) {
4812     QualType PType = (*PI)->getType();
4813     CharUnits sz = getObjCEncodingTypeSize(PType);
4814     if (sz.isZero())
4815       continue;
4816     assert (sz.isPositive() && "BlockExpr - Incomplete param type");
4817     ParmOffset += sz;
4818   }
4819   // Size of the argument frame
4820   S += charUnitsToString(ParmOffset);
4821   // Block pointer and offset.
4822   S += "@?0";
4823 
4824   // Argument types.
4825   ParmOffset = PtrSize;
4826   for (BlockDecl::param_const_iterator PI = Decl->param_begin(), E =
4827        Decl->param_end(); PI != E; ++PI) {
4828     ParmVarDecl *PVDecl = *PI;
4829     QualType PType = PVDecl->getOriginalType();
4830     if (const ArrayType *AT =
4831           dyn_cast<ArrayType>(PType->getCanonicalTypeInternal())) {
4832       // Use array's original type only if it has known number of
4833       // elements.
4834       if (!isa<ConstantArrayType>(AT))
4835         PType = PVDecl->getType();
4836     } else if (PType->isFunctionType())
4837       PType = PVDecl->getType();
4838     if (getLangOpts().EncodeExtendedBlockSig)
4839       getObjCEncodingForMethodParameter(Decl::OBJC_TQ_None, PType,
4840                                       S, true /*Extended*/);
4841     else
4842       getObjCEncodingForType(PType, S);
4843     S += charUnitsToString(ParmOffset);
4844     ParmOffset += getObjCEncodingTypeSize(PType);
4845   }
4846 
4847   return S;
4848 }
4849 
4850 bool ASTContext::getObjCEncodingForFunctionDecl(const FunctionDecl *Decl,
4851                                                 std::string& S) {
4852   // Encode result type.
4853   getObjCEncodingForType(Decl->getReturnType(), S);
4854   CharUnits ParmOffset;
4855   // Compute size of all parameters.
4856   for (FunctionDecl::param_const_iterator PI = Decl->param_begin(),
4857        E = Decl->param_end(); PI != E; ++PI) {
4858     QualType PType = (*PI)->getType();
4859     CharUnits sz = getObjCEncodingTypeSize(PType);
4860     if (sz.isZero())
4861       continue;
4862 
4863     assert (sz.isPositive() &&
4864         "getObjCEncodingForFunctionDecl - Incomplete param type");
4865     ParmOffset += sz;
4866   }
4867   S += charUnitsToString(ParmOffset);
4868   ParmOffset = CharUnits::Zero();
4869 
4870   // Argument types.
4871   for (FunctionDecl::param_const_iterator PI = Decl->param_begin(),
4872        E = Decl->param_end(); PI != E; ++PI) {
4873     ParmVarDecl *PVDecl = *PI;
4874     QualType PType = PVDecl->getOriginalType();
4875     if (const ArrayType *AT =
4876           dyn_cast<ArrayType>(PType->getCanonicalTypeInternal())) {
4877       // Use array's original type only if it has known number of
4878       // elements.
4879       if (!isa<ConstantArrayType>(AT))
4880         PType = PVDecl->getType();
4881     } else if (PType->isFunctionType())
4882       PType = PVDecl->getType();
4883     getObjCEncodingForType(PType, S);
4884     S += charUnitsToString(ParmOffset);
4885     ParmOffset += getObjCEncodingTypeSize(PType);
4886   }
4887 
4888   return false;
4889 }
4890 
4891 /// getObjCEncodingForMethodParameter - Return the encoded type for a single
4892 /// method parameter or return type. If Extended, include class names and
4893 /// block object types.
4894 void ASTContext::getObjCEncodingForMethodParameter(Decl::ObjCDeclQualifier QT,
4895                                                    QualType T, std::string& S,
4896                                                    bool Extended) const {
4897   // Encode type qualifer, 'in', 'inout', etc. for the parameter.
4898   getObjCEncodingForTypeQualifier(QT, S);
4899   // Encode parameter type.
4900   getObjCEncodingForTypeImpl(T, S, true, true, 0,
4901                              true     /*OutermostType*/,
4902                              false    /*EncodingProperty*/,
4903                              false    /*StructField*/,
4904                              Extended /*EncodeBlockParameters*/,
4905                              Extended /*EncodeClassNames*/);
4906 }
4907 
4908 /// getObjCEncodingForMethodDecl - Return the encoded type for this method
4909 /// declaration.
4910 bool ASTContext::getObjCEncodingForMethodDecl(const ObjCMethodDecl *Decl,
4911                                               std::string& S,
4912                                               bool Extended) const {
4913   // FIXME: This is not very efficient.
4914   // Encode return type.
4915   getObjCEncodingForMethodParameter(Decl->getObjCDeclQualifier(),
4916                                     Decl->getReturnType(), S, Extended);
4917   // Compute size of all parameters.
4918   // Start with computing size of a pointer in number of bytes.
4919   // FIXME: There might(should) be a better way of doing this computation!
4920   SourceLocation Loc;
4921   CharUnits PtrSize = getTypeSizeInChars(VoidPtrTy);
4922   // The first two arguments (self and _cmd) are pointers; account for
4923   // their size.
4924   CharUnits ParmOffset = 2 * PtrSize;
4925   for (ObjCMethodDecl::param_const_iterator PI = Decl->param_begin(),
4926        E = Decl->sel_param_end(); PI != E; ++PI) {
4927     QualType PType = (*PI)->getType();
4928     CharUnits sz = getObjCEncodingTypeSize(PType);
4929     if (sz.isZero())
4930       continue;
4931 
4932     assert (sz.isPositive() &&
4933         "getObjCEncodingForMethodDecl - Incomplete param type");
4934     ParmOffset += sz;
4935   }
4936   S += charUnitsToString(ParmOffset);
4937   S += "@0:";
4938   S += charUnitsToString(PtrSize);
4939 
4940   // Argument types.
4941   ParmOffset = 2 * PtrSize;
4942   for (ObjCMethodDecl::param_const_iterator PI = Decl->param_begin(),
4943        E = Decl->sel_param_end(); PI != E; ++PI) {
4944     const ParmVarDecl *PVDecl = *PI;
4945     QualType PType = PVDecl->getOriginalType();
4946     if (const ArrayType *AT =
4947           dyn_cast<ArrayType>(PType->getCanonicalTypeInternal())) {
4948       // Use array's original type only if it has known number of
4949       // elements.
4950       if (!isa<ConstantArrayType>(AT))
4951         PType = PVDecl->getType();
4952     } else if (PType->isFunctionType())
4953       PType = PVDecl->getType();
4954     getObjCEncodingForMethodParameter(PVDecl->getObjCDeclQualifier(),
4955                                       PType, S, Extended);
4956     S += charUnitsToString(ParmOffset);
4957     ParmOffset += getObjCEncodingTypeSize(PType);
4958   }
4959 
4960   return false;
4961 }
4962 
4963 ObjCPropertyImplDecl *
4964 ASTContext::getObjCPropertyImplDeclForPropertyDecl(
4965                                       const ObjCPropertyDecl *PD,
4966                                       const Decl *Container) const {
4967   if (!Container)
4968     return 0;
4969   if (const ObjCCategoryImplDecl *CID =
4970       dyn_cast<ObjCCategoryImplDecl>(Container)) {
4971     for (ObjCCategoryImplDecl::propimpl_iterator
4972          i = CID->propimpl_begin(), e = CID->propimpl_end();
4973          i != e; ++i) {
4974       ObjCPropertyImplDecl *PID = *i;
4975         if (PID->getPropertyDecl() == PD)
4976           return PID;
4977       }
4978     } else {
4979       const ObjCImplementationDecl *OID=cast<ObjCImplementationDecl>(Container);
4980       for (ObjCCategoryImplDecl::propimpl_iterator
4981            i = OID->propimpl_begin(), e = OID->propimpl_end();
4982            i != e; ++i) {
4983         ObjCPropertyImplDecl *PID = *i;
4984         if (PID->getPropertyDecl() == PD)
4985           return PID;
4986       }
4987     }
4988   return 0;
4989 }
4990 
4991 /// getObjCEncodingForPropertyDecl - Return the encoded type for this
4992 /// property declaration. If non-NULL, Container must be either an
4993 /// ObjCCategoryImplDecl or ObjCImplementationDecl; it should only be
4994 /// NULL when getting encodings for protocol properties.
4995 /// Property attributes are stored as a comma-delimited C string. The simple
4996 /// attributes readonly and bycopy are encoded as single characters. The
4997 /// parametrized attributes, getter=name, setter=name, and ivar=name, are
4998 /// encoded as single characters, followed by an identifier. Property types
4999 /// are also encoded as a parametrized attribute. The characters used to encode
5000 /// these attributes are defined by the following enumeration:
5001 /// @code
5002 /// enum PropertyAttributes {
5003 /// kPropertyReadOnly = 'R',   // property is read-only.
5004 /// kPropertyBycopy = 'C',     // property is a copy of the value last assigned
5005 /// kPropertyByref = '&',  // property is a reference to the value last assigned
5006 /// kPropertyDynamic = 'D',    // property is dynamic
5007 /// kPropertyGetter = 'G',     // followed by getter selector name
5008 /// kPropertySetter = 'S',     // followed by setter selector name
5009 /// kPropertyInstanceVariable = 'V'  // followed by instance variable  name
5010 /// kPropertyType = 'T'              // followed by old-style type encoding.
5011 /// kPropertyWeak = 'W'              // 'weak' property
5012 /// kPropertyStrong = 'P'            // property GC'able
5013 /// kPropertyNonAtomic = 'N'         // property non-atomic
5014 /// };
5015 /// @endcode
5016 void ASTContext::getObjCEncodingForPropertyDecl(const ObjCPropertyDecl *PD,
5017                                                 const Decl *Container,
5018                                                 std::string& S) const {
5019   // Collect information from the property implementation decl(s).
5020   bool Dynamic = false;
5021   ObjCPropertyImplDecl *SynthesizePID = 0;
5022 
5023   if (ObjCPropertyImplDecl *PropertyImpDecl =
5024       getObjCPropertyImplDeclForPropertyDecl(PD, Container)) {
5025     if (PropertyImpDecl->getPropertyImplementation() == ObjCPropertyImplDecl::Dynamic)
5026       Dynamic = true;
5027     else
5028       SynthesizePID = PropertyImpDecl;
5029   }
5030 
5031   // FIXME: This is not very efficient.
5032   S = "T";
5033 
5034   // Encode result type.
5035   // GCC has some special rules regarding encoding of properties which
5036   // closely resembles encoding of ivars.
5037   getObjCEncodingForTypeImpl(PD->getType(), S, true, true, 0,
5038                              true /* outermost type */,
5039                              true /* encoding for property */);
5040 
5041   if (PD->isReadOnly()) {
5042     S += ",R";
5043     if (PD->getPropertyAttributes() & ObjCPropertyDecl::OBJC_PR_copy)
5044       S += ",C";
5045     if (PD->getPropertyAttributes() & ObjCPropertyDecl::OBJC_PR_retain)
5046       S += ",&";
5047   } else {
5048     switch (PD->getSetterKind()) {
5049     case ObjCPropertyDecl::Assign: break;
5050     case ObjCPropertyDecl::Copy:   S += ",C"; break;
5051     case ObjCPropertyDecl::Retain: S += ",&"; break;
5052     case ObjCPropertyDecl::Weak:   S += ",W"; break;
5053     }
5054   }
5055 
5056   // It really isn't clear at all what this means, since properties
5057   // are "dynamic by default".
5058   if (Dynamic)
5059     S += ",D";
5060 
5061   if (PD->getPropertyAttributes() & ObjCPropertyDecl::OBJC_PR_nonatomic)
5062     S += ",N";
5063 
5064   if (PD->getPropertyAttributes() & ObjCPropertyDecl::OBJC_PR_getter) {
5065     S += ",G";
5066     S += PD->getGetterName().getAsString();
5067   }
5068 
5069   if (PD->getPropertyAttributes() & ObjCPropertyDecl::OBJC_PR_setter) {
5070     S += ",S";
5071     S += PD->getSetterName().getAsString();
5072   }
5073 
5074   if (SynthesizePID) {
5075     const ObjCIvarDecl *OID = SynthesizePID->getPropertyIvarDecl();
5076     S += ",V";
5077     S += OID->getNameAsString();
5078   }
5079 
5080   // FIXME: OBJCGC: weak & strong
5081 }
5082 
5083 /// getLegacyIntegralTypeEncoding -
5084 /// Another legacy compatibility encoding: 32-bit longs are encoded as
5085 /// 'l' or 'L' , but not always.  For typedefs, we need to use
5086 /// 'i' or 'I' instead if encoding a struct field, or a pointer!
5087 ///
5088 void ASTContext::getLegacyIntegralTypeEncoding (QualType &PointeeTy) const {
5089   if (isa<TypedefType>(PointeeTy.getTypePtr())) {
5090     if (const BuiltinType *BT = PointeeTy->getAs<BuiltinType>()) {
5091       if (BT->getKind() == BuiltinType::ULong && getIntWidth(PointeeTy) == 32)
5092         PointeeTy = UnsignedIntTy;
5093       else
5094         if (BT->getKind() == BuiltinType::Long && getIntWidth(PointeeTy) == 32)
5095           PointeeTy = IntTy;
5096     }
5097   }
5098 }
5099 
5100 void ASTContext::getObjCEncodingForType(QualType T, std::string& S,
5101                                         const FieldDecl *Field) const {
5102   // We follow the behavior of gcc, expanding structures which are
5103   // directly pointed to, and expanding embedded structures. Note that
5104   // these rules are sufficient to prevent recursive encoding of the
5105   // same type.
5106   getObjCEncodingForTypeImpl(T, S, true, true, Field,
5107                              true /* outermost type */);
5108 }
5109 
5110 static char getObjCEncodingForPrimitiveKind(const ASTContext *C,
5111                                             BuiltinType::Kind kind) {
5112     switch (kind) {
5113     case BuiltinType::Void:       return 'v';
5114     case BuiltinType::Bool:       return 'B';
5115     case BuiltinType::Char_U:
5116     case BuiltinType::UChar:      return 'C';
5117     case BuiltinType::Char16:
5118     case BuiltinType::UShort:     return 'S';
5119     case BuiltinType::Char32:
5120     case BuiltinType::UInt:       return 'I';
5121     case BuiltinType::ULong:
5122         return C->getTargetInfo().getLongWidth() == 32 ? 'L' : 'Q';
5123     case BuiltinType::UInt128:    return 'T';
5124     case BuiltinType::ULongLong:  return 'Q';
5125     case BuiltinType::Char_S:
5126     case BuiltinType::SChar:      return 'c';
5127     case BuiltinType::Short:      return 's';
5128     case BuiltinType::WChar_S:
5129     case BuiltinType::WChar_U:
5130     case BuiltinType::Int:        return 'i';
5131     case BuiltinType::Long:
5132       return C->getTargetInfo().getLongWidth() == 32 ? 'l' : 'q';
5133     case BuiltinType::LongLong:   return 'q';
5134     case BuiltinType::Int128:     return 't';
5135     case BuiltinType::Float:      return 'f';
5136     case BuiltinType::Double:     return 'd';
5137     case BuiltinType::LongDouble: return 'D';
5138     case BuiltinType::NullPtr:    return '*'; // like char*
5139 
5140     case BuiltinType::Half:
5141       // FIXME: potentially need @encodes for these!
5142       return ' ';
5143 
5144     case BuiltinType::ObjCId:
5145     case BuiltinType::ObjCClass:
5146     case BuiltinType::ObjCSel:
5147       llvm_unreachable("@encoding ObjC primitive type");
5148 
5149     // OpenCL and placeholder types don't need @encodings.
5150     case BuiltinType::OCLImage1d:
5151     case BuiltinType::OCLImage1dArray:
5152     case BuiltinType::OCLImage1dBuffer:
5153     case BuiltinType::OCLImage2d:
5154     case BuiltinType::OCLImage2dArray:
5155     case BuiltinType::OCLImage3d:
5156     case BuiltinType::OCLEvent:
5157     case BuiltinType::OCLSampler:
5158     case BuiltinType::Dependent:
5159 #define BUILTIN_TYPE(KIND, ID)
5160 #define PLACEHOLDER_TYPE(KIND, ID) \
5161     case BuiltinType::KIND:
5162 #include "clang/AST/BuiltinTypes.def"
5163       llvm_unreachable("invalid builtin type for @encode");
5164     }
5165     llvm_unreachable("invalid BuiltinType::Kind value");
5166 }
5167 
5168 static char ObjCEncodingForEnumType(const ASTContext *C, const EnumType *ET) {
5169   EnumDecl *Enum = ET->getDecl();
5170 
5171   // The encoding of an non-fixed enum type is always 'i', regardless of size.
5172   if (!Enum->isFixed())
5173     return 'i';
5174 
5175   // The encoding of a fixed enum type matches its fixed underlying type.
5176   const BuiltinType *BT = Enum->getIntegerType()->castAs<BuiltinType>();
5177   return getObjCEncodingForPrimitiveKind(C, BT->getKind());
5178 }
5179 
5180 static void EncodeBitField(const ASTContext *Ctx, std::string& S,
5181                            QualType T, const FieldDecl *FD) {
5182   assert(FD->isBitField() && "not a bitfield - getObjCEncodingForTypeImpl");
5183   S += 'b';
5184   // The NeXT runtime encodes bit fields as b followed by the number of bits.
5185   // The GNU runtime requires more information; bitfields are encoded as b,
5186   // then the offset (in bits) of the first element, then the type of the
5187   // bitfield, then the size in bits.  For example, in this structure:
5188   //
5189   // struct
5190   // {
5191   //    int integer;
5192   //    int flags:2;
5193   // };
5194   // On a 32-bit system, the encoding for flags would be b2 for the NeXT
5195   // runtime, but b32i2 for the GNU runtime.  The reason for this extra
5196   // information is not especially sensible, but we're stuck with it for
5197   // compatibility with GCC, although providing it breaks anything that
5198   // actually uses runtime introspection and wants to work on both runtimes...
5199   if (Ctx->getLangOpts().ObjCRuntime.isGNUFamily()) {
5200     const RecordDecl *RD = FD->getParent();
5201     const ASTRecordLayout &RL = Ctx->getASTRecordLayout(RD);
5202     S += llvm::utostr(RL.getFieldOffset(FD->getFieldIndex()));
5203     if (const EnumType *ET = T->getAs<EnumType>())
5204       S += ObjCEncodingForEnumType(Ctx, ET);
5205     else {
5206       const BuiltinType *BT = T->castAs<BuiltinType>();
5207       S += getObjCEncodingForPrimitiveKind(Ctx, BT->getKind());
5208     }
5209   }
5210   S += llvm::utostr(FD->getBitWidthValue(*Ctx));
5211 }
5212 
5213 // FIXME: Use SmallString for accumulating string.
5214 void ASTContext::getObjCEncodingForTypeImpl(QualType T, std::string& S,
5215                                             bool ExpandPointedToStructures,
5216                                             bool ExpandStructures,
5217                                             const FieldDecl *FD,
5218                                             bool OutermostType,
5219                                             bool EncodingProperty,
5220                                             bool StructField,
5221                                             bool EncodeBlockParameters,
5222                                             bool EncodeClassNames,
5223                                             bool EncodePointerToObjCTypedef) const {
5224   CanQualType CT = getCanonicalType(T);
5225   switch (CT->getTypeClass()) {
5226   case Type::Builtin:
5227   case Type::Enum:
5228     if (FD && FD->isBitField())
5229       return EncodeBitField(this, S, T, FD);
5230     if (const BuiltinType *BT = dyn_cast<BuiltinType>(CT))
5231       S += getObjCEncodingForPrimitiveKind(this, BT->getKind());
5232     else
5233       S += ObjCEncodingForEnumType(this, cast<EnumType>(CT));
5234     return;
5235 
5236   case Type::Complex: {
5237     const ComplexType *CT = T->castAs<ComplexType>();
5238     S += 'j';
5239     getObjCEncodingForTypeImpl(CT->getElementType(), S, false, false, 0, false,
5240                                false);
5241     return;
5242   }
5243 
5244   case Type::Atomic: {
5245     const AtomicType *AT = T->castAs<AtomicType>();
5246     S += 'A';
5247     getObjCEncodingForTypeImpl(AT->getValueType(), S, false, false, 0,
5248                                false, false);
5249     return;
5250   }
5251 
5252   // encoding for pointer or reference types.
5253   case Type::Pointer:
5254   case Type::LValueReference:
5255   case Type::RValueReference: {
5256     QualType PointeeTy;
5257     if (isa<PointerType>(CT)) {
5258       const PointerType *PT = T->castAs<PointerType>();
5259       if (PT->isObjCSelType()) {
5260         S += ':';
5261         return;
5262       }
5263       PointeeTy = PT->getPointeeType();
5264     } else {
5265       PointeeTy = T->castAs<ReferenceType>()->getPointeeType();
5266     }
5267 
5268     bool isReadOnly = false;
5269     // For historical/compatibility reasons, the read-only qualifier of the
5270     // pointee gets emitted _before_ the '^'.  The read-only qualifier of
5271     // the pointer itself gets ignored, _unless_ we are looking at a typedef!
5272     // Also, do not emit the 'r' for anything but the outermost type!
5273     if (isa<TypedefType>(T.getTypePtr())) {
5274       if (OutermostType && T.isConstQualified()) {
5275         isReadOnly = true;
5276         S += 'r';
5277       }
5278     } else if (OutermostType) {
5279       QualType P = PointeeTy;
5280       while (P->getAs<PointerType>())
5281         P = P->getAs<PointerType>()->getPointeeType();
5282       if (P.isConstQualified()) {
5283         isReadOnly = true;
5284         S += 'r';
5285       }
5286     }
5287     if (isReadOnly) {
5288       // Another legacy compatibility encoding. Some ObjC qualifier and type
5289       // combinations need to be rearranged.
5290       // Rewrite "in const" from "nr" to "rn"
5291       if (StringRef(S).endswith("nr"))
5292         S.replace(S.end()-2, S.end(), "rn");
5293     }
5294 
5295     if (PointeeTy->isCharType()) {
5296       // char pointer types should be encoded as '*' unless it is a
5297       // type that has been typedef'd to 'BOOL'.
5298       if (!isTypeTypedefedAsBOOL(PointeeTy)) {
5299         S += '*';
5300         return;
5301       }
5302     } else if (const RecordType *RTy = PointeeTy->getAs<RecordType>()) {
5303       // GCC binary compat: Need to convert "struct objc_class *" to "#".
5304       if (RTy->getDecl()->getIdentifier() == &Idents.get("objc_class")) {
5305         S += '#';
5306         return;
5307       }
5308       // GCC binary compat: Need to convert "struct objc_object *" to "@".
5309       if (RTy->getDecl()->getIdentifier() == &Idents.get("objc_object")) {
5310         S += '@';
5311         return;
5312       }
5313       // fall through...
5314     }
5315     S += '^';
5316     getLegacyIntegralTypeEncoding(PointeeTy);
5317 
5318     getObjCEncodingForTypeImpl(PointeeTy, S, false, ExpandPointedToStructures,
5319                                NULL);
5320     return;
5321   }
5322 
5323   case Type::ConstantArray:
5324   case Type::IncompleteArray:
5325   case Type::VariableArray: {
5326     const ArrayType *AT = cast<ArrayType>(CT);
5327 
5328     if (isa<IncompleteArrayType>(AT) && !StructField) {
5329       // Incomplete arrays are encoded as a pointer to the array element.
5330       S += '^';
5331 
5332       getObjCEncodingForTypeImpl(AT->getElementType(), S,
5333                                  false, ExpandStructures, FD);
5334     } else {
5335       S += '[';
5336 
5337       if (const ConstantArrayType *CAT = dyn_cast<ConstantArrayType>(AT))
5338         S += llvm::utostr(CAT->getSize().getZExtValue());
5339       else {
5340         //Variable length arrays are encoded as a regular array with 0 elements.
5341         assert((isa<VariableArrayType>(AT) || isa<IncompleteArrayType>(AT)) &&
5342                "Unknown array type!");
5343         S += '0';
5344       }
5345 
5346       getObjCEncodingForTypeImpl(AT->getElementType(), S,
5347                                  false, ExpandStructures, FD);
5348       S += ']';
5349     }
5350     return;
5351   }
5352 
5353   case Type::FunctionNoProto:
5354   case Type::FunctionProto:
5355     S += '?';
5356     return;
5357 
5358   case Type::Record: {
5359     RecordDecl *RDecl = cast<RecordType>(CT)->getDecl();
5360     S += RDecl->isUnion() ? '(' : '{';
5361     // Anonymous structures print as '?'
5362     if (const IdentifierInfo *II = RDecl->getIdentifier()) {
5363       S += II->getName();
5364       if (ClassTemplateSpecializationDecl *Spec
5365           = dyn_cast<ClassTemplateSpecializationDecl>(RDecl)) {
5366         const TemplateArgumentList &TemplateArgs = Spec->getTemplateArgs();
5367         llvm::raw_string_ostream OS(S);
5368         TemplateSpecializationType::PrintTemplateArgumentList(OS,
5369                                             TemplateArgs.data(),
5370                                             TemplateArgs.size(),
5371                                             (*this).getPrintingPolicy());
5372       }
5373     } else {
5374       S += '?';
5375     }
5376     if (ExpandStructures) {
5377       S += '=';
5378       if (!RDecl->isUnion()) {
5379         getObjCEncodingForStructureImpl(RDecl, S, FD);
5380       } else {
5381         for (RecordDecl::field_iterator Field = RDecl->field_begin(),
5382                                      FieldEnd = RDecl->field_end();
5383              Field != FieldEnd; ++Field) {
5384           if (FD) {
5385             S += '"';
5386             S += Field->getNameAsString();
5387             S += '"';
5388           }
5389 
5390           // Special case bit-fields.
5391           if (Field->isBitField()) {
5392             getObjCEncodingForTypeImpl(Field->getType(), S, false, true,
5393                                        *Field);
5394           } else {
5395             QualType qt = Field->getType();
5396             getLegacyIntegralTypeEncoding(qt);
5397             getObjCEncodingForTypeImpl(qt, S, false, true,
5398                                        FD, /*OutermostType*/false,
5399                                        /*EncodingProperty*/false,
5400                                        /*StructField*/true);
5401           }
5402         }
5403       }
5404     }
5405     S += RDecl->isUnion() ? ')' : '}';
5406     return;
5407   }
5408 
5409   case Type::BlockPointer: {
5410     const BlockPointerType *BT = T->castAs<BlockPointerType>();
5411     S += "@?"; // Unlike a pointer-to-function, which is "^?".
5412     if (EncodeBlockParameters) {
5413       const FunctionType *FT = BT->getPointeeType()->castAs<FunctionType>();
5414 
5415       S += '<';
5416       // Block return type
5417       getObjCEncodingForTypeImpl(
5418           FT->getReturnType(), S, ExpandPointedToStructures, ExpandStructures,
5419           FD, false /* OutermostType */, EncodingProperty,
5420           false /* StructField */, EncodeBlockParameters, EncodeClassNames);
5421       // Block self
5422       S += "@?";
5423       // Block parameters
5424       if (const FunctionProtoType *FPT = dyn_cast<FunctionProtoType>(FT)) {
5425         for (FunctionProtoType::param_type_iterator I = FPT->param_type_begin(),
5426                                                     E = FPT->param_type_end();
5427              I && (I != E); ++I) {
5428           getObjCEncodingForTypeImpl(*I, S,
5429                                      ExpandPointedToStructures,
5430                                      ExpandStructures,
5431                                      FD,
5432                                      false /* OutermostType */,
5433                                      EncodingProperty,
5434                                      false /* StructField */,
5435                                      EncodeBlockParameters,
5436                                      EncodeClassNames);
5437         }
5438       }
5439       S += '>';
5440     }
5441     return;
5442   }
5443 
5444   case Type::ObjCObject: {
5445     // hack to match legacy encoding of *id and *Class
5446     QualType Ty = getObjCObjectPointerType(CT);
5447     if (Ty->isObjCIdType()) {
5448       S += "{objc_object=}";
5449       return;
5450     }
5451     else if (Ty->isObjCClassType()) {
5452       S += "{objc_class=}";
5453       return;
5454     }
5455   }
5456 
5457   case Type::ObjCInterface: {
5458     // Ignore protocol qualifiers when mangling at this level.
5459     T = T->castAs<ObjCObjectType>()->getBaseType();
5460 
5461     // The assumption seems to be that this assert will succeed
5462     // because nested levels will have filtered out 'id' and 'Class'.
5463     const ObjCInterfaceType *OIT = T->castAs<ObjCInterfaceType>();
5464     // @encode(class_name)
5465     ObjCInterfaceDecl *OI = OIT->getDecl();
5466     S += '{';
5467     const IdentifierInfo *II = OI->getIdentifier();
5468     S += II->getName();
5469     S += '=';
5470     SmallVector<const ObjCIvarDecl*, 32> Ivars;
5471     DeepCollectObjCIvars(OI, true, Ivars);
5472     for (unsigned i = 0, e = Ivars.size(); i != e; ++i) {
5473       const FieldDecl *Field = cast<FieldDecl>(Ivars[i]);
5474       if (Field->isBitField())
5475         getObjCEncodingForTypeImpl(Field->getType(), S, false, true, Field);
5476       else
5477         getObjCEncodingForTypeImpl(Field->getType(), S, false, true, FD,
5478                                    false, false, false, false, false,
5479                                    EncodePointerToObjCTypedef);
5480     }
5481     S += '}';
5482     return;
5483   }
5484 
5485   case Type::ObjCObjectPointer: {
5486     const ObjCObjectPointerType *OPT = T->castAs<ObjCObjectPointerType>();
5487     if (OPT->isObjCIdType()) {
5488       S += '@';
5489       return;
5490     }
5491 
5492     if (OPT->isObjCClassType() || OPT->isObjCQualifiedClassType()) {
5493       // FIXME: Consider if we need to output qualifiers for 'Class<p>'.
5494       // Since this is a binary compatibility issue, need to consult with runtime
5495       // folks. Fortunately, this is a *very* obsure construct.
5496       S += '#';
5497       return;
5498     }
5499 
5500     if (OPT->isObjCQualifiedIdType()) {
5501       getObjCEncodingForTypeImpl(getObjCIdType(), S,
5502                                  ExpandPointedToStructures,
5503                                  ExpandStructures, FD);
5504       if (FD || EncodingProperty || EncodeClassNames) {
5505         // Note that we do extended encoding of protocol qualifer list
5506         // Only when doing ivar or property encoding.
5507         S += '"';
5508         for (ObjCObjectPointerType::qual_iterator I = OPT->qual_begin(),
5509              E = OPT->qual_end(); I != E; ++I) {
5510           S += '<';
5511           S += (*I)->getNameAsString();
5512           S += '>';
5513         }
5514         S += '"';
5515       }
5516       return;
5517     }
5518 
5519     QualType PointeeTy = OPT->getPointeeType();
5520     if (!EncodingProperty &&
5521         isa<TypedefType>(PointeeTy.getTypePtr()) &&
5522         !EncodePointerToObjCTypedef) {
5523       // Another historical/compatibility reason.
5524       // We encode the underlying type which comes out as
5525       // {...};
5526       S += '^';
5527       if (FD && OPT->getInterfaceDecl()) {
5528         // Prevent recursive encoding of fields in some rare cases.
5529         ObjCInterfaceDecl *OI = OPT->getInterfaceDecl();
5530         SmallVector<const ObjCIvarDecl*, 32> Ivars;
5531         DeepCollectObjCIvars(OI, true, Ivars);
5532         for (unsigned i = 0, e = Ivars.size(); i != e; ++i) {
5533           if (cast<FieldDecl>(Ivars[i]) == FD) {
5534             S += '{';
5535             S += OI->getIdentifier()->getName();
5536             S += '}';
5537             return;
5538           }
5539         }
5540       }
5541       getObjCEncodingForTypeImpl(PointeeTy, S,
5542                                  false, ExpandPointedToStructures,
5543                                  NULL,
5544                                  false, false, false, false, false,
5545                                  /*EncodePointerToObjCTypedef*/true);
5546       return;
5547     }
5548 
5549     S += '@';
5550     if (OPT->getInterfaceDecl() &&
5551         (FD || EncodingProperty || EncodeClassNames)) {
5552       S += '"';
5553       S += OPT->getInterfaceDecl()->getIdentifier()->getName();
5554       for (ObjCObjectPointerType::qual_iterator I = OPT->qual_begin(),
5555            E = OPT->qual_end(); I != E; ++I) {
5556         S += '<';
5557         S += (*I)->getNameAsString();
5558         S += '>';
5559       }
5560       S += '"';
5561     }
5562     return;
5563   }
5564 
5565   // gcc just blithely ignores member pointers.
5566   // FIXME: we shoul do better than that.  'M' is available.
5567   case Type::MemberPointer:
5568     return;
5569 
5570   case Type::Vector:
5571   case Type::ExtVector:
5572     // This matches gcc's encoding, even though technically it is
5573     // insufficient.
5574     // FIXME. We should do a better job than gcc.
5575     return;
5576 
5577   case Type::Auto:
5578     // We could see an undeduced auto type here during error recovery.
5579     // Just ignore it.
5580     return;
5581 
5582 #define ABSTRACT_TYPE(KIND, BASE)
5583 #define TYPE(KIND, BASE)
5584 #define DEPENDENT_TYPE(KIND, BASE) \
5585   case Type::KIND:
5586 #define NON_CANONICAL_TYPE(KIND, BASE) \
5587   case Type::KIND:
5588 #define NON_CANONICAL_UNLESS_DEPENDENT_TYPE(KIND, BASE) \
5589   case Type::KIND:
5590 #include "clang/AST/TypeNodes.def"
5591     llvm_unreachable("@encode for dependent type!");
5592   }
5593   llvm_unreachable("bad type kind!");
5594 }
5595 
5596 void ASTContext::getObjCEncodingForStructureImpl(RecordDecl *RDecl,
5597                                                  std::string &S,
5598                                                  const FieldDecl *FD,
5599                                                  bool includeVBases) const {
5600   assert(RDecl && "Expected non-null RecordDecl");
5601   assert(!RDecl->isUnion() && "Should not be called for unions");
5602   if (!RDecl->getDefinition())
5603     return;
5604 
5605   CXXRecordDecl *CXXRec = dyn_cast<CXXRecordDecl>(RDecl);
5606   std::multimap<uint64_t, NamedDecl *> FieldOrBaseOffsets;
5607   const ASTRecordLayout &layout = getASTRecordLayout(RDecl);
5608 
5609   if (CXXRec) {
5610     for (CXXRecordDecl::base_class_iterator
5611            BI = CXXRec->bases_begin(),
5612            BE = CXXRec->bases_end(); BI != BE; ++BI) {
5613       if (!BI->isVirtual()) {
5614         CXXRecordDecl *base = BI->getType()->getAsCXXRecordDecl();
5615         if (base->isEmpty())
5616           continue;
5617         uint64_t offs = toBits(layout.getBaseClassOffset(base));
5618         FieldOrBaseOffsets.insert(FieldOrBaseOffsets.upper_bound(offs),
5619                                   std::make_pair(offs, base));
5620       }
5621     }
5622   }
5623 
5624   unsigned i = 0;
5625   for (RecordDecl::field_iterator Field = RDecl->field_begin(),
5626                                FieldEnd = RDecl->field_end();
5627        Field != FieldEnd; ++Field, ++i) {
5628     uint64_t offs = layout.getFieldOffset(i);
5629     FieldOrBaseOffsets.insert(FieldOrBaseOffsets.upper_bound(offs),
5630                               std::make_pair(offs, *Field));
5631   }
5632 
5633   if (CXXRec && includeVBases) {
5634     for (CXXRecordDecl::base_class_iterator
5635            BI = CXXRec->vbases_begin(),
5636            BE = CXXRec->vbases_end(); BI != BE; ++BI) {
5637       CXXRecordDecl *base = BI->getType()->getAsCXXRecordDecl();
5638       if (base->isEmpty())
5639         continue;
5640       uint64_t offs = toBits(layout.getVBaseClassOffset(base));
5641       if (offs >= uint64_t(toBits(layout.getNonVirtualSize())) &&
5642           FieldOrBaseOffsets.find(offs) == FieldOrBaseOffsets.end())
5643         FieldOrBaseOffsets.insert(FieldOrBaseOffsets.end(),
5644                                   std::make_pair(offs, base));
5645     }
5646   }
5647 
5648   CharUnits size;
5649   if (CXXRec) {
5650     size = includeVBases ? layout.getSize() : layout.getNonVirtualSize();
5651   } else {
5652     size = layout.getSize();
5653   }
5654 
5655 #ifndef NDEBUG
5656   uint64_t CurOffs = 0;
5657 #endif
5658   std::multimap<uint64_t, NamedDecl *>::iterator
5659     CurLayObj = FieldOrBaseOffsets.begin();
5660 
5661   if (CXXRec && CXXRec->isDynamicClass() &&
5662       (CurLayObj == FieldOrBaseOffsets.end() || CurLayObj->first != 0)) {
5663     if (FD) {
5664       S += "\"_vptr$";
5665       std::string recname = CXXRec->getNameAsString();
5666       if (recname.empty()) recname = "?";
5667       S += recname;
5668       S += '"';
5669     }
5670     S += "^^?";
5671 #ifndef NDEBUG
5672     CurOffs += getTypeSize(VoidPtrTy);
5673 #endif
5674   }
5675 
5676   if (!RDecl->hasFlexibleArrayMember()) {
5677     // Mark the end of the structure.
5678     uint64_t offs = toBits(size);
5679     FieldOrBaseOffsets.insert(FieldOrBaseOffsets.upper_bound(offs),
5680                               std::make_pair(offs, (NamedDecl*)0));
5681   }
5682 
5683   for (; CurLayObj != FieldOrBaseOffsets.end(); ++CurLayObj) {
5684 #ifndef NDEBUG
5685     assert(CurOffs <= CurLayObj->first);
5686     if (CurOffs < CurLayObj->first) {
5687       uint64_t padding = CurLayObj->first - CurOffs;
5688       // FIXME: There doesn't seem to be a way to indicate in the encoding that
5689       // packing/alignment of members is different that normal, in which case
5690       // the encoding will be out-of-sync with the real layout.
5691       // If the runtime switches to just consider the size of types without
5692       // taking into account alignment, we could make padding explicit in the
5693       // encoding (e.g. using arrays of chars). The encoding strings would be
5694       // longer then though.
5695       CurOffs += padding;
5696     }
5697 #endif
5698 
5699     NamedDecl *dcl = CurLayObj->second;
5700     if (dcl == 0)
5701       break; // reached end of structure.
5702 
5703     if (CXXRecordDecl *base = dyn_cast<CXXRecordDecl>(dcl)) {
5704       // We expand the bases without their virtual bases since those are going
5705       // in the initial structure. Note that this differs from gcc which
5706       // expands virtual bases each time one is encountered in the hierarchy,
5707       // making the encoding type bigger than it really is.
5708       getObjCEncodingForStructureImpl(base, S, FD, /*includeVBases*/false);
5709       assert(!base->isEmpty());
5710 #ifndef NDEBUG
5711       CurOffs += toBits(getASTRecordLayout(base).getNonVirtualSize());
5712 #endif
5713     } else {
5714       FieldDecl *field = cast<FieldDecl>(dcl);
5715       if (FD) {
5716         S += '"';
5717         S += field->getNameAsString();
5718         S += '"';
5719       }
5720 
5721       if (field->isBitField()) {
5722         EncodeBitField(this, S, field->getType(), field);
5723 #ifndef NDEBUG
5724         CurOffs += field->getBitWidthValue(*this);
5725 #endif
5726       } else {
5727         QualType qt = field->getType();
5728         getLegacyIntegralTypeEncoding(qt);
5729         getObjCEncodingForTypeImpl(qt, S, false, true, FD,
5730                                    /*OutermostType*/false,
5731                                    /*EncodingProperty*/false,
5732                                    /*StructField*/true);
5733 #ifndef NDEBUG
5734         CurOffs += getTypeSize(field->getType());
5735 #endif
5736       }
5737     }
5738   }
5739 }
5740 
5741 void ASTContext::getObjCEncodingForTypeQualifier(Decl::ObjCDeclQualifier QT,
5742                                                  std::string& S) const {
5743   if (QT & Decl::OBJC_TQ_In)
5744     S += 'n';
5745   if (QT & Decl::OBJC_TQ_Inout)
5746     S += 'N';
5747   if (QT & Decl::OBJC_TQ_Out)
5748     S += 'o';
5749   if (QT & Decl::OBJC_TQ_Bycopy)
5750     S += 'O';
5751   if (QT & Decl::OBJC_TQ_Byref)
5752     S += 'R';
5753   if (QT & Decl::OBJC_TQ_Oneway)
5754     S += 'V';
5755 }
5756 
5757 TypedefDecl *ASTContext::getObjCIdDecl() const {
5758   if (!ObjCIdDecl) {
5759     QualType T = getObjCObjectType(ObjCBuiltinIdTy, 0, 0);
5760     T = getObjCObjectPointerType(T);
5761     ObjCIdDecl = buildImplicitTypedef(T, "id");
5762   }
5763   return ObjCIdDecl;
5764 }
5765 
5766 TypedefDecl *ASTContext::getObjCSelDecl() const {
5767   if (!ObjCSelDecl) {
5768     QualType T = getPointerType(ObjCBuiltinSelTy);
5769     ObjCSelDecl = buildImplicitTypedef(T, "SEL");
5770   }
5771   return ObjCSelDecl;
5772 }
5773 
5774 TypedefDecl *ASTContext::getObjCClassDecl() const {
5775   if (!ObjCClassDecl) {
5776     QualType T = getObjCObjectType(ObjCBuiltinClassTy, 0, 0);
5777     T = getObjCObjectPointerType(T);
5778     ObjCClassDecl = buildImplicitTypedef(T, "Class");
5779   }
5780   return ObjCClassDecl;
5781 }
5782 
5783 ObjCInterfaceDecl *ASTContext::getObjCProtocolDecl() const {
5784   if (!ObjCProtocolClassDecl) {
5785     ObjCProtocolClassDecl
5786       = ObjCInterfaceDecl::Create(*this, getTranslationUnitDecl(),
5787                                   SourceLocation(),
5788                                   &Idents.get("Protocol"),
5789                                   /*PrevDecl=*/0,
5790                                   SourceLocation(), true);
5791   }
5792 
5793   return ObjCProtocolClassDecl;
5794 }
5795 
5796 //===----------------------------------------------------------------------===//
5797 // __builtin_va_list Construction Functions
5798 //===----------------------------------------------------------------------===//
5799 
5800 static TypedefDecl *CreateCharPtrBuiltinVaListDecl(const ASTContext *Context) {
5801   // typedef char* __builtin_va_list;
5802   QualType T = Context->getPointerType(Context->CharTy);
5803   return Context->buildImplicitTypedef(T, "__builtin_va_list");
5804 }
5805 
5806 static TypedefDecl *CreateVoidPtrBuiltinVaListDecl(const ASTContext *Context) {
5807   // typedef void* __builtin_va_list;
5808   QualType T = Context->getPointerType(Context->VoidTy);
5809   return Context->buildImplicitTypedef(T, "__builtin_va_list");
5810 }
5811 
5812 static TypedefDecl *
5813 CreateAArch64ABIBuiltinVaListDecl(const ASTContext *Context) {
5814   // struct __va_list
5815   RecordDecl *VaListTagDecl = Context->buildImplicitRecord("__va_list");
5816   if (Context->getLangOpts().CPlusPlus) {
5817     // namespace std { struct __va_list {
5818     NamespaceDecl *NS;
5819     NS = NamespaceDecl::Create(const_cast<ASTContext &>(*Context),
5820                                Context->getTranslationUnitDecl(),
5821                                /*Inline*/false, SourceLocation(),
5822                                SourceLocation(), &Context->Idents.get("std"),
5823                                /*PrevDecl*/0);
5824     NS->setImplicit();
5825     VaListTagDecl->setDeclContext(NS);
5826   }
5827 
5828   VaListTagDecl->startDefinition();
5829 
5830   const size_t NumFields = 5;
5831   QualType FieldTypes[NumFields];
5832   const char *FieldNames[NumFields];
5833 
5834   // void *__stack;
5835   FieldTypes[0] = Context->getPointerType(Context->VoidTy);
5836   FieldNames[0] = "__stack";
5837 
5838   // void *__gr_top;
5839   FieldTypes[1] = Context->getPointerType(Context->VoidTy);
5840   FieldNames[1] = "__gr_top";
5841 
5842   // void *__vr_top;
5843   FieldTypes[2] = Context->getPointerType(Context->VoidTy);
5844   FieldNames[2] = "__vr_top";
5845 
5846   // int __gr_offs;
5847   FieldTypes[3] = Context->IntTy;
5848   FieldNames[3] = "__gr_offs";
5849 
5850   // int __vr_offs;
5851   FieldTypes[4] = Context->IntTy;
5852   FieldNames[4] = "__vr_offs";
5853 
5854   // Create fields
5855   for (unsigned i = 0; i < NumFields; ++i) {
5856     FieldDecl *Field = FieldDecl::Create(const_cast<ASTContext &>(*Context),
5857                                          VaListTagDecl,
5858                                          SourceLocation(),
5859                                          SourceLocation(),
5860                                          &Context->Idents.get(FieldNames[i]),
5861                                          FieldTypes[i], /*TInfo=*/0,
5862                                          /*BitWidth=*/0,
5863                                          /*Mutable=*/false,
5864                                          ICIS_NoInit);
5865     Field->setAccess(AS_public);
5866     VaListTagDecl->addDecl(Field);
5867   }
5868   VaListTagDecl->completeDefinition();
5869   QualType VaListTagType = Context->getRecordType(VaListTagDecl);
5870   Context->VaListTagTy = VaListTagType;
5871 
5872   // } __builtin_va_list;
5873   return Context->buildImplicitTypedef(VaListTagType, "__builtin_va_list");
5874 }
5875 
5876 static TypedefDecl *CreatePowerABIBuiltinVaListDecl(const ASTContext *Context) {
5877   // typedef struct __va_list_tag {
5878   RecordDecl *VaListTagDecl;
5879 
5880   VaListTagDecl = Context->buildImplicitRecord("__va_list_tag");
5881   VaListTagDecl->startDefinition();
5882 
5883   const size_t NumFields = 5;
5884   QualType FieldTypes[NumFields];
5885   const char *FieldNames[NumFields];
5886 
5887   //   unsigned char gpr;
5888   FieldTypes[0] = Context->UnsignedCharTy;
5889   FieldNames[0] = "gpr";
5890 
5891   //   unsigned char fpr;
5892   FieldTypes[1] = Context->UnsignedCharTy;
5893   FieldNames[1] = "fpr";
5894 
5895   //   unsigned short reserved;
5896   FieldTypes[2] = Context->UnsignedShortTy;
5897   FieldNames[2] = "reserved";
5898 
5899   //   void* overflow_arg_area;
5900   FieldTypes[3] = Context->getPointerType(Context->VoidTy);
5901   FieldNames[3] = "overflow_arg_area";
5902 
5903   //   void* reg_save_area;
5904   FieldTypes[4] = Context->getPointerType(Context->VoidTy);
5905   FieldNames[4] = "reg_save_area";
5906 
5907   // Create fields
5908   for (unsigned i = 0; i < NumFields; ++i) {
5909     FieldDecl *Field = FieldDecl::Create(*Context, VaListTagDecl,
5910                                          SourceLocation(),
5911                                          SourceLocation(),
5912                                          &Context->Idents.get(FieldNames[i]),
5913                                          FieldTypes[i], /*TInfo=*/0,
5914                                          /*BitWidth=*/0,
5915                                          /*Mutable=*/false,
5916                                          ICIS_NoInit);
5917     Field->setAccess(AS_public);
5918     VaListTagDecl->addDecl(Field);
5919   }
5920   VaListTagDecl->completeDefinition();
5921   QualType VaListTagType = Context->getRecordType(VaListTagDecl);
5922   Context->VaListTagTy = VaListTagType;
5923 
5924   // } __va_list_tag;
5925   TypedefDecl *VaListTagTypedefDecl =
5926       Context->buildImplicitTypedef(VaListTagType, "__va_list_tag");
5927 
5928   QualType VaListTagTypedefType =
5929     Context->getTypedefType(VaListTagTypedefDecl);
5930 
5931   // typedef __va_list_tag __builtin_va_list[1];
5932   llvm::APInt Size(Context->getTypeSize(Context->getSizeType()), 1);
5933   QualType VaListTagArrayType
5934     = Context->getConstantArrayType(VaListTagTypedefType,
5935                                     Size, ArrayType::Normal, 0);
5936   return Context->buildImplicitTypedef(VaListTagArrayType, "__builtin_va_list");
5937 }
5938 
5939 static TypedefDecl *
5940 CreateX86_64ABIBuiltinVaListDecl(const ASTContext *Context) {
5941   // typedef struct __va_list_tag {
5942   RecordDecl *VaListTagDecl;
5943   VaListTagDecl = Context->buildImplicitRecord("__va_list_tag");
5944   VaListTagDecl->startDefinition();
5945 
5946   const size_t NumFields = 4;
5947   QualType FieldTypes[NumFields];
5948   const char *FieldNames[NumFields];
5949 
5950   //   unsigned gp_offset;
5951   FieldTypes[0] = Context->UnsignedIntTy;
5952   FieldNames[0] = "gp_offset";
5953 
5954   //   unsigned fp_offset;
5955   FieldTypes[1] = Context->UnsignedIntTy;
5956   FieldNames[1] = "fp_offset";
5957 
5958   //   void* overflow_arg_area;
5959   FieldTypes[2] = Context->getPointerType(Context->VoidTy);
5960   FieldNames[2] = "overflow_arg_area";
5961 
5962   //   void* reg_save_area;
5963   FieldTypes[3] = Context->getPointerType(Context->VoidTy);
5964   FieldNames[3] = "reg_save_area";
5965 
5966   // Create fields
5967   for (unsigned i = 0; i < NumFields; ++i) {
5968     FieldDecl *Field = FieldDecl::Create(const_cast<ASTContext &>(*Context),
5969                                          VaListTagDecl,
5970                                          SourceLocation(),
5971                                          SourceLocation(),
5972                                          &Context->Idents.get(FieldNames[i]),
5973                                          FieldTypes[i], /*TInfo=*/0,
5974                                          /*BitWidth=*/0,
5975                                          /*Mutable=*/false,
5976                                          ICIS_NoInit);
5977     Field->setAccess(AS_public);
5978     VaListTagDecl->addDecl(Field);
5979   }
5980   VaListTagDecl->completeDefinition();
5981   QualType VaListTagType = Context->getRecordType(VaListTagDecl);
5982   Context->VaListTagTy = VaListTagType;
5983 
5984   // } __va_list_tag;
5985   TypedefDecl *VaListTagTypedefDecl =
5986       Context->buildImplicitTypedef(VaListTagType, "__va_list_tag");
5987 
5988   QualType VaListTagTypedefType =
5989     Context->getTypedefType(VaListTagTypedefDecl);
5990 
5991   // typedef __va_list_tag __builtin_va_list[1];
5992   llvm::APInt Size(Context->getTypeSize(Context->getSizeType()), 1);
5993   QualType VaListTagArrayType
5994     = Context->getConstantArrayType(VaListTagTypedefType,
5995                                       Size, ArrayType::Normal,0);
5996   return Context->buildImplicitTypedef(VaListTagArrayType, "__builtin_va_list");
5997 }
5998 
5999 static TypedefDecl *CreatePNaClABIBuiltinVaListDecl(const ASTContext *Context) {
6000   // typedef int __builtin_va_list[4];
6001   llvm::APInt Size(Context->getTypeSize(Context->getSizeType()), 4);
6002   QualType IntArrayType
6003     = Context->getConstantArrayType(Context->IntTy,
6004 				    Size, ArrayType::Normal, 0);
6005   return Context->buildImplicitTypedef(IntArrayType, "__builtin_va_list");
6006 }
6007 
6008 static TypedefDecl *
6009 CreateAAPCSABIBuiltinVaListDecl(const ASTContext *Context) {
6010   // struct __va_list
6011   RecordDecl *VaListDecl = Context->buildImplicitRecord("__va_list");
6012   if (Context->getLangOpts().CPlusPlus) {
6013     // namespace std { struct __va_list {
6014     NamespaceDecl *NS;
6015     NS = NamespaceDecl::Create(const_cast<ASTContext &>(*Context),
6016                                Context->getTranslationUnitDecl(),
6017                                /*Inline*/false, SourceLocation(),
6018                                SourceLocation(), &Context->Idents.get("std"),
6019                                /*PrevDecl*/0);
6020     NS->setImplicit();
6021     VaListDecl->setDeclContext(NS);
6022   }
6023 
6024   VaListDecl->startDefinition();
6025 
6026   // void * __ap;
6027   FieldDecl *Field = FieldDecl::Create(const_cast<ASTContext &>(*Context),
6028                                        VaListDecl,
6029                                        SourceLocation(),
6030                                        SourceLocation(),
6031                                        &Context->Idents.get("__ap"),
6032                                        Context->getPointerType(Context->VoidTy),
6033                                        /*TInfo=*/0,
6034                                        /*BitWidth=*/0,
6035                                        /*Mutable=*/false,
6036                                        ICIS_NoInit);
6037   Field->setAccess(AS_public);
6038   VaListDecl->addDecl(Field);
6039 
6040   // };
6041   VaListDecl->completeDefinition();
6042 
6043   // typedef struct __va_list __builtin_va_list;
6044   QualType T = Context->getRecordType(VaListDecl);
6045   return Context->buildImplicitTypedef(T, "__builtin_va_list");
6046 }
6047 
6048 static TypedefDecl *
6049 CreateSystemZBuiltinVaListDecl(const ASTContext *Context) {
6050   // typedef struct __va_list_tag {
6051   RecordDecl *VaListTagDecl;
6052   VaListTagDecl = Context->buildImplicitRecord("__va_list_tag");
6053   VaListTagDecl->startDefinition();
6054 
6055   const size_t NumFields = 4;
6056   QualType FieldTypes[NumFields];
6057   const char *FieldNames[NumFields];
6058 
6059   //   long __gpr;
6060   FieldTypes[0] = Context->LongTy;
6061   FieldNames[0] = "__gpr";
6062 
6063   //   long __fpr;
6064   FieldTypes[1] = Context->LongTy;
6065   FieldNames[1] = "__fpr";
6066 
6067   //   void *__overflow_arg_area;
6068   FieldTypes[2] = Context->getPointerType(Context->VoidTy);
6069   FieldNames[2] = "__overflow_arg_area";
6070 
6071   //   void *__reg_save_area;
6072   FieldTypes[3] = Context->getPointerType(Context->VoidTy);
6073   FieldNames[3] = "__reg_save_area";
6074 
6075   // Create fields
6076   for (unsigned i = 0; i < NumFields; ++i) {
6077     FieldDecl *Field = FieldDecl::Create(const_cast<ASTContext &>(*Context),
6078                                          VaListTagDecl,
6079                                          SourceLocation(),
6080                                          SourceLocation(),
6081                                          &Context->Idents.get(FieldNames[i]),
6082                                          FieldTypes[i], /*TInfo=*/0,
6083                                          /*BitWidth=*/0,
6084                                          /*Mutable=*/false,
6085                                          ICIS_NoInit);
6086     Field->setAccess(AS_public);
6087     VaListTagDecl->addDecl(Field);
6088   }
6089   VaListTagDecl->completeDefinition();
6090   QualType VaListTagType = Context->getRecordType(VaListTagDecl);
6091   Context->VaListTagTy = VaListTagType;
6092 
6093   // } __va_list_tag;
6094   TypedefDecl *VaListTagTypedefDecl =
6095       Context->buildImplicitTypedef(VaListTagType, "__va_list_tag");
6096   QualType VaListTagTypedefType =
6097     Context->getTypedefType(VaListTagTypedefDecl);
6098 
6099   // typedef __va_list_tag __builtin_va_list[1];
6100   llvm::APInt Size(Context->getTypeSize(Context->getSizeType()), 1);
6101   QualType VaListTagArrayType
6102     = Context->getConstantArrayType(VaListTagTypedefType,
6103                                       Size, ArrayType::Normal,0);
6104 
6105   return Context->buildImplicitTypedef(VaListTagArrayType, "__builtin_va_list");
6106 }
6107 
6108 static TypedefDecl *CreateVaListDecl(const ASTContext *Context,
6109                                      TargetInfo::BuiltinVaListKind Kind) {
6110   switch (Kind) {
6111   case TargetInfo::CharPtrBuiltinVaList:
6112     return CreateCharPtrBuiltinVaListDecl(Context);
6113   case TargetInfo::VoidPtrBuiltinVaList:
6114     return CreateVoidPtrBuiltinVaListDecl(Context);
6115   case TargetInfo::AArch64ABIBuiltinVaList:
6116     return CreateAArch64ABIBuiltinVaListDecl(Context);
6117   case TargetInfo::PowerABIBuiltinVaList:
6118     return CreatePowerABIBuiltinVaListDecl(Context);
6119   case TargetInfo::X86_64ABIBuiltinVaList:
6120     return CreateX86_64ABIBuiltinVaListDecl(Context);
6121   case TargetInfo::PNaClABIBuiltinVaList:
6122     return CreatePNaClABIBuiltinVaListDecl(Context);
6123   case TargetInfo::AAPCSABIBuiltinVaList:
6124     return CreateAAPCSABIBuiltinVaListDecl(Context);
6125   case TargetInfo::SystemZBuiltinVaList:
6126     return CreateSystemZBuiltinVaListDecl(Context);
6127   }
6128 
6129   llvm_unreachable("Unhandled __builtin_va_list type kind");
6130 }
6131 
6132 TypedefDecl *ASTContext::getBuiltinVaListDecl() const {
6133   if (!BuiltinVaListDecl) {
6134     BuiltinVaListDecl = CreateVaListDecl(this, Target->getBuiltinVaListKind());
6135     assert(BuiltinVaListDecl->isImplicit());
6136   }
6137 
6138   return BuiltinVaListDecl;
6139 }
6140 
6141 QualType ASTContext::getVaListTagType() const {
6142   // Force the creation of VaListTagTy by building the __builtin_va_list
6143   // declaration.
6144   if (VaListTagTy.isNull())
6145     (void) getBuiltinVaListDecl();
6146 
6147   return VaListTagTy;
6148 }
6149 
6150 void ASTContext::setObjCConstantStringInterface(ObjCInterfaceDecl *Decl) {
6151   assert(ObjCConstantStringType.isNull() &&
6152          "'NSConstantString' type already set!");
6153 
6154   ObjCConstantStringType = getObjCInterfaceType(Decl);
6155 }
6156 
6157 /// \brief Retrieve the template name that corresponds to a non-empty
6158 /// lookup.
6159 TemplateName
6160 ASTContext::getOverloadedTemplateName(UnresolvedSetIterator Begin,
6161                                       UnresolvedSetIterator End) const {
6162   unsigned size = End - Begin;
6163   assert(size > 1 && "set is not overloaded!");
6164 
6165   void *memory = Allocate(sizeof(OverloadedTemplateStorage) +
6166                           size * sizeof(FunctionTemplateDecl*));
6167   OverloadedTemplateStorage *OT = new(memory) OverloadedTemplateStorage(size);
6168 
6169   NamedDecl **Storage = OT->getStorage();
6170   for (UnresolvedSetIterator I = Begin; I != End; ++I) {
6171     NamedDecl *D = *I;
6172     assert(isa<FunctionTemplateDecl>(D) ||
6173            (isa<UsingShadowDecl>(D) &&
6174             isa<FunctionTemplateDecl>(D->getUnderlyingDecl())));
6175     *Storage++ = D;
6176   }
6177 
6178   return TemplateName(OT);
6179 }
6180 
6181 /// \brief Retrieve the template name that represents a qualified
6182 /// template name such as \c std::vector.
6183 TemplateName
6184 ASTContext::getQualifiedTemplateName(NestedNameSpecifier *NNS,
6185                                      bool TemplateKeyword,
6186                                      TemplateDecl *Template) const {
6187   assert(NNS && "Missing nested-name-specifier in qualified template name");
6188 
6189   // FIXME: Canonicalization?
6190   llvm::FoldingSetNodeID ID;
6191   QualifiedTemplateName::Profile(ID, NNS, TemplateKeyword, Template);
6192 
6193   void *InsertPos = 0;
6194   QualifiedTemplateName *QTN =
6195     QualifiedTemplateNames.FindNodeOrInsertPos(ID, InsertPos);
6196   if (!QTN) {
6197     QTN = new (*this, llvm::alignOf<QualifiedTemplateName>())
6198         QualifiedTemplateName(NNS, TemplateKeyword, Template);
6199     QualifiedTemplateNames.InsertNode(QTN, InsertPos);
6200   }
6201 
6202   return TemplateName(QTN);
6203 }
6204 
6205 /// \brief Retrieve the template name that represents a dependent
6206 /// template name such as \c MetaFun::template apply.
6207 TemplateName
6208 ASTContext::getDependentTemplateName(NestedNameSpecifier *NNS,
6209                                      const IdentifierInfo *Name) const {
6210   assert((!NNS || NNS->isDependent()) &&
6211          "Nested name specifier must be dependent");
6212 
6213   llvm::FoldingSetNodeID ID;
6214   DependentTemplateName::Profile(ID, NNS, Name);
6215 
6216   void *InsertPos = 0;
6217   DependentTemplateName *QTN =
6218     DependentTemplateNames.FindNodeOrInsertPos(ID, InsertPos);
6219 
6220   if (QTN)
6221     return TemplateName(QTN);
6222 
6223   NestedNameSpecifier *CanonNNS = getCanonicalNestedNameSpecifier(NNS);
6224   if (CanonNNS == NNS) {
6225     QTN = new (*this, llvm::alignOf<DependentTemplateName>())
6226         DependentTemplateName(NNS, Name);
6227   } else {
6228     TemplateName Canon = getDependentTemplateName(CanonNNS, Name);
6229     QTN = new (*this, llvm::alignOf<DependentTemplateName>())
6230         DependentTemplateName(NNS, Name, Canon);
6231     DependentTemplateName *CheckQTN =
6232       DependentTemplateNames.FindNodeOrInsertPos(ID, InsertPos);
6233     assert(!CheckQTN && "Dependent type name canonicalization broken");
6234     (void)CheckQTN;
6235   }
6236 
6237   DependentTemplateNames.InsertNode(QTN, InsertPos);
6238   return TemplateName(QTN);
6239 }
6240 
6241 /// \brief Retrieve the template name that represents a dependent
6242 /// template name such as \c MetaFun::template operator+.
6243 TemplateName
6244 ASTContext::getDependentTemplateName(NestedNameSpecifier *NNS,
6245                                      OverloadedOperatorKind Operator) const {
6246   assert((!NNS || NNS->isDependent()) &&
6247          "Nested name specifier must be dependent");
6248 
6249   llvm::FoldingSetNodeID ID;
6250   DependentTemplateName::Profile(ID, NNS, Operator);
6251 
6252   void *InsertPos = 0;
6253   DependentTemplateName *QTN
6254     = DependentTemplateNames.FindNodeOrInsertPos(ID, InsertPos);
6255 
6256   if (QTN)
6257     return TemplateName(QTN);
6258 
6259   NestedNameSpecifier *CanonNNS = getCanonicalNestedNameSpecifier(NNS);
6260   if (CanonNNS == NNS) {
6261     QTN = new (*this, llvm::alignOf<DependentTemplateName>())
6262         DependentTemplateName(NNS, Operator);
6263   } else {
6264     TemplateName Canon = getDependentTemplateName(CanonNNS, Operator);
6265     QTN = new (*this, llvm::alignOf<DependentTemplateName>())
6266         DependentTemplateName(NNS, Operator, Canon);
6267 
6268     DependentTemplateName *CheckQTN
6269       = DependentTemplateNames.FindNodeOrInsertPos(ID, InsertPos);
6270     assert(!CheckQTN && "Dependent template name canonicalization broken");
6271     (void)CheckQTN;
6272   }
6273 
6274   DependentTemplateNames.InsertNode(QTN, InsertPos);
6275   return TemplateName(QTN);
6276 }
6277 
6278 TemplateName
6279 ASTContext::getSubstTemplateTemplateParm(TemplateTemplateParmDecl *param,
6280                                          TemplateName replacement) const {
6281   llvm::FoldingSetNodeID ID;
6282   SubstTemplateTemplateParmStorage::Profile(ID, param, replacement);
6283 
6284   void *insertPos = 0;
6285   SubstTemplateTemplateParmStorage *subst
6286     = SubstTemplateTemplateParms.FindNodeOrInsertPos(ID, insertPos);
6287 
6288   if (!subst) {
6289     subst = new (*this) SubstTemplateTemplateParmStorage(param, replacement);
6290     SubstTemplateTemplateParms.InsertNode(subst, insertPos);
6291   }
6292 
6293   return TemplateName(subst);
6294 }
6295 
6296 TemplateName
6297 ASTContext::getSubstTemplateTemplateParmPack(TemplateTemplateParmDecl *Param,
6298                                        const TemplateArgument &ArgPack) const {
6299   ASTContext &Self = const_cast<ASTContext &>(*this);
6300   llvm::FoldingSetNodeID ID;
6301   SubstTemplateTemplateParmPackStorage::Profile(ID, Self, Param, ArgPack);
6302 
6303   void *InsertPos = 0;
6304   SubstTemplateTemplateParmPackStorage *Subst
6305     = SubstTemplateTemplateParmPacks.FindNodeOrInsertPos(ID, InsertPos);
6306 
6307   if (!Subst) {
6308     Subst = new (*this) SubstTemplateTemplateParmPackStorage(Param,
6309                                                            ArgPack.pack_size(),
6310                                                          ArgPack.pack_begin());
6311     SubstTemplateTemplateParmPacks.InsertNode(Subst, InsertPos);
6312   }
6313 
6314   return TemplateName(Subst);
6315 }
6316 
6317 /// getFromTargetType - Given one of the integer types provided by
6318 /// TargetInfo, produce the corresponding type. The unsigned @p Type
6319 /// is actually a value of type @c TargetInfo::IntType.
6320 CanQualType ASTContext::getFromTargetType(unsigned Type) const {
6321   switch (Type) {
6322   case TargetInfo::NoInt: return CanQualType();
6323   case TargetInfo::SignedChar: return SignedCharTy;
6324   case TargetInfo::UnsignedChar: return UnsignedCharTy;
6325   case TargetInfo::SignedShort: return ShortTy;
6326   case TargetInfo::UnsignedShort: return UnsignedShortTy;
6327   case TargetInfo::SignedInt: return IntTy;
6328   case TargetInfo::UnsignedInt: return UnsignedIntTy;
6329   case TargetInfo::SignedLong: return LongTy;
6330   case TargetInfo::UnsignedLong: return UnsignedLongTy;
6331   case TargetInfo::SignedLongLong: return LongLongTy;
6332   case TargetInfo::UnsignedLongLong: return UnsignedLongLongTy;
6333   }
6334 
6335   llvm_unreachable("Unhandled TargetInfo::IntType value");
6336 }
6337 
6338 //===----------------------------------------------------------------------===//
6339 //                        Type Predicates.
6340 //===----------------------------------------------------------------------===//
6341 
6342 /// getObjCGCAttr - Returns one of GCNone, Weak or Strong objc's
6343 /// garbage collection attribute.
6344 ///
6345 Qualifiers::GC ASTContext::getObjCGCAttrKind(QualType Ty) const {
6346   if (getLangOpts().getGC() == LangOptions::NonGC)
6347     return Qualifiers::GCNone;
6348 
6349   assert(getLangOpts().ObjC1);
6350   Qualifiers::GC GCAttrs = Ty.getObjCGCAttr();
6351 
6352   // Default behaviour under objective-C's gc is for ObjC pointers
6353   // (or pointers to them) be treated as though they were declared
6354   // as __strong.
6355   if (GCAttrs == Qualifiers::GCNone) {
6356     if (Ty->isObjCObjectPointerType() || Ty->isBlockPointerType())
6357       return Qualifiers::Strong;
6358     else if (Ty->isPointerType())
6359       return getObjCGCAttrKind(Ty->getAs<PointerType>()->getPointeeType());
6360   } else {
6361     // It's not valid to set GC attributes on anything that isn't a
6362     // pointer.
6363 #ifndef NDEBUG
6364     QualType CT = Ty->getCanonicalTypeInternal();
6365     while (const ArrayType *AT = dyn_cast<ArrayType>(CT))
6366       CT = AT->getElementType();
6367     assert(CT->isAnyPointerType() || CT->isBlockPointerType());
6368 #endif
6369   }
6370   return GCAttrs;
6371 }
6372 
6373 //===----------------------------------------------------------------------===//
6374 //                        Type Compatibility Testing
6375 //===----------------------------------------------------------------------===//
6376 
6377 /// areCompatVectorTypes - Return true if the two specified vector types are
6378 /// compatible.
6379 static bool areCompatVectorTypes(const VectorType *LHS,
6380                                  const VectorType *RHS) {
6381   assert(LHS->isCanonicalUnqualified() && RHS->isCanonicalUnqualified());
6382   return LHS->getElementType() == RHS->getElementType() &&
6383          LHS->getNumElements() == RHS->getNumElements();
6384 }
6385 
6386 bool ASTContext::areCompatibleVectorTypes(QualType FirstVec,
6387                                           QualType SecondVec) {
6388   assert(FirstVec->isVectorType() && "FirstVec should be a vector type");
6389   assert(SecondVec->isVectorType() && "SecondVec should be a vector type");
6390 
6391   if (hasSameUnqualifiedType(FirstVec, SecondVec))
6392     return true;
6393 
6394   // Treat Neon vector types and most AltiVec vector types as if they are the
6395   // equivalent GCC vector types.
6396   const VectorType *First = FirstVec->getAs<VectorType>();
6397   const VectorType *Second = SecondVec->getAs<VectorType>();
6398   if (First->getNumElements() == Second->getNumElements() &&
6399       hasSameType(First->getElementType(), Second->getElementType()) &&
6400       First->getVectorKind() != VectorType::AltiVecPixel &&
6401       First->getVectorKind() != VectorType::AltiVecBool &&
6402       Second->getVectorKind() != VectorType::AltiVecPixel &&
6403       Second->getVectorKind() != VectorType::AltiVecBool)
6404     return true;
6405 
6406   return false;
6407 }
6408 
6409 //===----------------------------------------------------------------------===//
6410 // ObjCQualifiedIdTypesAreCompatible - Compatibility testing for qualified id's.
6411 //===----------------------------------------------------------------------===//
6412 
6413 /// ProtocolCompatibleWithProtocol - return 'true' if 'lProto' is in the
6414 /// inheritance hierarchy of 'rProto'.
6415 bool
6416 ASTContext::ProtocolCompatibleWithProtocol(ObjCProtocolDecl *lProto,
6417                                            ObjCProtocolDecl *rProto) const {
6418   if (declaresSameEntity(lProto, rProto))
6419     return true;
6420   for (ObjCProtocolDecl::protocol_iterator PI = rProto->protocol_begin(),
6421        E = rProto->protocol_end(); PI != E; ++PI)
6422     if (ProtocolCompatibleWithProtocol(lProto, *PI))
6423       return true;
6424   return false;
6425 }
6426 
6427 /// ObjCQualifiedClassTypesAreCompatible - compare  Class<pr,...> and
6428 /// Class<pr1, ...>.
6429 bool ASTContext::ObjCQualifiedClassTypesAreCompatible(QualType lhs,
6430                                                       QualType rhs) {
6431   const ObjCObjectPointerType *lhsQID = lhs->getAs<ObjCObjectPointerType>();
6432   const ObjCObjectPointerType *rhsOPT = rhs->getAs<ObjCObjectPointerType>();
6433   assert ((lhsQID && rhsOPT) && "ObjCQualifiedClassTypesAreCompatible");
6434 
6435   for (ObjCObjectPointerType::qual_iterator I = lhsQID->qual_begin(),
6436        E = lhsQID->qual_end(); I != E; ++I) {
6437     bool match = false;
6438     ObjCProtocolDecl *lhsProto = *I;
6439     for (ObjCObjectPointerType::qual_iterator J = rhsOPT->qual_begin(),
6440          E = rhsOPT->qual_end(); J != E; ++J) {
6441       ObjCProtocolDecl *rhsProto = *J;
6442       if (ProtocolCompatibleWithProtocol(lhsProto, rhsProto)) {
6443         match = true;
6444         break;
6445       }
6446     }
6447     if (!match)
6448       return false;
6449   }
6450   return true;
6451 }
6452 
6453 /// ObjCQualifiedIdTypesAreCompatible - We know that one of lhs/rhs is an
6454 /// ObjCQualifiedIDType.
6455 bool ASTContext::ObjCQualifiedIdTypesAreCompatible(QualType lhs, QualType rhs,
6456                                                    bool compare) {
6457   // Allow id<P..> and an 'id' or void* type in all cases.
6458   if (lhs->isVoidPointerType() ||
6459       lhs->isObjCIdType() || lhs->isObjCClassType())
6460     return true;
6461   else if (rhs->isVoidPointerType() ||
6462            rhs->isObjCIdType() || rhs->isObjCClassType())
6463     return true;
6464 
6465   if (const ObjCObjectPointerType *lhsQID = lhs->getAsObjCQualifiedIdType()) {
6466     const ObjCObjectPointerType *rhsOPT = rhs->getAs<ObjCObjectPointerType>();
6467 
6468     if (!rhsOPT) return false;
6469 
6470     if (rhsOPT->qual_empty()) {
6471       // If the RHS is a unqualified interface pointer "NSString*",
6472       // make sure we check the class hierarchy.
6473       if (ObjCInterfaceDecl *rhsID = rhsOPT->getInterfaceDecl()) {
6474         for (ObjCObjectPointerType::qual_iterator I = lhsQID->qual_begin(),
6475              E = lhsQID->qual_end(); I != E; ++I) {
6476           // when comparing an id<P> on lhs with a static type on rhs,
6477           // see if static class implements all of id's protocols, directly or
6478           // through its super class and categories.
6479           if (!rhsID->ClassImplementsProtocol(*I, true))
6480             return false;
6481         }
6482       }
6483       // If there are no qualifiers and no interface, we have an 'id'.
6484       return true;
6485     }
6486     // Both the right and left sides have qualifiers.
6487     for (ObjCObjectPointerType::qual_iterator I = lhsQID->qual_begin(),
6488          E = lhsQID->qual_end(); I != E; ++I) {
6489       ObjCProtocolDecl *lhsProto = *I;
6490       bool match = false;
6491 
6492       // when comparing an id<P> on lhs with a static type on rhs,
6493       // see if static class implements all of id's protocols, directly or
6494       // through its super class and categories.
6495       for (ObjCObjectPointerType::qual_iterator J = rhsOPT->qual_begin(),
6496            E = rhsOPT->qual_end(); J != E; ++J) {
6497         ObjCProtocolDecl *rhsProto = *J;
6498         if (ProtocolCompatibleWithProtocol(lhsProto, rhsProto) ||
6499             (compare && ProtocolCompatibleWithProtocol(rhsProto, lhsProto))) {
6500           match = true;
6501           break;
6502         }
6503       }
6504       // If the RHS is a qualified interface pointer "NSString<P>*",
6505       // make sure we check the class hierarchy.
6506       if (ObjCInterfaceDecl *rhsID = rhsOPT->getInterfaceDecl()) {
6507         for (ObjCObjectPointerType::qual_iterator I = lhsQID->qual_begin(),
6508              E = lhsQID->qual_end(); I != E; ++I) {
6509           // when comparing an id<P> on lhs with a static type on rhs,
6510           // see if static class implements all of id's protocols, directly or
6511           // through its super class and categories.
6512           if (rhsID->ClassImplementsProtocol(*I, true)) {
6513             match = true;
6514             break;
6515           }
6516         }
6517       }
6518       if (!match)
6519         return false;
6520     }
6521 
6522     return true;
6523   }
6524 
6525   const ObjCObjectPointerType *rhsQID = rhs->getAsObjCQualifiedIdType();
6526   assert(rhsQID && "One of the LHS/RHS should be id<x>");
6527 
6528   if (const ObjCObjectPointerType *lhsOPT =
6529         lhs->getAsObjCInterfacePointerType()) {
6530     // If both the right and left sides have qualifiers.
6531     for (ObjCObjectPointerType::qual_iterator I = lhsOPT->qual_begin(),
6532          E = lhsOPT->qual_end(); I != E; ++I) {
6533       ObjCProtocolDecl *lhsProto = *I;
6534       bool match = false;
6535 
6536       // when comparing an id<P> on rhs with a static type on lhs,
6537       // see if static class implements all of id's protocols, directly or
6538       // through its super class and categories.
6539       // First, lhs protocols in the qualifier list must be found, direct
6540       // or indirect in rhs's qualifier list or it is a mismatch.
6541       for (ObjCObjectPointerType::qual_iterator J = rhsQID->qual_begin(),
6542            E = rhsQID->qual_end(); J != E; ++J) {
6543         ObjCProtocolDecl *rhsProto = *J;
6544         if (ProtocolCompatibleWithProtocol(lhsProto, rhsProto) ||
6545             (compare && ProtocolCompatibleWithProtocol(rhsProto, lhsProto))) {
6546           match = true;
6547           break;
6548         }
6549       }
6550       if (!match)
6551         return false;
6552     }
6553 
6554     // Static class's protocols, or its super class or category protocols
6555     // must be found, direct or indirect in rhs's qualifier list or it is a mismatch.
6556     if (ObjCInterfaceDecl *lhsID = lhsOPT->getInterfaceDecl()) {
6557       llvm::SmallPtrSet<ObjCProtocolDecl *, 8> LHSInheritedProtocols;
6558       CollectInheritedProtocols(lhsID, LHSInheritedProtocols);
6559       // This is rather dubious but matches gcc's behavior. If lhs has
6560       // no type qualifier and its class has no static protocol(s)
6561       // assume that it is mismatch.
6562       if (LHSInheritedProtocols.empty() && lhsOPT->qual_empty())
6563         return false;
6564       for (llvm::SmallPtrSet<ObjCProtocolDecl*,8>::iterator I =
6565            LHSInheritedProtocols.begin(),
6566            E = LHSInheritedProtocols.end(); I != E; ++I) {
6567         bool match = false;
6568         ObjCProtocolDecl *lhsProto = (*I);
6569         for (ObjCObjectPointerType::qual_iterator J = rhsQID->qual_begin(),
6570              E = rhsQID->qual_end(); J != E; ++J) {
6571           ObjCProtocolDecl *rhsProto = *J;
6572           if (ProtocolCompatibleWithProtocol(lhsProto, rhsProto) ||
6573               (compare && ProtocolCompatibleWithProtocol(rhsProto, lhsProto))) {
6574             match = true;
6575             break;
6576           }
6577         }
6578         if (!match)
6579           return false;
6580       }
6581     }
6582     return true;
6583   }
6584   return false;
6585 }
6586 
6587 /// canAssignObjCInterfaces - Return true if the two interface types are
6588 /// compatible for assignment from RHS to LHS.  This handles validation of any
6589 /// protocol qualifiers on the LHS or RHS.
6590 ///
6591 bool ASTContext::canAssignObjCInterfaces(const ObjCObjectPointerType *LHSOPT,
6592                                          const ObjCObjectPointerType *RHSOPT) {
6593   const ObjCObjectType* LHS = LHSOPT->getObjectType();
6594   const ObjCObjectType* RHS = RHSOPT->getObjectType();
6595 
6596   // If either type represents the built-in 'id' or 'Class' types, return true.
6597   if (LHS->isObjCUnqualifiedIdOrClass() ||
6598       RHS->isObjCUnqualifiedIdOrClass())
6599     return true;
6600 
6601   if (LHS->isObjCQualifiedId() || RHS->isObjCQualifiedId())
6602     return ObjCQualifiedIdTypesAreCompatible(QualType(LHSOPT,0),
6603                                              QualType(RHSOPT,0),
6604                                              false);
6605 
6606   if (LHS->isObjCQualifiedClass() && RHS->isObjCQualifiedClass())
6607     return ObjCQualifiedClassTypesAreCompatible(QualType(LHSOPT,0),
6608                                                 QualType(RHSOPT,0));
6609 
6610   // If we have 2 user-defined types, fall into that path.
6611   if (LHS->getInterface() && RHS->getInterface())
6612     return canAssignObjCInterfaces(LHS, RHS);
6613 
6614   return false;
6615 }
6616 
6617 /// canAssignObjCInterfacesInBlockPointer - This routine is specifically written
6618 /// for providing type-safety for objective-c pointers used to pass/return
6619 /// arguments in block literals. When passed as arguments, passing 'A*' where
6620 /// 'id' is expected is not OK. Passing 'Sub *" where 'Super *" is expected is
6621 /// not OK. For the return type, the opposite is not OK.
6622 bool ASTContext::canAssignObjCInterfacesInBlockPointer(
6623                                          const ObjCObjectPointerType *LHSOPT,
6624                                          const ObjCObjectPointerType *RHSOPT,
6625                                          bool BlockReturnType) {
6626   if (RHSOPT->isObjCBuiltinType() || LHSOPT->isObjCIdType())
6627     return true;
6628 
6629   if (LHSOPT->isObjCBuiltinType()) {
6630     return RHSOPT->isObjCBuiltinType() || RHSOPT->isObjCQualifiedIdType();
6631   }
6632 
6633   if (LHSOPT->isObjCQualifiedIdType() || RHSOPT->isObjCQualifiedIdType())
6634     return ObjCQualifiedIdTypesAreCompatible(QualType(LHSOPT,0),
6635                                              QualType(RHSOPT,0),
6636                                              false);
6637 
6638   const ObjCInterfaceType* LHS = LHSOPT->getInterfaceType();
6639   const ObjCInterfaceType* RHS = RHSOPT->getInterfaceType();
6640   if (LHS && RHS)  { // We have 2 user-defined types.
6641     if (LHS != RHS) {
6642       if (LHS->getDecl()->isSuperClassOf(RHS->getDecl()))
6643         return BlockReturnType;
6644       if (RHS->getDecl()->isSuperClassOf(LHS->getDecl()))
6645         return !BlockReturnType;
6646     }
6647     else
6648       return true;
6649   }
6650   return false;
6651 }
6652 
6653 /// getIntersectionOfProtocols - This routine finds the intersection of set
6654 /// of protocols inherited from two distinct objective-c pointer objects.
6655 /// It is used to build composite qualifier list of the composite type of
6656 /// the conditional expression involving two objective-c pointer objects.
6657 static
6658 void getIntersectionOfProtocols(ASTContext &Context,
6659                                 const ObjCObjectPointerType *LHSOPT,
6660                                 const ObjCObjectPointerType *RHSOPT,
6661       SmallVectorImpl<ObjCProtocolDecl *> &IntersectionOfProtocols) {
6662 
6663   const ObjCObjectType* LHS = LHSOPT->getObjectType();
6664   const ObjCObjectType* RHS = RHSOPT->getObjectType();
6665   assert(LHS->getInterface() && "LHS must have an interface base");
6666   assert(RHS->getInterface() && "RHS must have an interface base");
6667 
6668   llvm::SmallPtrSet<ObjCProtocolDecl *, 8> InheritedProtocolSet;
6669   unsigned LHSNumProtocols = LHS->getNumProtocols();
6670   if (LHSNumProtocols > 0)
6671     InheritedProtocolSet.insert(LHS->qual_begin(), LHS->qual_end());
6672   else {
6673     llvm::SmallPtrSet<ObjCProtocolDecl *, 8> LHSInheritedProtocols;
6674     Context.CollectInheritedProtocols(LHS->getInterface(),
6675                                       LHSInheritedProtocols);
6676     InheritedProtocolSet.insert(LHSInheritedProtocols.begin(),
6677                                 LHSInheritedProtocols.end());
6678   }
6679 
6680   unsigned RHSNumProtocols = RHS->getNumProtocols();
6681   if (RHSNumProtocols > 0) {
6682     ObjCProtocolDecl **RHSProtocols =
6683       const_cast<ObjCProtocolDecl **>(RHS->qual_begin());
6684     for (unsigned i = 0; i < RHSNumProtocols; ++i)
6685       if (InheritedProtocolSet.count(RHSProtocols[i]))
6686         IntersectionOfProtocols.push_back(RHSProtocols[i]);
6687   } else {
6688     llvm::SmallPtrSet<ObjCProtocolDecl *, 8> RHSInheritedProtocols;
6689     Context.CollectInheritedProtocols(RHS->getInterface(),
6690                                       RHSInheritedProtocols);
6691     for (llvm::SmallPtrSet<ObjCProtocolDecl*,8>::iterator I =
6692          RHSInheritedProtocols.begin(),
6693          E = RHSInheritedProtocols.end(); I != E; ++I)
6694       if (InheritedProtocolSet.count((*I)))
6695         IntersectionOfProtocols.push_back((*I));
6696   }
6697 }
6698 
6699 /// areCommonBaseCompatible - Returns common base class of the two classes if
6700 /// one found. Note that this is O'2 algorithm. But it will be called as the
6701 /// last type comparison in a ?-exp of ObjC pointer types before a
6702 /// warning is issued. So, its invokation is extremely rare.
6703 QualType ASTContext::areCommonBaseCompatible(
6704                                           const ObjCObjectPointerType *Lptr,
6705                                           const ObjCObjectPointerType *Rptr) {
6706   const ObjCObjectType *LHS = Lptr->getObjectType();
6707   const ObjCObjectType *RHS = Rptr->getObjectType();
6708   const ObjCInterfaceDecl* LDecl = LHS->getInterface();
6709   const ObjCInterfaceDecl* RDecl = RHS->getInterface();
6710   if (!LDecl || !RDecl || (declaresSameEntity(LDecl, RDecl)))
6711     return QualType();
6712 
6713   do {
6714     LHS = cast<ObjCInterfaceType>(getObjCInterfaceType(LDecl));
6715     if (canAssignObjCInterfaces(LHS, RHS)) {
6716       SmallVector<ObjCProtocolDecl *, 8> Protocols;
6717       getIntersectionOfProtocols(*this, Lptr, Rptr, Protocols);
6718 
6719       QualType Result = QualType(LHS, 0);
6720       if (!Protocols.empty())
6721         Result = getObjCObjectType(Result, Protocols.data(), Protocols.size());
6722       Result = getObjCObjectPointerType(Result);
6723       return Result;
6724     }
6725   } while ((LDecl = LDecl->getSuperClass()));
6726 
6727   return QualType();
6728 }
6729 
6730 bool ASTContext::canAssignObjCInterfaces(const ObjCObjectType *LHS,
6731                                          const ObjCObjectType *RHS) {
6732   assert(LHS->getInterface() && "LHS is not an interface type");
6733   assert(RHS->getInterface() && "RHS is not an interface type");
6734 
6735   // Verify that the base decls are compatible: the RHS must be a subclass of
6736   // the LHS.
6737   if (!LHS->getInterface()->isSuperClassOf(RHS->getInterface()))
6738     return false;
6739 
6740   // RHS must have a superset of the protocols in the LHS.  If the LHS is not
6741   // protocol qualified at all, then we are good.
6742   if (LHS->getNumProtocols() == 0)
6743     return true;
6744 
6745   // Okay, we know the LHS has protocol qualifiers.  If the RHS doesn't,
6746   // more detailed analysis is required.
6747   if (RHS->getNumProtocols() == 0) {
6748     // OK, if LHS is a superclass of RHS *and*
6749     // this superclass is assignment compatible with LHS.
6750     // false otherwise.
6751     bool IsSuperClass =
6752       LHS->getInterface()->isSuperClassOf(RHS->getInterface());
6753     if (IsSuperClass) {
6754       // OK if conversion of LHS to SuperClass results in narrowing of types
6755       // ; i.e., SuperClass may implement at least one of the protocols
6756       // in LHS's protocol list. Example, SuperObj<P1> = lhs<P1,P2> is ok.
6757       // But not SuperObj<P1,P2,P3> = lhs<P1,P2>.
6758       llvm::SmallPtrSet<ObjCProtocolDecl *, 8> SuperClassInheritedProtocols;
6759       CollectInheritedProtocols(RHS->getInterface(), SuperClassInheritedProtocols);
6760       // If super class has no protocols, it is not a match.
6761       if (SuperClassInheritedProtocols.empty())
6762         return false;
6763 
6764       for (ObjCObjectType::qual_iterator LHSPI = LHS->qual_begin(),
6765            LHSPE = LHS->qual_end();
6766            LHSPI != LHSPE; LHSPI++) {
6767         bool SuperImplementsProtocol = false;
6768         ObjCProtocolDecl *LHSProto = (*LHSPI);
6769 
6770         for (llvm::SmallPtrSet<ObjCProtocolDecl*,8>::iterator I =
6771              SuperClassInheritedProtocols.begin(),
6772              E = SuperClassInheritedProtocols.end(); I != E; ++I) {
6773           ObjCProtocolDecl *SuperClassProto = (*I);
6774           if (SuperClassProto->lookupProtocolNamed(LHSProto->getIdentifier())) {
6775             SuperImplementsProtocol = true;
6776             break;
6777           }
6778         }
6779         if (!SuperImplementsProtocol)
6780           return false;
6781       }
6782       return true;
6783     }
6784     return false;
6785   }
6786 
6787   for (ObjCObjectType::qual_iterator LHSPI = LHS->qual_begin(),
6788                                      LHSPE = LHS->qual_end();
6789        LHSPI != LHSPE; LHSPI++) {
6790     bool RHSImplementsProtocol = false;
6791 
6792     // If the RHS doesn't implement the protocol on the left, the types
6793     // are incompatible.
6794     for (ObjCObjectType::qual_iterator RHSPI = RHS->qual_begin(),
6795                                        RHSPE = RHS->qual_end();
6796          RHSPI != RHSPE; RHSPI++) {
6797       if ((*RHSPI)->lookupProtocolNamed((*LHSPI)->getIdentifier())) {
6798         RHSImplementsProtocol = true;
6799         break;
6800       }
6801     }
6802     // FIXME: For better diagnostics, consider passing back the protocol name.
6803     if (!RHSImplementsProtocol)
6804       return false;
6805   }
6806   // The RHS implements all protocols listed on the LHS.
6807   return true;
6808 }
6809 
6810 bool ASTContext::areComparableObjCPointerTypes(QualType LHS, QualType RHS) {
6811   // get the "pointed to" types
6812   const ObjCObjectPointerType *LHSOPT = LHS->getAs<ObjCObjectPointerType>();
6813   const ObjCObjectPointerType *RHSOPT = RHS->getAs<ObjCObjectPointerType>();
6814 
6815   if (!LHSOPT || !RHSOPT)
6816     return false;
6817 
6818   return canAssignObjCInterfaces(LHSOPT, RHSOPT) ||
6819          canAssignObjCInterfaces(RHSOPT, LHSOPT);
6820 }
6821 
6822 bool ASTContext::canBindObjCObjectType(QualType To, QualType From) {
6823   return canAssignObjCInterfaces(
6824                 getObjCObjectPointerType(To)->getAs<ObjCObjectPointerType>(),
6825                 getObjCObjectPointerType(From)->getAs<ObjCObjectPointerType>());
6826 }
6827 
6828 /// typesAreCompatible - C99 6.7.3p9: For two qualified types to be compatible,
6829 /// both shall have the identically qualified version of a compatible type.
6830 /// C99 6.2.7p1: Two types have compatible types if their types are the
6831 /// same. See 6.7.[2,3,5] for additional rules.
6832 bool ASTContext::typesAreCompatible(QualType LHS, QualType RHS,
6833                                     bool CompareUnqualified) {
6834   if (getLangOpts().CPlusPlus)
6835     return hasSameType(LHS, RHS);
6836 
6837   return !mergeTypes(LHS, RHS, false, CompareUnqualified).isNull();
6838 }
6839 
6840 bool ASTContext::propertyTypesAreCompatible(QualType LHS, QualType RHS) {
6841   return typesAreCompatible(LHS, RHS);
6842 }
6843 
6844 bool ASTContext::typesAreBlockPointerCompatible(QualType LHS, QualType RHS) {
6845   return !mergeTypes(LHS, RHS, true).isNull();
6846 }
6847 
6848 /// mergeTransparentUnionType - if T is a transparent union type and a member
6849 /// of T is compatible with SubType, return the merged type, else return
6850 /// QualType()
6851 QualType ASTContext::mergeTransparentUnionType(QualType T, QualType SubType,
6852                                                bool OfBlockPointer,
6853                                                bool Unqualified) {
6854   if (const RecordType *UT = T->getAsUnionType()) {
6855     RecordDecl *UD = UT->getDecl();
6856     if (UD->hasAttr<TransparentUnionAttr>()) {
6857       for (RecordDecl::field_iterator it = UD->field_begin(),
6858            itend = UD->field_end(); it != itend; ++it) {
6859         QualType ET = it->getType().getUnqualifiedType();
6860         QualType MT = mergeTypes(ET, SubType, OfBlockPointer, Unqualified);
6861         if (!MT.isNull())
6862           return MT;
6863       }
6864     }
6865   }
6866 
6867   return QualType();
6868 }
6869 
6870 /// mergeFunctionParameterTypes - merge two types which appear as function
6871 /// parameter types
6872 QualType ASTContext::mergeFunctionParameterTypes(QualType lhs, QualType rhs,
6873                                                  bool OfBlockPointer,
6874                                                  bool Unqualified) {
6875   // GNU extension: two types are compatible if they appear as a function
6876   // argument, one of the types is a transparent union type and the other
6877   // type is compatible with a union member
6878   QualType lmerge = mergeTransparentUnionType(lhs, rhs, OfBlockPointer,
6879                                               Unqualified);
6880   if (!lmerge.isNull())
6881     return lmerge;
6882 
6883   QualType rmerge = mergeTransparentUnionType(rhs, lhs, OfBlockPointer,
6884                                               Unqualified);
6885   if (!rmerge.isNull())
6886     return rmerge;
6887 
6888   return mergeTypes(lhs, rhs, OfBlockPointer, Unqualified);
6889 }
6890 
6891 QualType ASTContext::mergeFunctionTypes(QualType lhs, QualType rhs,
6892                                         bool OfBlockPointer,
6893                                         bool Unqualified) {
6894   const FunctionType *lbase = lhs->getAs<FunctionType>();
6895   const FunctionType *rbase = rhs->getAs<FunctionType>();
6896   const FunctionProtoType *lproto = dyn_cast<FunctionProtoType>(lbase);
6897   const FunctionProtoType *rproto = dyn_cast<FunctionProtoType>(rbase);
6898   bool allLTypes = true;
6899   bool allRTypes = true;
6900 
6901   // Check return type
6902   QualType retType;
6903   if (OfBlockPointer) {
6904     QualType RHS = rbase->getReturnType();
6905     QualType LHS = lbase->getReturnType();
6906     bool UnqualifiedResult = Unqualified;
6907     if (!UnqualifiedResult)
6908       UnqualifiedResult = (!RHS.hasQualifiers() && LHS.hasQualifiers());
6909     retType = mergeTypes(LHS, RHS, true, UnqualifiedResult, true);
6910   }
6911   else
6912     retType = mergeTypes(lbase->getReturnType(), rbase->getReturnType(), false,
6913                          Unqualified);
6914   if (retType.isNull()) return QualType();
6915 
6916   if (Unqualified)
6917     retType = retType.getUnqualifiedType();
6918 
6919   CanQualType LRetType = getCanonicalType(lbase->getReturnType());
6920   CanQualType RRetType = getCanonicalType(rbase->getReturnType());
6921   if (Unqualified) {
6922     LRetType = LRetType.getUnqualifiedType();
6923     RRetType = RRetType.getUnqualifiedType();
6924   }
6925 
6926   if (getCanonicalType(retType) != LRetType)
6927     allLTypes = false;
6928   if (getCanonicalType(retType) != RRetType)
6929     allRTypes = false;
6930 
6931   // FIXME: double check this
6932   // FIXME: should we error if lbase->getRegParmAttr() != 0 &&
6933   //                           rbase->getRegParmAttr() != 0 &&
6934   //                           lbase->getRegParmAttr() != rbase->getRegParmAttr()?
6935   FunctionType::ExtInfo lbaseInfo = lbase->getExtInfo();
6936   FunctionType::ExtInfo rbaseInfo = rbase->getExtInfo();
6937 
6938   // Compatible functions must have compatible calling conventions
6939   if (lbaseInfo.getCC() != rbaseInfo.getCC())
6940     return QualType();
6941 
6942   // Regparm is part of the calling convention.
6943   if (lbaseInfo.getHasRegParm() != rbaseInfo.getHasRegParm())
6944     return QualType();
6945   if (lbaseInfo.getRegParm() != rbaseInfo.getRegParm())
6946     return QualType();
6947 
6948   if (lbaseInfo.getProducesResult() != rbaseInfo.getProducesResult())
6949     return QualType();
6950 
6951   // FIXME: some uses, e.g. conditional exprs, really want this to be 'both'.
6952   bool NoReturn = lbaseInfo.getNoReturn() || rbaseInfo.getNoReturn();
6953 
6954   if (lbaseInfo.getNoReturn() != NoReturn)
6955     allLTypes = false;
6956   if (rbaseInfo.getNoReturn() != NoReturn)
6957     allRTypes = false;
6958 
6959   FunctionType::ExtInfo einfo = lbaseInfo.withNoReturn(NoReturn);
6960 
6961   if (lproto && rproto) { // two C99 style function prototypes
6962     assert(!lproto->hasExceptionSpec() && !rproto->hasExceptionSpec() &&
6963            "C++ shouldn't be here");
6964     // Compatible functions must have the same number of parameters
6965     if (lproto->getNumParams() != rproto->getNumParams())
6966       return QualType();
6967 
6968     // Variadic and non-variadic functions aren't compatible
6969     if (lproto->isVariadic() != rproto->isVariadic())
6970       return QualType();
6971 
6972     if (lproto->getTypeQuals() != rproto->getTypeQuals())
6973       return QualType();
6974 
6975     if (LangOpts.ObjCAutoRefCount &&
6976         !FunctionTypesMatchOnNSConsumedAttrs(rproto, lproto))
6977       return QualType();
6978 
6979     // Check parameter type compatibility
6980     SmallVector<QualType, 10> types;
6981     for (unsigned i = 0, n = lproto->getNumParams(); i < n; i++) {
6982       QualType lParamType = lproto->getParamType(i).getUnqualifiedType();
6983       QualType rParamType = rproto->getParamType(i).getUnqualifiedType();
6984       QualType paramType = mergeFunctionParameterTypes(
6985           lParamType, rParamType, OfBlockPointer, Unqualified);
6986       if (paramType.isNull())
6987         return QualType();
6988 
6989       if (Unqualified)
6990         paramType = paramType.getUnqualifiedType();
6991 
6992       types.push_back(paramType);
6993       if (Unqualified) {
6994         lParamType = lParamType.getUnqualifiedType();
6995         rParamType = rParamType.getUnqualifiedType();
6996       }
6997 
6998       if (getCanonicalType(paramType) != getCanonicalType(lParamType))
6999         allLTypes = false;
7000       if (getCanonicalType(paramType) != getCanonicalType(rParamType))
7001         allRTypes = false;
7002     }
7003 
7004     if (allLTypes) return lhs;
7005     if (allRTypes) return rhs;
7006 
7007     FunctionProtoType::ExtProtoInfo EPI = lproto->getExtProtoInfo();
7008     EPI.ExtInfo = einfo;
7009     return getFunctionType(retType, types, EPI);
7010   }
7011 
7012   if (lproto) allRTypes = false;
7013   if (rproto) allLTypes = false;
7014 
7015   const FunctionProtoType *proto = lproto ? lproto : rproto;
7016   if (proto) {
7017     assert(!proto->hasExceptionSpec() && "C++ shouldn't be here");
7018     if (proto->isVariadic()) return QualType();
7019     // Check that the types are compatible with the types that
7020     // would result from default argument promotions (C99 6.7.5.3p15).
7021     // The only types actually affected are promotable integer
7022     // types and floats, which would be passed as a different
7023     // type depending on whether the prototype is visible.
7024     for (unsigned i = 0, n = proto->getNumParams(); i < n; ++i) {
7025       QualType paramTy = proto->getParamType(i);
7026 
7027       // Look at the converted type of enum types, since that is the type used
7028       // to pass enum values.
7029       if (const EnumType *Enum = paramTy->getAs<EnumType>()) {
7030         paramTy = Enum->getDecl()->getIntegerType();
7031         if (paramTy.isNull())
7032           return QualType();
7033       }
7034 
7035       if (paramTy->isPromotableIntegerType() ||
7036           getCanonicalType(paramTy).getUnqualifiedType() == FloatTy)
7037         return QualType();
7038     }
7039 
7040     if (allLTypes) return lhs;
7041     if (allRTypes) return rhs;
7042 
7043     FunctionProtoType::ExtProtoInfo EPI = proto->getExtProtoInfo();
7044     EPI.ExtInfo = einfo;
7045     return getFunctionType(retType, proto->getParamTypes(), EPI);
7046   }
7047 
7048   if (allLTypes) return lhs;
7049   if (allRTypes) return rhs;
7050   return getFunctionNoProtoType(retType, einfo);
7051 }
7052 
7053 /// Given that we have an enum type and a non-enum type, try to merge them.
7054 static QualType mergeEnumWithInteger(ASTContext &Context, const EnumType *ET,
7055                                      QualType other, bool isBlockReturnType) {
7056   // C99 6.7.2.2p4: Each enumerated type shall be compatible with char,
7057   // a signed integer type, or an unsigned integer type.
7058   // Compatibility is based on the underlying type, not the promotion
7059   // type.
7060   QualType underlyingType = ET->getDecl()->getIntegerType();
7061   if (underlyingType.isNull()) return QualType();
7062   if (Context.hasSameType(underlyingType, other))
7063     return other;
7064 
7065   // In block return types, we're more permissive and accept any
7066   // integral type of the same size.
7067   if (isBlockReturnType && other->isIntegerType() &&
7068       Context.getTypeSize(underlyingType) == Context.getTypeSize(other))
7069     return other;
7070 
7071   return QualType();
7072 }
7073 
7074 QualType ASTContext::mergeTypes(QualType LHS, QualType RHS,
7075                                 bool OfBlockPointer,
7076                                 bool Unqualified, bool BlockReturnType) {
7077   // C++ [expr]: If an expression initially has the type "reference to T", the
7078   // type is adjusted to "T" prior to any further analysis, the expression
7079   // designates the object or function denoted by the reference, and the
7080   // expression is an lvalue unless the reference is an rvalue reference and
7081   // the expression is a function call (possibly inside parentheses).
7082   assert(!LHS->getAs<ReferenceType>() && "LHS is a reference type?");
7083   assert(!RHS->getAs<ReferenceType>() && "RHS is a reference type?");
7084 
7085   if (Unqualified) {
7086     LHS = LHS.getUnqualifiedType();
7087     RHS = RHS.getUnqualifiedType();
7088   }
7089 
7090   QualType LHSCan = getCanonicalType(LHS),
7091            RHSCan = getCanonicalType(RHS);
7092 
7093   // If two types are identical, they are compatible.
7094   if (LHSCan == RHSCan)
7095     return LHS;
7096 
7097   // If the qualifiers are different, the types aren't compatible... mostly.
7098   Qualifiers LQuals = LHSCan.getLocalQualifiers();
7099   Qualifiers RQuals = RHSCan.getLocalQualifiers();
7100   if (LQuals != RQuals) {
7101     // If any of these qualifiers are different, we have a type
7102     // mismatch.
7103     if (LQuals.getCVRQualifiers() != RQuals.getCVRQualifiers() ||
7104         LQuals.getAddressSpace() != RQuals.getAddressSpace() ||
7105         LQuals.getObjCLifetime() != RQuals.getObjCLifetime())
7106       return QualType();
7107 
7108     // Exactly one GC qualifier difference is allowed: __strong is
7109     // okay if the other type has no GC qualifier but is an Objective
7110     // C object pointer (i.e. implicitly strong by default).  We fix
7111     // this by pretending that the unqualified type was actually
7112     // qualified __strong.
7113     Qualifiers::GC GC_L = LQuals.getObjCGCAttr();
7114     Qualifiers::GC GC_R = RQuals.getObjCGCAttr();
7115     assert((GC_L != GC_R) && "unequal qualifier sets had only equal elements");
7116 
7117     if (GC_L == Qualifiers::Weak || GC_R == Qualifiers::Weak)
7118       return QualType();
7119 
7120     if (GC_L == Qualifiers::Strong && RHSCan->isObjCObjectPointerType()) {
7121       return mergeTypes(LHS, getObjCGCQualType(RHS, Qualifiers::Strong));
7122     }
7123     if (GC_R == Qualifiers::Strong && LHSCan->isObjCObjectPointerType()) {
7124       return mergeTypes(getObjCGCQualType(LHS, Qualifiers::Strong), RHS);
7125     }
7126     return QualType();
7127   }
7128 
7129   // Okay, qualifiers are equal.
7130 
7131   Type::TypeClass LHSClass = LHSCan->getTypeClass();
7132   Type::TypeClass RHSClass = RHSCan->getTypeClass();
7133 
7134   // We want to consider the two function types to be the same for these
7135   // comparisons, just force one to the other.
7136   if (LHSClass == Type::FunctionProto) LHSClass = Type::FunctionNoProto;
7137   if (RHSClass == Type::FunctionProto) RHSClass = Type::FunctionNoProto;
7138 
7139   // Same as above for arrays
7140   if (LHSClass == Type::VariableArray || LHSClass == Type::IncompleteArray)
7141     LHSClass = Type::ConstantArray;
7142   if (RHSClass == Type::VariableArray || RHSClass == Type::IncompleteArray)
7143     RHSClass = Type::ConstantArray;
7144 
7145   // ObjCInterfaces are just specialized ObjCObjects.
7146   if (LHSClass == Type::ObjCInterface) LHSClass = Type::ObjCObject;
7147   if (RHSClass == Type::ObjCInterface) RHSClass = Type::ObjCObject;
7148 
7149   // Canonicalize ExtVector -> Vector.
7150   if (LHSClass == Type::ExtVector) LHSClass = Type::Vector;
7151   if (RHSClass == Type::ExtVector) RHSClass = Type::Vector;
7152 
7153   // If the canonical type classes don't match.
7154   if (LHSClass != RHSClass) {
7155     // Note that we only have special rules for turning block enum
7156     // returns into block int returns, not vice-versa.
7157     if (const EnumType* ETy = LHS->getAs<EnumType>()) {
7158       return mergeEnumWithInteger(*this, ETy, RHS, false);
7159     }
7160     if (const EnumType* ETy = RHS->getAs<EnumType>()) {
7161       return mergeEnumWithInteger(*this, ETy, LHS, BlockReturnType);
7162     }
7163     // allow block pointer type to match an 'id' type.
7164     if (OfBlockPointer && !BlockReturnType) {
7165        if (LHS->isObjCIdType() && RHS->isBlockPointerType())
7166          return LHS;
7167       if (RHS->isObjCIdType() && LHS->isBlockPointerType())
7168         return RHS;
7169     }
7170 
7171     return QualType();
7172   }
7173 
7174   // The canonical type classes match.
7175   switch (LHSClass) {
7176 #define TYPE(Class, Base)
7177 #define ABSTRACT_TYPE(Class, Base)
7178 #define NON_CANONICAL_UNLESS_DEPENDENT_TYPE(Class, Base) case Type::Class:
7179 #define NON_CANONICAL_TYPE(Class, Base) case Type::Class:
7180 #define DEPENDENT_TYPE(Class, Base) case Type::Class:
7181 #include "clang/AST/TypeNodes.def"
7182     llvm_unreachable("Non-canonical and dependent types shouldn't get here");
7183 
7184   case Type::Auto:
7185   case Type::LValueReference:
7186   case Type::RValueReference:
7187   case Type::MemberPointer:
7188     llvm_unreachable("C++ should never be in mergeTypes");
7189 
7190   case Type::ObjCInterface:
7191   case Type::IncompleteArray:
7192   case Type::VariableArray:
7193   case Type::FunctionProto:
7194   case Type::ExtVector:
7195     llvm_unreachable("Types are eliminated above");
7196 
7197   case Type::Pointer:
7198   {
7199     // Merge two pointer types, while trying to preserve typedef info
7200     QualType LHSPointee = LHS->getAs<PointerType>()->getPointeeType();
7201     QualType RHSPointee = RHS->getAs<PointerType>()->getPointeeType();
7202     if (Unqualified) {
7203       LHSPointee = LHSPointee.getUnqualifiedType();
7204       RHSPointee = RHSPointee.getUnqualifiedType();
7205     }
7206     QualType ResultType = mergeTypes(LHSPointee, RHSPointee, false,
7207                                      Unqualified);
7208     if (ResultType.isNull()) return QualType();
7209     if (getCanonicalType(LHSPointee) == getCanonicalType(ResultType))
7210       return LHS;
7211     if (getCanonicalType(RHSPointee) == getCanonicalType(ResultType))
7212       return RHS;
7213     return getPointerType(ResultType);
7214   }
7215   case Type::BlockPointer:
7216   {
7217     // Merge two block pointer types, while trying to preserve typedef info
7218     QualType LHSPointee = LHS->getAs<BlockPointerType>()->getPointeeType();
7219     QualType RHSPointee = RHS->getAs<BlockPointerType>()->getPointeeType();
7220     if (Unqualified) {
7221       LHSPointee = LHSPointee.getUnqualifiedType();
7222       RHSPointee = RHSPointee.getUnqualifiedType();
7223     }
7224     QualType ResultType = mergeTypes(LHSPointee, RHSPointee, OfBlockPointer,
7225                                      Unqualified);
7226     if (ResultType.isNull()) return QualType();
7227     if (getCanonicalType(LHSPointee) == getCanonicalType(ResultType))
7228       return LHS;
7229     if (getCanonicalType(RHSPointee) == getCanonicalType(ResultType))
7230       return RHS;
7231     return getBlockPointerType(ResultType);
7232   }
7233   case Type::Atomic:
7234   {
7235     // Merge two pointer types, while trying to preserve typedef info
7236     QualType LHSValue = LHS->getAs<AtomicType>()->getValueType();
7237     QualType RHSValue = RHS->getAs<AtomicType>()->getValueType();
7238     if (Unqualified) {
7239       LHSValue = LHSValue.getUnqualifiedType();
7240       RHSValue = RHSValue.getUnqualifiedType();
7241     }
7242     QualType ResultType = mergeTypes(LHSValue, RHSValue, false,
7243                                      Unqualified);
7244     if (ResultType.isNull()) return QualType();
7245     if (getCanonicalType(LHSValue) == getCanonicalType(ResultType))
7246       return LHS;
7247     if (getCanonicalType(RHSValue) == getCanonicalType(ResultType))
7248       return RHS;
7249     return getAtomicType(ResultType);
7250   }
7251   case Type::ConstantArray:
7252   {
7253     const ConstantArrayType* LCAT = getAsConstantArrayType(LHS);
7254     const ConstantArrayType* RCAT = getAsConstantArrayType(RHS);
7255     if (LCAT && RCAT && RCAT->getSize() != LCAT->getSize())
7256       return QualType();
7257 
7258     QualType LHSElem = getAsArrayType(LHS)->getElementType();
7259     QualType RHSElem = getAsArrayType(RHS)->getElementType();
7260     if (Unqualified) {
7261       LHSElem = LHSElem.getUnqualifiedType();
7262       RHSElem = RHSElem.getUnqualifiedType();
7263     }
7264 
7265     QualType ResultType = mergeTypes(LHSElem, RHSElem, false, Unqualified);
7266     if (ResultType.isNull()) return QualType();
7267     if (LCAT && getCanonicalType(LHSElem) == getCanonicalType(ResultType))
7268       return LHS;
7269     if (RCAT && getCanonicalType(RHSElem) == getCanonicalType(ResultType))
7270       return RHS;
7271     if (LCAT) return getConstantArrayType(ResultType, LCAT->getSize(),
7272                                           ArrayType::ArraySizeModifier(), 0);
7273     if (RCAT) return getConstantArrayType(ResultType, RCAT->getSize(),
7274                                           ArrayType::ArraySizeModifier(), 0);
7275     const VariableArrayType* LVAT = getAsVariableArrayType(LHS);
7276     const VariableArrayType* RVAT = getAsVariableArrayType(RHS);
7277     if (LVAT && getCanonicalType(LHSElem) == getCanonicalType(ResultType))
7278       return LHS;
7279     if (RVAT && getCanonicalType(RHSElem) == getCanonicalType(ResultType))
7280       return RHS;
7281     if (LVAT) {
7282       // FIXME: This isn't correct! But tricky to implement because
7283       // the array's size has to be the size of LHS, but the type
7284       // has to be different.
7285       return LHS;
7286     }
7287     if (RVAT) {
7288       // FIXME: This isn't correct! But tricky to implement because
7289       // the array's size has to be the size of RHS, but the type
7290       // has to be different.
7291       return RHS;
7292     }
7293     if (getCanonicalType(LHSElem) == getCanonicalType(ResultType)) return LHS;
7294     if (getCanonicalType(RHSElem) == getCanonicalType(ResultType)) return RHS;
7295     return getIncompleteArrayType(ResultType,
7296                                   ArrayType::ArraySizeModifier(), 0);
7297   }
7298   case Type::FunctionNoProto:
7299     return mergeFunctionTypes(LHS, RHS, OfBlockPointer, Unqualified);
7300   case Type::Record:
7301   case Type::Enum:
7302     return QualType();
7303   case Type::Builtin:
7304     // Only exactly equal builtin types are compatible, which is tested above.
7305     return QualType();
7306   case Type::Complex:
7307     // Distinct complex types are incompatible.
7308     return QualType();
7309   case Type::Vector:
7310     // FIXME: The merged type should be an ExtVector!
7311     if (areCompatVectorTypes(LHSCan->getAs<VectorType>(),
7312                              RHSCan->getAs<VectorType>()))
7313       return LHS;
7314     return QualType();
7315   case Type::ObjCObject: {
7316     // Check if the types are assignment compatible.
7317     // FIXME: This should be type compatibility, e.g. whether
7318     // "LHS x; RHS x;" at global scope is legal.
7319     const ObjCObjectType* LHSIface = LHS->getAs<ObjCObjectType>();
7320     const ObjCObjectType* RHSIface = RHS->getAs<ObjCObjectType>();
7321     if (canAssignObjCInterfaces(LHSIface, RHSIface))
7322       return LHS;
7323 
7324     return QualType();
7325   }
7326   case Type::ObjCObjectPointer: {
7327     if (OfBlockPointer) {
7328       if (canAssignObjCInterfacesInBlockPointer(
7329                                           LHS->getAs<ObjCObjectPointerType>(),
7330                                           RHS->getAs<ObjCObjectPointerType>(),
7331                                           BlockReturnType))
7332         return LHS;
7333       return QualType();
7334     }
7335     if (canAssignObjCInterfaces(LHS->getAs<ObjCObjectPointerType>(),
7336                                 RHS->getAs<ObjCObjectPointerType>()))
7337       return LHS;
7338 
7339     return QualType();
7340   }
7341   }
7342 
7343   llvm_unreachable("Invalid Type::Class!");
7344 }
7345 
7346 bool ASTContext::FunctionTypesMatchOnNSConsumedAttrs(
7347                    const FunctionProtoType *FromFunctionType,
7348                    const FunctionProtoType *ToFunctionType) {
7349   if (FromFunctionType->hasAnyConsumedParams() !=
7350       ToFunctionType->hasAnyConsumedParams())
7351     return false;
7352   FunctionProtoType::ExtProtoInfo FromEPI =
7353     FromFunctionType->getExtProtoInfo();
7354   FunctionProtoType::ExtProtoInfo ToEPI =
7355     ToFunctionType->getExtProtoInfo();
7356   if (FromEPI.ConsumedParameters && ToEPI.ConsumedParameters)
7357     for (unsigned i = 0, n = FromFunctionType->getNumParams(); i != n; ++i) {
7358       if (FromEPI.ConsumedParameters[i] != ToEPI.ConsumedParameters[i])
7359         return false;
7360     }
7361   return true;
7362 }
7363 
7364 /// mergeObjCGCQualifiers - This routine merges ObjC's GC attribute of 'LHS' and
7365 /// 'RHS' attributes and returns the merged version; including for function
7366 /// return types.
7367 QualType ASTContext::mergeObjCGCQualifiers(QualType LHS, QualType RHS) {
7368   QualType LHSCan = getCanonicalType(LHS),
7369   RHSCan = getCanonicalType(RHS);
7370   // If two types are identical, they are compatible.
7371   if (LHSCan == RHSCan)
7372     return LHS;
7373   if (RHSCan->isFunctionType()) {
7374     if (!LHSCan->isFunctionType())
7375       return QualType();
7376     QualType OldReturnType =
7377         cast<FunctionType>(RHSCan.getTypePtr())->getReturnType();
7378     QualType NewReturnType =
7379         cast<FunctionType>(LHSCan.getTypePtr())->getReturnType();
7380     QualType ResReturnType =
7381       mergeObjCGCQualifiers(NewReturnType, OldReturnType);
7382     if (ResReturnType.isNull())
7383       return QualType();
7384     if (ResReturnType == NewReturnType || ResReturnType == OldReturnType) {
7385       // id foo(); ... __strong id foo(); or: __strong id foo(); ... id foo();
7386       // In either case, use OldReturnType to build the new function type.
7387       const FunctionType *F = LHS->getAs<FunctionType>();
7388       if (const FunctionProtoType *FPT = cast<FunctionProtoType>(F)) {
7389         FunctionProtoType::ExtProtoInfo EPI = FPT->getExtProtoInfo();
7390         EPI.ExtInfo = getFunctionExtInfo(LHS);
7391         QualType ResultType =
7392             getFunctionType(OldReturnType, FPT->getParamTypes(), EPI);
7393         return ResultType;
7394       }
7395     }
7396     return QualType();
7397   }
7398 
7399   // If the qualifiers are different, the types can still be merged.
7400   Qualifiers LQuals = LHSCan.getLocalQualifiers();
7401   Qualifiers RQuals = RHSCan.getLocalQualifiers();
7402   if (LQuals != RQuals) {
7403     // If any of these qualifiers are different, we have a type mismatch.
7404     if (LQuals.getCVRQualifiers() != RQuals.getCVRQualifiers() ||
7405         LQuals.getAddressSpace() != RQuals.getAddressSpace())
7406       return QualType();
7407 
7408     // Exactly one GC qualifier difference is allowed: __strong is
7409     // okay if the other type has no GC qualifier but is an Objective
7410     // C object pointer (i.e. implicitly strong by default).  We fix
7411     // this by pretending that the unqualified type was actually
7412     // qualified __strong.
7413     Qualifiers::GC GC_L = LQuals.getObjCGCAttr();
7414     Qualifiers::GC GC_R = RQuals.getObjCGCAttr();
7415     assert((GC_L != GC_R) && "unequal qualifier sets had only equal elements");
7416 
7417     if (GC_L == Qualifiers::Weak || GC_R == Qualifiers::Weak)
7418       return QualType();
7419 
7420     if (GC_L == Qualifiers::Strong)
7421       return LHS;
7422     if (GC_R == Qualifiers::Strong)
7423       return RHS;
7424     return QualType();
7425   }
7426 
7427   if (LHSCan->isObjCObjectPointerType() && RHSCan->isObjCObjectPointerType()) {
7428     QualType LHSBaseQT = LHS->getAs<ObjCObjectPointerType>()->getPointeeType();
7429     QualType RHSBaseQT = RHS->getAs<ObjCObjectPointerType>()->getPointeeType();
7430     QualType ResQT = mergeObjCGCQualifiers(LHSBaseQT, RHSBaseQT);
7431     if (ResQT == LHSBaseQT)
7432       return LHS;
7433     if (ResQT == RHSBaseQT)
7434       return RHS;
7435   }
7436   return QualType();
7437 }
7438 
7439 //===----------------------------------------------------------------------===//
7440 //                         Integer Predicates
7441 //===----------------------------------------------------------------------===//
7442 
7443 unsigned ASTContext::getIntWidth(QualType T) const {
7444   if (const EnumType *ET = T->getAs<EnumType>())
7445     T = ET->getDecl()->getIntegerType();
7446   if (T->isBooleanType())
7447     return 1;
7448   // For builtin types, just use the standard type sizing method
7449   return (unsigned)getTypeSize(T);
7450 }
7451 
7452 QualType ASTContext::getCorrespondingUnsignedType(QualType T) const {
7453   assert(T->hasSignedIntegerRepresentation() && "Unexpected type");
7454 
7455   // Turn <4 x signed int> -> <4 x unsigned int>
7456   if (const VectorType *VTy = T->getAs<VectorType>())
7457     return getVectorType(getCorrespondingUnsignedType(VTy->getElementType()),
7458                          VTy->getNumElements(), VTy->getVectorKind());
7459 
7460   // For enums, we return the unsigned version of the base type.
7461   if (const EnumType *ETy = T->getAs<EnumType>())
7462     T = ETy->getDecl()->getIntegerType();
7463 
7464   const BuiltinType *BTy = T->getAs<BuiltinType>();
7465   assert(BTy && "Unexpected signed integer type");
7466   switch (BTy->getKind()) {
7467   case BuiltinType::Char_S:
7468   case BuiltinType::SChar:
7469     return UnsignedCharTy;
7470   case BuiltinType::Short:
7471     return UnsignedShortTy;
7472   case BuiltinType::Int:
7473     return UnsignedIntTy;
7474   case BuiltinType::Long:
7475     return UnsignedLongTy;
7476   case BuiltinType::LongLong:
7477     return UnsignedLongLongTy;
7478   case BuiltinType::Int128:
7479     return UnsignedInt128Ty;
7480   default:
7481     llvm_unreachable("Unexpected signed integer type");
7482   }
7483 }
7484 
7485 ASTMutationListener::~ASTMutationListener() { }
7486 
7487 void ASTMutationListener::DeducedReturnType(const FunctionDecl *FD,
7488                                             QualType ReturnType) {}
7489 
7490 //===----------------------------------------------------------------------===//
7491 //                          Builtin Type Computation
7492 //===----------------------------------------------------------------------===//
7493 
7494 /// DecodeTypeFromStr - This decodes one type descriptor from Str, advancing the
7495 /// pointer over the consumed characters.  This returns the resultant type.  If
7496 /// AllowTypeModifiers is false then modifier like * are not parsed, just basic
7497 /// types.  This allows "v2i*" to be parsed as a pointer to a v2i instead of
7498 /// a vector of "i*".
7499 ///
7500 /// RequiresICE is filled in on return to indicate whether the value is required
7501 /// to be an Integer Constant Expression.
7502 static QualType DecodeTypeFromStr(const char *&Str, const ASTContext &Context,
7503                                   ASTContext::GetBuiltinTypeError &Error,
7504                                   bool &RequiresICE,
7505                                   bool AllowTypeModifiers) {
7506   // Modifiers.
7507   int HowLong = 0;
7508   bool Signed = false, Unsigned = false;
7509   RequiresICE = false;
7510 
7511   // Read the prefixed modifiers first.
7512   bool Done = false;
7513   while (!Done) {
7514     switch (*Str++) {
7515     default: Done = true; --Str; break;
7516     case 'I':
7517       RequiresICE = true;
7518       break;
7519     case 'S':
7520       assert(!Unsigned && "Can't use both 'S' and 'U' modifiers!");
7521       assert(!Signed && "Can't use 'S' modifier multiple times!");
7522       Signed = true;
7523       break;
7524     case 'U':
7525       assert(!Signed && "Can't use both 'S' and 'U' modifiers!");
7526       assert(!Unsigned && "Can't use 'S' modifier multiple times!");
7527       Unsigned = true;
7528       break;
7529     case 'L':
7530       assert(HowLong <= 2 && "Can't have LLLL modifier");
7531       ++HowLong;
7532       break;
7533     }
7534   }
7535 
7536   QualType Type;
7537 
7538   // Read the base type.
7539   switch (*Str++) {
7540   default: llvm_unreachable("Unknown builtin type letter!");
7541   case 'v':
7542     assert(HowLong == 0 && !Signed && !Unsigned &&
7543            "Bad modifiers used with 'v'!");
7544     Type = Context.VoidTy;
7545     break;
7546   case 'h':
7547     assert(HowLong == 0 && !Signed && !Unsigned &&
7548            "Bad modifiers used with 'f'!");
7549     Type = Context.HalfTy;
7550     break;
7551   case 'f':
7552     assert(HowLong == 0 && !Signed && !Unsigned &&
7553            "Bad modifiers used with 'f'!");
7554     Type = Context.FloatTy;
7555     break;
7556   case 'd':
7557     assert(HowLong < 2 && !Signed && !Unsigned &&
7558            "Bad modifiers used with 'd'!");
7559     if (HowLong)
7560       Type = Context.LongDoubleTy;
7561     else
7562       Type = Context.DoubleTy;
7563     break;
7564   case 's':
7565     assert(HowLong == 0 && "Bad modifiers used with 's'!");
7566     if (Unsigned)
7567       Type = Context.UnsignedShortTy;
7568     else
7569       Type = Context.ShortTy;
7570     break;
7571   case 'i':
7572     if (HowLong == 3)
7573       Type = Unsigned ? Context.UnsignedInt128Ty : Context.Int128Ty;
7574     else if (HowLong == 2)
7575       Type = Unsigned ? Context.UnsignedLongLongTy : Context.LongLongTy;
7576     else if (HowLong == 1)
7577       Type = Unsigned ? Context.UnsignedLongTy : Context.LongTy;
7578     else
7579       Type = Unsigned ? Context.UnsignedIntTy : Context.IntTy;
7580     break;
7581   case 'c':
7582     assert(HowLong == 0 && "Bad modifiers used with 'c'!");
7583     if (Signed)
7584       Type = Context.SignedCharTy;
7585     else if (Unsigned)
7586       Type = Context.UnsignedCharTy;
7587     else
7588       Type = Context.CharTy;
7589     break;
7590   case 'b': // boolean
7591     assert(HowLong == 0 && !Signed && !Unsigned && "Bad modifiers for 'b'!");
7592     Type = Context.BoolTy;
7593     break;
7594   case 'z':  // size_t.
7595     assert(HowLong == 0 && !Signed && !Unsigned && "Bad modifiers for 'z'!");
7596     Type = Context.getSizeType();
7597     break;
7598   case 'F':
7599     Type = Context.getCFConstantStringType();
7600     break;
7601   case 'G':
7602     Type = Context.getObjCIdType();
7603     break;
7604   case 'H':
7605     Type = Context.getObjCSelType();
7606     break;
7607   case 'M':
7608     Type = Context.getObjCSuperType();
7609     break;
7610   case 'a':
7611     Type = Context.getBuiltinVaListType();
7612     assert(!Type.isNull() && "builtin va list type not initialized!");
7613     break;
7614   case 'A':
7615     // This is a "reference" to a va_list; however, what exactly
7616     // this means depends on how va_list is defined. There are two
7617     // different kinds of va_list: ones passed by value, and ones
7618     // passed by reference.  An example of a by-value va_list is
7619     // x86, where va_list is a char*. An example of by-ref va_list
7620     // is x86-64, where va_list is a __va_list_tag[1]. For x86,
7621     // we want this argument to be a char*&; for x86-64, we want
7622     // it to be a __va_list_tag*.
7623     Type = Context.getBuiltinVaListType();
7624     assert(!Type.isNull() && "builtin va list type not initialized!");
7625     if (Type->isArrayType())
7626       Type = Context.getArrayDecayedType(Type);
7627     else
7628       Type = Context.getLValueReferenceType(Type);
7629     break;
7630   case 'V': {
7631     char *End;
7632     unsigned NumElements = strtoul(Str, &End, 10);
7633     assert(End != Str && "Missing vector size");
7634     Str = End;
7635 
7636     QualType ElementType = DecodeTypeFromStr(Str, Context, Error,
7637                                              RequiresICE, false);
7638     assert(!RequiresICE && "Can't require vector ICE");
7639 
7640     // TODO: No way to make AltiVec vectors in builtins yet.
7641     Type = Context.getVectorType(ElementType, NumElements,
7642                                  VectorType::GenericVector);
7643     break;
7644   }
7645   case 'E': {
7646     char *End;
7647 
7648     unsigned NumElements = strtoul(Str, &End, 10);
7649     assert(End != Str && "Missing vector size");
7650 
7651     Str = End;
7652 
7653     QualType ElementType = DecodeTypeFromStr(Str, Context, Error, RequiresICE,
7654                                              false);
7655     Type = Context.getExtVectorType(ElementType, NumElements);
7656     break;
7657   }
7658   case 'X': {
7659     QualType ElementType = DecodeTypeFromStr(Str, Context, Error, RequiresICE,
7660                                              false);
7661     assert(!RequiresICE && "Can't require complex ICE");
7662     Type = Context.getComplexType(ElementType);
7663     break;
7664   }
7665   case 'Y' : {
7666     Type = Context.getPointerDiffType();
7667     break;
7668   }
7669   case 'P':
7670     Type = Context.getFILEType();
7671     if (Type.isNull()) {
7672       Error = ASTContext::GE_Missing_stdio;
7673       return QualType();
7674     }
7675     break;
7676   case 'J':
7677     if (Signed)
7678       Type = Context.getsigjmp_bufType();
7679     else
7680       Type = Context.getjmp_bufType();
7681 
7682     if (Type.isNull()) {
7683       Error = ASTContext::GE_Missing_setjmp;
7684       return QualType();
7685     }
7686     break;
7687   case 'K':
7688     assert(HowLong == 0 && !Signed && !Unsigned && "Bad modifiers for 'K'!");
7689     Type = Context.getucontext_tType();
7690 
7691     if (Type.isNull()) {
7692       Error = ASTContext::GE_Missing_ucontext;
7693       return QualType();
7694     }
7695     break;
7696   case 'p':
7697     Type = Context.getProcessIDType();
7698     break;
7699   }
7700 
7701   // If there are modifiers and if we're allowed to parse them, go for it.
7702   Done = !AllowTypeModifiers;
7703   while (!Done) {
7704     switch (char c = *Str++) {
7705     default: Done = true; --Str; break;
7706     case '*':
7707     case '&': {
7708       // Both pointers and references can have their pointee types
7709       // qualified with an address space.
7710       char *End;
7711       unsigned AddrSpace = strtoul(Str, &End, 10);
7712       if (End != Str && AddrSpace != 0) {
7713         Type = Context.getAddrSpaceQualType(Type, AddrSpace);
7714         Str = End;
7715       }
7716       if (c == '*')
7717         Type = Context.getPointerType(Type);
7718       else
7719         Type = Context.getLValueReferenceType(Type);
7720       break;
7721     }
7722     // FIXME: There's no way to have a built-in with an rvalue ref arg.
7723     case 'C':
7724       Type = Type.withConst();
7725       break;
7726     case 'D':
7727       Type = Context.getVolatileType(Type);
7728       break;
7729     case 'R':
7730       Type = Type.withRestrict();
7731       break;
7732     }
7733   }
7734 
7735   assert((!RequiresICE || Type->isIntegralOrEnumerationType()) &&
7736          "Integer constant 'I' type must be an integer");
7737 
7738   return Type;
7739 }
7740 
7741 /// GetBuiltinType - Return the type for the specified builtin.
7742 QualType ASTContext::GetBuiltinType(unsigned Id,
7743                                     GetBuiltinTypeError &Error,
7744                                     unsigned *IntegerConstantArgs) const {
7745   const char *TypeStr = BuiltinInfo.GetTypeString(Id);
7746 
7747   SmallVector<QualType, 8> ArgTypes;
7748 
7749   bool RequiresICE = false;
7750   Error = GE_None;
7751   QualType ResType = DecodeTypeFromStr(TypeStr, *this, Error,
7752                                        RequiresICE, true);
7753   if (Error != GE_None)
7754     return QualType();
7755 
7756   assert(!RequiresICE && "Result of intrinsic cannot be required to be an ICE");
7757 
7758   while (TypeStr[0] && TypeStr[0] != '.') {
7759     QualType Ty = DecodeTypeFromStr(TypeStr, *this, Error, RequiresICE, true);
7760     if (Error != GE_None)
7761       return QualType();
7762 
7763     // If this argument is required to be an IntegerConstantExpression and the
7764     // caller cares, fill in the bitmask we return.
7765     if (RequiresICE && IntegerConstantArgs)
7766       *IntegerConstantArgs |= 1 << ArgTypes.size();
7767 
7768     // Do array -> pointer decay.  The builtin should use the decayed type.
7769     if (Ty->isArrayType())
7770       Ty = getArrayDecayedType(Ty);
7771 
7772     ArgTypes.push_back(Ty);
7773   }
7774 
7775   assert((TypeStr[0] != '.' || TypeStr[1] == 0) &&
7776          "'.' should only occur at end of builtin type list!");
7777 
7778   FunctionType::ExtInfo EI(CC_C);
7779   if (BuiltinInfo.isNoReturn(Id)) EI = EI.withNoReturn(true);
7780 
7781   bool Variadic = (TypeStr[0] == '.');
7782 
7783   // We really shouldn't be making a no-proto type here, especially in C++.
7784   if (ArgTypes.empty() && Variadic)
7785     return getFunctionNoProtoType(ResType, EI);
7786 
7787   FunctionProtoType::ExtProtoInfo EPI;
7788   EPI.ExtInfo = EI;
7789   EPI.Variadic = Variadic;
7790 
7791   return getFunctionType(ResType, ArgTypes, EPI);
7792 }
7793 
7794 GVALinkage ASTContext::GetGVALinkageForFunction(const FunctionDecl *FD) {
7795   if (!FD->isExternallyVisible())
7796     return GVA_Internal;
7797 
7798   GVALinkage External = GVA_StrongExternal;
7799   switch (FD->getTemplateSpecializationKind()) {
7800   case TSK_Undeclared:
7801   case TSK_ExplicitSpecialization:
7802     External = GVA_StrongExternal;
7803     break;
7804 
7805   case TSK_ExplicitInstantiationDefinition:
7806     return GVA_ExplicitTemplateInstantiation;
7807 
7808   case TSK_ExplicitInstantiationDeclaration:
7809   case TSK_ImplicitInstantiation:
7810     External = GVA_TemplateInstantiation;
7811     break;
7812   }
7813 
7814   if (!FD->isInlined())
7815     return External;
7816 
7817   if ((!getLangOpts().CPlusPlus && !getLangOpts().MSVCCompat) ||
7818       FD->hasAttr<GNUInlineAttr>()) {
7819     // GNU or C99 inline semantics. Determine whether this symbol should be
7820     // externally visible.
7821     if (FD->isInlineDefinitionExternallyVisible())
7822       return External;
7823 
7824     // C99 inline semantics, where the symbol is not externally visible.
7825     return GVA_C99Inline;
7826   }
7827 
7828   // C++0x [temp.explicit]p9:
7829   //   [ Note: The intent is that an inline function that is the subject of
7830   //   an explicit instantiation declaration will still be implicitly
7831   //   instantiated when used so that the body can be considered for
7832   //   inlining, but that no out-of-line copy of the inline function would be
7833   //   generated in the translation unit. -- end note ]
7834   if (FD->getTemplateSpecializationKind()
7835                                        == TSK_ExplicitInstantiationDeclaration)
7836     return GVA_C99Inline;
7837 
7838   return GVA_CXXInline;
7839 }
7840 
7841 GVALinkage ASTContext::GetGVALinkageForVariable(const VarDecl *VD) {
7842   if (!VD->isExternallyVisible())
7843     return GVA_Internal;
7844 
7845   switch (VD->getTemplateSpecializationKind()) {
7846   case TSK_Undeclared:
7847   case TSK_ExplicitSpecialization:
7848     return GVA_StrongExternal;
7849 
7850   case TSK_ExplicitInstantiationDeclaration:
7851     llvm_unreachable("Variable should not be instantiated");
7852   // Fall through to treat this like any other instantiation.
7853 
7854   case TSK_ExplicitInstantiationDefinition:
7855     return GVA_ExplicitTemplateInstantiation;
7856 
7857   case TSK_ImplicitInstantiation:
7858     return GVA_TemplateInstantiation;
7859   }
7860 
7861   llvm_unreachable("Invalid Linkage!");
7862 }
7863 
7864 bool ASTContext::DeclMustBeEmitted(const Decl *D) {
7865   if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
7866     if (!VD->isFileVarDecl())
7867       return false;
7868   } else if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
7869     // We never need to emit an uninstantiated function template.
7870     if (FD->getTemplatedKind() == FunctionDecl::TK_FunctionTemplate)
7871       return false;
7872   } else
7873     return false;
7874 
7875   // If this is a member of a class template, we do not need to emit it.
7876   if (D->getDeclContext()->isDependentContext())
7877     return false;
7878 
7879   // Weak references don't produce any output by themselves.
7880   if (D->hasAttr<WeakRefAttr>())
7881     return false;
7882 
7883   // Aliases and used decls are required.
7884   if (D->hasAttr<AliasAttr>() || D->hasAttr<UsedAttr>())
7885     return true;
7886 
7887   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
7888     // Forward declarations aren't required.
7889     if (!FD->doesThisDeclarationHaveABody())
7890       return FD->doesDeclarationForceExternallyVisibleDefinition();
7891 
7892     // Constructors and destructors are required.
7893     if (FD->hasAttr<ConstructorAttr>() || FD->hasAttr<DestructorAttr>())
7894       return true;
7895 
7896     // The key function for a class is required.  This rule only comes
7897     // into play when inline functions can be key functions, though.
7898     if (getTargetInfo().getCXXABI().canKeyFunctionBeInline()) {
7899       if (const CXXMethodDecl *MD = dyn_cast<CXXMethodDecl>(FD)) {
7900         const CXXRecordDecl *RD = MD->getParent();
7901         if (MD->isOutOfLine() && RD->isDynamicClass()) {
7902           const CXXMethodDecl *KeyFunc = getCurrentKeyFunction(RD);
7903           if (KeyFunc && KeyFunc->getCanonicalDecl() == MD->getCanonicalDecl())
7904             return true;
7905         }
7906       }
7907     }
7908 
7909     GVALinkage Linkage = GetGVALinkageForFunction(FD);
7910 
7911     // static, static inline, always_inline, and extern inline functions can
7912     // always be deferred.  Normal inline functions can be deferred in C99/C++.
7913     // Implicit template instantiations can also be deferred in C++.
7914     if (Linkage == GVA_Internal  || Linkage == GVA_C99Inline ||
7915         Linkage == GVA_CXXInline || Linkage == GVA_TemplateInstantiation)
7916       return false;
7917     return true;
7918   }
7919 
7920   const VarDecl *VD = cast<VarDecl>(D);
7921   assert(VD->isFileVarDecl() && "Expected file scoped var");
7922 
7923   if (VD->isThisDeclarationADefinition() == VarDecl::DeclarationOnly)
7924     return false;
7925 
7926   // Variables that can be needed in other TUs are required.
7927   GVALinkage L = GetGVALinkageForVariable(VD);
7928   if (L != GVA_Internal && L != GVA_TemplateInstantiation)
7929     return true;
7930 
7931   // Variables that have destruction with side-effects are required.
7932   if (VD->getType().isDestructedType())
7933     return true;
7934 
7935   // Variables that have initialization with side-effects are required.
7936   if (VD->getInit() && VD->getInit()->HasSideEffects(*this))
7937     return true;
7938 
7939   return false;
7940 }
7941 
7942 CallingConv ASTContext::getDefaultCallingConvention(bool IsVariadic,
7943                                                     bool IsCXXMethod) const {
7944   // Pass through to the C++ ABI object
7945   if (IsCXXMethod)
7946     return ABI->getDefaultMethodCallConv(IsVariadic);
7947 
7948   return (LangOpts.MRTD && !IsVariadic) ? CC_X86StdCall : CC_C;
7949 }
7950 
7951 bool ASTContext::isNearlyEmpty(const CXXRecordDecl *RD) const {
7952   // Pass through to the C++ ABI object
7953   return ABI->isNearlyEmpty(RD);
7954 }
7955 
7956 VTableContextBase *ASTContext::getVTableContext() {
7957   if (!VTContext.get()) {
7958     if (Target->getCXXABI().isMicrosoft())
7959       VTContext.reset(new MicrosoftVTableContext(*this));
7960     else
7961       VTContext.reset(new ItaniumVTableContext(*this));
7962   }
7963   return VTContext.get();
7964 }
7965 
7966 MangleContext *ASTContext::createMangleContext() {
7967   switch (Target->getCXXABI().getKind()) {
7968   case TargetCXXABI::GenericAArch64:
7969   case TargetCXXABI::GenericItanium:
7970   case TargetCXXABI::GenericARM:
7971   case TargetCXXABI::iOS:
7972     return ItaniumMangleContext::create(*this, getDiagnostics());
7973   case TargetCXXABI::Microsoft:
7974     return MicrosoftMangleContext::create(*this, getDiagnostics());
7975   }
7976   llvm_unreachable("Unsupported ABI");
7977 }
7978 
7979 CXXABI::~CXXABI() {}
7980 
7981 size_t ASTContext::getSideTableAllocatedMemory() const {
7982   return ASTRecordLayouts.getMemorySize() +
7983          llvm::capacity_in_bytes(ObjCLayouts) +
7984          llvm::capacity_in_bytes(KeyFunctions) +
7985          llvm::capacity_in_bytes(ObjCImpls) +
7986          llvm::capacity_in_bytes(BlockVarCopyInits) +
7987          llvm::capacity_in_bytes(DeclAttrs) +
7988          llvm::capacity_in_bytes(TemplateOrInstantiation) +
7989          llvm::capacity_in_bytes(InstantiatedFromUsingDecl) +
7990          llvm::capacity_in_bytes(InstantiatedFromUsingShadowDecl) +
7991          llvm::capacity_in_bytes(InstantiatedFromUnnamedFieldDecl) +
7992          llvm::capacity_in_bytes(OverriddenMethods) +
7993          llvm::capacity_in_bytes(Types) +
7994          llvm::capacity_in_bytes(VariableArrayTypes) +
7995          llvm::capacity_in_bytes(ClassScopeSpecializationPattern);
7996 }
7997 
7998 /// getIntTypeForBitwidth -
7999 /// sets integer QualTy according to specified details:
8000 /// bitwidth, signed/unsigned.
8001 /// Returns empty type if there is no appropriate target types.
8002 QualType ASTContext::getIntTypeForBitwidth(unsigned DestWidth,
8003                                            unsigned Signed) const {
8004   TargetInfo::IntType Ty = getTargetInfo().getIntTypeByWidth(DestWidth, Signed);
8005   CanQualType QualTy = getFromTargetType(Ty);
8006   if (!QualTy && DestWidth == 128)
8007     return Signed ? Int128Ty : UnsignedInt128Ty;
8008   return QualTy;
8009 }
8010 
8011 /// getRealTypeForBitwidth -
8012 /// sets floating point QualTy according to specified bitwidth.
8013 /// Returns empty type if there is no appropriate target types.
8014 QualType ASTContext::getRealTypeForBitwidth(unsigned DestWidth) const {
8015   TargetInfo::RealType Ty = getTargetInfo().getRealTypeByWidth(DestWidth);
8016   switch (Ty) {
8017   case TargetInfo::Float:
8018     return FloatTy;
8019   case TargetInfo::Double:
8020     return DoubleTy;
8021   case TargetInfo::LongDouble:
8022     return LongDoubleTy;
8023   case TargetInfo::NoFloat:
8024     return QualType();
8025   }
8026 
8027   llvm_unreachable("Unhandled TargetInfo::RealType value");
8028 }
8029 
8030 void ASTContext::setManglingNumber(const NamedDecl *ND, unsigned Number) {
8031   if (Number > 1)
8032     MangleNumbers[ND] = Number;
8033 }
8034 
8035 unsigned ASTContext::getManglingNumber(const NamedDecl *ND) const {
8036   llvm::DenseMap<const NamedDecl *, unsigned>::const_iterator I =
8037     MangleNumbers.find(ND);
8038   return I != MangleNumbers.end() ? I->second : 1;
8039 }
8040 
8041 MangleNumberingContext &
8042 ASTContext::getManglingNumberContext(const DeclContext *DC) {
8043   assert(LangOpts.CPlusPlus);  // We don't need mangling numbers for plain C.
8044   MangleNumberingContext *&MCtx = MangleNumberingContexts[DC];
8045   if (!MCtx)
8046     MCtx = createMangleNumberingContext();
8047   return *MCtx;
8048 }
8049 
8050 MangleNumberingContext *ASTContext::createMangleNumberingContext() const {
8051   return ABI->createMangleNumberingContext();
8052 }
8053 
8054 void ASTContext::setParameterIndex(const ParmVarDecl *D, unsigned int index) {
8055   ParamIndices[D] = index;
8056 }
8057 
8058 unsigned ASTContext::getParameterIndex(const ParmVarDecl *D) const {
8059   ParameterIndexTable::const_iterator I = ParamIndices.find(D);
8060   assert(I != ParamIndices.end() &&
8061          "ParmIndices lacks entry set by ParmVarDecl");
8062   return I->second;
8063 }
8064 
8065 APValue *
8066 ASTContext::getMaterializedTemporaryValue(const MaterializeTemporaryExpr *E,
8067                                           bool MayCreate) {
8068   assert(E && E->getStorageDuration() == SD_Static &&
8069          "don't need to cache the computed value for this temporary");
8070   if (MayCreate)
8071     return &MaterializedTemporaryValues[E];
8072 
8073   llvm::DenseMap<const MaterializeTemporaryExpr *, APValue>::iterator I =
8074       MaterializedTemporaryValues.find(E);
8075   return I == MaterializedTemporaryValues.end() ? 0 : &I->second;
8076 }
8077 
8078 bool ASTContext::AtomicUsesUnsupportedLibcall(const AtomicExpr *E) const {
8079   const llvm::Triple &T = getTargetInfo().getTriple();
8080   if (!T.isOSDarwin())
8081     return false;
8082 
8083   if (!(T.isiOS() && T.isOSVersionLT(7)) &&
8084       !(T.isMacOSX() && T.isOSVersionLT(10, 9)))
8085     return false;
8086 
8087   QualType AtomicTy = E->getPtr()->getType()->getPointeeType();
8088   CharUnits sizeChars = getTypeSizeInChars(AtomicTy);
8089   uint64_t Size = sizeChars.getQuantity();
8090   CharUnits alignChars = getTypeAlignInChars(AtomicTy);
8091   unsigned Align = alignChars.getQuantity();
8092   unsigned MaxInlineWidthInBits = getTargetInfo().getMaxAtomicInlineWidth();
8093   return (Size != Align || toBits(sizeChars) > MaxInlineWidthInBits);
8094 }
8095 
8096 namespace {
8097 
8098   /// \brief A \c RecursiveASTVisitor that builds a map from nodes to their
8099   /// parents as defined by the \c RecursiveASTVisitor.
8100   ///
8101   /// Note that the relationship described here is purely in terms of AST
8102   /// traversal - there are other relationships (for example declaration context)
8103   /// in the AST that are better modeled by special matchers.
8104   ///
8105   /// FIXME: Currently only builds up the map using \c Stmt and \c Decl nodes.
8106   class ParentMapASTVisitor : public RecursiveASTVisitor<ParentMapASTVisitor> {
8107 
8108   public:
8109     /// \brief Builds and returns the translation unit's parent map.
8110     ///
8111     ///  The caller takes ownership of the returned \c ParentMap.
8112     static ASTContext::ParentMap *buildMap(TranslationUnitDecl &TU) {
8113       ParentMapASTVisitor Visitor(new ASTContext::ParentMap);
8114       Visitor.TraverseDecl(&TU);
8115       return Visitor.Parents;
8116     }
8117 
8118   private:
8119     typedef RecursiveASTVisitor<ParentMapASTVisitor> VisitorBase;
8120 
8121     ParentMapASTVisitor(ASTContext::ParentMap *Parents) : Parents(Parents) {
8122     }
8123 
8124     bool shouldVisitTemplateInstantiations() const {
8125       return true;
8126     }
8127     bool shouldVisitImplicitCode() const {
8128       return true;
8129     }
8130     // Disables data recursion. We intercept Traverse* methods in the RAV, which
8131     // are not triggered during data recursion.
8132     bool shouldUseDataRecursionFor(clang::Stmt *S) const {
8133       return false;
8134     }
8135 
8136     template <typename T>
8137     bool TraverseNode(T *Node, bool(VisitorBase:: *traverse) (T *)) {
8138       if (Node == NULL)
8139         return true;
8140       if (ParentStack.size() > 0)
8141         // FIXME: Currently we add the same parent multiple times, for example
8142         // when we visit all subexpressions of template instantiations; this is
8143         // suboptimal, bug benign: the only way to visit those is with
8144         // hasAncestor / hasParent, and those do not create new matches.
8145         // The plan is to enable DynTypedNode to be storable in a map or hash
8146         // map. The main problem there is to implement hash functions /
8147         // comparison operators for all types that DynTypedNode supports that
8148         // do not have pointer identity.
8149         (*Parents)[Node].push_back(ParentStack.back());
8150       ParentStack.push_back(ast_type_traits::DynTypedNode::create(*Node));
8151       bool Result = (this ->* traverse) (Node);
8152       ParentStack.pop_back();
8153       return Result;
8154     }
8155 
8156     bool TraverseDecl(Decl *DeclNode) {
8157       return TraverseNode(DeclNode, &VisitorBase::TraverseDecl);
8158     }
8159 
8160     bool TraverseStmt(Stmt *StmtNode) {
8161       return TraverseNode(StmtNode, &VisitorBase::TraverseStmt);
8162     }
8163 
8164     ASTContext::ParentMap *Parents;
8165     llvm::SmallVector<ast_type_traits::DynTypedNode, 16> ParentStack;
8166 
8167     friend class RecursiveASTVisitor<ParentMapASTVisitor>;
8168   };
8169 
8170 } // end namespace
8171 
8172 ASTContext::ParentVector
8173 ASTContext::getParents(const ast_type_traits::DynTypedNode &Node) {
8174   assert(Node.getMemoizationData() &&
8175          "Invariant broken: only nodes that support memoization may be "
8176          "used in the parent map.");
8177   if (!AllParents) {
8178     // We always need to run over the whole translation unit, as
8179     // hasAncestor can escape any subtree.
8180     AllParents.reset(
8181         ParentMapASTVisitor::buildMap(*getTranslationUnitDecl()));
8182   }
8183   ParentMap::const_iterator I = AllParents->find(Node.getMemoizationData());
8184   if (I == AllParents->end()) {
8185     return ParentVector();
8186   }
8187   return I->second;
8188 }
8189 
8190 bool
8191 ASTContext::ObjCMethodsAreEqual(const ObjCMethodDecl *MethodDecl,
8192                                 const ObjCMethodDecl *MethodImpl) {
8193   // No point trying to match an unavailable/deprecated mothod.
8194   if (MethodDecl->hasAttr<UnavailableAttr>()
8195       || MethodDecl->hasAttr<DeprecatedAttr>())
8196     return false;
8197   if (MethodDecl->getObjCDeclQualifier() !=
8198       MethodImpl->getObjCDeclQualifier())
8199     return false;
8200   if (!hasSameType(MethodDecl->getReturnType(), MethodImpl->getReturnType()))
8201     return false;
8202 
8203   if (MethodDecl->param_size() != MethodImpl->param_size())
8204     return false;
8205 
8206   for (ObjCMethodDecl::param_const_iterator IM = MethodImpl->param_begin(),
8207        IF = MethodDecl->param_begin(), EM = MethodImpl->param_end(),
8208        EF = MethodDecl->param_end();
8209        IM != EM && IF != EF; ++IM, ++IF) {
8210     const ParmVarDecl *DeclVar = (*IF);
8211     const ParmVarDecl *ImplVar = (*IM);
8212     if (ImplVar->getObjCDeclQualifier() != DeclVar->getObjCDeclQualifier())
8213       return false;
8214     if (!hasSameType(DeclVar->getType(), ImplVar->getType()))
8215       return false;
8216   }
8217   return (MethodDecl->isVariadic() == MethodImpl->isVariadic());
8218 
8219 }
8220