clang  5.0.0
MultiplexConsumer.cpp
Go to the documentation of this file.
1 //===- MultiplexConsumer.cpp - AST Consumer for PCH Generation --*- C++ -*-===//
2 //
3 // The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 //
10 // This file defines the MultiplexConsumer class. It also declares and defines
11 // MultiplexASTDeserializationListener and MultiplexASTMutationListener, which
12 // are implementation details of MultiplexConsumer.
13 //
14 //===----------------------------------------------------------------------===//
15 
18 #include "clang/AST/DeclGroup.h"
20 
21 using namespace clang;
22 
23 namespace clang {
24 
25 // This ASTDeserializationListener forwards its notifications to a set of
26 // child listeners.
29 public:
30  // Does NOT take ownership of the elements in L.
32  const std::vector<ASTDeserializationListener*>& L);
33  void ReaderInitialized(ASTReader *Reader) override;
35  IdentifierInfo *II) override;
36  void MacroRead(serialization::MacroID ID, MacroInfo *MI) override;
37  void TypeRead(serialization::TypeIdx Idx, QualType T) override;
38  void DeclRead(serialization::DeclID ID, const Decl *D) override;
39  void SelectorRead(serialization::SelectorID iD, Selector Sel) override;
41  MacroDefinitionRecord *MD) override;
42  void ModuleRead(serialization::SubmoduleID ID, Module *Mod) override;
43 
44 private:
45  std::vector<ASTDeserializationListener *> Listeners;
46 };
47 
49  const std::vector<ASTDeserializationListener*>& L)
50  : Listeners(L) {
51 }
52 
54  ASTReader *Reader) {
55  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
56  Listeners[i]->ReaderInitialized(Reader);
57 }
58 
61  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
62  Listeners[i]->IdentifierRead(ID, II);
63 }
64 
67  for (auto &Listener : Listeners)
68  Listener->MacroRead(ID, MI);
69 }
70 
73  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
74  Listeners[i]->TypeRead(Idx, T);
75 }
76 
78  serialization::DeclID ID, const Decl *D) {
79  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
80  Listeners[i]->DeclRead(ID, D);
81 }
82 
85  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
86  Listeners[i]->SelectorRead(ID, Sel);
87 }
88 
91  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
92  Listeners[i]->MacroDefinitionRead(ID, MD);
93 }
94 
97  for (auto &Listener : Listeners)
98  Listener->ModuleRead(ID, Mod);
99 }
100 
101 // This ASTMutationListener forwards its notifications to a set of
102 // child listeners.
104 public:
105  // Does NOT take ownership of the elements in L.
107  void CompletedTagDefinition(const TagDecl *D) override;
108  void AddedVisibleDecl(const DeclContext *DC, const Decl *D) override;
109  void AddedCXXImplicitMember(const CXXRecordDecl *RD, const Decl *D) override;
111  const ClassTemplateSpecializationDecl *D) override;
113  const VarTemplateSpecializationDecl *D) override;
115  const FunctionDecl *D) override;
116  void ResolvedExceptionSpec(const FunctionDecl *FD) override;
117  void DeducedReturnType(const FunctionDecl *FD, QualType ReturnType) override;
119  const FunctionDecl *Delete) override;
120  void CompletedImplicitDefinition(const FunctionDecl *D) override;
121  void StaticDataMemberInstantiated(const VarDecl *D) override;
122  void DefaultArgumentInstantiated(const ParmVarDecl *D) override;
123  void DefaultMemberInitializerInstantiated(const FieldDecl *D) override;
125  const ObjCInterfaceDecl *IFD) override;
126  void FunctionDefinitionInstantiated(const FunctionDecl *D) override;
127  void DeclarationMarkedUsed(const Decl *D) override;
128  void DeclarationMarkedOpenMPThreadPrivate(const Decl *D) override;
130  const Attr *Attr) override;
131  void RedefinedHiddenDefinition(const NamedDecl *D, Module *M) override;
132  void AddedAttributeToRecord(const Attr *Attr,
133  const RecordDecl *Record) override;
134 
135 private:
136  std::vector<ASTMutationListener*> Listeners;
137 };
138 
141  : Listeners(L.begin(), L.end()) {
142 }
143 
145  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
146  Listeners[i]->CompletedTagDefinition(D);
147 }
148 
150  const DeclContext *DC, const Decl *D) {
151  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
152  Listeners[i]->AddedVisibleDecl(DC, D);
153 }
154 
156  const CXXRecordDecl *RD, const Decl *D) {
157  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
158  Listeners[i]->AddedCXXImplicitMember(RD, D);
159 }
162  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
163  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
164 }
166  const VarTemplateDecl *TD, const VarTemplateSpecializationDecl *D) {
167  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
168  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
169 }
171  const FunctionTemplateDecl *TD, const FunctionDecl *D) {
172  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
173  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
174 }
176  const FunctionDecl *FD) {
177  for (auto &Listener : Listeners)
178  Listener->ResolvedExceptionSpec(FD);
179 }
181  QualType ReturnType) {
182  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
183  Listeners[i]->DeducedReturnType(FD, ReturnType);
184 }
186  const CXXDestructorDecl *DD, const FunctionDecl *Delete) {
187  for (auto *L : Listeners)
188  L->ResolvedOperatorDelete(DD, Delete);
189 }
191  const FunctionDecl *D) {
192  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
193  Listeners[i]->CompletedImplicitDefinition(D);
194 }
196  const VarDecl *D) {
197  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
198  Listeners[i]->StaticDataMemberInstantiated(D);
199 }
201  const ParmVarDecl *D) {
202  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
203  Listeners[i]->DefaultArgumentInstantiated(D);
204 }
206  const FieldDecl *D) {
207  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
208  Listeners[i]->DefaultMemberInitializerInstantiated(D);
209 }
211  const ObjCCategoryDecl *CatD,
212  const ObjCInterfaceDecl *IFD) {
213  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
214  Listeners[i]->AddedObjCCategoryToInterface(CatD, IFD);
215 }
217  const FunctionDecl *D) {
218  for (auto &Listener : Listeners)
219  Listener->FunctionDefinitionInstantiated(D);
220 }
222  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
223  Listeners[i]->DeclarationMarkedUsed(D);
224 }
226  const Decl *D) {
227  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
228  Listeners[i]->DeclarationMarkedOpenMPThreadPrivate(D);
229 }
231  const Decl *D, const Attr *Attr) {
232  for (auto *L : Listeners)
233  L->DeclarationMarkedOpenMPDeclareTarget(D, Attr);
234 }
236  Module *M) {
237  for (auto *L : Listeners)
238  L->RedefinedHiddenDefinition(D, M);
239 }
240 
242  const Attr *Attr,
243  const RecordDecl *Record) {
244  for (auto *L : Listeners)
245  L->AddedAttributeToRecord(Attr, Record);
246 }
247 
248 } // end namespace clang
249 
250 MultiplexConsumer::MultiplexConsumer(
251  std::vector<std::unique_ptr<ASTConsumer>> C)
252  : Consumers(std::move(C)), MutationListener(), DeserializationListener() {
253  // Collect the mutation listeners and deserialization listeners of all
254  // children, and create a multiplex listener each if so.
255  std::vector<ASTMutationListener*> mutationListeners;
256  std::vector<ASTDeserializationListener*> serializationListeners;
257  for (auto &Consumer : Consumers) {
258  if (auto *mutationListener = Consumer->GetASTMutationListener())
259  mutationListeners.push_back(mutationListener);
260  if (auto *serializationListener = Consumer->GetASTDeserializationListener())
261  serializationListeners.push_back(serializationListener);
262  }
263  if (!mutationListeners.empty()) {
264  MutationListener =
265  llvm::make_unique<MultiplexASTMutationListener>(mutationListeners);
266  }
267  if (!serializationListeners.empty()) {
268  DeserializationListener =
269  llvm::make_unique<MultiplexASTDeserializationListener>(
270  serializationListeners);
271  }
272 }
273 
275 
277  for (auto &Consumer : Consumers)
278  Consumer->Initialize(Context);
279 }
280 
282  bool Continue = true;
283  for (auto &Consumer : Consumers)
284  Continue = Continue && Consumer->HandleTopLevelDecl(D);
285  return Continue;
286 }
287 
289  for (auto &Consumer : Consumers)
290  Consumer->HandleInlineFunctionDefinition(D);
291 }
292 
294  for (auto &Consumer : Consumers)
295  Consumer->HandleCXXStaticMemberVarInstantiation(VD);
296 }
297 
299  for (auto &Consumer : Consumers)
300  Consumer->HandleInterestingDecl(D);
301 }
302 
304  for (auto &Consumer : Consumers)
305  Consumer->HandleTranslationUnit(Ctx);
306 }
307 
309  for (auto &Consumer : Consumers)
310  Consumer->HandleTagDeclDefinition(D);
311 }
312 
314  for (auto &Consumer : Consumers)
315  Consumer->HandleTagDeclRequiredDefinition(D);
316 }
317 
319  for (auto &Consumer : Consumers)
320  Consumer->HandleCXXImplicitFunctionInstantiation(D);
321 }
322 
324  for (auto &Consumer : Consumers)
325  Consumer->HandleTopLevelDeclInObjCContainer(D);
326 }
327 
329  for (auto &Consumer : Consumers)
330  Consumer->HandleImplicitImportDecl(D);
331 }
332 
334  for (auto &Consumer : Consumers)
335  Consumer->CompleteTentativeDefinition(D);
336 }
337 
339  for (auto &Consumer : Consumers)
340  Consumer->AssignInheritanceModel(RD);
341 }
342 
344  for (auto &Consumer : Consumers)
345  Consumer->HandleVTable(RD);
346 }
347 
349  return MutationListener.get();
350 }
351 
353  return DeserializationListener.get();
354 }
355 
357  for (auto &Consumer : Consumers)
358  Consumer->PrintStats();
359 }
360 
362  bool Skip = true;
363  for (auto &Consumer : Consumers)
364  Skip = Skip && Consumer->shouldSkipFunctionBody(D);
365  return Skip;
366 }
367 
369  for (auto &Consumer : Consumers)
370  if (SemaConsumer *SC = dyn_cast<SemaConsumer>(Consumer.get()))
371  SC->InitializeSema(S);
372 }
373 
375  for (auto &Consumer : Consumers)
376  if (SemaConsumer *SC = dyn_cast<SemaConsumer>(Consumer.get()))
377  SC->ForgetSema();
378 }
void AddedCXXImplicitMember(const CXXRecordDecl *RD, const Decl *D) override
An implicit member was added after the definition was completed.
FunctionDecl - An instance of this class is created to represent a function declaration or definition...
Definition: Decl.h:1618
void DeclarationMarkedUsed(const Decl *D) override
A declaration is marked used which was not previously marked used.
ASTMutationListener * GetASTMutationListener() override
If the consumer is interested in entities getting modified after their initial creation, it should return a pointer to an ASTMutationListener here.
void CompletedImplicitDefinition(const FunctionDecl *D) override
An implicit member got a definition.
Smart pointer class that efficiently represents Objective-C method names.
void SelectorRead(serialization::SelectorID iD, Selector Sel) override
A selector was read from the AST file.
void HandleTopLevelDeclInObjCContainer(DeclGroupRef D) override
Handle the specified top-level declaration that occurred inside and ObjC container.
A (possibly-)qualified type.
Definition: Type.h:616
void TypeRead(serialization::TypeIdx Idx, QualType T) override
A type was deserialized from the AST file.
void ResolvedOperatorDelete(const CXXDestructorDecl *DD, const FunctionDecl *Delete) override
A virtual destructor's operator delete has been resolved.
uint32_t IdentID
An ID number that refers to an identifier in an AST file.
Definition: ASTBitCodes.h:123
void ResolvedExceptionSpec(const FunctionDecl *FD) override
A function's exception specification has been evaluated or instantiated.
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:81
void HandleInlineFunctionDefinition(FunctionDecl *D) override
This callback is invoked each time an inline (method or friend) function definition in a class is com...
void HandleVTable(CXXRecordDecl *RD) override
Callback involved at the end of a translation unit to notify the consumer that a vtable for the given...
uint32_t DeclID
An ID number that refers to a declaration in an AST file.
Definition: ASTBitCodes.h:63
Declaration of a variable template.
MultiplexASTDeserializationListener(const std::vector< ASTDeserializationListener * > &L)
void DeclRead(serialization::DeclID ID, const Decl *D) override
A decl was deserialized from the AST file.
VarDecl - An instance of this class is created to represent a variable declaration or definition...
Definition: Decl.h:758
Represents a variable template specialization, which refers to a variable template with a given set o...
MultiplexASTMutationListener(ArrayRef< ASTMutationListener * > L)
void MacroDefinitionRead(serialization::PreprocessedEntityID, MacroDefinitionRecord *MD) override
A macro definition was read from the AST file.
void CompleteTentativeDefinition(VarDecl *D) override
CompleteTentativeDefinition - Callback invoked at the end of a translation unit to notify the consume...
ParmVarDecl - Represents a parameter to a function.
Definition: Decl.h:1434
RecordDecl - Represents a struct/union/class.
Definition: Decl.h:3354
Represents a class template specialization, which refers to a class template with a given set of temp...
One of these records is kept for each identifier that is lexed.
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:128
Record the location of a macro definition.
FieldDecl - An instance of this class is created by Sema::ActOnField to represent a member of a struc...
Definition: Decl.h:2366
void StaticDataMemberInstantiated(const VarDecl *D) override
A static data member was implicitly instantiated.
void PrintStats() override
PrintStats - If desired, print any statistics.
void DeclarationMarkedOpenMPThreadPrivate(const Decl *D) override
A declaration is marked as OpenMP threadprivate which was not previously marked as threadprivate...
Describes a module or submodule.
Definition: Module.h:57
An abstract interface that should be implemented by clients that read ASTs and then require further s...
Definition: SemaConsumer.h:26
bool HandleTopLevelDecl(DeclGroupRef D) override
HandleTopLevelDecl - Handle the specified top-level declaration.
uint32_t SubmoduleID
An ID number that refers to a submodule in a module file.
Definition: ASTBitCodes.h:160
void AddedAttributeToRecord(const Attr *Attr, const RecordDecl *Record) override
An attribute was added to a RecordDecl.
void DefaultArgumentInstantiated(const ParmVarDecl *D) override
A default argument was instantiated.
void HandleTagDeclRequiredDefinition(const TagDecl *D) override
This callback is invoked the first time each TagDecl is required to be complete.
Represents an ObjC class declaration.
Definition: DeclObjC.h:1108
void ReaderInitialized(ASTReader *Reader) override
The ASTReader was initialized.
Sema - This implements semantic analysis and AST building for C.
Definition: Sema.h:269
ASTContext * Context
void Initialize(ASTContext &Context) override
Initialize - This is called to initialize the consumer, providing the ASTContext. ...
void AddedCXXTemplateSpecialization(const ClassTemplateDecl *TD, const ClassTemplateSpecializationDecl *D) override
A template specialization (or partial one) was added to the template declaration. ...
void FunctionDefinitionInstantiated(const FunctionDecl *D) override
A function template's definition was instantiated.
Represents a C++ destructor within a class.
Definition: DeclCXX.h:2551
void HandleTagDeclDefinition(TagDecl *D) override
HandleTagDeclDefinition - This callback is invoked each time a TagDecl (e.g.
void DefaultMemberInitializerInstantiated(const FieldDecl *D) override
A default member initializer was instantiated.
void DeducedReturnType(const FunctionDecl *FD, QualType ReturnType) override
A function's return type has been deduced.
An abstract interface that should be implemented by listeners that want to be notified when an AST en...
void HandleInterestingDecl(DeclGroupRef D) override
HandleInterestingDecl - Handle the specified interesting declaration.
void IdentifierRead(serialization::IdentID ID, IdentifierInfo *II) override
An identifier was deserialized from the AST file.
void DeclarationMarkedOpenMPDeclareTarget(const Decl *D, const Attr *Attr) override
A declaration is marked as OpenMP declaretarget which was not previously marked as declaretarget...
void CompletedTagDefinition(const TagDecl *D) override
A new TagDecl definition was completed.
void AssignInheritanceModel(CXXRecordDecl *RD) override
Callback invoked when an MSInheritanceAttr has been attached to a CXXRecordDecl.
void HandleCXXImplicitFunctionInstantiation(FunctionDecl *D) override
Invoked when a function is implicitly instantiated.
void ModuleRead(serialization::SubmoduleID ID, Module *Mod) override
A module definition was read from the AST file.
const std::string ID
TagDecl - Represents the declaration of a struct/union/class/enum.
Definition: Decl.h:2816
ObjCCategoryDecl - Represents a category declaration.
Definition: DeclObjC.h:2189
void AddedVisibleDecl(const DeclContext *DC, const Decl *D) override
A new declaration with name has been added to a DeclContext.
uint32_t MacroID
An ID number that refers to a macro in an AST file.
Definition: ASTBitCodes.h:129
void HandleImplicitImportDecl(ImportDecl *D) override
Handle an ImportDecl that was implicitly created due to an inclusion directive.
void ForgetSema() override
Inform the semantic consumer that Sema is no longer available.
Describes a module import declaration, which makes the contents of the named module visible in the cu...
Definition: Decl.h:3829
void InitializeSema(Sema &S) override
Initialize the semantic consumer with the Sema instance being used to perform semantic analysis on th...
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition: DeclBase.h:1215
Reads an AST files chain containing the contents of a translation unit.
Definition: ASTReader.h:328
Encapsulates the data about a macro definition (e.g.
Definition: MacroInfo.h:34
uint32_t PreprocessedEntityID
An ID number that refers to an entity in the detailed preprocessing record.
Definition: ASTBitCodes.h:157
Represents a C++ struct/union/class.
Definition: DeclCXX.h:267
uint32_t SelectorID
An ID number that refers to an ObjC selector in an AST file.
Definition: ASTBitCodes.h:142
void MacroRead(serialization::MacroID ID, MacroInfo *MI) override
A macro was read from the AST file.
Declaration of a class template.
void HandleTranslationUnit(ASTContext &Ctx) override
HandleTranslationUnit - This method is called when the ASTs for entire translation unit have been par...
ASTDeserializationListener * GetASTDeserializationListener() override
If the consumer is interested in entities being deserialized from AST files, it should return a point...
void AddedObjCCategoryToInterface(const ObjCCategoryDecl *CatD, const ObjCInterfaceDecl *IFD) override
A new objc category class was added for an interface.
NamedDecl - This represents a decl with a name.
Definition: Decl.h:213
bool shouldSkipFunctionBody(Decl *D) override
This callback is called for each function if the Parser was initialized with SkipFunctionBodies set t...
Declaration of a template function.
Definition: DeclTemplate.h:939
A type index; the type ID with the qualifier bits removed.
Definition: ASTBitCodes.h:83
Attr - This represents one attribute.
Definition: Attr.h:43
void HandleCXXStaticMemberVarInstantiation(VarDecl *VD) override
HandleCXXStaticMemberVarInstantiation - Tell the consumer that this.
void RedefinedHiddenDefinition(const NamedDecl *D, Module *M) override
A definition has been made visible by being redefined locally.