clang  19.0.0git
MultiplexConsumer.cpp
Go to the documentation of this file.
1 //===- MultiplexConsumer.cpp - AST Consumer for PCH Generation --*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file defines the MultiplexConsumer class. It also declares and defines
10 // MultiplexASTDeserializationListener and MultiplexASTMutationListener, which
11 // are implementation details of MultiplexConsumer.
12 //
13 //===----------------------------------------------------------------------===//
14 
17 #include "clang/AST/DeclGroup.h"
18 
19 using namespace clang;
20 
21 namespace clang {
22 
23 class NamespaceDecl;
25 
27  const std::vector<ASTDeserializationListener*>& L)
28  : Listeners(L) {
29 }
30 
32  ASTReader *Reader) {
33  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
34  Listeners[i]->ReaderInitialized(Reader);
35 }
36 
39  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
40  Listeners[i]->IdentifierRead(ID, II);
41 }
42 
45  for (auto &Listener : Listeners)
46  Listener->MacroRead(ID, MI);
47 }
48 
51  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
52  Listeners[i]->TypeRead(Idx, T);
53 }
54 
56  const Decl *D) {
57  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
58  Listeners[i]->DeclRead(ID, D);
59 }
60 
63  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
64  Listeners[i]->SelectorRead(ID, Sel);
65 }
66 
69  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
70  Listeners[i]->MacroDefinitionRead(ID, MD);
71 }
72 
75  for (auto &Listener : Listeners)
76  Listener->ModuleRead(ID, Mod);
77 }
78 
81  for (auto &Listener : Listeners)
82  Listener->ModuleImportRead(ID, ImportLoc);
83 }
84 
85 // This ASTMutationListener forwards its notifications to a set of
86 // child listeners.
88 public:
89  // Does NOT take ownership of the elements in L.
91  void CompletedTagDefinition(const TagDecl *D) override;
92  void AddedVisibleDecl(const DeclContext *DC, const Decl *D) override;
93  void AddedCXXImplicitMember(const CXXRecordDecl *RD, const Decl *D) override;
95  const ClassTemplateSpecializationDecl *D) override;
97  const VarTemplateSpecializationDecl *D) override;
99  const FunctionDecl *D) override;
100  void ResolvedExceptionSpec(const FunctionDecl *FD) override;
101  void DeducedReturnType(const FunctionDecl *FD, QualType ReturnType) override;
103  const FunctionDecl *Delete,
104  Expr *ThisArg) override;
105  void CompletedImplicitDefinition(const FunctionDecl *D) override;
106  void InstantiationRequested(const ValueDecl *D) override;
107  void VariableDefinitionInstantiated(const VarDecl *D) override;
108  void FunctionDefinitionInstantiated(const FunctionDecl *D) override;
109  void DefaultArgumentInstantiated(const ParmVarDecl *D) override;
110  void DefaultMemberInitializerInstantiated(const FieldDecl *D) override;
112  const ObjCInterfaceDecl *IFD) override;
113  void DeclarationMarkedUsed(const Decl *D) override;
114  void DeclarationMarkedOpenMPThreadPrivate(const Decl *D) override;
115  void DeclarationMarkedOpenMPAllocate(const Decl *D, const Attr *A) override;
117  const Attr *Attr) override;
118  void RedefinedHiddenDefinition(const NamedDecl *D, Module *M) override;
119  void AddedAttributeToRecord(const Attr *Attr,
120  const RecordDecl *Record) override;
121  void EnteringModulePurview() override;
122  void AddedManglingNumber(const Decl *D, unsigned) override;
123  void AddedStaticLocalNumbers(const Decl *D, unsigned) override;
125  NamespaceDecl *AnonNamespace) override;
126 
127 private:
128  std::vector<ASTMutationListener*> Listeners;
129 };
130 
133  : Listeners(L.begin(), L.end()) {
134 }
135 
137  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
138  Listeners[i]->CompletedTagDefinition(D);
139 }
140 
142  const DeclContext *DC, const Decl *D) {
143  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
144  Listeners[i]->AddedVisibleDecl(DC, D);
145 }
146 
148  const CXXRecordDecl *RD, const Decl *D) {
149  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
150  Listeners[i]->AddedCXXImplicitMember(RD, D);
151 }
154  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
155  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
156 }
158  const VarTemplateDecl *TD, const VarTemplateSpecializationDecl *D) {
159  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
160  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
161 }
163  const FunctionTemplateDecl *TD, const FunctionDecl *D) {
164  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
165  Listeners[i]->AddedCXXTemplateSpecialization(TD, D);
166 }
168  const FunctionDecl *FD) {
169  for (auto &Listener : Listeners)
170  Listener->ResolvedExceptionSpec(FD);
171 }
173  QualType ReturnType) {
174  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
175  Listeners[i]->DeducedReturnType(FD, ReturnType);
176 }
178  const CXXDestructorDecl *DD, const FunctionDecl *Delete, Expr *ThisArg) {
179  for (auto *L : Listeners)
180  L->ResolvedOperatorDelete(DD, Delete, ThisArg);
181 }
183  const FunctionDecl *D) {
184  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
185  Listeners[i]->CompletedImplicitDefinition(D);
186 }
188  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
189  Listeners[i]->InstantiationRequested(D);
190 }
192  const VarDecl *D) {
193  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
194  Listeners[i]->VariableDefinitionInstantiated(D);
195 }
197  const FunctionDecl *D) {
198  for (auto &Listener : Listeners)
199  Listener->FunctionDefinitionInstantiated(D);
200 }
202  const ParmVarDecl *D) {
203  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
204  Listeners[i]->DefaultArgumentInstantiated(D);
205 }
207  const FieldDecl *D) {
208  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
209  Listeners[i]->DefaultMemberInitializerInstantiated(D);
210 }
212  const ObjCCategoryDecl *CatD,
213  const ObjCInterfaceDecl *IFD) {
214  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
215  Listeners[i]->AddedObjCCategoryToInterface(CatD, IFD);
216 }
218  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
219  Listeners[i]->DeclarationMarkedUsed(D);
220 }
222  const Decl *D) {
223  for (size_t i = 0, e = Listeners.size(); i != e; ++i)
224  Listeners[i]->DeclarationMarkedOpenMPThreadPrivate(D);
225 }
227  const Decl *D, const Attr *A) {
228  for (ASTMutationListener *L : Listeners)
229  L->DeclarationMarkedOpenMPAllocate(D, A);
230 }
232  const Decl *D, const Attr *Attr) {
233  for (auto *L : Listeners)
234  L->DeclarationMarkedOpenMPDeclareTarget(D, Attr);
235 }
237  Module *M) {
238  for (auto *L : Listeners)
239  L->RedefinedHiddenDefinition(D, M);
240 }
241 
243  const Attr *Attr,
244  const RecordDecl *Record) {
245  for (auto *L : Listeners)
246  L->AddedAttributeToRecord(Attr, Record);
247 }
248 
250  for (auto *L : Listeners)
251  L->EnteringModulePurview();
252 }
253 
255  unsigned Number) {
256  for (auto *L : Listeners)
257  L->AddedManglingNumber(D, Number);
258 }
260  unsigned Number) {
261  for (auto *L : Listeners)
262  L->AddedStaticLocalNumbers(D, Number);
263 }
265  const TranslationUnitDecl *TU, NamespaceDecl *AnonNamespace) {
266  for (auto *L : Listeners)
267  L->AddedAnonymousNamespace(TU, AnonNamespace);
268 }
269 
270 } // end namespace clang
271 
272 MultiplexConsumer::MultiplexConsumer(
273  std::vector<std::unique_ptr<ASTConsumer>> C)
274  : Consumers(std::move(C)) {
275  // Collect the mutation listeners and deserialization listeners of all
276  // children, and create a multiplex listener each if so.
277  std::vector<ASTMutationListener *> mutationListeners;
278  std::vector<ASTDeserializationListener*> serializationListeners;
279  for (auto &Consumer : Consumers) {
280  if (auto *mutationListener = Consumer->GetASTMutationListener())
281  mutationListeners.push_back(mutationListener);
282  if (auto *serializationListener = Consumer->GetASTDeserializationListener())
283  serializationListeners.push_back(serializationListener);
284  }
285  if (!mutationListeners.empty()) {
286  MutationListener =
287  std::make_unique<MultiplexASTMutationListener>(mutationListeners);
288  }
289  if (!serializationListeners.empty()) {
290  DeserializationListener =
291  std::make_unique<MultiplexASTDeserializationListener>(
292  serializationListeners);
293  }
294 }
295 
297 
299  for (auto &Consumer : Consumers)
300  Consumer->Initialize(Context);
301 }
302 
304  bool Continue = true;
305  for (auto &Consumer : Consumers)
306  Continue = Continue && Consumer->HandleTopLevelDecl(D);
307  return Continue;
308 }
309 
311  for (auto &Consumer : Consumers)
312  Consumer->HandleInlineFunctionDefinition(D);
313 }
314 
316  for (auto &Consumer : Consumers)
317  Consumer->HandleCXXStaticMemberVarInstantiation(VD);
318 }
319 
321  for (auto &Consumer : Consumers)
322  Consumer->HandleInterestingDecl(D);
323 }
324 
326  for (auto &Consumer : Consumers)
327  Consumer->HandleTranslationUnit(Ctx);
328 }
329 
331  for (auto &Consumer : Consumers)
332  Consumer->HandleTagDeclDefinition(D);
333 }
334 
336  for (auto &Consumer : Consumers)
337  Consumer->HandleTagDeclRequiredDefinition(D);
338 }
339 
341  for (auto &Consumer : Consumers)
342  Consumer->HandleCXXImplicitFunctionInstantiation(D);
343 }
344 
346  for (auto &Consumer : Consumers)
347  Consumer->HandleTopLevelDeclInObjCContainer(D);
348 }
349 
351  for (auto &Consumer : Consumers)
352  Consumer->HandleImplicitImportDecl(D);
353 }
354 
356  for (auto &Consumer : Consumers)
357  Consumer->CompleteTentativeDefinition(D);
358 }
359 
361  for (auto &Consumer : Consumers)
362  Consumer->CompleteExternalDeclaration(D);
363 }
364 
366  for (auto &Consumer : Consumers)
367  Consumer->AssignInheritanceModel(RD);
368 }
369 
371  for (auto &Consumer : Consumers)
372  Consumer->HandleVTable(RD);
373 }
374 
376  return MutationListener.get();
377 }
378 
380  return DeserializationListener.get();
381 }
382 
384  for (auto &Consumer : Consumers)
385  Consumer->PrintStats();
386 }
387 
389  bool Skip = true;
390  for (auto &Consumer : Consumers)
391  Skip = Skip && Consumer->shouldSkipFunctionBody(D);
392  return Skip;
393 }
394 
396  for (auto &Consumer : Consumers)
397  if (SemaConsumer *SC = dyn_cast<SemaConsumer>(Consumer.get()))
398  SC->InitializeSema(S);
399 }
400 
402  for (auto &Consumer : Consumers)
403  if (SemaConsumer *SC = dyn_cast<SemaConsumer>(Consumer.get()))
404  SC->ForgetSema();
405 }
static char ID
Definition: Arena.cpp:183
llvm::MachO::Record Record
Definition: MachO.h:31
Holds long-lived AST nodes (such as types and decls) that can be referred to throughout the semantic ...
Definition: ASTContext.h:185
An abstract interface that should be implemented by listeners that want to be notified when an AST en...
Reads an AST files chain containing the contents of a translation unit.
Definition: ASTReader.h:366
Attr - This represents one attribute.
Definition: Attr.h:46
Represents a C++ destructor within a class.
Definition: DeclCXX.h:2799
Represents a C++ struct/union/class.
Definition: DeclCXX.h:258
Declaration of a class template.
Represents a class template specialization, which refers to a class template with a given set of temp...
DeclContext - This is used only as base class of specific decl types that can act as declaration cont...
Definition: DeclBase.h:1436
Decl - This represents one declaration (or definition), e.g.
Definition: DeclBase.h:86
This represents one expression.
Definition: Expr.h:110
Represents a member of a struct/union/class.
Definition: Decl.h:3060
Represents a function declaration or definition.
Definition: Decl.h:1972
Declaration of a template function.
Definition: DeclTemplate.h:957
One of these records is kept for each identifier that is lexed.
Describes a module import declaration, which makes the contents of the named module visible in the cu...
Definition: Decl.h:4802
Record the location of a macro definition.
Encapsulates the data about a macro definition (e.g.
Definition: MacroInfo.h:39
Describes a module or submodule.
Definition: Module.h:105
void IdentifierRead(serialization::IdentifierID ID, IdentifierInfo *II) override
An identifier was deserialized from the AST file.
void MacroDefinitionRead(serialization::PreprocessedEntityID, MacroDefinitionRecord *MD) override
A macro definition was read from the AST file.
void ModuleRead(serialization::SubmoduleID ID, Module *Mod) override
A module definition was read from the AST file.
void TypeRead(serialization::TypeIdx Idx, QualType T) override
A type was deserialized from the AST file.
void DeclRead(GlobalDeclID ID, const Decl *D) override
A decl was deserialized from the AST file.
void SelectorRead(serialization::SelectorID iD, Selector Sel) override
A selector was read from the AST file.
void MacroRead(serialization::MacroID ID, MacroInfo *MI) override
A macro was read from the AST file.
void ReaderInitialized(ASTReader *Reader) override
The ASTReader was initialized.
void ModuleImportRead(serialization::SubmoduleID ID, SourceLocation ImportLoc) override
A module import was read from the AST file.
MultiplexASTDeserializationListener(const std::vector< ASTDeserializationListener * > &L)
void DeclarationMarkedUsed(const Decl *D) override
A declaration is marked used which was not previously marked used.
void AddedObjCCategoryToInterface(const ObjCCategoryDecl *CatD, const ObjCInterfaceDecl *IFD) override
A new objc category class was added for an interface.
void RedefinedHiddenDefinition(const NamedDecl *D, Module *M) override
A definition has been made visible by being redefined locally.
void ResolvedExceptionSpec(const FunctionDecl *FD) override
A function's exception specification has been evaluated or instantiated.
void DeclarationMarkedOpenMPAllocate(const Decl *D, const Attr *A) override
A declaration is marked as a variable with OpenMP allocator.
void CompletedImplicitDefinition(const FunctionDecl *D) override
An implicit member got a definition.
void EnteringModulePurview() override
The parser find the named module declaration.
void DefaultArgumentInstantiated(const ParmVarDecl *D) override
A default argument was instantiated.
void AddedStaticLocalNumbers(const Decl *D, unsigned) override
An static local number was added to a Decl.
void DeducedReturnType(const FunctionDecl *FD, QualType ReturnType) override
A function's return type has been deduced.
void AddedManglingNumber(const Decl *D, unsigned) override
An mangling number was added to a Decl.
void AddedCXXImplicitMember(const CXXRecordDecl *RD, const Decl *D) override
An implicit member was added after the definition was completed.
void VariableDefinitionInstantiated(const VarDecl *D) override
A templated variable's definition was implicitly instantiated.
void AddedAnonymousNamespace(const TranslationUnitDecl *, NamespaceDecl *AnonNamespace) override
An anonymous namespace was added the translation unit decl.
void DeclarationMarkedOpenMPThreadPrivate(const Decl *D) override
A declaration is marked as OpenMP threadprivate which was not previously marked as threadprivate.
MultiplexASTMutationListener(ArrayRef< ASTMutationListener * > L)
void ResolvedOperatorDelete(const CXXDestructorDecl *DD, const FunctionDecl *Delete, Expr *ThisArg) override
A virtual destructor's operator delete has been resolved.
void InstantiationRequested(const ValueDecl *D) override
The instantiation of a templated function or variable was requested.
void DeclarationMarkedOpenMPDeclareTarget(const Decl *D, const Attr *Attr) override
A declaration is marked as OpenMP declaretarget which was not previously marked as declaretarget.
void AddedVisibleDecl(const DeclContext *DC, const Decl *D) override
A new declaration with name has been added to a DeclContext.
void FunctionDefinitionInstantiated(const FunctionDecl *D) override
A function template's definition was instantiated.
void AddedCXXTemplateSpecialization(const ClassTemplateDecl *TD, const ClassTemplateSpecializationDecl *D) override
A template specialization (or partial one) was added to the template declaration.
void DefaultMemberInitializerInstantiated(const FieldDecl *D) override
A default member initializer was instantiated.
void CompletedTagDefinition(const TagDecl *D) override
A new TagDecl definition was completed.
void AddedAttributeToRecord(const Attr *Attr, const RecordDecl *Record) override
An attribute was added to a RecordDecl.
void HandleImplicitImportDecl(ImportDecl *D) override
Handle an ImportDecl that was implicitly created due to an inclusion directive.
ASTDeserializationListener * GetASTDeserializationListener() override
If the consumer is interested in entities being deserialized from AST files, it should return a point...
void HandleCXXImplicitFunctionInstantiation(FunctionDecl *D) override
Invoked when a function is implicitly instantiated.
bool HandleTopLevelDecl(DeclGroupRef D) override
HandleTopLevelDecl - Handle the specified top-level declaration.
void HandleTagDeclRequiredDefinition(const TagDecl *D) override
This callback is invoked the first time each TagDecl is required to be complete.
void AssignInheritanceModel(CXXRecordDecl *RD) override
Callback invoked when an MSInheritanceAttr has been attached to a CXXRecordDecl.
void HandleTagDeclDefinition(TagDecl *D) override
HandleTagDeclDefinition - This callback is invoked each time a TagDecl (e.g.
void InitializeSema(Sema &S) override
Initialize the semantic consumer with the Sema instance being used to perform semantic analysis on th...
void HandleTranslationUnit(ASTContext &Ctx) override
HandleTranslationUnit - This method is called when the ASTs for entire translation unit have been par...
void CompleteTentativeDefinition(VarDecl *D) override
CompleteTentativeDefinition - Callback invoked at the end of a translation unit to notify the consume...
void HandleInterestingDecl(DeclGroupRef D) override
HandleInterestingDecl - Handle the specified interesting declaration.
void CompleteExternalDeclaration(VarDecl *D) override
CompleteExternalDeclaration - Callback invoked at the end of a translation unit to notify the consume...
void HandleCXXStaticMemberVarInstantiation(VarDecl *VD) override
HandleCXXStaticMemberVarInstantiation - Tell the consumer that this.
void HandleVTable(CXXRecordDecl *RD) override
Callback involved at the end of a translation unit to notify the consumer that a vtable for the given...
bool shouldSkipFunctionBody(Decl *D) override
This callback is called for each function if the Parser was initialized with SkipFunctionBodies set t...
ASTMutationListener * GetASTMutationListener() override
If the consumer is interested in entities getting modified after their initial creation,...
void PrintStats() override
PrintStats - If desired, print any statistics.
void HandleTopLevelDeclInObjCContainer(DeclGroupRef D) override
Handle the specified top-level declaration that occurred inside and ObjC container.
void ForgetSema() override
Inform the semantic consumer that Sema is no longer available.
void HandleInlineFunctionDefinition(FunctionDecl *D) override
This callback is invoked each time an inline (method or friend) function definition in a class is com...
void Initialize(ASTContext &Context) override
Initialize - This is called to initialize the consumer, providing the ASTContext.
This represents a decl that may have a name.
Definition: Decl.h:249
Represent a C++ namespace.
Definition: Decl.h:548
ObjCCategoryDecl - Represents a category declaration.
Definition: DeclObjC.h:2326
Represents an ObjC class declaration.
Definition: DeclObjC.h:1153
Represents a parameter to a function.
Definition: Decl.h:1762
A (possibly-)qualified type.
Definition: Type.h:940
Represents a struct/union/class.
Definition: Decl.h:4171
Smart pointer class that efficiently represents Objective-C method names.
An abstract interface that should be implemented by clients that read ASTs and then require further s...
Definition: SemaConsumer.h:25
Sema - This implements semantic analysis and AST building for C.
Definition: Sema.h:462
Encodes a location in the source.
Represents the declaration of a struct/union/class/enum.
Definition: Decl.h:3587
The top declaration context.
Definition: Decl.h:84
Represent the declaration of a variable (in which case it is an lvalue) a function (in which case it ...
Definition: Decl.h:707
Represents a variable declaration or definition.
Definition: Decl.h:919
Declaration of a variable template.
Represents a variable template specialization, which refers to a variable template with a given set o...
A type index; the type ID with the qualifier bits removed.
Definition: ASTBitCodes.h:84
uint32_t SubmoduleID
An ID number that refers to a submodule in a module file.
Definition: ASTBitCodes.h:161
uint32_t SelectorID
An ID number that refers to an ObjC selector in an AST file.
Definition: ASTBitCodes.h:143
uint32_t PreprocessedEntityID
An ID number that refers to an entity in the detailed preprocessing record.
Definition: ASTBitCodes.h:158
uint32_t MacroID
An ID number that refers to a macro in an AST file.
Definition: ASTBitCodes.h:130
uint32_t IdentifierID
An ID number that refers to an identifier in an AST file.
Definition: ASTBitCodes.h:62
The JSON file list parser is used to communicate input to InstallAPI.
const FunctionProtoType * T
Definition: Format.h:5433