1 //===--- ASTReaderDecl.cpp - Decl Deserialization ---------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file implements the ASTReader::ReadDeclRecord method, which is the
11 // entrypoint for loading a decl.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "clang/Serialization/ASTReader.h"
16 #include "ASTCommon.h"
17 #include "ASTReaderInternals.h"
18 #include "clang/AST/ASTConsumer.h"
19 #include "clang/AST/ASTContext.h"
20 #include "clang/AST/DeclCXX.h"
21 #include "clang/AST/DeclGroup.h"
22 #include "clang/AST/DeclTemplate.h"
23 #include "clang/AST/DeclVisitor.h"
24 #include "clang/AST/Expr.h"
25 #include "clang/Sema/IdentifierResolver.h"
26 #include "clang/Sema/Sema.h"
27 #include "clang/Sema/SemaDiagnostic.h"
28 #include "llvm/Support/SaveAndRestore.h"
29 using namespace clang;
30 using namespace clang::serialization;
31 
32 //===----------------------------------------------------------------------===//
33 // Declaration deserialization
34 //===----------------------------------------------------------------------===//
35 
36 namespace clang {
37   class ASTDeclReader : public DeclVisitor<ASTDeclReader, void> {
38     ASTReader &Reader;
39     ModuleFile &F;
40     const DeclID ThisDeclID;
41     const unsigned RawLocation;
42     typedef ASTReader::RecordData RecordData;
43     const RecordData &Record;
44     unsigned &Idx;
45     TypeID TypeIDForTypeDecl;
46     unsigned AnonymousDeclNumber;
47     GlobalDeclID NamedDeclForTagDecl;
48     IdentifierInfo *TypedefNameForLinkage;
49 
50     bool HasPendingBody;
51 
52     uint64_t GetCurrentCursorOffset();
53 
54     SourceLocation ReadSourceLocation(const RecordData &R, unsigned &I) {
55       return Reader.ReadSourceLocation(F, R, I);
56     }
57 
58     SourceRange ReadSourceRange(const RecordData &R, unsigned &I) {
59       return Reader.ReadSourceRange(F, R, I);
60     }
61 
62     TypeSourceInfo *GetTypeSourceInfo(const RecordData &R, unsigned &I) {
63       return Reader.GetTypeSourceInfo(F, R, I);
64     }
65 
66     serialization::DeclID ReadDeclID(const RecordData &R, unsigned &I) {
67       return Reader.ReadDeclID(F, R, I);
68     }
69 
70     void ReadDeclIDList(SmallVectorImpl<DeclID> &IDs) {
71       for (unsigned I = 0, Size = Record[Idx++]; I != Size; ++I)
72         IDs.push_back(ReadDeclID(Record, Idx));
73     }
74 
75     Decl *ReadDecl(const RecordData &R, unsigned &I) {
76       return Reader.ReadDecl(F, R, I);
77     }
78 
79     template<typename T>
80     T *ReadDeclAs(const RecordData &R, unsigned &I) {
81       return Reader.ReadDeclAs<T>(F, R, I);
82     }
83 
84     void ReadQualifierInfo(QualifierInfo &Info,
85                            const RecordData &R, unsigned &I) {
86       Reader.ReadQualifierInfo(F, Info, R, I);
87     }
88 
89     void ReadDeclarationNameLoc(DeclarationNameLoc &DNLoc, DeclarationName Name,
90                                 const RecordData &R, unsigned &I) {
91       Reader.ReadDeclarationNameLoc(F, DNLoc, Name, R, I);
92     }
93 
94     void ReadDeclarationNameInfo(DeclarationNameInfo &NameInfo,
95                                 const RecordData &R, unsigned &I) {
96       Reader.ReadDeclarationNameInfo(F, NameInfo, R, I);
97     }
98 
99     serialization::SubmoduleID readSubmoduleID(const RecordData &R,
100                                                unsigned &I) {
101       if (I >= R.size())
102         return 0;
103 
104       return Reader.getGlobalSubmoduleID(F, R[I++]);
105     }
106 
107     Module *readModule(const RecordData &R, unsigned &I) {
108       return Reader.getSubmodule(readSubmoduleID(R, I));
109     }
110 
111     void ReadCXXRecordDefinition(CXXRecordDecl *D, bool Update);
112     void ReadCXXDefinitionData(struct CXXRecordDecl::DefinitionData &Data,
113                                const RecordData &R, unsigned &I);
114     void MergeDefinitionData(CXXRecordDecl *D,
115                              struct CXXRecordDecl::DefinitionData &&NewDD);
116 
117     static NamedDecl *getAnonymousDeclForMerging(ASTReader &Reader,
118                                                  DeclContext *DC,
119                                                  unsigned Index);
120     static void setAnonymousDeclForMerging(ASTReader &Reader, DeclContext *DC,
121                                            unsigned Index, NamedDecl *D);
122 
123     /// \brief RAII class used to capture the first ID within a redeclaration
124     /// chain and to introduce it into the list of pending redeclaration chains
125     /// on destruction.
126     class RedeclarableResult {
127       ASTReader &Reader;
128       GlobalDeclID FirstID;
129       Decl *MergeWith;
130       mutable bool Owning;
131       Decl::Kind DeclKind;
132 
133       void operator=(RedeclarableResult &) = delete;
134 
135     public:
136       RedeclarableResult(ASTReader &Reader, GlobalDeclID FirstID,
137                          Decl *MergeWith, Decl::Kind DeclKind)
138         : Reader(Reader), FirstID(FirstID), MergeWith(MergeWith),
139           Owning(true), DeclKind(DeclKind) {}
140 
141       RedeclarableResult(RedeclarableResult &&Other)
142         : Reader(Other.Reader), FirstID(Other.FirstID),
143           MergeWith(Other.MergeWith), Owning(Other.Owning),
144           DeclKind(Other.DeclKind) {
145         Other.Owning = false;
146       }
147 
148       ~RedeclarableResult() {
149         if (FirstID && Owning && isRedeclarableDeclKind(DeclKind)) {
150           auto Canon = Reader.GetDecl(FirstID)->getCanonicalDecl();
151           if (Reader.PendingDeclChainsKnown.insert(Canon).second)
152             Reader.PendingDeclChains.push_back(Canon);
153         }
154       }
155 
156       /// \brief Retrieve the first ID.
157       GlobalDeclID getFirstID() const { return FirstID; }
158 
159       /// \brief Get a known declaration that this should be merged with, if
160       /// any.
161       Decl *getKnownMergeTarget() const { return MergeWith; }
162     };
163 
164     /// \brief Class used to capture the result of searching for an existing
165     /// declaration of a specific kind and name, along with the ability
166     /// to update the place where this result was found (the declaration
167     /// chain hanging off an identifier or the DeclContext we searched in)
168     /// if requested.
169     class FindExistingResult {
170       ASTReader &Reader;
171       NamedDecl *New;
172       NamedDecl *Existing;
173       mutable bool AddResult;
174 
175       unsigned AnonymousDeclNumber;
176       IdentifierInfo *TypedefNameForLinkage;
177 
178       void operator=(FindExistingResult&) = delete;
179 
180     public:
181       FindExistingResult(ASTReader &Reader)
182           : Reader(Reader), New(nullptr), Existing(nullptr), AddResult(false),
183             AnonymousDeclNumber(0), TypedefNameForLinkage(0) {}
184 
185       FindExistingResult(ASTReader &Reader, NamedDecl *New, NamedDecl *Existing,
186                          unsigned AnonymousDeclNumber,
187                          IdentifierInfo *TypedefNameForLinkage)
188           : Reader(Reader), New(New), Existing(Existing), AddResult(true),
189             AnonymousDeclNumber(AnonymousDeclNumber),
190             TypedefNameForLinkage(TypedefNameForLinkage) {}
191 
192       FindExistingResult(const FindExistingResult &Other)
193           : Reader(Other.Reader), New(Other.New), Existing(Other.Existing),
194             AddResult(Other.AddResult),
195             AnonymousDeclNumber(Other.AnonymousDeclNumber),
196             TypedefNameForLinkage(Other.TypedefNameForLinkage) {
197         Other.AddResult = false;
198       }
199 
200       ~FindExistingResult();
201 
202       /// \brief Suppress the addition of this result into the known set of
203       /// names.
204       void suppress() { AddResult = false; }
205 
206       operator NamedDecl*() const { return Existing; }
207 
208       template<typename T>
209       operator T*() const { return dyn_cast_or_null<T>(Existing); }
210     };
211 
212     static DeclContext *getPrimaryContextForMerging(ASTReader &Reader,
213                                                     DeclContext *DC);
214     FindExistingResult findExisting(NamedDecl *D);
215 
216   public:
217     ASTDeclReader(ASTReader &Reader, ModuleFile &F, DeclID thisDeclID,
218                   unsigned RawLocation, const RecordData &Record, unsigned &Idx)
219         : Reader(Reader), F(F), ThisDeclID(thisDeclID),
220           RawLocation(RawLocation), Record(Record), Idx(Idx),
221           TypeIDForTypeDecl(0), NamedDeclForTagDecl(0),
222           TypedefNameForLinkage(nullptr), HasPendingBody(false) {}
223 
224     template <typename DeclT>
225     static Decl *getMostRecentDeclImpl(Redeclarable<DeclT> *D);
226     static Decl *getMostRecentDeclImpl(...);
227     static Decl *getMostRecentDecl(Decl *D);
228 
229     template <typename DeclT>
230     static void attachPreviousDeclImpl(ASTReader &Reader,
231                                        Redeclarable<DeclT> *D, Decl *Previous,
232                                        Decl *Canon);
233     static void attachPreviousDeclImpl(ASTReader &Reader, ...);
234     static void attachPreviousDecl(ASTReader &Reader, Decl *D, Decl *Previous,
235                                    Decl *Canon);
236 
237     template <typename DeclT>
238     static void attachLatestDeclImpl(Redeclarable<DeclT> *D, Decl *Latest);
239     static void attachLatestDeclImpl(...);
240     static void attachLatestDecl(Decl *D, Decl *latest);
241 
242     template <typename DeclT>
243     static void markIncompleteDeclChainImpl(Redeclarable<DeclT> *D);
244     static void markIncompleteDeclChainImpl(...);
245 
246     /// \brief Determine whether this declaration has a pending body.
247     bool hasPendingBody() const { return HasPendingBody; }
248 
249     void Visit(Decl *D);
250 
251     void UpdateDecl(Decl *D, ModuleFile &ModuleFile,
252                     const RecordData &Record);
253 
254     static void setNextObjCCategory(ObjCCategoryDecl *Cat,
255                                     ObjCCategoryDecl *Next) {
256       Cat->NextClassCategory = Next;
257     }
258 
259     void VisitDecl(Decl *D);
260     void VisitTranslationUnitDecl(TranslationUnitDecl *TU);
261     void VisitNamedDecl(NamedDecl *ND);
262     void VisitLabelDecl(LabelDecl *LD);
263     void VisitNamespaceDecl(NamespaceDecl *D);
264     void VisitUsingDirectiveDecl(UsingDirectiveDecl *D);
265     void VisitNamespaceAliasDecl(NamespaceAliasDecl *D);
266     void VisitTypeDecl(TypeDecl *TD);
267     RedeclarableResult VisitTypedefNameDecl(TypedefNameDecl *TD);
268     void VisitTypedefDecl(TypedefDecl *TD);
269     void VisitTypeAliasDecl(TypeAliasDecl *TD);
270     void VisitUnresolvedUsingTypenameDecl(UnresolvedUsingTypenameDecl *D);
271     RedeclarableResult VisitTagDecl(TagDecl *TD);
272     void VisitEnumDecl(EnumDecl *ED);
273     RedeclarableResult VisitRecordDeclImpl(RecordDecl *RD);
274     void VisitRecordDecl(RecordDecl *RD) { VisitRecordDeclImpl(RD); }
275     RedeclarableResult VisitCXXRecordDeclImpl(CXXRecordDecl *D);
276     void VisitCXXRecordDecl(CXXRecordDecl *D) { VisitCXXRecordDeclImpl(D); }
277     RedeclarableResult VisitClassTemplateSpecializationDeclImpl(
278                                             ClassTemplateSpecializationDecl *D);
279     void VisitClassTemplateSpecializationDecl(
280         ClassTemplateSpecializationDecl *D) {
281       VisitClassTemplateSpecializationDeclImpl(D);
282     }
283     void VisitClassTemplatePartialSpecializationDecl(
284                                      ClassTemplatePartialSpecializationDecl *D);
285     void VisitClassScopeFunctionSpecializationDecl(
286                                        ClassScopeFunctionSpecializationDecl *D);
287     RedeclarableResult
288     VisitVarTemplateSpecializationDeclImpl(VarTemplateSpecializationDecl *D);
289     void VisitVarTemplateSpecializationDecl(VarTemplateSpecializationDecl *D) {
290       VisitVarTemplateSpecializationDeclImpl(D);
291     }
292     void VisitVarTemplatePartialSpecializationDecl(
293         VarTemplatePartialSpecializationDecl *D);
294     void VisitTemplateTypeParmDecl(TemplateTypeParmDecl *D);
295     void VisitValueDecl(ValueDecl *VD);
296     void VisitEnumConstantDecl(EnumConstantDecl *ECD);
297     void VisitUnresolvedUsingValueDecl(UnresolvedUsingValueDecl *D);
298     void VisitDeclaratorDecl(DeclaratorDecl *DD);
299     void VisitFunctionDecl(FunctionDecl *FD);
300     void VisitCXXMethodDecl(CXXMethodDecl *D);
301     void VisitCXXConstructorDecl(CXXConstructorDecl *D);
302     void VisitCXXDestructorDecl(CXXDestructorDecl *D);
303     void VisitCXXConversionDecl(CXXConversionDecl *D);
304     void VisitFieldDecl(FieldDecl *FD);
305     void VisitMSPropertyDecl(MSPropertyDecl *FD);
306     void VisitIndirectFieldDecl(IndirectFieldDecl *FD);
307     RedeclarableResult VisitVarDeclImpl(VarDecl *D);
308     void VisitVarDecl(VarDecl *VD) { VisitVarDeclImpl(VD); }
309     void VisitImplicitParamDecl(ImplicitParamDecl *PD);
310     void VisitParmVarDecl(ParmVarDecl *PD);
311     void VisitNonTypeTemplateParmDecl(NonTypeTemplateParmDecl *D);
312     DeclID VisitTemplateDecl(TemplateDecl *D);
313     RedeclarableResult VisitRedeclarableTemplateDecl(RedeclarableTemplateDecl *D);
314     void VisitClassTemplateDecl(ClassTemplateDecl *D);
315     void VisitVarTemplateDecl(VarTemplateDecl *D);
316     void VisitFunctionTemplateDecl(FunctionTemplateDecl *D);
317     void VisitTemplateTemplateParmDecl(TemplateTemplateParmDecl *D);
318     void VisitTypeAliasTemplateDecl(TypeAliasTemplateDecl *D);
319     void VisitUsingDecl(UsingDecl *D);
320     void VisitUsingShadowDecl(UsingShadowDecl *D);
321     void VisitLinkageSpecDecl(LinkageSpecDecl *D);
322     void VisitFileScopeAsmDecl(FileScopeAsmDecl *AD);
323     void VisitImportDecl(ImportDecl *D);
324     void VisitAccessSpecDecl(AccessSpecDecl *D);
325     void VisitFriendDecl(FriendDecl *D);
326     void VisitFriendTemplateDecl(FriendTemplateDecl *D);
327     void VisitStaticAssertDecl(StaticAssertDecl *D);
328     void VisitBlockDecl(BlockDecl *BD);
329     void VisitCapturedDecl(CapturedDecl *CD);
330     void VisitEmptyDecl(EmptyDecl *D);
331 
332     std::pair<uint64_t, uint64_t> VisitDeclContext(DeclContext *DC);
333 
334     template<typename T>
335     RedeclarableResult VisitRedeclarable(Redeclarable<T> *D);
336 
337     template<typename T>
338     void mergeRedeclarable(Redeclarable<T> *D, RedeclarableResult &Redecl,
339                            DeclID TemplatePatternID = 0);
340 
341     template<typename T>
342     void mergeRedeclarable(Redeclarable<T> *D, T *Existing,
343                            RedeclarableResult &Redecl,
344                            DeclID TemplatePatternID = 0);
345 
346     template<typename T>
347     void mergeMergeable(Mergeable<T> *D);
348 
349     void mergeTemplatePattern(RedeclarableTemplateDecl *D,
350                               RedeclarableTemplateDecl *Existing,
351                               DeclID DsID);
352 
353     // FIXME: Reorder according to DeclNodes.td?
354     void VisitObjCMethodDecl(ObjCMethodDecl *D);
355     void VisitObjCContainerDecl(ObjCContainerDecl *D);
356     void VisitObjCInterfaceDecl(ObjCInterfaceDecl *D);
357     void VisitObjCIvarDecl(ObjCIvarDecl *D);
358     void VisitObjCProtocolDecl(ObjCProtocolDecl *D);
359     void VisitObjCAtDefsFieldDecl(ObjCAtDefsFieldDecl *D);
360     void VisitObjCCategoryDecl(ObjCCategoryDecl *D);
361     void VisitObjCImplDecl(ObjCImplDecl *D);
362     void VisitObjCCategoryImplDecl(ObjCCategoryImplDecl *D);
363     void VisitObjCImplementationDecl(ObjCImplementationDecl *D);
364     void VisitObjCCompatibleAliasDecl(ObjCCompatibleAliasDecl *D);
365     void VisitObjCPropertyDecl(ObjCPropertyDecl *D);
366     void VisitObjCPropertyImplDecl(ObjCPropertyImplDecl *D);
367     void VisitOMPThreadPrivateDecl(OMPThreadPrivateDecl *D);
368   };
369 }
370 
371 uint64_t ASTDeclReader::GetCurrentCursorOffset() {
372   return F.DeclsCursor.GetCurrentBitNo() + F.GlobalBitOffset;
373 }
374 
375 void ASTDeclReader::Visit(Decl *D) {
376   DeclVisitor<ASTDeclReader, void>::Visit(D);
377 
378   if (DeclaratorDecl *DD = dyn_cast<DeclaratorDecl>(D)) {
379     if (DD->DeclInfo) {
380       DeclaratorDecl::ExtInfo *Info =
381           DD->DeclInfo.get<DeclaratorDecl::ExtInfo *>();
382       Info->TInfo =
383           GetTypeSourceInfo(Record, Idx);
384     }
385     else {
386       DD->DeclInfo = GetTypeSourceInfo(Record, Idx);
387     }
388   }
389 
390   if (TypeDecl *TD = dyn_cast<TypeDecl>(D)) {
391     // We have a fully initialized TypeDecl. Read its type now.
392     TD->setTypeForDecl(Reader.GetType(TypeIDForTypeDecl).getTypePtrOrNull());
393 
394     // If this is a tag declaration with a typedef name for linkage, it's safe
395     // to load that typedef now.
396     if (NamedDeclForTagDecl)
397       cast<TagDecl>(D)->NamedDeclOrQualifier =
398           cast<NamedDecl>(Reader.GetDecl(NamedDeclForTagDecl));
399   } else if (ObjCInterfaceDecl *ID = dyn_cast<ObjCInterfaceDecl>(D)) {
400     // if we have a fully initialized TypeDecl, we can safely read its type now.
401     ID->TypeForDecl = Reader.GetType(TypeIDForTypeDecl).getTypePtrOrNull();
402   } else if (FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
403     // FunctionDecl's body was written last after all other Stmts/Exprs.
404     // We only read it if FD doesn't already have a body (e.g., from another
405     // module).
406     // FIXME: Can we diagnose ODR violations somehow?
407     if (Record[Idx++]) {
408       if (auto *CD = dyn_cast<CXXConstructorDecl>(FD)) {
409         CD->NumCtorInitializers = Record[Idx++];
410         if (CD->NumCtorInitializers)
411           CD->CtorInitializers =
412               Reader.ReadCXXCtorInitializersRef(F, Record, Idx);
413       }
414       Reader.PendingBodies[FD] = GetCurrentCursorOffset();
415       HasPendingBody = true;
416     }
417   }
418 }
419 
420 void ASTDeclReader::VisitDecl(Decl *D) {
421   if (D->isTemplateParameter() || D->isTemplateParameterPack() ||
422       isa<ParmVarDecl>(D)) {
423     // We don't want to deserialize the DeclContext of a template
424     // parameter or of a parameter of a function template immediately.   These
425     // entities might be used in the formulation of its DeclContext (for
426     // example, a function parameter can be used in decltype() in trailing
427     // return type of the function).  Use the translation unit DeclContext as a
428     // placeholder.
429     GlobalDeclID SemaDCIDForTemplateParmDecl = ReadDeclID(Record, Idx);
430     GlobalDeclID LexicalDCIDForTemplateParmDecl = ReadDeclID(Record, Idx);
431     Reader.addPendingDeclContextInfo(D,
432                                      SemaDCIDForTemplateParmDecl,
433                                      LexicalDCIDForTemplateParmDecl);
434     D->setDeclContext(Reader.getContext().getTranslationUnitDecl());
435   } else {
436     DeclContext *SemaDC = ReadDeclAs<DeclContext>(Record, Idx);
437     DeclContext *LexicalDC = ReadDeclAs<DeclContext>(Record, Idx);
438     DeclContext *MergedSemaDC = Reader.MergedDeclContexts.lookup(SemaDC);
439     // Avoid calling setLexicalDeclContext() directly because it uses
440     // Decl::getASTContext() internally which is unsafe during derialization.
441     D->setDeclContextsImpl(MergedSemaDC ? MergedSemaDC : SemaDC, LexicalDC,
442                            Reader.getContext());
443   }
444   D->setLocation(Reader.ReadSourceLocation(F, RawLocation));
445   D->setInvalidDecl(Record[Idx++]);
446   if (Record[Idx++]) { // hasAttrs
447     AttrVec Attrs;
448     Reader.ReadAttributes(F, Attrs, Record, Idx);
449     // Avoid calling setAttrs() directly because it uses Decl::getASTContext()
450     // internally which is unsafe during derialization.
451     D->setAttrsImpl(Attrs, Reader.getContext());
452   }
453   D->setImplicit(Record[Idx++]);
454   D->Used = Record[Idx++];
455   D->setReferenced(Record[Idx++]);
456   D->setTopLevelDeclInObjCContainer(Record[Idx++]);
457   D->setAccess((AccessSpecifier)Record[Idx++]);
458   D->FromASTFile = true;
459   D->setModulePrivate(Record[Idx++]);
460   D->Hidden = D->isModulePrivate();
461 
462   // Determine whether this declaration is part of a (sub)module. If so, it
463   // may not yet be visible.
464   if (unsigned SubmoduleID = readSubmoduleID(Record, Idx)) {
465     // Store the owning submodule ID in the declaration.
466     D->setOwningModuleID(SubmoduleID);
467 
468     // Module-private declarations are never visible, so there is no work to do.
469     if (!D->isModulePrivate()) {
470       if (Module *Owner = Reader.getSubmodule(SubmoduleID)) {
471         if (Owner->NameVisibility != Module::AllVisible) {
472           // The owning module is not visible. Mark this declaration as hidden.
473           D->Hidden = true;
474 
475           // Note that this declaration was hidden because its owning module is
476           // not yet visible.
477           Reader.HiddenNamesMap[Owner].HiddenDecls.push_back(D);
478         }
479       }
480     }
481   }
482 }
483 
484 void ASTDeclReader::VisitTranslationUnitDecl(TranslationUnitDecl *TU) {
485   llvm_unreachable("Translation units are not serialized");
486 }
487 
488 void ASTDeclReader::VisitNamedDecl(NamedDecl *ND) {
489   VisitDecl(ND);
490   ND->setDeclName(Reader.ReadDeclarationName(F, Record, Idx));
491   AnonymousDeclNumber = Record[Idx++];
492 }
493 
494 void ASTDeclReader::VisitTypeDecl(TypeDecl *TD) {
495   VisitNamedDecl(TD);
496   TD->setLocStart(ReadSourceLocation(Record, Idx));
497   // Delay type reading until after we have fully initialized the decl.
498   TypeIDForTypeDecl = Reader.getGlobalTypeID(F, Record[Idx++]);
499 }
500 
501 ASTDeclReader::RedeclarableResult
502 ASTDeclReader::VisitTypedefNameDecl(TypedefNameDecl *TD) {
503   RedeclarableResult Redecl = VisitRedeclarable(TD);
504   VisitTypeDecl(TD);
505   TypeSourceInfo *TInfo = GetTypeSourceInfo(Record, Idx);
506   if (Record[Idx++]) { // isModed
507     QualType modedT = Reader.readType(F, Record, Idx);
508     TD->setModedTypeSourceInfo(TInfo, modedT);
509   } else
510     TD->setTypeSourceInfo(TInfo);
511   return Redecl;
512 }
513 
514 void ASTDeclReader::VisitTypedefDecl(TypedefDecl *TD) {
515   RedeclarableResult Redecl = VisitTypedefNameDecl(TD);
516   mergeRedeclarable(TD, Redecl);
517 }
518 
519 void ASTDeclReader::VisitTypeAliasDecl(TypeAliasDecl *TD) {
520   RedeclarableResult Redecl = VisitTypedefNameDecl(TD);
521   if (auto *Template = ReadDeclAs<TypeAliasTemplateDecl>(Record, Idx))
522     // Merged when we merge the template.
523     TD->setDescribedAliasTemplate(Template);
524   else
525     mergeRedeclarable(TD, Redecl);
526 }
527 
528 ASTDeclReader::RedeclarableResult ASTDeclReader::VisitTagDecl(TagDecl *TD) {
529   RedeclarableResult Redecl = VisitRedeclarable(TD);
530   VisitTypeDecl(TD);
531 
532   TD->IdentifierNamespace = Record[Idx++];
533   TD->setTagKind((TagDecl::TagKind)Record[Idx++]);
534   if (!isa<CXXRecordDecl>(TD))
535     TD->setCompleteDefinition(Record[Idx++]);
536   TD->setEmbeddedInDeclarator(Record[Idx++]);
537   TD->setFreeStanding(Record[Idx++]);
538   TD->setCompleteDefinitionRequired(Record[Idx++]);
539   TD->setRBraceLoc(ReadSourceLocation(Record, Idx));
540 
541   switch (Record[Idx++]) {
542   case 0:
543     break;
544   case 1: { // ExtInfo
545     TagDecl::ExtInfo *Info = new (Reader.getContext()) TagDecl::ExtInfo();
546     ReadQualifierInfo(*Info, Record, Idx);
547     TD->NamedDeclOrQualifier = Info;
548     break;
549   }
550   case 2: // TypedefNameForAnonDecl
551     NamedDeclForTagDecl = ReadDeclID(Record, Idx);
552     TypedefNameForLinkage = Reader.GetIdentifierInfo(F, Record, Idx);
553     break;
554   case 3: // DeclaratorForAnonDecl
555     NamedDeclForTagDecl = ReadDeclID(Record, Idx);
556     break;
557   default:
558     llvm_unreachable("unexpected tag info kind");
559   }
560 
561   if (!isa<CXXRecordDecl>(TD))
562     mergeRedeclarable(TD, Redecl);
563   return Redecl;
564 }
565 
566 void ASTDeclReader::VisitEnumDecl(EnumDecl *ED) {
567   VisitTagDecl(ED);
568   if (TypeSourceInfo *TI = Reader.GetTypeSourceInfo(F, Record, Idx))
569     ED->setIntegerTypeSourceInfo(TI);
570   else
571     ED->setIntegerType(Reader.readType(F, Record, Idx));
572   ED->setPromotionType(Reader.readType(F, Record, Idx));
573   ED->setNumPositiveBits(Record[Idx++]);
574   ED->setNumNegativeBits(Record[Idx++]);
575   ED->IsScoped = Record[Idx++];
576   ED->IsScopedUsingClassTag = Record[Idx++];
577   ED->IsFixed = Record[Idx++];
578 
579   // If this is a definition subject to the ODR, and we already have a
580   // definition, merge this one into it.
581   if (ED->IsCompleteDefinition &&
582       Reader.getContext().getLangOpts().Modules &&
583       Reader.getContext().getLangOpts().CPlusPlus) {
584     if (EnumDecl *&OldDef = Reader.EnumDefinitions[ED->getCanonicalDecl()]) {
585       Reader.MergedDeclContexts.insert(std::make_pair(ED, OldDef));
586       ED->IsCompleteDefinition = false;
587     } else {
588       OldDef = ED;
589     }
590   }
591 
592   if (EnumDecl *InstED = ReadDeclAs<EnumDecl>(Record, Idx)) {
593     TemplateSpecializationKind TSK = (TemplateSpecializationKind)Record[Idx++];
594     SourceLocation POI = ReadSourceLocation(Record, Idx);
595     ED->setInstantiationOfMemberEnum(Reader.getContext(), InstED, TSK);
596     ED->getMemberSpecializationInfo()->setPointOfInstantiation(POI);
597   }
598 }
599 
600 ASTDeclReader::RedeclarableResult
601 ASTDeclReader::VisitRecordDeclImpl(RecordDecl *RD) {
602   RedeclarableResult Redecl = VisitTagDecl(RD);
603   RD->setHasFlexibleArrayMember(Record[Idx++]);
604   RD->setAnonymousStructOrUnion(Record[Idx++]);
605   RD->setHasObjectMember(Record[Idx++]);
606   RD->setHasVolatileMember(Record[Idx++]);
607   return Redecl;
608 }
609 
610 void ASTDeclReader::VisitValueDecl(ValueDecl *VD) {
611   VisitNamedDecl(VD);
612   VD->setType(Reader.readType(F, Record, Idx));
613 }
614 
615 void ASTDeclReader::VisitEnumConstantDecl(EnumConstantDecl *ECD) {
616   VisitValueDecl(ECD);
617   if (Record[Idx++])
618     ECD->setInitExpr(Reader.ReadExpr(F));
619   ECD->setInitVal(Reader.ReadAPSInt(Record, Idx));
620   mergeMergeable(ECD);
621 }
622 
623 void ASTDeclReader::VisitDeclaratorDecl(DeclaratorDecl *DD) {
624   VisitValueDecl(DD);
625   DD->setInnerLocStart(ReadSourceLocation(Record, Idx));
626   if (Record[Idx++]) { // hasExtInfo
627     DeclaratorDecl::ExtInfo *Info
628         = new (Reader.getContext()) DeclaratorDecl::ExtInfo();
629     ReadQualifierInfo(*Info, Record, Idx);
630     DD->DeclInfo = Info;
631   }
632 }
633 
634 void ASTDeclReader::VisitFunctionDecl(FunctionDecl *FD) {
635   RedeclarableResult Redecl = VisitRedeclarable(FD);
636   VisitDeclaratorDecl(FD);
637 
638   ReadDeclarationNameLoc(FD->DNLoc, FD->getDeclName(), Record, Idx);
639   FD->IdentifierNamespace = Record[Idx++];
640 
641   // FunctionDecl's body is handled last at ASTDeclReader::Visit,
642   // after everything else is read.
643 
644   FD->SClass = (StorageClass)Record[Idx++];
645   FD->IsInline = Record[Idx++];
646   FD->IsInlineSpecified = Record[Idx++];
647   FD->IsVirtualAsWritten = Record[Idx++];
648   FD->IsPure = Record[Idx++];
649   FD->HasInheritedPrototype = Record[Idx++];
650   FD->HasWrittenPrototype = Record[Idx++];
651   FD->IsDeleted = Record[Idx++];
652   FD->IsTrivial = Record[Idx++];
653   FD->IsDefaulted = Record[Idx++];
654   FD->IsExplicitlyDefaulted = Record[Idx++];
655   FD->HasImplicitReturnZero = Record[Idx++];
656   FD->IsConstexpr = Record[Idx++];
657   FD->HasSkippedBody = Record[Idx++];
658   FD->IsLateTemplateParsed = Record[Idx++];
659   FD->setCachedLinkage(Linkage(Record[Idx++]));
660   FD->EndRangeLoc = ReadSourceLocation(Record, Idx);
661 
662   switch ((FunctionDecl::TemplatedKind)Record[Idx++]) {
663   case FunctionDecl::TK_NonTemplate:
664     mergeRedeclarable(FD, Redecl);
665     break;
666   case FunctionDecl::TK_FunctionTemplate:
667     // Merged when we merge the template.
668     FD->setDescribedFunctionTemplate(ReadDeclAs<FunctionTemplateDecl>(Record,
669                                                                       Idx));
670     break;
671   case FunctionDecl::TK_MemberSpecialization: {
672     FunctionDecl *InstFD = ReadDeclAs<FunctionDecl>(Record, Idx);
673     TemplateSpecializationKind TSK = (TemplateSpecializationKind)Record[Idx++];
674     SourceLocation POI = ReadSourceLocation(Record, Idx);
675     FD->setInstantiationOfMemberFunction(Reader.getContext(), InstFD, TSK);
676     FD->getMemberSpecializationInfo()->setPointOfInstantiation(POI);
677     mergeRedeclarable(FD, Redecl);
678     break;
679   }
680   case FunctionDecl::TK_FunctionTemplateSpecialization: {
681     FunctionTemplateDecl *Template = ReadDeclAs<FunctionTemplateDecl>(Record,
682                                                                       Idx);
683     TemplateSpecializationKind TSK = (TemplateSpecializationKind)Record[Idx++];
684 
685     // Template arguments.
686     SmallVector<TemplateArgument, 8> TemplArgs;
687     Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
688 
689     // Template args as written.
690     SmallVector<TemplateArgumentLoc, 8> TemplArgLocs;
691     SourceLocation LAngleLoc, RAngleLoc;
692     bool HasTemplateArgumentsAsWritten = Record[Idx++];
693     if (HasTemplateArgumentsAsWritten) {
694       unsigned NumTemplateArgLocs = Record[Idx++];
695       TemplArgLocs.reserve(NumTemplateArgLocs);
696       for (unsigned i=0; i != NumTemplateArgLocs; ++i)
697         TemplArgLocs.push_back(
698             Reader.ReadTemplateArgumentLoc(F, Record, Idx));
699 
700       LAngleLoc = ReadSourceLocation(Record, Idx);
701       RAngleLoc = ReadSourceLocation(Record, Idx);
702     }
703 
704     SourceLocation POI = ReadSourceLocation(Record, Idx);
705 
706     ASTContext &C = Reader.getContext();
707     TemplateArgumentList *TemplArgList
708       = TemplateArgumentList::CreateCopy(C, TemplArgs.data(), TemplArgs.size());
709     TemplateArgumentListInfo TemplArgsInfo(LAngleLoc, RAngleLoc);
710     for (unsigned i=0, e = TemplArgLocs.size(); i != e; ++i)
711       TemplArgsInfo.addArgument(TemplArgLocs[i]);
712     FunctionTemplateSpecializationInfo *FTInfo
713         = FunctionTemplateSpecializationInfo::Create(C, FD, Template, TSK,
714                                                      TemplArgList,
715                              HasTemplateArgumentsAsWritten ? &TemplArgsInfo
716                                                            : nullptr,
717                                                      POI);
718     FD->TemplateOrSpecialization = FTInfo;
719 
720     if (FD->isCanonicalDecl()) { // if canonical add to template's set.
721       // The template that contains the specializations set. It's not safe to
722       // use getCanonicalDecl on Template since it may still be initializing.
723       FunctionTemplateDecl *CanonTemplate
724         = ReadDeclAs<FunctionTemplateDecl>(Record, Idx);
725       // Get the InsertPos by FindNodeOrInsertPos() instead of calling
726       // InsertNode(FTInfo) directly to avoid the getASTContext() call in
727       // FunctionTemplateSpecializationInfo's Profile().
728       // We avoid getASTContext because a decl in the parent hierarchy may
729       // be initializing.
730       llvm::FoldingSetNodeID ID;
731       FunctionTemplateSpecializationInfo::Profile(ID, TemplArgs, C);
732       void *InsertPos = nullptr;
733       FunctionTemplateDecl::Common *CommonPtr = CanonTemplate->getCommonPtr();
734       CommonPtr->Specializations.FindNodeOrInsertPos(ID, InsertPos);
735       if (InsertPos)
736         CommonPtr->Specializations.InsertNode(FTInfo, InsertPos);
737       else {
738         assert(Reader.getContext().getLangOpts().Modules &&
739                "already deserialized this template specialization");
740         // FIXME: This specialization is a redeclaration of one from another
741         // module. Merge it.
742       }
743     }
744     break;
745   }
746   case FunctionDecl::TK_DependentFunctionTemplateSpecialization: {
747     // Templates.
748     UnresolvedSet<8> TemplDecls;
749     unsigned NumTemplates = Record[Idx++];
750     while (NumTemplates--)
751       TemplDecls.addDecl(ReadDeclAs<NamedDecl>(Record, Idx));
752 
753     // Templates args.
754     TemplateArgumentListInfo TemplArgs;
755     unsigned NumArgs = Record[Idx++];
756     while (NumArgs--)
757       TemplArgs.addArgument(Reader.ReadTemplateArgumentLoc(F, Record, Idx));
758     TemplArgs.setLAngleLoc(ReadSourceLocation(Record, Idx));
759     TemplArgs.setRAngleLoc(ReadSourceLocation(Record, Idx));
760 
761     FD->setDependentTemplateSpecialization(Reader.getContext(),
762                                            TemplDecls, TemplArgs);
763 
764     // FIXME: Merging.
765     break;
766   }
767   }
768 
769   // Read in the parameters.
770   unsigned NumParams = Record[Idx++];
771   SmallVector<ParmVarDecl *, 16> Params;
772   Params.reserve(NumParams);
773   for (unsigned I = 0; I != NumParams; ++I)
774     Params.push_back(ReadDeclAs<ParmVarDecl>(Record, Idx));
775   FD->setParams(Reader.getContext(), Params);
776 }
777 
778 void ASTDeclReader::VisitObjCMethodDecl(ObjCMethodDecl *MD) {
779   VisitNamedDecl(MD);
780   if (Record[Idx++]) {
781     // Load the body on-demand. Most clients won't care, because method
782     // definitions rarely show up in headers.
783     Reader.PendingBodies[MD] = GetCurrentCursorOffset();
784     HasPendingBody = true;
785     MD->setSelfDecl(ReadDeclAs<ImplicitParamDecl>(Record, Idx));
786     MD->setCmdDecl(ReadDeclAs<ImplicitParamDecl>(Record, Idx));
787   }
788   MD->setInstanceMethod(Record[Idx++]);
789   MD->setVariadic(Record[Idx++]);
790   MD->setPropertyAccessor(Record[Idx++]);
791   MD->setDefined(Record[Idx++]);
792   MD->IsOverriding = Record[Idx++];
793   MD->HasSkippedBody = Record[Idx++];
794 
795   MD->IsRedeclaration = Record[Idx++];
796   MD->HasRedeclaration = Record[Idx++];
797   if (MD->HasRedeclaration)
798     Reader.getContext().setObjCMethodRedeclaration(MD,
799                                        ReadDeclAs<ObjCMethodDecl>(Record, Idx));
800 
801   MD->setDeclImplementation((ObjCMethodDecl::ImplementationControl)Record[Idx++]);
802   MD->setObjCDeclQualifier((Decl::ObjCDeclQualifier)Record[Idx++]);
803   MD->SetRelatedResultType(Record[Idx++]);
804   MD->setReturnType(Reader.readType(F, Record, Idx));
805   MD->setReturnTypeSourceInfo(GetTypeSourceInfo(Record, Idx));
806   MD->DeclEndLoc = ReadSourceLocation(Record, Idx);
807   unsigned NumParams = Record[Idx++];
808   SmallVector<ParmVarDecl *, 16> Params;
809   Params.reserve(NumParams);
810   for (unsigned I = 0; I != NumParams; ++I)
811     Params.push_back(ReadDeclAs<ParmVarDecl>(Record, Idx));
812 
813   MD->SelLocsKind = Record[Idx++];
814   unsigned NumStoredSelLocs = Record[Idx++];
815   SmallVector<SourceLocation, 16> SelLocs;
816   SelLocs.reserve(NumStoredSelLocs);
817   for (unsigned i = 0; i != NumStoredSelLocs; ++i)
818     SelLocs.push_back(ReadSourceLocation(Record, Idx));
819 
820   MD->setParamsAndSelLocs(Reader.getContext(), Params, SelLocs);
821 }
822 
823 void ASTDeclReader::VisitObjCContainerDecl(ObjCContainerDecl *CD) {
824   VisitNamedDecl(CD);
825   CD->setAtStartLoc(ReadSourceLocation(Record, Idx));
826   CD->setAtEndRange(ReadSourceRange(Record, Idx));
827 }
828 
829 void ASTDeclReader::VisitObjCInterfaceDecl(ObjCInterfaceDecl *ID) {
830   RedeclarableResult Redecl = VisitRedeclarable(ID);
831   VisitObjCContainerDecl(ID);
832   TypeIDForTypeDecl = Reader.getGlobalTypeID(F, Record[Idx++]);
833   mergeRedeclarable(ID, Redecl);
834 
835   if (Record[Idx++]) {
836     // Read the definition.
837     ID->allocateDefinitionData();
838 
839     // Set the definition data of the canonical declaration, so other
840     // redeclarations will see it.
841     ID->getCanonicalDecl()->Data = ID->Data;
842 
843     ObjCInterfaceDecl::DefinitionData &Data = ID->data();
844 
845     // Read the superclass.
846     Data.SuperClass = ReadDeclAs<ObjCInterfaceDecl>(Record, Idx);
847     Data.SuperClassLoc = ReadSourceLocation(Record, Idx);
848 
849     Data.EndLoc = ReadSourceLocation(Record, Idx);
850     Data.HasDesignatedInitializers = Record[Idx++];
851 
852     // Read the directly referenced protocols and their SourceLocations.
853     unsigned NumProtocols = Record[Idx++];
854     SmallVector<ObjCProtocolDecl *, 16> Protocols;
855     Protocols.reserve(NumProtocols);
856     for (unsigned I = 0; I != NumProtocols; ++I)
857       Protocols.push_back(ReadDeclAs<ObjCProtocolDecl>(Record, Idx));
858     SmallVector<SourceLocation, 16> ProtoLocs;
859     ProtoLocs.reserve(NumProtocols);
860     for (unsigned I = 0; I != NumProtocols; ++I)
861       ProtoLocs.push_back(ReadSourceLocation(Record, Idx));
862     ID->setProtocolList(Protocols.data(), NumProtocols, ProtoLocs.data(),
863                         Reader.getContext());
864 
865     // Read the transitive closure of protocols referenced by this class.
866     NumProtocols = Record[Idx++];
867     Protocols.clear();
868     Protocols.reserve(NumProtocols);
869     for (unsigned I = 0; I != NumProtocols; ++I)
870       Protocols.push_back(ReadDeclAs<ObjCProtocolDecl>(Record, Idx));
871     ID->data().AllReferencedProtocols.set(Protocols.data(), NumProtocols,
872                                           Reader.getContext());
873 
874     // We will rebuild this list lazily.
875     ID->setIvarList(nullptr);
876 
877     // Note that we have deserialized a definition.
878     Reader.PendingDefinitions.insert(ID);
879 
880     // Note that we've loaded this Objective-C class.
881     Reader.ObjCClassesLoaded.push_back(ID);
882   } else {
883     ID->Data = ID->getCanonicalDecl()->Data;
884   }
885 }
886 
887 void ASTDeclReader::VisitObjCIvarDecl(ObjCIvarDecl *IVD) {
888   VisitFieldDecl(IVD);
889   IVD->setAccessControl((ObjCIvarDecl::AccessControl)Record[Idx++]);
890   // This field will be built lazily.
891   IVD->setNextIvar(nullptr);
892   bool synth = Record[Idx++];
893   IVD->setSynthesize(synth);
894 }
895 
896 void ASTDeclReader::VisitObjCProtocolDecl(ObjCProtocolDecl *PD) {
897   RedeclarableResult Redecl = VisitRedeclarable(PD);
898   VisitObjCContainerDecl(PD);
899   mergeRedeclarable(PD, Redecl);
900 
901   if (Record[Idx++]) {
902     // Read the definition.
903     PD->allocateDefinitionData();
904 
905     // Set the definition data of the canonical declaration, so other
906     // redeclarations will see it.
907     PD->getCanonicalDecl()->Data = PD->Data;
908 
909     unsigned NumProtoRefs = Record[Idx++];
910     SmallVector<ObjCProtocolDecl *, 16> ProtoRefs;
911     ProtoRefs.reserve(NumProtoRefs);
912     for (unsigned I = 0; I != NumProtoRefs; ++I)
913       ProtoRefs.push_back(ReadDeclAs<ObjCProtocolDecl>(Record, Idx));
914     SmallVector<SourceLocation, 16> ProtoLocs;
915     ProtoLocs.reserve(NumProtoRefs);
916     for (unsigned I = 0; I != NumProtoRefs; ++I)
917       ProtoLocs.push_back(ReadSourceLocation(Record, Idx));
918     PD->setProtocolList(ProtoRefs.data(), NumProtoRefs, ProtoLocs.data(),
919                         Reader.getContext());
920 
921     // Note that we have deserialized a definition.
922     Reader.PendingDefinitions.insert(PD);
923   } else {
924     PD->Data = PD->getCanonicalDecl()->Data;
925   }
926 }
927 
928 void ASTDeclReader::VisitObjCAtDefsFieldDecl(ObjCAtDefsFieldDecl *FD) {
929   VisitFieldDecl(FD);
930 }
931 
932 void ASTDeclReader::VisitObjCCategoryDecl(ObjCCategoryDecl *CD) {
933   VisitObjCContainerDecl(CD);
934   CD->setCategoryNameLoc(ReadSourceLocation(Record, Idx));
935   CD->setIvarLBraceLoc(ReadSourceLocation(Record, Idx));
936   CD->setIvarRBraceLoc(ReadSourceLocation(Record, Idx));
937 
938   // Note that this category has been deserialized. We do this before
939   // deserializing the interface declaration, so that it will consider this
940   /// category.
941   Reader.CategoriesDeserialized.insert(CD);
942 
943   CD->ClassInterface = ReadDeclAs<ObjCInterfaceDecl>(Record, Idx);
944   unsigned NumProtoRefs = Record[Idx++];
945   SmallVector<ObjCProtocolDecl *, 16> ProtoRefs;
946   ProtoRefs.reserve(NumProtoRefs);
947   for (unsigned I = 0; I != NumProtoRefs; ++I)
948     ProtoRefs.push_back(ReadDeclAs<ObjCProtocolDecl>(Record, Idx));
949   SmallVector<SourceLocation, 16> ProtoLocs;
950   ProtoLocs.reserve(NumProtoRefs);
951   for (unsigned I = 0; I != NumProtoRefs; ++I)
952     ProtoLocs.push_back(ReadSourceLocation(Record, Idx));
953   CD->setProtocolList(ProtoRefs.data(), NumProtoRefs, ProtoLocs.data(),
954                       Reader.getContext());
955 }
956 
957 void ASTDeclReader::VisitObjCCompatibleAliasDecl(ObjCCompatibleAliasDecl *CAD) {
958   VisitNamedDecl(CAD);
959   CAD->setClassInterface(ReadDeclAs<ObjCInterfaceDecl>(Record, Idx));
960 }
961 
962 void ASTDeclReader::VisitObjCPropertyDecl(ObjCPropertyDecl *D) {
963   VisitNamedDecl(D);
964   D->setAtLoc(ReadSourceLocation(Record, Idx));
965   D->setLParenLoc(ReadSourceLocation(Record, Idx));
966   D->setType(GetTypeSourceInfo(Record, Idx));
967   // FIXME: stable encoding
968   D->setPropertyAttributes(
969                       (ObjCPropertyDecl::PropertyAttributeKind)Record[Idx++]);
970   D->setPropertyAttributesAsWritten(
971                       (ObjCPropertyDecl::PropertyAttributeKind)Record[Idx++]);
972   // FIXME: stable encoding
973   D->setPropertyImplementation(
974                             (ObjCPropertyDecl::PropertyControl)Record[Idx++]);
975   D->setGetterName(Reader.ReadDeclarationName(F,Record, Idx).getObjCSelector());
976   D->setSetterName(Reader.ReadDeclarationName(F,Record, Idx).getObjCSelector());
977   D->setGetterMethodDecl(ReadDeclAs<ObjCMethodDecl>(Record, Idx));
978   D->setSetterMethodDecl(ReadDeclAs<ObjCMethodDecl>(Record, Idx));
979   D->setPropertyIvarDecl(ReadDeclAs<ObjCIvarDecl>(Record, Idx));
980 }
981 
982 void ASTDeclReader::VisitObjCImplDecl(ObjCImplDecl *D) {
983   VisitObjCContainerDecl(D);
984   D->setClassInterface(ReadDeclAs<ObjCInterfaceDecl>(Record, Idx));
985 }
986 
987 void ASTDeclReader::VisitObjCCategoryImplDecl(ObjCCategoryImplDecl *D) {
988   VisitObjCImplDecl(D);
989   D->setIdentifier(Reader.GetIdentifierInfo(F, Record, Idx));
990   D->CategoryNameLoc = ReadSourceLocation(Record, Idx);
991 }
992 
993 void ASTDeclReader::VisitObjCImplementationDecl(ObjCImplementationDecl *D) {
994   VisitObjCImplDecl(D);
995   D->setSuperClass(ReadDeclAs<ObjCInterfaceDecl>(Record, Idx));
996   D->SuperLoc = ReadSourceLocation(Record, Idx);
997   D->setIvarLBraceLoc(ReadSourceLocation(Record, Idx));
998   D->setIvarRBraceLoc(ReadSourceLocation(Record, Idx));
999   D->setHasNonZeroConstructors(Record[Idx++]);
1000   D->setHasDestructors(Record[Idx++]);
1001   D->NumIvarInitializers = Record[Idx++];
1002   if (D->NumIvarInitializers)
1003     D->IvarInitializers = Reader.ReadCXXCtorInitializersRef(F, Record, Idx);
1004 }
1005 
1006 
1007 void ASTDeclReader::VisitObjCPropertyImplDecl(ObjCPropertyImplDecl *D) {
1008   VisitDecl(D);
1009   D->setAtLoc(ReadSourceLocation(Record, Idx));
1010   D->setPropertyDecl(ReadDeclAs<ObjCPropertyDecl>(Record, Idx));
1011   D->PropertyIvarDecl = ReadDeclAs<ObjCIvarDecl>(Record, Idx);
1012   D->IvarLoc = ReadSourceLocation(Record, Idx);
1013   D->setGetterCXXConstructor(Reader.ReadExpr(F));
1014   D->setSetterCXXAssignment(Reader.ReadExpr(F));
1015 }
1016 
1017 void ASTDeclReader::VisitFieldDecl(FieldDecl *FD) {
1018   VisitDeclaratorDecl(FD);
1019   FD->Mutable = Record[Idx++];
1020   if (int BitWidthOrInitializer = Record[Idx++]) {
1021     FD->InitStorage.setInt(
1022           static_cast<FieldDecl::InitStorageKind>(BitWidthOrInitializer - 1));
1023     if (FD->InitStorage.getInt() == FieldDecl::ISK_CapturedVLAType) {
1024       // Read captured variable length array.
1025       FD->InitStorage.setPointer(
1026           Reader.readType(F, Record, Idx).getAsOpaquePtr());
1027     } else {
1028       FD->InitStorage.setPointer(Reader.ReadExpr(F));
1029     }
1030   }
1031   if (!FD->getDeclName()) {
1032     if (FieldDecl *Tmpl = ReadDeclAs<FieldDecl>(Record, Idx))
1033       Reader.getContext().setInstantiatedFromUnnamedFieldDecl(FD, Tmpl);
1034   }
1035   mergeMergeable(FD);
1036 }
1037 
1038 void ASTDeclReader::VisitMSPropertyDecl(MSPropertyDecl *PD) {
1039   VisitDeclaratorDecl(PD);
1040   PD->GetterId = Reader.GetIdentifierInfo(F, Record, Idx);
1041   PD->SetterId = Reader.GetIdentifierInfo(F, Record, Idx);
1042 }
1043 
1044 void ASTDeclReader::VisitIndirectFieldDecl(IndirectFieldDecl *FD) {
1045   VisitValueDecl(FD);
1046 
1047   FD->ChainingSize = Record[Idx++];
1048   assert(FD->ChainingSize >= 2 && "Anonymous chaining must be >= 2");
1049   FD->Chaining = new (Reader.getContext())NamedDecl*[FD->ChainingSize];
1050 
1051   for (unsigned I = 0; I != FD->ChainingSize; ++I)
1052     FD->Chaining[I] = ReadDeclAs<NamedDecl>(Record, Idx);
1053 }
1054 
1055 ASTDeclReader::RedeclarableResult ASTDeclReader::VisitVarDeclImpl(VarDecl *VD) {
1056   RedeclarableResult Redecl = VisitRedeclarable(VD);
1057   VisitDeclaratorDecl(VD);
1058 
1059   VD->VarDeclBits.SClass = (StorageClass)Record[Idx++];
1060   VD->VarDeclBits.TSCSpec = Record[Idx++];
1061   VD->VarDeclBits.InitStyle = Record[Idx++];
1062   VD->VarDeclBits.ExceptionVar = Record[Idx++];
1063   VD->VarDeclBits.NRVOVariable = Record[Idx++];
1064   VD->VarDeclBits.CXXForRangeDecl = Record[Idx++];
1065   VD->VarDeclBits.ARCPseudoStrong = Record[Idx++];
1066   VD->VarDeclBits.IsConstexpr = Record[Idx++];
1067   VD->VarDeclBits.IsInitCapture = Record[Idx++];
1068   VD->VarDeclBits.PreviousDeclInSameBlockScope = Record[Idx++];
1069   Linkage VarLinkage = Linkage(Record[Idx++]);
1070   VD->setCachedLinkage(VarLinkage);
1071 
1072   // Reconstruct the one piece of the IdentifierNamespace that we need.
1073   if (VD->getStorageClass() == SC_Extern && VarLinkage != NoLinkage &&
1074       VD->getLexicalDeclContext()->isFunctionOrMethod())
1075     VD->setLocalExternDecl();
1076 
1077   if (uint64_t Val = Record[Idx++]) {
1078     VD->setInit(Reader.ReadExpr(F));
1079     if (Val > 1) {
1080       EvaluatedStmt *Eval = VD->ensureEvaluatedStmt();
1081       Eval->CheckedICE = true;
1082       Eval->IsICE = Val == 3;
1083     }
1084   }
1085 
1086   enum VarKind {
1087     VarNotTemplate = 0, VarTemplate, StaticDataMemberSpecialization
1088   };
1089   switch ((VarKind)Record[Idx++]) {
1090   case VarNotTemplate:
1091     // Only true variables (not parameters or implicit parameters) can be merged
1092     if (VD->getKind() != Decl::ParmVar && VD->getKind() != Decl::ImplicitParam &&
1093         !isa<VarTemplateSpecializationDecl>(VD))
1094       mergeRedeclarable(VD, Redecl);
1095     break;
1096   case VarTemplate:
1097     // Merged when we merge the template.
1098     VD->setDescribedVarTemplate(ReadDeclAs<VarTemplateDecl>(Record, Idx));
1099     break;
1100   case StaticDataMemberSpecialization: { // HasMemberSpecializationInfo.
1101     VarDecl *Tmpl = ReadDeclAs<VarDecl>(Record, Idx);
1102     TemplateSpecializationKind TSK = (TemplateSpecializationKind)Record[Idx++];
1103     SourceLocation POI = ReadSourceLocation(Record, Idx);
1104     Reader.getContext().setInstantiatedFromStaticDataMember(VD, Tmpl, TSK,POI);
1105     mergeRedeclarable(VD, Redecl);
1106     break;
1107   }
1108   }
1109 
1110   return Redecl;
1111 }
1112 
1113 void ASTDeclReader::VisitImplicitParamDecl(ImplicitParamDecl *PD) {
1114   VisitVarDecl(PD);
1115 }
1116 
1117 void ASTDeclReader::VisitParmVarDecl(ParmVarDecl *PD) {
1118   VisitVarDecl(PD);
1119   unsigned isObjCMethodParam = Record[Idx++];
1120   unsigned scopeDepth = Record[Idx++];
1121   unsigned scopeIndex = Record[Idx++];
1122   unsigned declQualifier = Record[Idx++];
1123   if (isObjCMethodParam) {
1124     assert(scopeDepth == 0);
1125     PD->setObjCMethodScopeInfo(scopeIndex);
1126     PD->ParmVarDeclBits.ScopeDepthOrObjCQuals = declQualifier;
1127   } else {
1128     PD->setScopeInfo(scopeDepth, scopeIndex);
1129   }
1130   PD->ParmVarDeclBits.IsKNRPromoted = Record[Idx++];
1131   PD->ParmVarDeclBits.HasInheritedDefaultArg = Record[Idx++];
1132   if (Record[Idx++]) // hasUninstantiatedDefaultArg.
1133     PD->setUninstantiatedDefaultArg(Reader.ReadExpr(F));
1134 
1135   // FIXME: If this is a redeclaration of a function from another module, handle
1136   // inheritance of default arguments.
1137 }
1138 
1139 void ASTDeclReader::VisitFileScopeAsmDecl(FileScopeAsmDecl *AD) {
1140   VisitDecl(AD);
1141   AD->setAsmString(cast<StringLiteral>(Reader.ReadExpr(F)));
1142   AD->setRParenLoc(ReadSourceLocation(Record, Idx));
1143 }
1144 
1145 void ASTDeclReader::VisitBlockDecl(BlockDecl *BD) {
1146   VisitDecl(BD);
1147   BD->setBody(cast_or_null<CompoundStmt>(Reader.ReadStmt(F)));
1148   BD->setSignatureAsWritten(GetTypeSourceInfo(Record, Idx));
1149   unsigned NumParams = Record[Idx++];
1150   SmallVector<ParmVarDecl *, 16> Params;
1151   Params.reserve(NumParams);
1152   for (unsigned I = 0; I != NumParams; ++I)
1153     Params.push_back(ReadDeclAs<ParmVarDecl>(Record, Idx));
1154   BD->setParams(Params);
1155 
1156   BD->setIsVariadic(Record[Idx++]);
1157   BD->setBlockMissingReturnType(Record[Idx++]);
1158   BD->setIsConversionFromLambda(Record[Idx++]);
1159 
1160   bool capturesCXXThis = Record[Idx++];
1161   unsigned numCaptures = Record[Idx++];
1162   SmallVector<BlockDecl::Capture, 16> captures;
1163   captures.reserve(numCaptures);
1164   for (unsigned i = 0; i != numCaptures; ++i) {
1165     VarDecl *decl = ReadDeclAs<VarDecl>(Record, Idx);
1166     unsigned flags = Record[Idx++];
1167     bool byRef = (flags & 1);
1168     bool nested = (flags & 2);
1169     Expr *copyExpr = ((flags & 4) ? Reader.ReadExpr(F) : nullptr);
1170 
1171     captures.push_back(BlockDecl::Capture(decl, byRef, nested, copyExpr));
1172   }
1173   BD->setCaptures(Reader.getContext(), captures.begin(),
1174                   captures.end(), capturesCXXThis);
1175 }
1176 
1177 void ASTDeclReader::VisitCapturedDecl(CapturedDecl *CD) {
1178   VisitDecl(CD);
1179   unsigned ContextParamPos = Record[Idx++];
1180   CD->setNothrow(Record[Idx++] != 0);
1181   // Body is set by VisitCapturedStmt.
1182   for (unsigned I = 0; I < CD->NumParams; ++I) {
1183     if (I != ContextParamPos)
1184       CD->setParam(I, ReadDeclAs<ImplicitParamDecl>(Record, Idx));
1185     else
1186       CD->setContextParam(I, ReadDeclAs<ImplicitParamDecl>(Record, Idx));
1187   }
1188 }
1189 
1190 void ASTDeclReader::VisitLinkageSpecDecl(LinkageSpecDecl *D) {
1191   VisitDecl(D);
1192   D->setLanguage((LinkageSpecDecl::LanguageIDs)Record[Idx++]);
1193   D->setExternLoc(ReadSourceLocation(Record, Idx));
1194   D->setRBraceLoc(ReadSourceLocation(Record, Idx));
1195 }
1196 
1197 void ASTDeclReader::VisitLabelDecl(LabelDecl *D) {
1198   VisitNamedDecl(D);
1199   D->setLocStart(ReadSourceLocation(Record, Idx));
1200 }
1201 
1202 
1203 void ASTDeclReader::VisitNamespaceDecl(NamespaceDecl *D) {
1204   RedeclarableResult Redecl = VisitRedeclarable(D);
1205   VisitNamedDecl(D);
1206   D->setInline(Record[Idx++]);
1207   D->LocStart = ReadSourceLocation(Record, Idx);
1208   D->RBraceLoc = ReadSourceLocation(Record, Idx);
1209 
1210   // Defer loading the anonymous namespace until we've finished merging
1211   // this namespace; loading it might load a later declaration of the
1212   // same namespace, and we have an invariant that older declarations
1213   // get merged before newer ones try to merge.
1214   GlobalDeclID AnonNamespace = 0;
1215   if (Redecl.getFirstID() == ThisDeclID) {
1216     AnonNamespace = ReadDeclID(Record, Idx);
1217   } else {
1218     // Link this namespace back to the first declaration, which has already
1219     // been deserialized.
1220     D->AnonOrFirstNamespaceAndInline.setPointer(D->getFirstDecl());
1221   }
1222 
1223   mergeRedeclarable(D, Redecl);
1224 
1225   if (AnonNamespace) {
1226     // Each module has its own anonymous namespace, which is disjoint from
1227     // any other module's anonymous namespaces, so don't attach the anonymous
1228     // namespace at all.
1229     NamespaceDecl *Anon = cast<NamespaceDecl>(Reader.GetDecl(AnonNamespace));
1230     if (F.Kind != MK_ImplicitModule && F.Kind != MK_ExplicitModule)
1231       D->setAnonymousNamespace(Anon);
1232   }
1233 }
1234 
1235 void ASTDeclReader::VisitNamespaceAliasDecl(NamespaceAliasDecl *D) {
1236   RedeclarableResult Redecl = VisitRedeclarable(D);
1237   VisitNamedDecl(D);
1238   D->NamespaceLoc = ReadSourceLocation(Record, Idx);
1239   D->IdentLoc = ReadSourceLocation(Record, Idx);
1240   D->QualifierLoc = Reader.ReadNestedNameSpecifierLoc(F, Record, Idx);
1241   D->Namespace = ReadDeclAs<NamedDecl>(Record, Idx);
1242   mergeRedeclarable(D, Redecl);
1243 }
1244 
1245 void ASTDeclReader::VisitUsingDecl(UsingDecl *D) {
1246   VisitNamedDecl(D);
1247   D->setUsingLoc(ReadSourceLocation(Record, Idx));
1248   D->QualifierLoc = Reader.ReadNestedNameSpecifierLoc(F, Record, Idx);
1249   ReadDeclarationNameLoc(D->DNLoc, D->getDeclName(), Record, Idx);
1250   D->FirstUsingShadow.setPointer(ReadDeclAs<UsingShadowDecl>(Record, Idx));
1251   D->setTypename(Record[Idx++]);
1252   if (NamedDecl *Pattern = ReadDeclAs<NamedDecl>(Record, Idx))
1253     Reader.getContext().setInstantiatedFromUsingDecl(D, Pattern);
1254   mergeMergeable(D);
1255 }
1256 
1257 void ASTDeclReader::VisitUsingShadowDecl(UsingShadowDecl *D) {
1258   RedeclarableResult Redecl = VisitRedeclarable(D);
1259   VisitNamedDecl(D);
1260   D->setTargetDecl(ReadDeclAs<NamedDecl>(Record, Idx));
1261   D->UsingOrNextShadow = ReadDeclAs<NamedDecl>(Record, Idx);
1262   UsingShadowDecl *Pattern = ReadDeclAs<UsingShadowDecl>(Record, Idx);
1263   if (Pattern)
1264     Reader.getContext().setInstantiatedFromUsingShadowDecl(D, Pattern);
1265   mergeRedeclarable(D, Redecl);
1266 }
1267 
1268 void ASTDeclReader::VisitUsingDirectiveDecl(UsingDirectiveDecl *D) {
1269   VisitNamedDecl(D);
1270   D->UsingLoc = ReadSourceLocation(Record, Idx);
1271   D->NamespaceLoc = ReadSourceLocation(Record, Idx);
1272   D->QualifierLoc = Reader.ReadNestedNameSpecifierLoc(F, Record, Idx);
1273   D->NominatedNamespace = ReadDeclAs<NamedDecl>(Record, Idx);
1274   D->CommonAncestor = ReadDeclAs<DeclContext>(Record, Idx);
1275 }
1276 
1277 void ASTDeclReader::VisitUnresolvedUsingValueDecl(UnresolvedUsingValueDecl *D) {
1278   VisitValueDecl(D);
1279   D->setUsingLoc(ReadSourceLocation(Record, Idx));
1280   D->QualifierLoc = Reader.ReadNestedNameSpecifierLoc(F, Record, Idx);
1281   ReadDeclarationNameLoc(D->DNLoc, D->getDeclName(), Record, Idx);
1282   mergeMergeable(D);
1283 }
1284 
1285 void ASTDeclReader::VisitUnresolvedUsingTypenameDecl(
1286                                                UnresolvedUsingTypenameDecl *D) {
1287   VisitTypeDecl(D);
1288   D->TypenameLocation = ReadSourceLocation(Record, Idx);
1289   D->QualifierLoc = Reader.ReadNestedNameSpecifierLoc(F, Record, Idx);
1290   mergeMergeable(D);
1291 }
1292 
1293 void ASTDeclReader::ReadCXXDefinitionData(
1294                                    struct CXXRecordDecl::DefinitionData &Data,
1295                                    const RecordData &Record, unsigned &Idx) {
1296   // Note: the caller has deserialized the IsLambda bit already.
1297   Data.UserDeclaredConstructor = Record[Idx++];
1298   Data.UserDeclaredSpecialMembers = Record[Idx++];
1299   Data.Aggregate = Record[Idx++];
1300   Data.PlainOldData = Record[Idx++];
1301   Data.Empty = Record[Idx++];
1302   Data.Polymorphic = Record[Idx++];
1303   Data.Abstract = Record[Idx++];
1304   Data.IsStandardLayout = Record[Idx++];
1305   Data.HasNoNonEmptyBases = Record[Idx++];
1306   Data.HasPrivateFields = Record[Idx++];
1307   Data.HasProtectedFields = Record[Idx++];
1308   Data.HasPublicFields = Record[Idx++];
1309   Data.HasMutableFields = Record[Idx++];
1310   Data.HasVariantMembers = Record[Idx++];
1311   Data.HasOnlyCMembers = Record[Idx++];
1312   Data.HasInClassInitializer = Record[Idx++];
1313   Data.HasUninitializedReferenceMember = Record[Idx++];
1314   Data.NeedOverloadResolutionForMoveConstructor = Record[Idx++];
1315   Data.NeedOverloadResolutionForMoveAssignment = Record[Idx++];
1316   Data.NeedOverloadResolutionForDestructor = Record[Idx++];
1317   Data.DefaultedMoveConstructorIsDeleted = Record[Idx++];
1318   Data.DefaultedMoveAssignmentIsDeleted = Record[Idx++];
1319   Data.DefaultedDestructorIsDeleted = Record[Idx++];
1320   Data.HasTrivialSpecialMembers = Record[Idx++];
1321   Data.DeclaredNonTrivialSpecialMembers = Record[Idx++];
1322   Data.HasIrrelevantDestructor = Record[Idx++];
1323   Data.HasConstexprNonCopyMoveConstructor = Record[Idx++];
1324   Data.DefaultedDefaultConstructorIsConstexpr = Record[Idx++];
1325   Data.HasConstexprDefaultConstructor = Record[Idx++];
1326   Data.HasNonLiteralTypeFieldsOrBases = Record[Idx++];
1327   Data.ComputedVisibleConversions = Record[Idx++];
1328   Data.UserProvidedDefaultConstructor = Record[Idx++];
1329   Data.DeclaredSpecialMembers = Record[Idx++];
1330   Data.ImplicitCopyConstructorHasConstParam = Record[Idx++];
1331   Data.ImplicitCopyAssignmentHasConstParam = Record[Idx++];
1332   Data.HasDeclaredCopyConstructorWithConstParam = Record[Idx++];
1333   Data.HasDeclaredCopyAssignmentWithConstParam = Record[Idx++];
1334 
1335   Data.NumBases = Record[Idx++];
1336   if (Data.NumBases)
1337     Data.Bases = Reader.readCXXBaseSpecifiers(F, Record, Idx);
1338   Data.NumVBases = Record[Idx++];
1339   if (Data.NumVBases)
1340     Data.VBases = Reader.readCXXBaseSpecifiers(F, Record, Idx);
1341 
1342   Reader.ReadUnresolvedSet(F, Data.Conversions, Record, Idx);
1343   Reader.ReadUnresolvedSet(F, Data.VisibleConversions, Record, Idx);
1344   assert(Data.Definition && "Data.Definition should be already set!");
1345   Data.FirstFriend = ReadDeclID(Record, Idx);
1346 
1347   if (Data.IsLambda) {
1348     typedef LambdaCapture Capture;
1349     CXXRecordDecl::LambdaDefinitionData &Lambda
1350       = static_cast<CXXRecordDecl::LambdaDefinitionData &>(Data);
1351     Lambda.Dependent = Record[Idx++];
1352     Lambda.IsGenericLambda = Record[Idx++];
1353     Lambda.CaptureDefault = Record[Idx++];
1354     Lambda.NumCaptures = Record[Idx++];
1355     Lambda.NumExplicitCaptures = Record[Idx++];
1356     Lambda.ManglingNumber = Record[Idx++];
1357     Lambda.ContextDecl = ReadDecl(Record, Idx);
1358     Lambda.Captures
1359       = (Capture*)Reader.Context.Allocate(sizeof(Capture)*Lambda.NumCaptures);
1360     Capture *ToCapture = Lambda.Captures;
1361     Lambda.MethodTyInfo = GetTypeSourceInfo(Record, Idx);
1362     for (unsigned I = 0, N = Lambda.NumCaptures; I != N; ++I) {
1363       SourceLocation Loc = ReadSourceLocation(Record, Idx);
1364       bool IsImplicit = Record[Idx++];
1365       LambdaCaptureKind Kind = static_cast<LambdaCaptureKind>(Record[Idx++]);
1366       switch (Kind) {
1367       case LCK_This:
1368       case LCK_VLAType:
1369         *ToCapture++ = Capture(Loc, IsImplicit, Kind, nullptr,SourceLocation());
1370         break;
1371       case LCK_ByCopy:
1372       case LCK_ByRef:
1373         VarDecl *Var = ReadDeclAs<VarDecl>(Record, Idx);
1374         SourceLocation EllipsisLoc = ReadSourceLocation(Record, Idx);
1375         *ToCapture++ = Capture(Loc, IsImplicit, Kind, Var, EllipsisLoc);
1376         break;
1377       }
1378     }
1379   }
1380 }
1381 
1382 void ASTDeclReader::MergeDefinitionData(
1383     CXXRecordDecl *D, struct CXXRecordDecl::DefinitionData &&MergeDD) {
1384   assert(D->DefinitionData.getNotUpdated() &&
1385          "merging class definition into non-definition");
1386   auto &DD = *D->DefinitionData.getNotUpdated();
1387 
1388   auto PFDI = Reader.PendingFakeDefinitionData.find(&DD);
1389   if (PFDI != Reader.PendingFakeDefinitionData.end() &&
1390       PFDI->second == ASTReader::PendingFakeDefinitionKind::Fake) {
1391     // We faked up this definition data because we found a class for which we'd
1392     // not yet loaded the definition. Replace it with the real thing now.
1393     assert(!DD.IsLambda && !MergeDD.IsLambda && "faked up lambda definition?");
1394     PFDI->second = ASTReader::PendingFakeDefinitionKind::FakeLoaded;
1395 
1396     // Don't change which declaration is the definition; that is required
1397     // to be invariant once we select it.
1398     auto *Def = DD.Definition;
1399     DD = std::move(MergeDD);
1400     DD.Definition = Def;
1401     return;
1402   }
1403 
1404   // If the new definition has new special members, let the name lookup
1405   // code know that it needs to look in the new definition too.
1406   //
1407   // FIXME: We only need to do this if the merged definition declares members
1408   // that this definition did not declare, or if it defines members that this
1409   // definition did not define.
1410   if (MergeDD.DeclaredSpecialMembers && DD.Definition != MergeDD.Definition) {
1411     Reader.MergedLookups[DD.Definition].push_back(MergeDD.Definition);
1412     DD.Definition->setHasExternalVisibleStorage();
1413   }
1414 
1415   // FIXME: Move this out into a .def file?
1416   bool DetectedOdrViolation = false;
1417 #define OR_FIELD(Field) DD.Field |= MergeDD.Field;
1418 #define MATCH_FIELD(Field) \
1419     DetectedOdrViolation |= DD.Field != MergeDD.Field; \
1420     OR_FIELD(Field)
1421   MATCH_FIELD(UserDeclaredConstructor)
1422   MATCH_FIELD(UserDeclaredSpecialMembers)
1423   MATCH_FIELD(Aggregate)
1424   MATCH_FIELD(PlainOldData)
1425   MATCH_FIELD(Empty)
1426   MATCH_FIELD(Polymorphic)
1427   MATCH_FIELD(Abstract)
1428   MATCH_FIELD(IsStandardLayout)
1429   MATCH_FIELD(HasNoNonEmptyBases)
1430   MATCH_FIELD(HasPrivateFields)
1431   MATCH_FIELD(HasProtectedFields)
1432   MATCH_FIELD(HasPublicFields)
1433   MATCH_FIELD(HasMutableFields)
1434   MATCH_FIELD(HasVariantMembers)
1435   MATCH_FIELD(HasOnlyCMembers)
1436   MATCH_FIELD(HasInClassInitializer)
1437   MATCH_FIELD(HasUninitializedReferenceMember)
1438   MATCH_FIELD(NeedOverloadResolutionForMoveConstructor)
1439   MATCH_FIELD(NeedOverloadResolutionForMoveAssignment)
1440   MATCH_FIELD(NeedOverloadResolutionForDestructor)
1441   MATCH_FIELD(DefaultedMoveConstructorIsDeleted)
1442   MATCH_FIELD(DefaultedMoveAssignmentIsDeleted)
1443   MATCH_FIELD(DefaultedDestructorIsDeleted)
1444   OR_FIELD(HasTrivialSpecialMembers)
1445   OR_FIELD(DeclaredNonTrivialSpecialMembers)
1446   MATCH_FIELD(HasIrrelevantDestructor)
1447   OR_FIELD(HasConstexprNonCopyMoveConstructor)
1448   MATCH_FIELD(DefaultedDefaultConstructorIsConstexpr)
1449   OR_FIELD(HasConstexprDefaultConstructor)
1450   MATCH_FIELD(HasNonLiteralTypeFieldsOrBases)
1451   // ComputedVisibleConversions is handled below.
1452   MATCH_FIELD(UserProvidedDefaultConstructor)
1453   OR_FIELD(DeclaredSpecialMembers)
1454   MATCH_FIELD(ImplicitCopyConstructorHasConstParam)
1455   MATCH_FIELD(ImplicitCopyAssignmentHasConstParam)
1456   OR_FIELD(HasDeclaredCopyConstructorWithConstParam)
1457   OR_FIELD(HasDeclaredCopyAssignmentWithConstParam)
1458   MATCH_FIELD(IsLambda)
1459 #undef OR_FIELD
1460 #undef MATCH_FIELD
1461 
1462   if (DD.NumBases != MergeDD.NumBases || DD.NumVBases != MergeDD.NumVBases)
1463     DetectedOdrViolation = true;
1464   // FIXME: Issue a diagnostic if the base classes don't match when we come
1465   // to lazily load them.
1466 
1467   // FIXME: Issue a diagnostic if the list of conversion functions doesn't
1468   // match when we come to lazily load them.
1469   if (MergeDD.ComputedVisibleConversions && !DD.ComputedVisibleConversions) {
1470     DD.VisibleConversions = std::move(MergeDD.VisibleConversions);
1471     DD.ComputedVisibleConversions = true;
1472   }
1473 
1474   // FIXME: Issue a diagnostic if FirstFriend doesn't match when we come to
1475   // lazily load it.
1476 
1477   if (DD.IsLambda) {
1478     // FIXME: ODR-checking for merging lambdas (this happens, for instance,
1479     // when they occur within the body of a function template specialization).
1480   }
1481 
1482   if (DetectedOdrViolation)
1483     Reader.PendingOdrMergeFailures[DD.Definition].push_back(MergeDD.Definition);
1484 }
1485 
1486 void ASTDeclReader::ReadCXXRecordDefinition(CXXRecordDecl *D, bool Update) {
1487   struct CXXRecordDecl::DefinitionData *DD;
1488   ASTContext &C = Reader.getContext();
1489 
1490   // Determine whether this is a lambda closure type, so that we can
1491   // allocate the appropriate DefinitionData structure.
1492   bool IsLambda = Record[Idx++];
1493   if (IsLambda)
1494     DD = new (C) CXXRecordDecl::LambdaDefinitionData(D, nullptr, false, false,
1495                                                      LCD_None);
1496   else
1497     DD = new (C) struct CXXRecordDecl::DefinitionData(D);
1498 
1499   ReadCXXDefinitionData(*DD, Record, Idx);
1500 
1501   // We might already have a definition for this record. This can happen either
1502   // because we're reading an update record, or because we've already done some
1503   // merging. Either way, just merge into it.
1504   CXXRecordDecl *Canon = D->getCanonicalDecl();
1505   if (auto *CanonDD = Canon->DefinitionData.getNotUpdated()) {
1506     if (CanonDD->Definition != DD->Definition)
1507       Reader.MergedDeclContexts.insert(
1508           std::make_pair(DD->Definition, CanonDD->Definition));
1509     MergeDefinitionData(Canon, std::move(*DD));
1510     D->DefinitionData = Canon->DefinitionData;
1511     return;
1512   }
1513 
1514   // Propagate the DefinitionData pointer to the canonical declaration, so
1515   // that all other deserialized declarations will see it.
1516   if (Canon == D) {
1517     D->DefinitionData = DD;
1518     D->IsCompleteDefinition = true;
1519 
1520     // If this is an update record, we can have redeclarations already. Make a
1521     // note that we need to propagate the DefinitionData pointer onto them.
1522     if (Update)
1523       Reader.PendingDefinitions.insert(D);
1524   } else if (auto *CanonDD = Canon->DefinitionData.getNotUpdated()) {
1525     // We have already deserialized a definition of this record. This
1526     // definition is no longer really a definition. Note that the pre-existing
1527     // definition is the *real* definition.
1528     Reader.MergedDeclContexts.insert(
1529         std::make_pair(D, CanonDD->Definition));
1530     D->DefinitionData = Canon->DefinitionData;
1531     D->IsCompleteDefinition = false;
1532     MergeDefinitionData(D, std::move(*DD));
1533   } else {
1534     Canon->DefinitionData = DD;
1535     D->DefinitionData = Canon->DefinitionData;
1536     D->IsCompleteDefinition = true;
1537 
1538     // Note that we have deserialized a definition. Any declarations
1539     // deserialized before this one will be be given the DefinitionData
1540     // pointer at the end.
1541     Reader.PendingDefinitions.insert(D);
1542   }
1543 }
1544 
1545 ASTDeclReader::RedeclarableResult
1546 ASTDeclReader::VisitCXXRecordDeclImpl(CXXRecordDecl *D) {
1547   RedeclarableResult Redecl = VisitRecordDeclImpl(D);
1548 
1549   ASTContext &C = Reader.getContext();
1550 
1551   enum CXXRecKind {
1552     CXXRecNotTemplate = 0, CXXRecTemplate, CXXRecMemberSpecialization
1553   };
1554   switch ((CXXRecKind)Record[Idx++]) {
1555   case CXXRecNotTemplate:
1556     // Merged when we merge the folding set entry in the primary template.
1557     if (!isa<ClassTemplateSpecializationDecl>(D))
1558       mergeRedeclarable(D, Redecl);
1559     break;
1560   case CXXRecTemplate: {
1561     // Merged when we merge the template.
1562     ClassTemplateDecl *Template = ReadDeclAs<ClassTemplateDecl>(Record, Idx);
1563     D->TemplateOrInstantiation = Template;
1564     if (!Template->getTemplatedDecl()) {
1565       // We've not actually loaded the ClassTemplateDecl yet, because we're
1566       // currently being loaded as its pattern. Rely on it to set up our
1567       // TypeForDecl (see VisitClassTemplateDecl).
1568       //
1569       // Beware: we do not yet know our canonical declaration, and may still
1570       // get merged once the surrounding class template has got off the ground.
1571       TypeIDForTypeDecl = 0;
1572     }
1573     break;
1574   }
1575   case CXXRecMemberSpecialization: {
1576     CXXRecordDecl *RD = ReadDeclAs<CXXRecordDecl>(Record, Idx);
1577     TemplateSpecializationKind TSK = (TemplateSpecializationKind)Record[Idx++];
1578     SourceLocation POI = ReadSourceLocation(Record, Idx);
1579     MemberSpecializationInfo *MSI = new (C) MemberSpecializationInfo(RD, TSK);
1580     MSI->setPointOfInstantiation(POI);
1581     D->TemplateOrInstantiation = MSI;
1582     mergeRedeclarable(D, Redecl);
1583     break;
1584   }
1585   }
1586 
1587   bool WasDefinition = Record[Idx++];
1588   if (WasDefinition)
1589     ReadCXXRecordDefinition(D, /*Update*/false);
1590   else
1591     // Propagate DefinitionData pointer from the canonical declaration.
1592     D->DefinitionData = D->getCanonicalDecl()->DefinitionData;
1593 
1594   // Lazily load the key function to avoid deserializing every method so we can
1595   // compute it.
1596   if (WasDefinition) {
1597     DeclID KeyFn = ReadDeclID(Record, Idx);
1598     if (KeyFn && D->IsCompleteDefinition)
1599       // FIXME: This is wrong for the ARM ABI, where some other module may have
1600       // made this function no longer be a key function. We need an update
1601       // record or similar for that case.
1602       C.KeyFunctions[D] = KeyFn;
1603   }
1604 
1605   return Redecl;
1606 }
1607 
1608 void ASTDeclReader::VisitCXXMethodDecl(CXXMethodDecl *D) {
1609   VisitFunctionDecl(D);
1610 
1611   unsigned NumOverridenMethods = Record[Idx++];
1612   if (D->isCanonicalDecl()) {
1613     while (NumOverridenMethods--) {
1614       // Avoid invariant checking of CXXMethodDecl::addOverriddenMethod,
1615       // MD may be initializing.
1616       if (CXXMethodDecl *MD = ReadDeclAs<CXXMethodDecl>(Record, Idx))
1617         Reader.getContext().addOverriddenMethod(D, MD->getCanonicalDecl());
1618     }
1619   } else {
1620     // We don't care about which declarations this used to override; we get
1621     // the relevant information from the canonical declaration.
1622     Idx += NumOverridenMethods;
1623   }
1624 }
1625 
1626 void ASTDeclReader::VisitCXXConstructorDecl(CXXConstructorDecl *D) {
1627   VisitCXXMethodDecl(D);
1628 
1629   if (auto *CD = ReadDeclAs<CXXConstructorDecl>(Record, Idx))
1630     if (D->isCanonicalDecl())
1631       D->setInheritedConstructor(CD);
1632   D->IsExplicitSpecified = Record[Idx++];
1633 }
1634 
1635 void ASTDeclReader::VisitCXXDestructorDecl(CXXDestructorDecl *D) {
1636   VisitCXXMethodDecl(D);
1637 
1638   if (auto *OperatorDelete = ReadDeclAs<FunctionDecl>(Record, Idx)) {
1639     auto *Canon = cast<CXXDestructorDecl>(D->getCanonicalDecl());
1640     // FIXME: Check consistency if we have an old and new operator delete.
1641     if (!Canon->OperatorDelete)
1642       Canon->OperatorDelete = OperatorDelete;
1643   }
1644 }
1645 
1646 void ASTDeclReader::VisitCXXConversionDecl(CXXConversionDecl *D) {
1647   VisitCXXMethodDecl(D);
1648   D->IsExplicitSpecified = Record[Idx++];
1649 }
1650 
1651 void ASTDeclReader::VisitImportDecl(ImportDecl *D) {
1652   VisitDecl(D);
1653   D->ImportedAndComplete.setPointer(readModule(Record, Idx));
1654   D->ImportedAndComplete.setInt(Record[Idx++]);
1655   SourceLocation *StoredLocs = reinterpret_cast<SourceLocation *>(D + 1);
1656   for (unsigned I = 0, N = Record.back(); I != N; ++I)
1657     StoredLocs[I] = ReadSourceLocation(Record, Idx);
1658   ++Idx; // The number of stored source locations.
1659 }
1660 
1661 void ASTDeclReader::VisitAccessSpecDecl(AccessSpecDecl *D) {
1662   VisitDecl(D);
1663   D->setColonLoc(ReadSourceLocation(Record, Idx));
1664 }
1665 
1666 void ASTDeclReader::VisitFriendDecl(FriendDecl *D) {
1667   VisitDecl(D);
1668   if (Record[Idx++]) // hasFriendDecl
1669     D->Friend = ReadDeclAs<NamedDecl>(Record, Idx);
1670   else
1671     D->Friend = GetTypeSourceInfo(Record, Idx);
1672   for (unsigned i = 0; i != D->NumTPLists; ++i)
1673     D->getTPLists()[i] = Reader.ReadTemplateParameterList(F, Record, Idx);
1674   D->NextFriend = ReadDeclID(Record, Idx);
1675   D->UnsupportedFriend = (Record[Idx++] != 0);
1676   D->FriendLoc = ReadSourceLocation(Record, Idx);
1677 }
1678 
1679 void ASTDeclReader::VisitFriendTemplateDecl(FriendTemplateDecl *D) {
1680   VisitDecl(D);
1681   unsigned NumParams = Record[Idx++];
1682   D->NumParams = NumParams;
1683   D->Params = new TemplateParameterList*[NumParams];
1684   for (unsigned i = 0; i != NumParams; ++i)
1685     D->Params[i] = Reader.ReadTemplateParameterList(F, Record, Idx);
1686   if (Record[Idx++]) // HasFriendDecl
1687     D->Friend = ReadDeclAs<NamedDecl>(Record, Idx);
1688   else
1689     D->Friend = GetTypeSourceInfo(Record, Idx);
1690   D->FriendLoc = ReadSourceLocation(Record, Idx);
1691 }
1692 
1693 DeclID ASTDeclReader::VisitTemplateDecl(TemplateDecl *D) {
1694   VisitNamedDecl(D);
1695 
1696   DeclID PatternID = ReadDeclID(Record, Idx);
1697   NamedDecl *TemplatedDecl = cast_or_null<NamedDecl>(Reader.GetDecl(PatternID));
1698   TemplateParameterList* TemplateParams
1699       = Reader.ReadTemplateParameterList(F, Record, Idx);
1700   D->init(TemplatedDecl, TemplateParams);
1701 
1702   // FIXME: If this is a redeclaration of a template from another module, handle
1703   // inheritance of default template arguments.
1704 
1705   return PatternID;
1706 }
1707 
1708 ASTDeclReader::RedeclarableResult
1709 ASTDeclReader::VisitRedeclarableTemplateDecl(RedeclarableTemplateDecl *D) {
1710   RedeclarableResult Redecl = VisitRedeclarable(D);
1711 
1712   // Make sure we've allocated the Common pointer first. We do this before
1713   // VisitTemplateDecl so that getCommonPtr() can be used during initialization.
1714   RedeclarableTemplateDecl *CanonD = D->getCanonicalDecl();
1715   if (!CanonD->Common) {
1716     CanonD->Common = CanonD->newCommon(Reader.getContext());
1717     Reader.PendingDefinitions.insert(CanonD);
1718   }
1719   D->Common = CanonD->Common;
1720 
1721   // If this is the first declaration of the template, fill in the information
1722   // for the 'common' pointer.
1723   if (ThisDeclID == Redecl.getFirstID()) {
1724     if (RedeclarableTemplateDecl *RTD
1725           = ReadDeclAs<RedeclarableTemplateDecl>(Record, Idx)) {
1726       assert(RTD->getKind() == D->getKind() &&
1727              "InstantiatedFromMemberTemplate kind mismatch");
1728       D->setInstantiatedFromMemberTemplate(RTD);
1729       if (Record[Idx++])
1730         D->setMemberSpecialization();
1731     }
1732   }
1733 
1734   DeclID PatternID = VisitTemplateDecl(D);
1735   D->IdentifierNamespace = Record[Idx++];
1736 
1737   mergeRedeclarable(D, Redecl, PatternID);
1738 
1739   // If we merged the template with a prior declaration chain, merge the common
1740   // pointer.
1741   // FIXME: Actually merge here, don't just overwrite.
1742   D->Common = D->getCanonicalDecl()->Common;
1743 
1744   return Redecl;
1745 }
1746 
1747 static DeclID *newDeclIDList(ASTContext &Context, DeclID *Old,
1748                              SmallVectorImpl<DeclID> &IDs) {
1749   assert(!IDs.empty() && "no IDs to add to list");
1750   if (Old) {
1751     IDs.insert(IDs.end(), Old + 1, Old + 1 + Old[0]);
1752     std::sort(IDs.begin(), IDs.end());
1753     IDs.erase(std::unique(IDs.begin(), IDs.end()), IDs.end());
1754   }
1755 
1756   auto *Result = new (Context) DeclID[1 + IDs.size()];
1757   *Result = IDs.size();
1758   std::copy(IDs.begin(), IDs.end(), Result + 1);
1759   return Result;
1760 }
1761 
1762 void ASTDeclReader::VisitClassTemplateDecl(ClassTemplateDecl *D) {
1763   RedeclarableResult Redecl = VisitRedeclarableTemplateDecl(D);
1764 
1765   if (ThisDeclID == Redecl.getFirstID()) {
1766     // This ClassTemplateDecl owns a CommonPtr; read it to keep track of all of
1767     // the specializations.
1768     SmallVector<serialization::DeclID, 32> SpecIDs;
1769     ReadDeclIDList(SpecIDs);
1770 
1771     if (!SpecIDs.empty()) {
1772       auto *CommonPtr = D->getCommonPtr();
1773       CommonPtr->LazySpecializations = newDeclIDList(
1774           Reader.getContext(), CommonPtr->LazySpecializations, SpecIDs);
1775     }
1776   }
1777 
1778   if (D->getTemplatedDecl()->TemplateOrInstantiation) {
1779     // We were loaded before our templated declaration was. We've not set up
1780     // its corresponding type yet (see VisitCXXRecordDeclImpl), so reconstruct
1781     // it now.
1782     Reader.Context.getInjectedClassNameType(
1783         D->getTemplatedDecl(), D->getInjectedClassNameSpecialization());
1784   }
1785 }
1786 
1787 /// TODO: Unify with ClassTemplateDecl version?
1788 ///       May require unifying ClassTemplateDecl and
1789 ///        VarTemplateDecl beyond TemplateDecl...
1790 void ASTDeclReader::VisitVarTemplateDecl(VarTemplateDecl *D) {
1791   RedeclarableResult Redecl = VisitRedeclarableTemplateDecl(D);
1792 
1793   if (ThisDeclID == Redecl.getFirstID()) {
1794     // This VarTemplateDecl owns a CommonPtr; read it to keep track of all of
1795     // the specializations.
1796     SmallVector<serialization::DeclID, 32> SpecIDs;
1797     ReadDeclIDList(SpecIDs);
1798 
1799     if (!SpecIDs.empty()) {
1800       auto *CommonPtr = D->getCommonPtr();
1801       CommonPtr->LazySpecializations = newDeclIDList(
1802           Reader.getContext(), CommonPtr->LazySpecializations, SpecIDs);
1803     }
1804   }
1805 }
1806 
1807 ASTDeclReader::RedeclarableResult
1808 ASTDeclReader::VisitClassTemplateSpecializationDeclImpl(
1809     ClassTemplateSpecializationDecl *D) {
1810   RedeclarableResult Redecl = VisitCXXRecordDeclImpl(D);
1811 
1812   ASTContext &C = Reader.getContext();
1813   if (Decl *InstD = ReadDecl(Record, Idx)) {
1814     if (ClassTemplateDecl *CTD = dyn_cast<ClassTemplateDecl>(InstD)) {
1815       D->SpecializedTemplate = CTD;
1816     } else {
1817       SmallVector<TemplateArgument, 8> TemplArgs;
1818       Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
1819       TemplateArgumentList *ArgList
1820         = TemplateArgumentList::CreateCopy(C, TemplArgs.data(),
1821                                            TemplArgs.size());
1822       ClassTemplateSpecializationDecl::SpecializedPartialSpecialization *PS
1823           = new (C) ClassTemplateSpecializationDecl::
1824                                              SpecializedPartialSpecialization();
1825       PS->PartialSpecialization
1826           = cast<ClassTemplatePartialSpecializationDecl>(InstD);
1827       PS->TemplateArgs = ArgList;
1828       D->SpecializedTemplate = PS;
1829     }
1830   }
1831 
1832   SmallVector<TemplateArgument, 8> TemplArgs;
1833   Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
1834   D->TemplateArgs = TemplateArgumentList::CreateCopy(C, TemplArgs.data(),
1835                                                      TemplArgs.size());
1836   D->PointOfInstantiation = ReadSourceLocation(Record, Idx);
1837   D->SpecializationKind = (TemplateSpecializationKind)Record[Idx++];
1838 
1839   bool writtenAsCanonicalDecl = Record[Idx++];
1840   if (writtenAsCanonicalDecl) {
1841     ClassTemplateDecl *CanonPattern = ReadDeclAs<ClassTemplateDecl>(Record,Idx);
1842     if (D->isCanonicalDecl()) { // It's kept in the folding set.
1843       // Set this as, or find, the canonical declaration for this specialization
1844       ClassTemplateSpecializationDecl *CanonSpec;
1845       if (ClassTemplatePartialSpecializationDecl *Partial =
1846               dyn_cast<ClassTemplatePartialSpecializationDecl>(D)) {
1847         CanonSpec = CanonPattern->getCommonPtr()->PartialSpecializations
1848             .GetOrInsertNode(Partial);
1849       } else {
1850         CanonSpec =
1851             CanonPattern->getCommonPtr()->Specializations.GetOrInsertNode(D);
1852       }
1853       // If there was already a canonical specialization, merge into it.
1854       if (CanonSpec != D) {
1855         mergeRedeclarable<TagDecl>(D, CanonSpec, Redecl);
1856 
1857         // This declaration might be a definition. Merge with any existing
1858         // definition.
1859         if (auto *DDD = D->DefinitionData.getNotUpdated()) {
1860           if (auto *CanonDD = CanonSpec->DefinitionData.getNotUpdated()) {
1861             MergeDefinitionData(CanonSpec, std::move(*DDD));
1862             Reader.PendingDefinitions.erase(D);
1863             Reader.MergedDeclContexts.insert(
1864                 std::make_pair(D, CanonDD->Definition));
1865             D->IsCompleteDefinition = false;
1866           } else {
1867             CanonSpec->DefinitionData = D->DefinitionData;
1868           }
1869         }
1870         D->DefinitionData = CanonSpec->DefinitionData;
1871       }
1872     }
1873   }
1874 
1875   // Explicit info.
1876   if (TypeSourceInfo *TyInfo = GetTypeSourceInfo(Record, Idx)) {
1877     ClassTemplateSpecializationDecl::ExplicitSpecializationInfo *ExplicitInfo
1878         = new (C) ClassTemplateSpecializationDecl::ExplicitSpecializationInfo;
1879     ExplicitInfo->TypeAsWritten = TyInfo;
1880     ExplicitInfo->ExternLoc = ReadSourceLocation(Record, Idx);
1881     ExplicitInfo->TemplateKeywordLoc = ReadSourceLocation(Record, Idx);
1882     D->ExplicitInfo = ExplicitInfo;
1883   }
1884 
1885   return Redecl;
1886 }
1887 
1888 void ASTDeclReader::VisitClassTemplatePartialSpecializationDecl(
1889                                     ClassTemplatePartialSpecializationDecl *D) {
1890   RedeclarableResult Redecl = VisitClassTemplateSpecializationDeclImpl(D);
1891 
1892   D->TemplateParams = Reader.ReadTemplateParameterList(F, Record, Idx);
1893   D->ArgsAsWritten = Reader.ReadASTTemplateArgumentListInfo(F, Record, Idx);
1894 
1895   // These are read/set from/to the first declaration.
1896   if (ThisDeclID == Redecl.getFirstID()) {
1897     D->InstantiatedFromMember.setPointer(
1898       ReadDeclAs<ClassTemplatePartialSpecializationDecl>(Record, Idx));
1899     D->InstantiatedFromMember.setInt(Record[Idx++]);
1900   }
1901 }
1902 
1903 void ASTDeclReader::VisitClassScopeFunctionSpecializationDecl(
1904                                     ClassScopeFunctionSpecializationDecl *D) {
1905   VisitDecl(D);
1906   D->Specialization = ReadDeclAs<CXXMethodDecl>(Record, Idx);
1907 }
1908 
1909 void ASTDeclReader::VisitFunctionTemplateDecl(FunctionTemplateDecl *D) {
1910   RedeclarableResult Redecl = VisitRedeclarableTemplateDecl(D);
1911 
1912   if (ThisDeclID == Redecl.getFirstID()) {
1913     // This FunctionTemplateDecl owns a CommonPtr; read it.
1914     SmallVector<serialization::DeclID, 32> SpecIDs;
1915     ReadDeclIDList(SpecIDs);
1916 
1917     if (!SpecIDs.empty()) {
1918       auto *CommonPtr = D->getCommonPtr();
1919       CommonPtr->LazySpecializations = newDeclIDList(
1920           Reader.getContext(), CommonPtr->LazySpecializations, SpecIDs);
1921     }
1922   }
1923 }
1924 
1925 /// TODO: Unify with ClassTemplateSpecializationDecl version?
1926 ///       May require unifying ClassTemplate(Partial)SpecializationDecl and
1927 ///        VarTemplate(Partial)SpecializationDecl with a new data
1928 ///        structure Template(Partial)SpecializationDecl, and
1929 ///        using Template(Partial)SpecializationDecl as input type.
1930 ASTDeclReader::RedeclarableResult
1931 ASTDeclReader::VisitVarTemplateSpecializationDeclImpl(
1932     VarTemplateSpecializationDecl *D) {
1933   RedeclarableResult Redecl = VisitVarDeclImpl(D);
1934 
1935   ASTContext &C = Reader.getContext();
1936   if (Decl *InstD = ReadDecl(Record, Idx)) {
1937     if (VarTemplateDecl *VTD = dyn_cast<VarTemplateDecl>(InstD)) {
1938       D->SpecializedTemplate = VTD;
1939     } else {
1940       SmallVector<TemplateArgument, 8> TemplArgs;
1941       Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
1942       TemplateArgumentList *ArgList = TemplateArgumentList::CreateCopy(
1943           C, TemplArgs.data(), TemplArgs.size());
1944       VarTemplateSpecializationDecl::SpecializedPartialSpecialization *PS =
1945           new (C)
1946           VarTemplateSpecializationDecl::SpecializedPartialSpecialization();
1947       PS->PartialSpecialization =
1948           cast<VarTemplatePartialSpecializationDecl>(InstD);
1949       PS->TemplateArgs = ArgList;
1950       D->SpecializedTemplate = PS;
1951     }
1952   }
1953 
1954   // Explicit info.
1955   if (TypeSourceInfo *TyInfo = GetTypeSourceInfo(Record, Idx)) {
1956     VarTemplateSpecializationDecl::ExplicitSpecializationInfo *ExplicitInfo =
1957         new (C) VarTemplateSpecializationDecl::ExplicitSpecializationInfo;
1958     ExplicitInfo->TypeAsWritten = TyInfo;
1959     ExplicitInfo->ExternLoc = ReadSourceLocation(Record, Idx);
1960     ExplicitInfo->TemplateKeywordLoc = ReadSourceLocation(Record, Idx);
1961     D->ExplicitInfo = ExplicitInfo;
1962   }
1963 
1964   SmallVector<TemplateArgument, 8> TemplArgs;
1965   Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
1966   D->TemplateArgs =
1967       TemplateArgumentList::CreateCopy(C, TemplArgs.data(), TemplArgs.size());
1968   D->PointOfInstantiation = ReadSourceLocation(Record, Idx);
1969   D->SpecializationKind = (TemplateSpecializationKind)Record[Idx++];
1970 
1971   bool writtenAsCanonicalDecl = Record[Idx++];
1972   if (writtenAsCanonicalDecl) {
1973     VarTemplateDecl *CanonPattern = ReadDeclAs<VarTemplateDecl>(Record, Idx);
1974     if (D->isCanonicalDecl()) { // It's kept in the folding set.
1975       if (VarTemplatePartialSpecializationDecl *Partial =
1976               dyn_cast<VarTemplatePartialSpecializationDecl>(D)) {
1977         CanonPattern->getCommonPtr()->PartialSpecializations
1978             .GetOrInsertNode(Partial);
1979       } else {
1980         CanonPattern->getCommonPtr()->Specializations.GetOrInsertNode(D);
1981       }
1982     }
1983   }
1984 
1985   return Redecl;
1986 }
1987 
1988 /// TODO: Unify with ClassTemplatePartialSpecializationDecl version?
1989 ///       May require unifying ClassTemplate(Partial)SpecializationDecl and
1990 ///        VarTemplate(Partial)SpecializationDecl with a new data
1991 ///        structure Template(Partial)SpecializationDecl, and
1992 ///        using Template(Partial)SpecializationDecl as input type.
1993 void ASTDeclReader::VisitVarTemplatePartialSpecializationDecl(
1994     VarTemplatePartialSpecializationDecl *D) {
1995   RedeclarableResult Redecl = VisitVarTemplateSpecializationDeclImpl(D);
1996 
1997   D->TemplateParams = Reader.ReadTemplateParameterList(F, Record, Idx);
1998   D->ArgsAsWritten = Reader.ReadASTTemplateArgumentListInfo(F, Record, Idx);
1999 
2000   // These are read/set from/to the first declaration.
2001   if (ThisDeclID == Redecl.getFirstID()) {
2002     D->InstantiatedFromMember.setPointer(
2003         ReadDeclAs<VarTemplatePartialSpecializationDecl>(Record, Idx));
2004     D->InstantiatedFromMember.setInt(Record[Idx++]);
2005   }
2006 }
2007 
2008 void ASTDeclReader::VisitTemplateTypeParmDecl(TemplateTypeParmDecl *D) {
2009   VisitTypeDecl(D);
2010 
2011   D->setDeclaredWithTypename(Record[Idx++]);
2012 
2013   bool Inherited = Record[Idx++];
2014   TypeSourceInfo *DefArg = GetTypeSourceInfo(Record, Idx);
2015   D->setDefaultArgument(DefArg, Inherited);
2016 }
2017 
2018 void ASTDeclReader::VisitNonTypeTemplateParmDecl(NonTypeTemplateParmDecl *D) {
2019   VisitDeclaratorDecl(D);
2020   // TemplateParmPosition.
2021   D->setDepth(Record[Idx++]);
2022   D->setPosition(Record[Idx++]);
2023   if (D->isExpandedParameterPack()) {
2024     void **Data = reinterpret_cast<void **>(D + 1);
2025     for (unsigned I = 0, N = D->getNumExpansionTypes(); I != N; ++I) {
2026       Data[2*I] = Reader.readType(F, Record, Idx).getAsOpaquePtr();
2027       Data[2*I + 1] = GetTypeSourceInfo(Record, Idx);
2028     }
2029   } else {
2030     // Rest of NonTypeTemplateParmDecl.
2031     D->ParameterPack = Record[Idx++];
2032     if (Record[Idx++]) {
2033       Expr *DefArg = Reader.ReadExpr(F);
2034       bool Inherited = Record[Idx++];
2035       D->setDefaultArgument(DefArg, Inherited);
2036    }
2037   }
2038 }
2039 
2040 void ASTDeclReader::VisitTemplateTemplateParmDecl(TemplateTemplateParmDecl *D) {
2041   VisitTemplateDecl(D);
2042   // TemplateParmPosition.
2043   D->setDepth(Record[Idx++]);
2044   D->setPosition(Record[Idx++]);
2045   if (D->isExpandedParameterPack()) {
2046     void **Data = reinterpret_cast<void **>(D + 1);
2047     for (unsigned I = 0, N = D->getNumExpansionTemplateParameters();
2048          I != N; ++I)
2049       Data[I] = Reader.ReadTemplateParameterList(F, Record, Idx);
2050   } else {
2051     // Rest of TemplateTemplateParmDecl.
2052     TemplateArgumentLoc Arg = Reader.ReadTemplateArgumentLoc(F, Record, Idx);
2053     bool IsInherited = Record[Idx++];
2054     D->setDefaultArgument(Arg, IsInherited);
2055     D->ParameterPack = Record[Idx++];
2056   }
2057 }
2058 
2059 void ASTDeclReader::VisitTypeAliasTemplateDecl(TypeAliasTemplateDecl *D) {
2060   VisitRedeclarableTemplateDecl(D);
2061 }
2062 
2063 void ASTDeclReader::VisitStaticAssertDecl(StaticAssertDecl *D) {
2064   VisitDecl(D);
2065   D->AssertExprAndFailed.setPointer(Reader.ReadExpr(F));
2066   D->AssertExprAndFailed.setInt(Record[Idx++]);
2067   D->Message = cast<StringLiteral>(Reader.ReadExpr(F));
2068   D->RParenLoc = ReadSourceLocation(Record, Idx);
2069 }
2070 
2071 void ASTDeclReader::VisitEmptyDecl(EmptyDecl *D) {
2072   VisitDecl(D);
2073 }
2074 
2075 std::pair<uint64_t, uint64_t>
2076 ASTDeclReader::VisitDeclContext(DeclContext *DC) {
2077   uint64_t LexicalOffset = Record[Idx++];
2078   uint64_t VisibleOffset = Record[Idx++];
2079   return std::make_pair(LexicalOffset, VisibleOffset);
2080 }
2081 
2082 template <typename T>
2083 ASTDeclReader::RedeclarableResult
2084 ASTDeclReader::VisitRedeclarable(Redeclarable<T> *D) {
2085   DeclID FirstDeclID = ReadDeclID(Record, Idx);
2086   Decl *MergeWith = nullptr;
2087 
2088   // 0 indicates that this declaration was the only declaration of its entity,
2089   // and is used for space optimization.
2090   if (FirstDeclID == 0)
2091     FirstDeclID = ThisDeclID;
2092   else if (unsigned N = Record[Idx++]) {
2093     // We have some declarations that must be before us in our redeclaration
2094     // chain. Read them now, and remember that we ought to merge with one of
2095     // them.
2096     // FIXME: Provide a known merge target to the second and subsequent such
2097     // declaration.
2098     for (unsigned I = 0; I != N; ++I)
2099       MergeWith = ReadDecl(Record, Idx/*, MergeWith*/);
2100   }
2101 
2102   T *FirstDecl = cast_or_null<T>(Reader.GetDecl(FirstDeclID));
2103   if (FirstDecl != D) {
2104     // We delay loading of the redeclaration chain to avoid deeply nested calls.
2105     // We temporarily set the first (canonical) declaration as the previous one
2106     // which is the one that matters and mark the real previous DeclID to be
2107     // loaded & attached later on.
2108     D->RedeclLink = Redeclarable<T>::PreviousDeclLink(FirstDecl);
2109   }
2110 
2111   // Note that this declaration has been deserialized.
2112   Reader.RedeclsDeserialized.insert(static_cast<T *>(D));
2113 
2114   // The result structure takes care to note that we need to load the
2115   // other declaration chains for this ID.
2116   return RedeclarableResult(Reader, FirstDeclID, MergeWith,
2117                             static_cast<T *>(D)->getKind());
2118 }
2119 
2120 /// \brief Attempts to merge the given declaration (D) with another declaration
2121 /// of the same entity.
2122 template<typename T>
2123 void ASTDeclReader::mergeRedeclarable(Redeclarable<T> *DBase,
2124                                       RedeclarableResult &Redecl,
2125                                       DeclID TemplatePatternID) {
2126   T *D = static_cast<T*>(DBase);
2127 
2128   // If modules are not available, there is no reason to perform this merge.
2129   if (!Reader.getContext().getLangOpts().Modules)
2130     return;
2131 
2132   // If we're not the canonical declaration, we don't need to merge.
2133   if (!DBase->isFirstDecl())
2134     return;
2135 
2136   if (auto *Existing = Redecl.getKnownMergeTarget())
2137     // We already know of an existing declaration we should merge with.
2138     mergeRedeclarable(D, cast<T>(Existing), Redecl, TemplatePatternID);
2139   else if (FindExistingResult ExistingRes = findExisting(D))
2140     if (T *Existing = ExistingRes)
2141       mergeRedeclarable(D, Existing, Redecl, TemplatePatternID);
2142 }
2143 
2144 /// \brief "Cast" to type T, asserting if we don't have an implicit conversion.
2145 /// We use this to put code in a template that will only be valid for certain
2146 /// instantiations.
2147 template<typename T> static T assert_cast(T t) { return t; }
2148 template<typename T> static T assert_cast(...) {
2149   llvm_unreachable("bad assert_cast");
2150 }
2151 
2152 /// \brief Merge together the pattern declarations from two template
2153 /// declarations.
2154 void ASTDeclReader::mergeTemplatePattern(RedeclarableTemplateDecl *D,
2155                                          RedeclarableTemplateDecl *Existing,
2156                                          DeclID DsID) {
2157   auto *DPattern = D->getTemplatedDecl();
2158   auto *ExistingPattern = Existing->getTemplatedDecl();
2159   RedeclarableResult Result(Reader, DPattern->getCanonicalDecl()->getGlobalID(),
2160                             /*MergeWith*/ExistingPattern, DPattern->getKind());
2161 
2162   if (auto *DClass = dyn_cast<CXXRecordDecl>(DPattern)) {
2163     // Merge with any existing definition.
2164     // FIXME: This is duplicated in several places. Refactor.
2165     auto *ExistingClass =
2166         cast<CXXRecordDecl>(ExistingPattern)->getCanonicalDecl();
2167     if (auto *DDD = DClass->DefinitionData.getNotUpdated()) {
2168       if (auto *ExistingDD = ExistingClass->DefinitionData.getNotUpdated()) {
2169         MergeDefinitionData(ExistingClass, std::move(*DDD));
2170         Reader.PendingDefinitions.erase(DClass);
2171         Reader.MergedDeclContexts.insert(
2172             std::make_pair(DClass, ExistingDD->Definition));
2173         DClass->IsCompleteDefinition = false;
2174       } else {
2175         ExistingClass->DefinitionData = DClass->DefinitionData;
2176         Reader.PendingDefinitions.insert(DClass);
2177       }
2178     }
2179     DClass->DefinitionData = ExistingClass->DefinitionData;
2180 
2181     return mergeRedeclarable(DClass, cast<TagDecl>(ExistingPattern),
2182                              Result);
2183   }
2184   if (auto *DFunction = dyn_cast<FunctionDecl>(DPattern))
2185     return mergeRedeclarable(DFunction, cast<FunctionDecl>(ExistingPattern),
2186                              Result);
2187   if (auto *DVar = dyn_cast<VarDecl>(DPattern))
2188     return mergeRedeclarable(DVar, cast<VarDecl>(ExistingPattern), Result);
2189   if (auto *DAlias = dyn_cast<TypeAliasDecl>(DPattern))
2190     return mergeRedeclarable(DAlias, cast<TypedefNameDecl>(ExistingPattern),
2191                              Result);
2192   llvm_unreachable("merged an unknown kind of redeclarable template");
2193 }
2194 
2195 /// \brief Attempts to merge the given declaration (D) with another declaration
2196 /// of the same entity.
2197 template<typename T>
2198 void ASTDeclReader::mergeRedeclarable(Redeclarable<T> *DBase, T *Existing,
2199                                       RedeclarableResult &Redecl,
2200                                       DeclID TemplatePatternID) {
2201   T *D = static_cast<T*>(DBase);
2202   T *ExistingCanon = Existing->getCanonicalDecl();
2203   T *DCanon = D->getCanonicalDecl();
2204   if (ExistingCanon != DCanon) {
2205     assert(DCanon->getGlobalID() == Redecl.getFirstID() &&
2206            "already merged this declaration");
2207 
2208     // Have our redeclaration link point back at the canonical declaration
2209     // of the existing declaration, so that this declaration has the
2210     // appropriate canonical declaration.
2211     D->RedeclLink = Redeclarable<T>::PreviousDeclLink(ExistingCanon);
2212 
2213     // When we merge a namespace, update its pointer to the first namespace.
2214     // We cannot have loaded any redeclarations of this declaration yet, so
2215     // there's nothing else that needs to be updated.
2216     if (auto *Namespace = dyn_cast<NamespaceDecl>(D))
2217       Namespace->AnonOrFirstNamespaceAndInline.setPointer(
2218           assert_cast<NamespaceDecl*>(ExistingCanon));
2219 
2220     // When we merge a template, merge its pattern.
2221     if (auto *DTemplate = dyn_cast<RedeclarableTemplateDecl>(D))
2222       mergeTemplatePattern(
2223           DTemplate, assert_cast<RedeclarableTemplateDecl*>(ExistingCanon),
2224           TemplatePatternID);
2225 
2226     // If this declaration was the canonical declaration, make a note of that.
2227     if (DCanon == D) {
2228       Reader.MergedDecls[ExistingCanon].push_back(Redecl.getFirstID());
2229       if (Reader.PendingDeclChainsKnown.insert(ExistingCanon).second)
2230         Reader.PendingDeclChains.push_back(ExistingCanon);
2231     }
2232   }
2233 }
2234 
2235 /// \brief Attempts to merge the given declaration (D) with another declaration
2236 /// of the same entity, for the case where the entity is not actually
2237 /// redeclarable. This happens, for instance, when merging the fields of
2238 /// identical class definitions from two different modules.
2239 template<typename T>
2240 void ASTDeclReader::mergeMergeable(Mergeable<T> *D) {
2241   // If modules are not available, there is no reason to perform this merge.
2242   if (!Reader.getContext().getLangOpts().Modules)
2243     return;
2244 
2245   // ODR-based merging is only performed in C++. In C, identically-named things
2246   // in different translation units are not redeclarations (but may still have
2247   // compatible types).
2248   if (!Reader.getContext().getLangOpts().CPlusPlus)
2249     return;
2250 
2251   if (FindExistingResult ExistingRes = findExisting(static_cast<T*>(D)))
2252     if (T *Existing = ExistingRes)
2253       Reader.Context.setPrimaryMergedDecl(static_cast<T*>(D),
2254                                           Existing->getCanonicalDecl());
2255 }
2256 
2257 void ASTDeclReader::VisitOMPThreadPrivateDecl(OMPThreadPrivateDecl *D) {
2258   VisitDecl(D);
2259   unsigned NumVars = D->varlist_size();
2260   SmallVector<Expr *, 16> Vars;
2261   Vars.reserve(NumVars);
2262   for (unsigned i = 0; i != NumVars; ++i) {
2263     Vars.push_back(Reader.ReadExpr(F));
2264   }
2265   D->setVars(Vars);
2266 }
2267 
2268 //===----------------------------------------------------------------------===//
2269 // Attribute Reading
2270 //===----------------------------------------------------------------------===//
2271 
2272 /// \brief Reads attributes from the current stream position.
2273 void ASTReader::ReadAttributes(ModuleFile &F, AttrVec &Attrs,
2274                                const RecordData &Record, unsigned &Idx) {
2275   for (unsigned i = 0, e = Record[Idx++]; i != e; ++i) {
2276     Attr *New = nullptr;
2277     attr::Kind Kind = (attr::Kind)Record[Idx++];
2278     SourceRange Range = ReadSourceRange(F, Record, Idx);
2279 
2280 #include "clang/Serialization/AttrPCHRead.inc"
2281 
2282     assert(New && "Unable to decode attribute?");
2283     Attrs.push_back(New);
2284   }
2285 }
2286 
2287 //===----------------------------------------------------------------------===//
2288 // ASTReader Implementation
2289 //===----------------------------------------------------------------------===//
2290 
2291 /// \brief Note that we have loaded the declaration with the given
2292 /// Index.
2293 ///
2294 /// This routine notes that this declaration has already been loaded,
2295 /// so that future GetDecl calls will return this declaration rather
2296 /// than trying to load a new declaration.
2297 inline void ASTReader::LoadedDecl(unsigned Index, Decl *D) {
2298   assert(!DeclsLoaded[Index] && "Decl loaded twice?");
2299   DeclsLoaded[Index] = D;
2300 }
2301 
2302 
2303 /// \brief Determine whether the consumer will be interested in seeing
2304 /// this declaration (via HandleTopLevelDecl).
2305 ///
2306 /// This routine should return true for anything that might affect
2307 /// code generation, e.g., inline function definitions, Objective-C
2308 /// declarations with metadata, etc.
2309 static bool isConsumerInterestedIn(Decl *D, bool HasBody) {
2310   // An ObjCMethodDecl is never considered as "interesting" because its
2311   // implementation container always is.
2312 
2313   if (isa<FileScopeAsmDecl>(D) ||
2314       isa<ObjCProtocolDecl>(D) ||
2315       isa<ObjCImplDecl>(D) ||
2316       isa<ImportDecl>(D) ||
2317       isa<OMPThreadPrivateDecl>(D))
2318     return true;
2319   if (VarDecl *Var = dyn_cast<VarDecl>(D))
2320     return Var->isFileVarDecl() &&
2321            Var->isThisDeclarationADefinition() == VarDecl::Definition;
2322   if (FunctionDecl *Func = dyn_cast<FunctionDecl>(D))
2323     return Func->doesThisDeclarationHaveABody() || HasBody;
2324 
2325   return false;
2326 }
2327 
2328 /// \brief Get the correct cursor and offset for loading a declaration.
2329 ASTReader::RecordLocation
2330 ASTReader::DeclCursorForID(DeclID ID, unsigned &RawLocation) {
2331   // See if there's an override.
2332   DeclReplacementMap::iterator It = ReplacedDecls.find(ID);
2333   if (It != ReplacedDecls.end()) {
2334     RawLocation = It->second.RawLoc;
2335     return RecordLocation(It->second.Mod, It->second.Offset);
2336   }
2337 
2338   GlobalDeclMapType::iterator I = GlobalDeclMap.find(ID);
2339   assert(I != GlobalDeclMap.end() && "Corrupted global declaration map");
2340   ModuleFile *M = I->second;
2341   const DeclOffset &
2342     DOffs =  M->DeclOffsets[ID - M->BaseDeclID - NUM_PREDEF_DECL_IDS];
2343   RawLocation = DOffs.Loc;
2344   return RecordLocation(M, DOffs.BitOffset);
2345 }
2346 
2347 ASTReader::RecordLocation ASTReader::getLocalBitOffset(uint64_t GlobalOffset) {
2348   ContinuousRangeMap<uint64_t, ModuleFile*, 4>::iterator I
2349     = GlobalBitOffsetsMap.find(GlobalOffset);
2350 
2351   assert(I != GlobalBitOffsetsMap.end() && "Corrupted global bit offsets map");
2352   return RecordLocation(I->second, GlobalOffset - I->second->GlobalBitOffset);
2353 }
2354 
2355 uint64_t ASTReader::getGlobalBitOffset(ModuleFile &M, uint32_t LocalOffset) {
2356   return LocalOffset + M.GlobalBitOffset;
2357 }
2358 
2359 static bool isSameTemplateParameterList(const TemplateParameterList *X,
2360                                         const TemplateParameterList *Y);
2361 
2362 /// \brief Determine whether two template parameters are similar enough
2363 /// that they may be used in declarations of the same template.
2364 static bool isSameTemplateParameter(const NamedDecl *X,
2365                                     const NamedDecl *Y) {
2366   if (X->getKind() != Y->getKind())
2367     return false;
2368 
2369   if (const TemplateTypeParmDecl *TX = dyn_cast<TemplateTypeParmDecl>(X)) {
2370     const TemplateTypeParmDecl *TY = cast<TemplateTypeParmDecl>(Y);
2371     return TX->isParameterPack() == TY->isParameterPack();
2372   }
2373 
2374   if (const NonTypeTemplateParmDecl *TX = dyn_cast<NonTypeTemplateParmDecl>(X)) {
2375     const NonTypeTemplateParmDecl *TY = cast<NonTypeTemplateParmDecl>(Y);
2376     return TX->isParameterPack() == TY->isParameterPack() &&
2377            TX->getASTContext().hasSameType(TX->getType(), TY->getType());
2378   }
2379 
2380   const TemplateTemplateParmDecl *TX = cast<TemplateTemplateParmDecl>(X);
2381   const TemplateTemplateParmDecl *TY = cast<TemplateTemplateParmDecl>(Y);
2382   return TX->isParameterPack() == TY->isParameterPack() &&
2383          isSameTemplateParameterList(TX->getTemplateParameters(),
2384                                      TY->getTemplateParameters());
2385 }
2386 
2387 static NamespaceDecl *getNamespace(const NestedNameSpecifier *X) {
2388   if (auto *NS = X->getAsNamespace())
2389     return NS;
2390   if (auto *NAS = X->getAsNamespaceAlias())
2391     return NAS->getNamespace();
2392   return nullptr;
2393 }
2394 
2395 static bool isSameQualifier(const NestedNameSpecifier *X,
2396                             const NestedNameSpecifier *Y) {
2397   if (auto *NSX = getNamespace(X)) {
2398     auto *NSY = getNamespace(Y);
2399     if (!NSY || NSX->getCanonicalDecl() != NSY->getCanonicalDecl())
2400       return false;
2401   } else if (X->getKind() != Y->getKind())
2402     return false;
2403 
2404   // FIXME: For namespaces and types, we're permitted to check that the entity
2405   // is named via the same tokens. We should probably do so.
2406   switch (X->getKind()) {
2407   case NestedNameSpecifier::Identifier:
2408     if (X->getAsIdentifier() != Y->getAsIdentifier())
2409       return false;
2410     break;
2411   case NestedNameSpecifier::Namespace:
2412   case NestedNameSpecifier::NamespaceAlias:
2413     // We've already checked that we named the same namespace.
2414     break;
2415   case NestedNameSpecifier::TypeSpec:
2416   case NestedNameSpecifier::TypeSpecWithTemplate:
2417     if (X->getAsType()->getCanonicalTypeInternal() !=
2418         Y->getAsType()->getCanonicalTypeInternal())
2419       return false;
2420     break;
2421   case NestedNameSpecifier::Global:
2422   case NestedNameSpecifier::Super:
2423     return true;
2424   }
2425 
2426   // Recurse into earlier portion of NNS, if any.
2427   auto *PX = X->getPrefix();
2428   auto *PY = Y->getPrefix();
2429   if (PX && PY)
2430     return isSameQualifier(PX, PY);
2431   return !PX && !PY;
2432 }
2433 
2434 /// \brief Determine whether two template parameter lists are similar enough
2435 /// that they may be used in declarations of the same template.
2436 static bool isSameTemplateParameterList(const TemplateParameterList *X,
2437                                         const TemplateParameterList *Y) {
2438   if (X->size() != Y->size())
2439     return false;
2440 
2441   for (unsigned I = 0, N = X->size(); I != N; ++I)
2442     if (!isSameTemplateParameter(X->getParam(I), Y->getParam(I)))
2443       return false;
2444 
2445   return true;
2446 }
2447 
2448 /// \brief Determine whether the two declarations refer to the same entity.
2449 static bool isSameEntity(NamedDecl *X, NamedDecl *Y) {
2450   assert(X->getDeclName() == Y->getDeclName() && "Declaration name mismatch!");
2451 
2452   if (X == Y)
2453     return true;
2454 
2455   // Must be in the same context.
2456   if (!X->getDeclContext()->getRedeclContext()->Equals(
2457          Y->getDeclContext()->getRedeclContext()))
2458     return false;
2459 
2460   // Two typedefs refer to the same entity if they have the same underlying
2461   // type.
2462   if (TypedefNameDecl *TypedefX = dyn_cast<TypedefNameDecl>(X))
2463     if (TypedefNameDecl *TypedefY = dyn_cast<TypedefNameDecl>(Y))
2464       return X->getASTContext().hasSameType(TypedefX->getUnderlyingType(),
2465                                             TypedefY->getUnderlyingType());
2466 
2467   // Must have the same kind.
2468   if (X->getKind() != Y->getKind())
2469     return false;
2470 
2471   // Objective-C classes and protocols with the same name always match.
2472   if (isa<ObjCInterfaceDecl>(X) || isa<ObjCProtocolDecl>(X))
2473     return true;
2474 
2475   if (isa<ClassTemplateSpecializationDecl>(X)) {
2476     // No need to handle these here: we merge them when adding them to the
2477     // template.
2478     return false;
2479   }
2480 
2481   // Compatible tags match.
2482   if (TagDecl *TagX = dyn_cast<TagDecl>(X)) {
2483     TagDecl *TagY = cast<TagDecl>(Y);
2484     return (TagX->getTagKind() == TagY->getTagKind()) ||
2485       ((TagX->getTagKind() == TTK_Struct || TagX->getTagKind() == TTK_Class ||
2486         TagX->getTagKind() == TTK_Interface) &&
2487        (TagY->getTagKind() == TTK_Struct || TagY->getTagKind() == TTK_Class ||
2488         TagY->getTagKind() == TTK_Interface));
2489   }
2490 
2491   // Functions with the same type and linkage match.
2492   // FIXME: This needs to cope with merging of prototyped/non-prototyped
2493   // functions, etc.
2494   if (FunctionDecl *FuncX = dyn_cast<FunctionDecl>(X)) {
2495     FunctionDecl *FuncY = cast<FunctionDecl>(Y);
2496     return (FuncX->getLinkageInternal() == FuncY->getLinkageInternal()) &&
2497       FuncX->getASTContext().hasSameType(FuncX->getType(), FuncY->getType());
2498   }
2499 
2500   // Variables with the same type and linkage match.
2501   if (VarDecl *VarX = dyn_cast<VarDecl>(X)) {
2502     VarDecl *VarY = cast<VarDecl>(Y);
2503     return (VarX->getLinkageInternal() == VarY->getLinkageInternal()) &&
2504       VarX->getASTContext().hasSameType(VarX->getType(), VarY->getType());
2505   }
2506 
2507   // Namespaces with the same name and inlinedness match.
2508   if (NamespaceDecl *NamespaceX = dyn_cast<NamespaceDecl>(X)) {
2509     NamespaceDecl *NamespaceY = cast<NamespaceDecl>(Y);
2510     return NamespaceX->isInline() == NamespaceY->isInline();
2511   }
2512 
2513   // Identical template names and kinds match if their template parameter lists
2514   // and patterns match.
2515   if (TemplateDecl *TemplateX = dyn_cast<TemplateDecl>(X)) {
2516     TemplateDecl *TemplateY = cast<TemplateDecl>(Y);
2517     return isSameEntity(TemplateX->getTemplatedDecl(),
2518                         TemplateY->getTemplatedDecl()) &&
2519            isSameTemplateParameterList(TemplateX->getTemplateParameters(),
2520                                        TemplateY->getTemplateParameters());
2521   }
2522 
2523   // Fields with the same name and the same type match.
2524   if (FieldDecl *FDX = dyn_cast<FieldDecl>(X)) {
2525     FieldDecl *FDY = cast<FieldDecl>(Y);
2526     // FIXME: Also check the bitwidth is odr-equivalent, if any.
2527     return X->getASTContext().hasSameType(FDX->getType(), FDY->getType());
2528   }
2529 
2530   // Enumerators with the same name match.
2531   if (isa<EnumConstantDecl>(X))
2532     // FIXME: Also check the value is odr-equivalent.
2533     return true;
2534 
2535   // Using shadow declarations with the same target match.
2536   if (UsingShadowDecl *USX = dyn_cast<UsingShadowDecl>(X)) {
2537     UsingShadowDecl *USY = cast<UsingShadowDecl>(Y);
2538     return USX->getTargetDecl() == USY->getTargetDecl();
2539   }
2540 
2541   // Using declarations with the same qualifier match. (We already know that
2542   // the name matches.)
2543   if (auto *UX = dyn_cast<UsingDecl>(X)) {
2544     auto *UY = cast<UsingDecl>(Y);
2545     return isSameQualifier(UX->getQualifier(), UY->getQualifier()) &&
2546            UX->hasTypename() == UY->hasTypename() &&
2547            UX->isAccessDeclaration() == UY->isAccessDeclaration();
2548   }
2549   if (auto *UX = dyn_cast<UnresolvedUsingValueDecl>(X)) {
2550     auto *UY = cast<UnresolvedUsingValueDecl>(Y);
2551     return isSameQualifier(UX->getQualifier(), UY->getQualifier()) &&
2552            UX->isAccessDeclaration() == UY->isAccessDeclaration();
2553   }
2554   if (auto *UX = dyn_cast<UnresolvedUsingTypenameDecl>(X))
2555     return isSameQualifier(
2556         UX->getQualifier(),
2557         cast<UnresolvedUsingTypenameDecl>(Y)->getQualifier());
2558 
2559   // Namespace alias definitions with the same target match.
2560   if (auto *NAX = dyn_cast<NamespaceAliasDecl>(X)) {
2561     auto *NAY = cast<NamespaceAliasDecl>(Y);
2562     return NAX->getNamespace()->Equals(NAY->getNamespace());
2563   }
2564 
2565   // FIXME: Many other cases to implement.
2566   return false;
2567 }
2568 
2569 /// Find the context in which we should search for previous declarations when
2570 /// looking for declarations to merge.
2571 DeclContext *ASTDeclReader::getPrimaryContextForMerging(ASTReader &Reader,
2572                                                         DeclContext *DC) {
2573   if (NamespaceDecl *ND = dyn_cast<NamespaceDecl>(DC))
2574     return ND->getOriginalNamespace();
2575 
2576   if (CXXRecordDecl *RD = dyn_cast<CXXRecordDecl>(DC)) {
2577     // Try to dig out the definition.
2578     auto *DD = RD->DefinitionData.getNotUpdated();
2579     if (!DD)
2580       DD = RD->getCanonicalDecl()->DefinitionData.getNotUpdated();
2581 
2582     // If there's no definition yet, then DC's definition is added by an update
2583     // record, but we've not yet loaded that update record. In this case, we
2584     // commit to DC being the canonical definition now, and will fix this when
2585     // we load the update record.
2586     if (!DD) {
2587       DD = new (Reader.Context) struct CXXRecordDecl::DefinitionData(RD);
2588       RD->IsCompleteDefinition = true;
2589       RD->DefinitionData = DD;
2590       RD->getCanonicalDecl()->DefinitionData = DD;
2591 
2592       // Track that we did this horrible thing so that we can fix it later.
2593       Reader.PendingFakeDefinitionData.insert(
2594           std::make_pair(DD, ASTReader::PendingFakeDefinitionKind::Fake));
2595     }
2596 
2597     return DD->Definition;
2598   }
2599 
2600   if (EnumDecl *ED = dyn_cast<EnumDecl>(DC))
2601     return ED->getASTContext().getLangOpts().CPlusPlus? ED->getDefinition()
2602                                                       : nullptr;
2603 
2604   // We can see the TU here only if we have no Sema object. In that case,
2605   // there's no TU scope to look in, so using the DC alone is sufficient.
2606   if (auto *TU = dyn_cast<TranslationUnitDecl>(DC))
2607     return TU;
2608 
2609   return nullptr;
2610 }
2611 
2612 ASTDeclReader::FindExistingResult::~FindExistingResult() {
2613   // Record that we had a typedef name for linkage whether or not we merge
2614   // with that declaration.
2615   if (TypedefNameForLinkage) {
2616     DeclContext *DC = New->getDeclContext()->getRedeclContext();
2617     Reader.ImportedTypedefNamesForLinkage.insert(
2618         std::make_pair(std::make_pair(DC, TypedefNameForLinkage), New));
2619     return;
2620   }
2621 
2622   if (!AddResult || Existing)
2623     return;
2624 
2625   DeclarationName Name = New->getDeclName();
2626   DeclContext *DC = New->getDeclContext()->getRedeclContext();
2627   if (needsAnonymousDeclarationNumber(New)) {
2628     setAnonymousDeclForMerging(Reader, New->getLexicalDeclContext(),
2629                                AnonymousDeclNumber, New);
2630   } else if (DC->isTranslationUnit() && Reader.SemaObj &&
2631              !Reader.getContext().getLangOpts().CPlusPlus) {
2632     if (Reader.SemaObj->IdResolver.tryAddTopLevelDecl(New, Name))
2633       Reader.PendingFakeLookupResults[Name.getAsIdentifierInfo()]
2634             .push_back(New);
2635   } else if (DeclContext *MergeDC = getPrimaryContextForMerging(Reader, DC)) {
2636     // Add the declaration to its redeclaration context so later merging
2637     // lookups will find it.
2638     MergeDC->makeDeclVisibleInContextImpl(New, /*Internal*/true);
2639   }
2640 }
2641 
2642 /// Find the declaration that should be merged into, given the declaration found
2643 /// by name lookup. If we're merging an anonymous declaration within a typedef,
2644 /// we need a matching typedef, and we merge with the type inside it.
2645 static NamedDecl *getDeclForMerging(NamedDecl *Found,
2646                                     bool IsTypedefNameForLinkage) {
2647   if (!IsTypedefNameForLinkage)
2648     return Found;
2649 
2650   // If we found a typedef declaration that gives a name to some other
2651   // declaration, then we want that inner declaration. Declarations from
2652   // AST files are handled via ImportedTypedefNamesForLinkage.
2653   if (Found->isFromASTFile()) return 0;
2654   if (auto *TND = dyn_cast<TypedefNameDecl>(Found)) {
2655     if (auto *TT = TND->getTypeSourceInfo()->getType()->getAs<TagType>())
2656       if (TT->getDecl()->getTypedefNameForAnonDecl() == TND)
2657         return TT->getDecl();
2658   }
2659 
2660   return 0;
2661 }
2662 
2663 NamedDecl *ASTDeclReader::getAnonymousDeclForMerging(ASTReader &Reader,
2664                                                      DeclContext *DC,
2665                                                      unsigned Index) {
2666   // If the lexical context has been merged, look into the now-canonical
2667   // definition.
2668   if (auto *Merged = Reader.MergedDeclContexts.lookup(DC))
2669     DC = Merged;
2670 
2671   // If we've seen this before, return the canonical declaration.
2672   auto &Previous = Reader.AnonymousDeclarationsForMerging[DC];
2673   if (Index < Previous.size() && Previous[Index])
2674     return Previous[Index];
2675 
2676   // If this is the first time, but we have parsed a declaration of the context,
2677   // build the anonymous declaration list from the parsed declaration.
2678   if (!cast<Decl>(DC)->isFromASTFile()) {
2679     numberAnonymousDeclsWithin(DC, [&](NamedDecl *ND, unsigned Number) {
2680       if (Previous.size() == Number)
2681         Previous.push_back(cast<NamedDecl>(ND->getCanonicalDecl()));
2682       else
2683         Previous[Number] = cast<NamedDecl>(ND->getCanonicalDecl());
2684     });
2685   }
2686 
2687   return Index < Previous.size() ? Previous[Index] : nullptr;
2688 }
2689 
2690 void ASTDeclReader::setAnonymousDeclForMerging(ASTReader &Reader,
2691                                                DeclContext *DC, unsigned Index,
2692                                                NamedDecl *D) {
2693   if (auto *Merged = Reader.MergedDeclContexts.lookup(DC))
2694     DC = Merged;
2695 
2696   auto &Previous = Reader.AnonymousDeclarationsForMerging[DC];
2697   if (Index >= Previous.size())
2698     Previous.resize(Index + 1);
2699   if (!Previous[Index])
2700     Previous[Index] = D;
2701 }
2702 
2703 ASTDeclReader::FindExistingResult ASTDeclReader::findExisting(NamedDecl *D) {
2704   DeclarationName Name = TypedefNameForLinkage ? TypedefNameForLinkage
2705                                                : D->getDeclName();
2706 
2707   if (!Name && !needsAnonymousDeclarationNumber(D)) {
2708     // Don't bother trying to find unnamed declarations that are in
2709     // unmergeable contexts.
2710     FindExistingResult Result(Reader, D, /*Existing=*/nullptr,
2711                               AnonymousDeclNumber, TypedefNameForLinkage);
2712     Result.suppress();
2713     return Result;
2714   }
2715 
2716   // FIXME: Bail out for non-canonical declarations. We will have performed any
2717   // necessary merging already.
2718 
2719   DeclContext *DC = D->getDeclContext()->getRedeclContext();
2720   if (TypedefNameForLinkage) {
2721     auto It = Reader.ImportedTypedefNamesForLinkage.find(
2722         std::make_pair(DC, TypedefNameForLinkage));
2723     if (It != Reader.ImportedTypedefNamesForLinkage.end())
2724       if (isSameEntity(It->second, D))
2725         return FindExistingResult(Reader, D, It->second, AnonymousDeclNumber,
2726                                   TypedefNameForLinkage);
2727     // Go on to check in other places in case an existing typedef name
2728     // was not imported.
2729   }
2730 
2731   if (needsAnonymousDeclarationNumber(D)) {
2732     // This is an anonymous declaration that we may need to merge. Look it up
2733     // in its context by number.
2734     if (auto *Existing = getAnonymousDeclForMerging(
2735             Reader, D->getLexicalDeclContext(), AnonymousDeclNumber))
2736       if (isSameEntity(Existing, D))
2737         return FindExistingResult(Reader, D, Existing, AnonymousDeclNumber,
2738                                   TypedefNameForLinkage);
2739   } else if (DC->isTranslationUnit() && Reader.SemaObj &&
2740              !Reader.getContext().getLangOpts().CPlusPlus) {
2741     IdentifierResolver &IdResolver = Reader.SemaObj->IdResolver;
2742 
2743     // Temporarily consider the identifier to be up-to-date. We don't want to
2744     // cause additional lookups here.
2745     class UpToDateIdentifierRAII {
2746       IdentifierInfo *II;
2747       bool WasOutToDate;
2748 
2749     public:
2750       explicit UpToDateIdentifierRAII(IdentifierInfo *II)
2751         : II(II), WasOutToDate(false)
2752       {
2753         if (II) {
2754           WasOutToDate = II->isOutOfDate();
2755           if (WasOutToDate)
2756             II->setOutOfDate(false);
2757         }
2758       }
2759 
2760       ~UpToDateIdentifierRAII() {
2761         if (WasOutToDate)
2762           II->setOutOfDate(true);
2763       }
2764     } UpToDate(Name.getAsIdentifierInfo());
2765 
2766     for (IdentifierResolver::iterator I = IdResolver.begin(Name),
2767                                    IEnd = IdResolver.end();
2768          I != IEnd; ++I) {
2769       if (NamedDecl *Existing = getDeclForMerging(*I, TypedefNameForLinkage))
2770         if (isSameEntity(Existing, D))
2771           return FindExistingResult(Reader, D, Existing, AnonymousDeclNumber,
2772                                     TypedefNameForLinkage);
2773     }
2774   } else if (DeclContext *MergeDC = getPrimaryContextForMerging(Reader, DC)) {
2775     DeclContext::lookup_result R = MergeDC->noload_lookup(Name);
2776     for (DeclContext::lookup_iterator I = R.begin(), E = R.end(); I != E; ++I) {
2777       if (NamedDecl *Existing = getDeclForMerging(*I, TypedefNameForLinkage))
2778         if (isSameEntity(Existing, D))
2779           return FindExistingResult(Reader, D, Existing, AnonymousDeclNumber,
2780                                     TypedefNameForLinkage);
2781     }
2782   } else {
2783     // Not in a mergeable context.
2784     return FindExistingResult(Reader);
2785   }
2786 
2787   // If this declaration is from a merged context, make a note that we need to
2788   // check that the canonical definition of that context contains the decl.
2789   //
2790   // FIXME: We should do something similar if we merge two definitions of the
2791   // same template specialization into the same CXXRecordDecl.
2792   auto MergedDCIt = Reader.MergedDeclContexts.find(D->getLexicalDeclContext());
2793   if (MergedDCIt != Reader.MergedDeclContexts.end() &&
2794       MergedDCIt->second == D->getDeclContext())
2795     Reader.PendingOdrMergeChecks.push_back(D);
2796 
2797   return FindExistingResult(Reader, D, /*Existing=*/nullptr,
2798                             AnonymousDeclNumber, TypedefNameForLinkage);
2799 }
2800 
2801 template<typename DeclT>
2802 Decl *ASTDeclReader::getMostRecentDeclImpl(Redeclarable<DeclT> *D) {
2803   return D->RedeclLink.getLatestNotUpdated();
2804 }
2805 Decl *ASTDeclReader::getMostRecentDeclImpl(...) {
2806   llvm_unreachable("getMostRecentDecl on non-redeclarable declaration");
2807 }
2808 
2809 Decl *ASTDeclReader::getMostRecentDecl(Decl *D) {
2810   assert(D);
2811 
2812   switch (D->getKind()) {
2813 #define ABSTRACT_DECL(TYPE)
2814 #define DECL(TYPE, BASE)                               \
2815   case Decl::TYPE:                                     \
2816     return getMostRecentDeclImpl(cast<TYPE##Decl>(D));
2817 #include "clang/AST/DeclNodes.inc"
2818   }
2819   llvm_unreachable("unknown decl kind");
2820 }
2821 
2822 Decl *ASTReader::getMostRecentExistingDecl(Decl *D) {
2823   return ASTDeclReader::getMostRecentDecl(D->getCanonicalDecl());
2824 }
2825 
2826 template<typename DeclT>
2827 void ASTDeclReader::attachPreviousDeclImpl(ASTReader &Reader,
2828                                            Redeclarable<DeclT> *D,
2829                                            Decl *Previous, Decl *Canon) {
2830   D->RedeclLink.setPrevious(cast<DeclT>(Previous));
2831 }
2832 namespace clang {
2833 template<>
2834 void ASTDeclReader::attachPreviousDeclImpl(ASTReader &Reader,
2835                                            Redeclarable<FunctionDecl> *D,
2836                                            Decl *Previous, Decl *Canon) {
2837   FunctionDecl *FD = static_cast<FunctionDecl*>(D);
2838   FunctionDecl *PrevFD = cast<FunctionDecl>(Previous);
2839 
2840   FD->RedeclLink.setPrevious(PrevFD);
2841 
2842   // If the previous declaration is an inline function declaration, then this
2843   // declaration is too.
2844   if (PrevFD->IsInline != FD->IsInline) {
2845     // FIXME: [dcl.fct.spec]p4:
2846     //   If a function with external linkage is declared inline in one
2847     //   translation unit, it shall be declared inline in all translation
2848     //   units in which it appears.
2849     //
2850     // Be careful of this case:
2851     //
2852     // module A:
2853     //   template<typename T> struct X { void f(); };
2854     //   template<typename T> inline void X<T>::f() {}
2855     //
2856     // module B instantiates the declaration of X<int>::f
2857     // module C instantiates the definition of X<int>::f
2858     //
2859     // If module B and C are merged, we do not have a violation of this rule.
2860     FD->IsInline = true;
2861   }
2862 
2863   // If we need to propagate an exception specification along the redecl
2864   // chain, make a note of that so that we can do so later.
2865   auto *FPT = FD->getType()->getAs<FunctionProtoType>();
2866   auto *PrevFPT = PrevFD->getType()->getAs<FunctionProtoType>();
2867   if (FPT && PrevFPT) {
2868     bool IsUnresolved = isUnresolvedExceptionSpec(FPT->getExceptionSpecType());
2869     bool WasUnresolved =
2870         isUnresolvedExceptionSpec(PrevFPT->getExceptionSpecType());
2871     if (IsUnresolved != WasUnresolved)
2872       Reader.PendingExceptionSpecUpdates.insert(
2873           std::make_pair(Canon, IsUnresolved ? PrevFD : FD));
2874   }
2875 }
2876 }
2877 void ASTDeclReader::attachPreviousDeclImpl(ASTReader &Reader, ...) {
2878   llvm_unreachable("attachPreviousDecl on non-redeclarable declaration");
2879 }
2880 
2881 void ASTDeclReader::attachPreviousDecl(ASTReader &Reader, Decl *D,
2882                                        Decl *Previous, Decl *Canon) {
2883   assert(D && Previous);
2884 
2885   switch (D->getKind()) {
2886 #define ABSTRACT_DECL(TYPE)
2887 #define DECL(TYPE, BASE)                                                  \
2888   case Decl::TYPE:                                                        \
2889     attachPreviousDeclImpl(Reader, cast<TYPE##Decl>(D), Previous, Canon); \
2890     break;
2891 #include "clang/AST/DeclNodes.inc"
2892   }
2893 
2894   // If the declaration was visible in one module, a redeclaration of it in
2895   // another module remains visible even if it wouldn't be visible by itself.
2896   //
2897   // FIXME: In this case, the declaration should only be visible if a module
2898   //        that makes it visible has been imported.
2899   D->IdentifierNamespace |=
2900       Previous->IdentifierNamespace &
2901       (Decl::IDNS_Ordinary | Decl::IDNS_Tag | Decl::IDNS_Type);
2902 
2903   // If the previous declaration is marked as used, then this declaration should
2904   // be too.
2905   if (Previous->Used)
2906     D->Used = true;
2907 }
2908 
2909 template<typename DeclT>
2910 void ASTDeclReader::attachLatestDeclImpl(Redeclarable<DeclT> *D, Decl *Latest) {
2911   D->RedeclLink.setLatest(cast<DeclT>(Latest));
2912 }
2913 void ASTDeclReader::attachLatestDeclImpl(...) {
2914   llvm_unreachable("attachLatestDecl on non-redeclarable declaration");
2915 }
2916 
2917 void ASTDeclReader::attachLatestDecl(Decl *D, Decl *Latest) {
2918   assert(D && Latest);
2919 
2920   switch (D->getKind()) {
2921 #define ABSTRACT_DECL(TYPE)
2922 #define DECL(TYPE, BASE)                                  \
2923   case Decl::TYPE:                                        \
2924     attachLatestDeclImpl(cast<TYPE##Decl>(D), Latest); \
2925     break;
2926 #include "clang/AST/DeclNodes.inc"
2927   }
2928 }
2929 
2930 template<typename DeclT>
2931 void ASTDeclReader::markIncompleteDeclChainImpl(Redeclarable<DeclT> *D) {
2932   D->RedeclLink.markIncomplete();
2933 }
2934 void ASTDeclReader::markIncompleteDeclChainImpl(...) {
2935   llvm_unreachable("markIncompleteDeclChain on non-redeclarable declaration");
2936 }
2937 
2938 void ASTReader::markIncompleteDeclChain(Decl *D) {
2939   switch (D->getKind()) {
2940 #define ABSTRACT_DECL(TYPE)
2941 #define DECL(TYPE, BASE)                                             \
2942   case Decl::TYPE:                                                   \
2943     ASTDeclReader::markIncompleteDeclChainImpl(cast<TYPE##Decl>(D)); \
2944     break;
2945 #include "clang/AST/DeclNodes.inc"
2946   }
2947 }
2948 
2949 /// \brief Read the declaration at the given offset from the AST file.
2950 Decl *ASTReader::ReadDeclRecord(DeclID ID) {
2951   unsigned Index = ID - NUM_PREDEF_DECL_IDS;
2952   unsigned RawLocation = 0;
2953   RecordLocation Loc = DeclCursorForID(ID, RawLocation);
2954   llvm::BitstreamCursor &DeclsCursor = Loc.F->DeclsCursor;
2955   // Keep track of where we are in the stream, then jump back there
2956   // after reading this declaration.
2957   SavedStreamPosition SavedPosition(DeclsCursor);
2958 
2959   ReadingKindTracker ReadingKind(Read_Decl, *this);
2960 
2961   // Note that we are loading a declaration record.
2962   Deserializing ADecl(this);
2963 
2964   DeclsCursor.JumpToBit(Loc.Offset);
2965   RecordData Record;
2966   unsigned Code = DeclsCursor.ReadCode();
2967   unsigned Idx = 0;
2968   ASTDeclReader Reader(*this, *Loc.F, ID, RawLocation, Record,Idx);
2969 
2970   Decl *D = nullptr;
2971   switch ((DeclCode)DeclsCursor.readRecord(Code, Record)) {
2972   case DECL_CONTEXT_LEXICAL:
2973   case DECL_CONTEXT_VISIBLE:
2974     llvm_unreachable("Record cannot be de-serialized with ReadDeclRecord");
2975   case DECL_TYPEDEF:
2976     D = TypedefDecl::CreateDeserialized(Context, ID);
2977     break;
2978   case DECL_TYPEALIAS:
2979     D = TypeAliasDecl::CreateDeserialized(Context, ID);
2980     break;
2981   case DECL_ENUM:
2982     D = EnumDecl::CreateDeserialized(Context, ID);
2983     break;
2984   case DECL_RECORD:
2985     D = RecordDecl::CreateDeserialized(Context, ID);
2986     break;
2987   case DECL_ENUM_CONSTANT:
2988     D = EnumConstantDecl::CreateDeserialized(Context, ID);
2989     break;
2990   case DECL_FUNCTION:
2991     D = FunctionDecl::CreateDeserialized(Context, ID);
2992     break;
2993   case DECL_LINKAGE_SPEC:
2994     D = LinkageSpecDecl::CreateDeserialized(Context, ID);
2995     break;
2996   case DECL_LABEL:
2997     D = LabelDecl::CreateDeserialized(Context, ID);
2998     break;
2999   case DECL_NAMESPACE:
3000     D = NamespaceDecl::CreateDeserialized(Context, ID);
3001     break;
3002   case DECL_NAMESPACE_ALIAS:
3003     D = NamespaceAliasDecl::CreateDeserialized(Context, ID);
3004     break;
3005   case DECL_USING:
3006     D = UsingDecl::CreateDeserialized(Context, ID);
3007     break;
3008   case DECL_USING_SHADOW:
3009     D = UsingShadowDecl::CreateDeserialized(Context, ID);
3010     break;
3011   case DECL_USING_DIRECTIVE:
3012     D = UsingDirectiveDecl::CreateDeserialized(Context, ID);
3013     break;
3014   case DECL_UNRESOLVED_USING_VALUE:
3015     D = UnresolvedUsingValueDecl::CreateDeserialized(Context, ID);
3016     break;
3017   case DECL_UNRESOLVED_USING_TYPENAME:
3018     D = UnresolvedUsingTypenameDecl::CreateDeserialized(Context, ID);
3019     break;
3020   case DECL_CXX_RECORD:
3021     D = CXXRecordDecl::CreateDeserialized(Context, ID);
3022     break;
3023   case DECL_CXX_METHOD:
3024     D = CXXMethodDecl::CreateDeserialized(Context, ID);
3025     break;
3026   case DECL_CXX_CONSTRUCTOR:
3027     D = CXXConstructorDecl::CreateDeserialized(Context, ID);
3028     break;
3029   case DECL_CXX_DESTRUCTOR:
3030     D = CXXDestructorDecl::CreateDeserialized(Context, ID);
3031     break;
3032   case DECL_CXX_CONVERSION:
3033     D = CXXConversionDecl::CreateDeserialized(Context, ID);
3034     break;
3035   case DECL_ACCESS_SPEC:
3036     D = AccessSpecDecl::CreateDeserialized(Context, ID);
3037     break;
3038   case DECL_FRIEND:
3039     D = FriendDecl::CreateDeserialized(Context, ID, Record[Idx++]);
3040     break;
3041   case DECL_FRIEND_TEMPLATE:
3042     D = FriendTemplateDecl::CreateDeserialized(Context, ID);
3043     break;
3044   case DECL_CLASS_TEMPLATE:
3045     D = ClassTemplateDecl::CreateDeserialized(Context, ID);
3046     break;
3047   case DECL_CLASS_TEMPLATE_SPECIALIZATION:
3048     D = ClassTemplateSpecializationDecl::CreateDeserialized(Context, ID);
3049     break;
3050   case DECL_CLASS_TEMPLATE_PARTIAL_SPECIALIZATION:
3051     D = ClassTemplatePartialSpecializationDecl::CreateDeserialized(Context, ID);
3052     break;
3053   case DECL_VAR_TEMPLATE:
3054     D = VarTemplateDecl::CreateDeserialized(Context, ID);
3055     break;
3056   case DECL_VAR_TEMPLATE_SPECIALIZATION:
3057     D = VarTemplateSpecializationDecl::CreateDeserialized(Context, ID);
3058     break;
3059   case DECL_VAR_TEMPLATE_PARTIAL_SPECIALIZATION:
3060     D = VarTemplatePartialSpecializationDecl::CreateDeserialized(Context, ID);
3061     break;
3062   case DECL_CLASS_SCOPE_FUNCTION_SPECIALIZATION:
3063     D = ClassScopeFunctionSpecializationDecl::CreateDeserialized(Context, ID);
3064     break;
3065   case DECL_FUNCTION_TEMPLATE:
3066     D = FunctionTemplateDecl::CreateDeserialized(Context, ID);
3067     break;
3068   case DECL_TEMPLATE_TYPE_PARM:
3069     D = TemplateTypeParmDecl::CreateDeserialized(Context, ID);
3070     break;
3071   case DECL_NON_TYPE_TEMPLATE_PARM:
3072     D = NonTypeTemplateParmDecl::CreateDeserialized(Context, ID);
3073     break;
3074   case DECL_EXPANDED_NON_TYPE_TEMPLATE_PARM_PACK:
3075     D = NonTypeTemplateParmDecl::CreateDeserialized(Context, ID, Record[Idx++]);
3076     break;
3077   case DECL_TEMPLATE_TEMPLATE_PARM:
3078     D = TemplateTemplateParmDecl::CreateDeserialized(Context, ID);
3079     break;
3080   case DECL_EXPANDED_TEMPLATE_TEMPLATE_PARM_PACK:
3081     D = TemplateTemplateParmDecl::CreateDeserialized(Context, ID,
3082                                                      Record[Idx++]);
3083     break;
3084   case DECL_TYPE_ALIAS_TEMPLATE:
3085     D = TypeAliasTemplateDecl::CreateDeserialized(Context, ID);
3086     break;
3087   case DECL_STATIC_ASSERT:
3088     D = StaticAssertDecl::CreateDeserialized(Context, ID);
3089     break;
3090   case DECL_OBJC_METHOD:
3091     D = ObjCMethodDecl::CreateDeserialized(Context, ID);
3092     break;
3093   case DECL_OBJC_INTERFACE:
3094     D = ObjCInterfaceDecl::CreateDeserialized(Context, ID);
3095     break;
3096   case DECL_OBJC_IVAR:
3097     D = ObjCIvarDecl::CreateDeserialized(Context, ID);
3098     break;
3099   case DECL_OBJC_PROTOCOL:
3100     D = ObjCProtocolDecl::CreateDeserialized(Context, ID);
3101     break;
3102   case DECL_OBJC_AT_DEFS_FIELD:
3103     D = ObjCAtDefsFieldDecl::CreateDeserialized(Context, ID);
3104     break;
3105   case DECL_OBJC_CATEGORY:
3106     D = ObjCCategoryDecl::CreateDeserialized(Context, ID);
3107     break;
3108   case DECL_OBJC_CATEGORY_IMPL:
3109     D = ObjCCategoryImplDecl::CreateDeserialized(Context, ID);
3110     break;
3111   case DECL_OBJC_IMPLEMENTATION:
3112     D = ObjCImplementationDecl::CreateDeserialized(Context, ID);
3113     break;
3114   case DECL_OBJC_COMPATIBLE_ALIAS:
3115     D = ObjCCompatibleAliasDecl::CreateDeserialized(Context, ID);
3116     break;
3117   case DECL_OBJC_PROPERTY:
3118     D = ObjCPropertyDecl::CreateDeserialized(Context, ID);
3119     break;
3120   case DECL_OBJC_PROPERTY_IMPL:
3121     D = ObjCPropertyImplDecl::CreateDeserialized(Context, ID);
3122     break;
3123   case DECL_FIELD:
3124     D = FieldDecl::CreateDeserialized(Context, ID);
3125     break;
3126   case DECL_INDIRECTFIELD:
3127     D = IndirectFieldDecl::CreateDeserialized(Context, ID);
3128     break;
3129   case DECL_VAR:
3130     D = VarDecl::CreateDeserialized(Context, ID);
3131     break;
3132   case DECL_IMPLICIT_PARAM:
3133     D = ImplicitParamDecl::CreateDeserialized(Context, ID);
3134     break;
3135   case DECL_PARM_VAR:
3136     D = ParmVarDecl::CreateDeserialized(Context, ID);
3137     break;
3138   case DECL_FILE_SCOPE_ASM:
3139     D = FileScopeAsmDecl::CreateDeserialized(Context, ID);
3140     break;
3141   case DECL_BLOCK:
3142     D = BlockDecl::CreateDeserialized(Context, ID);
3143     break;
3144   case DECL_MS_PROPERTY:
3145     D = MSPropertyDecl::CreateDeserialized(Context, ID);
3146     break;
3147   case DECL_CAPTURED:
3148     D = CapturedDecl::CreateDeserialized(Context, ID, Record[Idx++]);
3149     break;
3150   case DECL_CXX_BASE_SPECIFIERS:
3151     Error("attempt to read a C++ base-specifier record as a declaration");
3152     return nullptr;
3153   case DECL_CXX_CTOR_INITIALIZERS:
3154     Error("attempt to read a C++ ctor initializer record as a declaration");
3155     return nullptr;
3156   case DECL_IMPORT:
3157     // Note: last entry of the ImportDecl record is the number of stored source
3158     // locations.
3159     D = ImportDecl::CreateDeserialized(Context, ID, Record.back());
3160     break;
3161   case DECL_OMP_THREADPRIVATE:
3162     D = OMPThreadPrivateDecl::CreateDeserialized(Context, ID, Record[Idx++]);
3163     break;
3164   case DECL_EMPTY:
3165     D = EmptyDecl::CreateDeserialized(Context, ID);
3166     break;
3167   }
3168 
3169   assert(D && "Unknown declaration reading AST file");
3170   LoadedDecl(Index, D);
3171   // Set the DeclContext before doing any deserialization, to make sure internal
3172   // calls to Decl::getASTContext() by Decl's methods will find the
3173   // TranslationUnitDecl without crashing.
3174   D->setDeclContext(Context.getTranslationUnitDecl());
3175   Reader.Visit(D);
3176 
3177   // If this declaration is also a declaration context, get the
3178   // offsets for its tables of lexical and visible declarations.
3179   if (DeclContext *DC = dyn_cast<DeclContext>(D)) {
3180     // FIXME: This should really be
3181     //     DeclContext *LookupDC = DC->getPrimaryContext();
3182     // but that can walk the redeclaration chain, which might not work yet.
3183     DeclContext *LookupDC = DC;
3184     if (isa<NamespaceDecl>(DC))
3185       LookupDC = DC->getPrimaryContext();
3186     std::pair<uint64_t, uint64_t> Offsets = Reader.VisitDeclContext(DC);
3187     if (Offsets.first || Offsets.second) {
3188       if (Offsets.first != 0)
3189         DC->setHasExternalLexicalStorage(true);
3190       if (Offsets.second != 0)
3191         LookupDC->setHasExternalVisibleStorage(true);
3192       if (ReadDeclContextStorage(*Loc.F, DeclsCursor, Offsets,
3193                                  Loc.F->DeclContextInfos[DC]))
3194         return nullptr;
3195     }
3196 
3197     // Now add the pending visible updates for this decl context, if it has any.
3198     DeclContextVisibleUpdatesPending::iterator I =
3199         PendingVisibleUpdates.find(ID);
3200     if (I != PendingVisibleUpdates.end()) {
3201       // There are updates. This means the context has external visible
3202       // storage, even if the original stored version didn't.
3203       LookupDC->setHasExternalVisibleStorage(true);
3204       for (const auto &Update : I->second) {
3205         DeclContextInfo &Info = Update.second->DeclContextInfos[DC];
3206         delete Info.NameLookupTableData;
3207         Info.NameLookupTableData = Update.first;
3208       }
3209       PendingVisibleUpdates.erase(I);
3210     }
3211   }
3212   assert(Idx == Record.size());
3213 
3214   // Load any relevant update records.
3215   PendingUpdateRecords.push_back(std::make_pair(ID, D));
3216 
3217   // Load the categories after recursive loading is finished.
3218   if (ObjCInterfaceDecl *Class = dyn_cast<ObjCInterfaceDecl>(D))
3219     if (Class->isThisDeclarationADefinition())
3220       loadObjCCategories(ID, Class);
3221 
3222   // If we have deserialized a declaration that has a definition the
3223   // AST consumer might need to know about, queue it.
3224   // We don't pass it to the consumer immediately because we may be in recursive
3225   // loading, and some declarations may still be initializing.
3226   if (isConsumerInterestedIn(D, Reader.hasPendingBody()))
3227     InterestingDecls.push_back(D);
3228 
3229   return D;
3230 }
3231 
3232 void ASTReader::loadDeclUpdateRecords(serialization::DeclID ID, Decl *D) {
3233   // The declaration may have been modified by files later in the chain.
3234   // If this is the case, read the record containing the updates from each file
3235   // and pass it to ASTDeclReader to make the modifications.
3236   DeclUpdateOffsetsMap::iterator UpdI = DeclUpdateOffsets.find(ID);
3237   if (UpdI != DeclUpdateOffsets.end()) {
3238     FileOffsetsTy &UpdateOffsets = UpdI->second;
3239     bool WasInteresting = isConsumerInterestedIn(D, false);
3240     for (FileOffsetsTy::iterator
3241          I = UpdateOffsets.begin(), E = UpdateOffsets.end(); I != E; ++I) {
3242       ModuleFile *F = I->first;
3243       uint64_t Offset = I->second;
3244       llvm::BitstreamCursor &Cursor = F->DeclsCursor;
3245       SavedStreamPosition SavedPosition(Cursor);
3246       Cursor.JumpToBit(Offset);
3247       RecordData Record;
3248       unsigned Code = Cursor.ReadCode();
3249       unsigned RecCode = Cursor.readRecord(Code, Record);
3250       (void)RecCode;
3251       assert(RecCode == DECL_UPDATES && "Expected DECL_UPDATES record!");
3252 
3253       unsigned Idx = 0;
3254       ASTDeclReader Reader(*this, *F, ID, 0, Record, Idx);
3255       Reader.UpdateDecl(D, *F, Record);
3256 
3257       // We might have made this declaration interesting. If so, remember that
3258       // we need to hand it off to the consumer.
3259       if (!WasInteresting &&
3260           isConsumerInterestedIn(D, Reader.hasPendingBody())) {
3261         InterestingDecls.push_back(D);
3262         WasInteresting = true;
3263       }
3264     }
3265   }
3266 }
3267 
3268 namespace {
3269   /// \brief Module visitor class that finds all of the redeclarations of a
3270   /// redeclarable declaration.
3271   class RedeclChainVisitor {
3272     ASTReader &Reader;
3273     SmallVectorImpl<DeclID> &SearchDecls;
3274     llvm::SmallPtrSetImpl<Decl *> &Deserialized;
3275     GlobalDeclID CanonID;
3276     SmallVector<Decl *, 4> Chain;
3277 
3278   public:
3279     RedeclChainVisitor(ASTReader &Reader, SmallVectorImpl<DeclID> &SearchDecls,
3280                        llvm::SmallPtrSetImpl<Decl *> &Deserialized,
3281                        GlobalDeclID CanonID)
3282       : Reader(Reader), SearchDecls(SearchDecls), Deserialized(Deserialized),
3283         CanonID(CanonID) {
3284       // Ensure that the canonical ID goes at the start of the chain.
3285       addToChain(Reader.GetDecl(CanonID));
3286     }
3287 
3288     static bool visit(ModuleFile &M, bool Preorder, void *UserData) {
3289       if (Preorder)
3290         return false;
3291 
3292       return static_cast<RedeclChainVisitor *>(UserData)->visit(M);
3293     }
3294 
3295     void addToChain(Decl *D) {
3296       if (!D)
3297         return;
3298 
3299       if (Deserialized.erase(D))
3300         Chain.push_back(D);
3301     }
3302 
3303     void searchForID(ModuleFile &M, GlobalDeclID GlobalID) {
3304       // Map global ID of the first declaration down to the local ID
3305       // used in this module file.
3306       DeclID ID = Reader.mapGlobalIDToModuleFileGlobalID(M, GlobalID);
3307       if (!ID)
3308         return;
3309 
3310       // If the search decl was from this module, add it to the chain before any
3311       // of its redeclarations in this module or users of it, and after any from
3312       // imported modules.
3313       if (CanonID != GlobalID && Reader.isDeclIDFromModule(GlobalID, M))
3314         addToChain(Reader.GetDecl(GlobalID));
3315 
3316       // Perform a binary search to find the local redeclarations for this
3317       // declaration (if any).
3318       const LocalRedeclarationsInfo Compare = { ID, 0 };
3319       const LocalRedeclarationsInfo *Result
3320         = std::lower_bound(M.RedeclarationsMap,
3321                            M.RedeclarationsMap + M.LocalNumRedeclarationsInMap,
3322                            Compare);
3323       if (Result == M.RedeclarationsMap + M.LocalNumRedeclarationsInMap ||
3324           Result->FirstID != ID) {
3325         // If we have a previously-canonical singleton declaration that was
3326         // merged into another redeclaration chain, create a trivial chain
3327         // for this single declaration so that it will get wired into the
3328         // complete redeclaration chain.
3329         if (GlobalID != CanonID &&
3330             GlobalID - NUM_PREDEF_DECL_IDS >= M.BaseDeclID &&
3331             GlobalID - NUM_PREDEF_DECL_IDS < M.BaseDeclID + M.LocalNumDecls) {
3332           addToChain(Reader.GetDecl(GlobalID));
3333         }
3334 
3335         return;
3336       }
3337 
3338       // Dig out all of the redeclarations.
3339       unsigned Offset = Result->Offset;
3340       unsigned N = M.RedeclarationChains[Offset];
3341       M.RedeclarationChains[Offset++] = 0; // Don't try to deserialize again
3342       for (unsigned I = 0; I != N; ++I)
3343         addToChain(Reader.GetLocalDecl(M, M.RedeclarationChains[Offset++]));
3344     }
3345 
3346     bool visit(ModuleFile &M) {
3347       // Visit each of the declarations.
3348       for (unsigned I = 0, N = SearchDecls.size(); I != N; ++I)
3349         searchForID(M, SearchDecls[I]);
3350       // FIXME: If none of the SearchDecls had local IDs in this module, can
3351       // we avoid searching any ancestor module files?
3352       return false;
3353     }
3354 
3355     ArrayRef<Decl *> getChain() const {
3356       return Chain;
3357     }
3358   };
3359 }
3360 
3361 void ASTReader::loadPendingDeclChain(Decl *CanonDecl) {
3362   // The decl might have been merged into something else after being added to
3363   // our list. If it was, just skip it.
3364   if (!CanonDecl->isCanonicalDecl())
3365     return;
3366 
3367   // Determine the set of declaration IDs we'll be searching for.
3368   SmallVector<DeclID, 16> SearchDecls;
3369   GlobalDeclID CanonID = CanonDecl->getGlobalID();
3370   if (CanonID)
3371     SearchDecls.push_back(CanonDecl->getGlobalID()); // Always first.
3372   MergedDeclsMap::iterator MergedPos = MergedDecls.find(CanonDecl);
3373   if (MergedPos != MergedDecls.end())
3374     SearchDecls.append(MergedPos->second.begin(), MergedPos->second.end());
3375 
3376   // Build up the list of redeclarations.
3377   RedeclChainVisitor Visitor(*this, SearchDecls, RedeclsDeserialized, CanonID);
3378   ModuleMgr.visitDepthFirst(&RedeclChainVisitor::visit, &Visitor);
3379 
3380   // Retrieve the chains.
3381   ArrayRef<Decl *> Chain = Visitor.getChain();
3382   if (Chain.empty())
3383     return;
3384 
3385   // Hook up the chains.
3386   //
3387   // FIXME: We have three different dispatches on decl kind here; maybe
3388   // we should instead generate one loop per kind and dispatch up-front?
3389   Decl *MostRecent = ASTDeclReader::getMostRecentDecl(CanonDecl);
3390   if (!MostRecent)
3391     MostRecent = CanonDecl;
3392   for (unsigned I = 0, N = Chain.size(); I != N; ++I) {
3393     if (Chain[I] == CanonDecl)
3394       continue;
3395 
3396     ASTDeclReader::attachPreviousDecl(*this, Chain[I], MostRecent, CanonDecl);
3397     MostRecent = Chain[I];
3398   }
3399   ASTDeclReader::attachLatestDecl(CanonDecl, MostRecent);
3400 }
3401 
3402 namespace {
3403   /// \brief Given an ObjC interface, goes through the modules and links to the
3404   /// interface all the categories for it.
3405   class ObjCCategoriesVisitor {
3406     ASTReader &Reader;
3407     serialization::GlobalDeclID InterfaceID;
3408     ObjCInterfaceDecl *Interface;
3409     llvm::SmallPtrSetImpl<ObjCCategoryDecl *> &Deserialized;
3410     unsigned PreviousGeneration;
3411     ObjCCategoryDecl *Tail;
3412     llvm::DenseMap<DeclarationName, ObjCCategoryDecl *> NameCategoryMap;
3413 
3414     void add(ObjCCategoryDecl *Cat) {
3415       // Only process each category once.
3416       if (!Deserialized.erase(Cat))
3417         return;
3418 
3419       // Check for duplicate categories.
3420       if (Cat->getDeclName()) {
3421         ObjCCategoryDecl *&Existing = NameCategoryMap[Cat->getDeclName()];
3422         if (Existing &&
3423             Reader.getOwningModuleFile(Existing)
3424                                           != Reader.getOwningModuleFile(Cat)) {
3425           // FIXME: We should not warn for duplicates in diamond:
3426           //
3427           //   MT     //
3428           //  /  \    //
3429           // ML  MR   //
3430           //  \  /    //
3431           //   MB     //
3432           //
3433           // If there are duplicates in ML/MR, there will be warning when
3434           // creating MB *and* when importing MB. We should not warn when
3435           // importing.
3436           Reader.Diag(Cat->getLocation(), diag::warn_dup_category_def)
3437             << Interface->getDeclName() << Cat->getDeclName();
3438           Reader.Diag(Existing->getLocation(), diag::note_previous_definition);
3439         } else if (!Existing) {
3440           // Record this category.
3441           Existing = Cat;
3442         }
3443       }
3444 
3445       // Add this category to the end of the chain.
3446       if (Tail)
3447         ASTDeclReader::setNextObjCCategory(Tail, Cat);
3448       else
3449         Interface->setCategoryListRaw(Cat);
3450       Tail = Cat;
3451     }
3452 
3453   public:
3454     ObjCCategoriesVisitor(ASTReader &Reader,
3455                           serialization::GlobalDeclID InterfaceID,
3456                           ObjCInterfaceDecl *Interface,
3457                         llvm::SmallPtrSetImpl<ObjCCategoryDecl *> &Deserialized,
3458                           unsigned PreviousGeneration)
3459       : Reader(Reader), InterfaceID(InterfaceID), Interface(Interface),
3460         Deserialized(Deserialized), PreviousGeneration(PreviousGeneration),
3461         Tail(nullptr)
3462     {
3463       // Populate the name -> category map with the set of known categories.
3464       for (auto *Cat : Interface->known_categories()) {
3465         if (Cat->getDeclName())
3466           NameCategoryMap[Cat->getDeclName()] = Cat;
3467 
3468         // Keep track of the tail of the category list.
3469         Tail = Cat;
3470       }
3471     }
3472 
3473     static bool visit(ModuleFile &M, void *UserData) {
3474       return static_cast<ObjCCategoriesVisitor *>(UserData)->visit(M);
3475     }
3476 
3477     bool visit(ModuleFile &M) {
3478       // If we've loaded all of the category information we care about from
3479       // this module file, we're done.
3480       if (M.Generation <= PreviousGeneration)
3481         return true;
3482 
3483       // Map global ID of the definition down to the local ID used in this
3484       // module file. If there is no such mapping, we'll find nothing here
3485       // (or in any module it imports).
3486       DeclID LocalID = Reader.mapGlobalIDToModuleFileGlobalID(M, InterfaceID);
3487       if (!LocalID)
3488         return true;
3489 
3490       // Perform a binary search to find the local redeclarations for this
3491       // declaration (if any).
3492       const ObjCCategoriesInfo Compare = { LocalID, 0 };
3493       const ObjCCategoriesInfo *Result
3494         = std::lower_bound(M.ObjCCategoriesMap,
3495                            M.ObjCCategoriesMap + M.LocalNumObjCCategoriesInMap,
3496                            Compare);
3497       if (Result == M.ObjCCategoriesMap + M.LocalNumObjCCategoriesInMap ||
3498           Result->DefinitionID != LocalID) {
3499         // We didn't find anything. If the class definition is in this module
3500         // file, then the module files it depends on cannot have any categories,
3501         // so suppress further lookup.
3502         return Reader.isDeclIDFromModule(InterfaceID, M);
3503       }
3504 
3505       // We found something. Dig out all of the categories.
3506       unsigned Offset = Result->Offset;
3507       unsigned N = M.ObjCCategories[Offset];
3508       M.ObjCCategories[Offset++] = 0; // Don't try to deserialize again
3509       for (unsigned I = 0; I != N; ++I)
3510         add(cast_or_null<ObjCCategoryDecl>(
3511               Reader.GetLocalDecl(M, M.ObjCCategories[Offset++])));
3512       return true;
3513     }
3514   };
3515 }
3516 
3517 void ASTReader::loadObjCCategories(serialization::GlobalDeclID ID,
3518                                    ObjCInterfaceDecl *D,
3519                                    unsigned PreviousGeneration) {
3520   ObjCCategoriesVisitor Visitor(*this, ID, D, CategoriesDeserialized,
3521                                 PreviousGeneration);
3522   ModuleMgr.visit(ObjCCategoriesVisitor::visit, &Visitor);
3523 }
3524 
3525 namespace {
3526 /// Iterator over the redeclarations of a declaration that have already
3527 /// been merged into the same redeclaration chain.
3528 template<typename DeclT>
3529 class MergedRedeclIterator {
3530   DeclT *Start, *Canonical, *Current;
3531 public:
3532   MergedRedeclIterator() : Current(nullptr) {}
3533   MergedRedeclIterator(DeclT *Start)
3534       : Start(Start), Canonical(nullptr), Current(Start) {}
3535 
3536   DeclT *operator*() { return Current; }
3537 
3538   MergedRedeclIterator &operator++() {
3539     if (Current->isFirstDecl()) {
3540       Canonical = Current;
3541       Current = Current->getMostRecentDecl();
3542     } else
3543       Current = Current->getPreviousDecl();
3544 
3545     // If we started in the merged portion, we'll reach our start position
3546     // eventually. Otherwise, we'll never reach it, but the second declaration
3547     // we reached was the canonical declaration, so stop when we see that one
3548     // again.
3549     if (Current == Start || Current == Canonical)
3550       Current = nullptr;
3551     return *this;
3552   }
3553 
3554   friend bool operator!=(const MergedRedeclIterator &A,
3555                          const MergedRedeclIterator &B) {
3556     return A.Current != B.Current;
3557   }
3558 };
3559 }
3560 template<typename DeclT>
3561 llvm::iterator_range<MergedRedeclIterator<DeclT>> merged_redecls(DeclT *D) {
3562   return llvm::iterator_range<MergedRedeclIterator<DeclT>>(
3563       MergedRedeclIterator<DeclT>(D),
3564       MergedRedeclIterator<DeclT>());
3565 }
3566 
3567 template<typename DeclT, typename Fn>
3568 static void forAllLaterRedecls(DeclT *D, Fn F) {
3569   F(D);
3570 
3571   // Check whether we've already merged D into its redeclaration chain.
3572   // MostRecent may or may not be nullptr if D has not been merged. If
3573   // not, walk the merged redecl chain and see if it's there.
3574   auto *MostRecent = D->getMostRecentDecl();
3575   bool Found = false;
3576   for (auto *Redecl = MostRecent; Redecl && !Found;
3577        Redecl = Redecl->getPreviousDecl())
3578     Found = (Redecl == D);
3579 
3580   // If this declaration is merged, apply the functor to all later decls.
3581   if (Found) {
3582     for (auto *Redecl = MostRecent; Redecl != D;
3583          Redecl = Redecl->getPreviousDecl())
3584       F(Redecl);
3585   }
3586 }
3587 
3588 void ASTDeclReader::UpdateDecl(Decl *D, ModuleFile &ModuleFile,
3589                                const RecordData &Record) {
3590   while (Idx < Record.size()) {
3591     switch ((DeclUpdateKind)Record[Idx++]) {
3592     case UPD_CXX_ADDED_IMPLICIT_MEMBER: {
3593       auto *RD = cast<CXXRecordDecl>(D);
3594       // FIXME: If we also have an update record for instantiating the
3595       // definition of D, we need that to happen before we get here.
3596       Decl *MD = Reader.ReadDecl(ModuleFile, Record, Idx);
3597       assert(MD && "couldn't read decl from update record");
3598       // FIXME: We should call addHiddenDecl instead, to add the member
3599       // to its DeclContext.
3600       RD->addedMember(MD);
3601 
3602       // If we've added a new special member to a class definition that is not
3603       // the canonical definition, then we need special member lookups in the
3604       // canonical definition to also look into our class.
3605       auto *DD = RD->DefinitionData.getNotUpdated();
3606       if (DD && DD->Definition != RD) {
3607         auto &Merged = Reader.MergedLookups[DD->Definition];
3608         // FIXME: Avoid the linear-time scan here.
3609         if (std::find(Merged.begin(), Merged.end(), RD) == Merged.end())
3610           Merged.push_back(RD);
3611       }
3612       break;
3613     }
3614 
3615     case UPD_CXX_ADDED_TEMPLATE_SPECIALIZATION:
3616       // It will be added to the template's specializations set when loaded.
3617       (void)Reader.ReadDecl(ModuleFile, Record, Idx);
3618       break;
3619 
3620     case UPD_CXX_ADDED_ANONYMOUS_NAMESPACE: {
3621       NamespaceDecl *Anon
3622         = Reader.ReadDeclAs<NamespaceDecl>(ModuleFile, Record, Idx);
3623 
3624       // Each module has its own anonymous namespace, which is disjoint from
3625       // any other module's anonymous namespaces, so don't attach the anonymous
3626       // namespace at all.
3627       if (ModuleFile.Kind != MK_ImplicitModule &&
3628           ModuleFile.Kind != MK_ExplicitModule) {
3629         if (TranslationUnitDecl *TU = dyn_cast<TranslationUnitDecl>(D))
3630           TU->setAnonymousNamespace(Anon);
3631         else
3632           cast<NamespaceDecl>(D)->setAnonymousNamespace(Anon);
3633       }
3634       break;
3635     }
3636 
3637     case UPD_CXX_INSTANTIATED_STATIC_DATA_MEMBER:
3638       cast<VarDecl>(D)->getMemberSpecializationInfo()->setPointOfInstantiation(
3639           Reader.ReadSourceLocation(ModuleFile, Record, Idx));
3640       break;
3641 
3642     case UPD_CXX_ADDED_FUNCTION_DEFINITION: {
3643       FunctionDecl *FD = cast<FunctionDecl>(D);
3644       if (Reader.PendingBodies[FD]) {
3645         // FIXME: Maybe check for ODR violations.
3646         // It's safe to stop now because this update record is always last.
3647         return;
3648       }
3649 
3650       if (Record[Idx++]) {
3651         // Maintain AST consistency: any later redeclarations of this function
3652         // are inline if this one is. (We might have merged another declaration
3653         // into this one.)
3654         forAllLaterRedecls(FD, [](FunctionDecl *FD) {
3655           FD->setImplicitlyInline();
3656         });
3657       }
3658       FD->setInnerLocStart(Reader.ReadSourceLocation(ModuleFile, Record, Idx));
3659       if (auto *CD = dyn_cast<CXXConstructorDecl>(FD)) {
3660         CD->NumCtorInitializers = Record[Idx++];
3661         if (CD->NumCtorInitializers)
3662           CD->CtorInitializers =
3663               Reader.ReadCXXCtorInitializersRef(F, Record, Idx);
3664       }
3665       // Store the offset of the body so we can lazily load it later.
3666       Reader.PendingBodies[FD] = GetCurrentCursorOffset();
3667       HasPendingBody = true;
3668       assert(Idx == Record.size() && "lazy body must be last");
3669       break;
3670     }
3671 
3672     case UPD_CXX_INSTANTIATED_CLASS_DEFINITION: {
3673       auto *RD = cast<CXXRecordDecl>(D);
3674       auto *OldDD = RD->DefinitionData.getNotUpdated();
3675       bool HadRealDefinition =
3676           OldDD && (OldDD->Definition != RD ||
3677                     !Reader.PendingFakeDefinitionData.count(OldDD));
3678       ReadCXXRecordDefinition(RD, /*Update*/true);
3679 
3680       // Visible update is handled separately.
3681       uint64_t LexicalOffset = Record[Idx++];
3682       if (!HadRealDefinition && LexicalOffset) {
3683         RD->setHasExternalLexicalStorage(true);
3684         Reader.ReadDeclContextStorage(ModuleFile, ModuleFile.DeclsCursor,
3685                                       std::make_pair(LexicalOffset, 0),
3686                                       ModuleFile.DeclContextInfos[RD]);
3687         Reader.PendingFakeDefinitionData.erase(OldDD);
3688       }
3689 
3690       auto TSK = (TemplateSpecializationKind)Record[Idx++];
3691       SourceLocation POI = Reader.ReadSourceLocation(ModuleFile, Record, Idx);
3692       if (MemberSpecializationInfo *MSInfo =
3693               RD->getMemberSpecializationInfo()) {
3694         MSInfo->setTemplateSpecializationKind(TSK);
3695         MSInfo->setPointOfInstantiation(POI);
3696       } else {
3697         ClassTemplateSpecializationDecl *Spec =
3698             cast<ClassTemplateSpecializationDecl>(RD);
3699         Spec->setTemplateSpecializationKind(TSK);
3700         Spec->setPointOfInstantiation(POI);
3701 
3702         if (Record[Idx++]) {
3703           auto PartialSpec =
3704               ReadDeclAs<ClassTemplatePartialSpecializationDecl>(Record, Idx);
3705           SmallVector<TemplateArgument, 8> TemplArgs;
3706           Reader.ReadTemplateArgumentList(TemplArgs, F, Record, Idx);
3707           auto *TemplArgList = TemplateArgumentList::CreateCopy(
3708               Reader.getContext(), TemplArgs.data(), TemplArgs.size());
3709 
3710           // FIXME: If we already have a partial specialization set,
3711           // check that it matches.
3712           if (!Spec->getSpecializedTemplateOrPartial()
3713                    .is<ClassTemplatePartialSpecializationDecl *>())
3714             Spec->setInstantiationOf(PartialSpec, TemplArgList);
3715         }
3716       }
3717 
3718       RD->setTagKind((TagTypeKind)Record[Idx++]);
3719       RD->setLocation(Reader.ReadSourceLocation(ModuleFile, Record, Idx));
3720       RD->setLocStart(Reader.ReadSourceLocation(ModuleFile, Record, Idx));
3721       RD->setRBraceLoc(Reader.ReadSourceLocation(ModuleFile, Record, Idx));
3722 
3723       if (Record[Idx++]) {
3724         AttrVec Attrs;
3725         Reader.ReadAttributes(F, Attrs, Record, Idx);
3726         D->setAttrsImpl(Attrs, Reader.getContext());
3727       }
3728       break;
3729     }
3730 
3731     case UPD_CXX_RESOLVED_DTOR_DELETE: {
3732       // Set the 'operator delete' directly to avoid emitting another update
3733       // record.
3734       auto *Del = Reader.ReadDeclAs<FunctionDecl>(ModuleFile, Record, Idx);
3735       auto *First = cast<CXXDestructorDecl>(D->getCanonicalDecl());
3736       // FIXME: Check consistency if we have an old and new operator delete.
3737       if (!First->OperatorDelete)
3738         First->OperatorDelete = Del;
3739       break;
3740     }
3741 
3742     case UPD_CXX_RESOLVED_EXCEPTION_SPEC: {
3743       FunctionProtoType::ExceptionSpecInfo ESI;
3744       SmallVector<QualType, 8> ExceptionStorage;
3745       Reader.readExceptionSpec(ModuleFile, ExceptionStorage, ESI, Record, Idx);
3746 
3747       // Update this declaration's exception specification, if needed.
3748       auto *FD = cast<FunctionDecl>(D);
3749       auto *FPT = FD->getType()->castAs<FunctionProtoType>();
3750       // FIXME: If the exception specification is already present, check that it
3751       // matches.
3752       if (isUnresolvedExceptionSpec(FPT->getExceptionSpecType())) {
3753         FD->setType(Reader.Context.getFunctionType(
3754             FPT->getReturnType(), FPT->getParamTypes(),
3755             FPT->getExtProtoInfo().withExceptionSpec(ESI)));
3756 
3757         // When we get to the end of deserializing, see if there are other decls
3758         // that we need to propagate this exception specification onto.
3759         Reader.PendingExceptionSpecUpdates.insert(
3760             std::make_pair(FD->getCanonicalDecl(), FD));
3761       }
3762       break;
3763     }
3764 
3765     case UPD_CXX_DEDUCED_RETURN_TYPE: {
3766       // FIXME: Also do this when merging redecls.
3767       QualType DeducedResultType = Reader.readType(ModuleFile, Record, Idx);
3768       for (auto *Redecl : merged_redecls(D)) {
3769         // FIXME: If the return type is already deduced, check that it matches.
3770         FunctionDecl *FD = cast<FunctionDecl>(Redecl);
3771         Reader.Context.adjustDeducedFunctionResultType(FD, DeducedResultType);
3772       }
3773       break;
3774     }
3775 
3776     case UPD_DECL_MARKED_USED: {
3777       // FIXME: This doesn't send the right notifications if there are
3778       // ASTMutationListeners other than an ASTWriter.
3779 
3780       // Maintain AST consistency: any later redeclarations are used too.
3781       forAllLaterRedecls(D, [](Decl *D) { D->Used = true; });
3782       break;
3783     }
3784 
3785     case UPD_MANGLING_NUMBER:
3786       Reader.Context.setManglingNumber(cast<NamedDecl>(D), Record[Idx++]);
3787       break;
3788 
3789     case UPD_STATIC_LOCAL_NUMBER:
3790       Reader.Context.setStaticLocalNumber(cast<VarDecl>(D), Record[Idx++]);
3791       break;
3792     case UPD_DECL_MARKED_OPENMP_THREADPRIVATE:
3793       D->addAttr(OMPThreadPrivateDeclAttr::CreateImplicit(
3794           Reader.Context, ReadSourceRange(Record, Idx)));
3795       break;
3796     }
3797   }
3798 }
3799