clang 17.0.0git
FrontendActions.h
Go to the documentation of this file.
1//===-- FrontendActions.h - Useful Frontend Actions -------------*- 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#ifndef LLVM_CLANG_FRONTEND_FRONTENDACTIONS_H
10#define LLVM_CLANG_FRONTEND_FRONTENDACTIONS_H
11
13#include <memory>
14#include <string>
15#include <vector>
16
17namespace clang {
18
19//===----------------------------------------------------------------------===//
20// Custom Consumer Actions
21//===----------------------------------------------------------------------===//
22
24 void ExecuteAction() override;
25
26 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
27 StringRef InFile) override;
28
29public:
30 // Don't claim to only use the preprocessor, we want to follow the AST path,
31 // but do nothing.
32 bool usesPreprocessorOnly() const override { return false; }
33};
34
35/// Preprocessor-based frontend action that also loads PCH files.
37 void ExecuteAction() override;
38
39 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
40 StringRef InFile) override;
41
42public:
43 bool usesPreprocessorOnly() const override { return false; }
44};
45
47 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
48 StringRef InFile) override {
49 return nullptr;
50 }
51
52 void ExecuteAction() override;
53
54public:
55 bool usesPreprocessorOnly() const override { return true; }
56};
57
58//===----------------------------------------------------------------------===//
59// AST Consumer Actions
60//===----------------------------------------------------------------------===//
61
63protected:
64 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
65 StringRef InFile) override;
66};
67
69protected:
70 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
71 StringRef InFile) override;
72};
73
75protected:
76 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
77 StringRef InFile) override;
78};
79
81protected:
82 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
83 StringRef InFile) override;
84};
85
87protected:
88 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
89 StringRef InFile) override;
90
92 return TU_Prefix;
93 }
94
95 bool hasASTFileSupport() const override { return false; }
96
97 bool shouldEraseOutputFiles() override;
98
99public:
100 /// Compute the AST consumer arguments that will be used to
101 /// create the PCHGenerator instance returned by CreateASTConsumer.
102 ///
103 /// \returns false if an error occurred, true otherwise.
105 std::string &Sysroot);
106
107 /// Creates file to write the PCH into and returns a stream to write it
108 /// into. On error, returns null.
109 static std::unique_ptr<llvm::raw_pwrite_stream>
110 CreateOutputFile(CompilerInstance &CI, StringRef InFile,
111 std::string &OutputFile);
112
113 bool BeginSourceFileAction(CompilerInstance &CI) override;
114};
115
117 virtual std::unique_ptr<raw_pwrite_stream>
118 CreateOutputFile(CompilerInstance &CI, StringRef InFile) = 0;
119
120protected:
121 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
122 StringRef InFile) override;
123
125 return TU_Module;
126 }
127
128 bool hasASTFileSupport() const override { return false; }
129
130 bool shouldEraseOutputFiles() override;
131};
132
134protected:
135 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
136 StringRef InFile) override;
137
139 bool hasASTFileSupport() const override { return false; }
140};
141
143private:
144 bool BeginSourceFileAction(CompilerInstance &CI) override;
145
146 std::unique_ptr<raw_pwrite_stream>
147 CreateOutputFile(CompilerInstance &CI, StringRef InFile) override;
148};
149
151private:
152 bool BeginSourceFileAction(CompilerInstance &CI) override;
153
154 std::unique_ptr<raw_pwrite_stream>
155 CreateOutputFile(CompilerInstance &CI, StringRef InFile) override;
156};
157
159
160private:
161 bool BeginSourceFileAction(CompilerInstance &CI) override;
162
163 std::unique_ptr<raw_pwrite_stream>
164 CreateOutputFile(CompilerInstance &CI, StringRef InFile) override;
165};
166
168protected:
169 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
170 StringRef InFile) override;
171
172public:
173 ~SyntaxOnlyAction() override;
174 bool hasCodeCompletionSupport() const override { return true; }
175};
176
177/// Dump information about the given module file, to be used for
178/// basic debugging and discovery.
180public:
181 // Allow other tools (ex lldb) to direct output for their use.
182 llvm::raw_ostream *OutputStream = nullptr;
183
184protected:
185 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
186 StringRef InFile) override;
187 bool BeginInvocation(CompilerInstance &CI) override;
188 void ExecuteAction() override;
189
190public:
191 bool hasPCHSupport() const override { return false; }
192 bool hasASTFileSupport() const override { return true; }
193 bool hasIRSupport() const override { return false; }
194 bool hasCodeCompletionSupport() const override { return false; }
195};
196
198protected:
199 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
200 StringRef InFile) override;
201
202 void ExecuteAction() override;
203
204public:
205 bool hasCodeCompletionSupport() const override { return false; }
206};
207
209protected:
210 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
211 StringRef InFile) override;
212
213 void ExecuteAction() override;
214};
215
216/**
217 * Frontend action adaptor that merges ASTs together.
218 *
219 * This action takes an existing AST file and "merges" it into the AST
220 * context, producing a merged context. This action is an action
221 * adaptor, which forwards most of its calls to another action that
222 * will consume the merged context.
223 */
225 /// The action that the merge action adapts.
226 std::unique_ptr<FrontendAction> AdaptedAction;
227
228 /// The set of AST files to merge.
229 std::vector<std::string> ASTFiles;
230
231protected:
232 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &CI,
233 StringRef InFile) override;
234
235 bool BeginSourceFileAction(CompilerInstance &CI) override;
236
237 void ExecuteAction() override;
238 void EndSourceFileAction() override;
239
240public:
241 ASTMergeAction(std::unique_ptr<FrontendAction> AdaptedAction,
242 ArrayRef<std::string> ASTFiles);
243 ~ASTMergeAction() override;
244
245 bool usesPreprocessorOnly() const override;
247 bool hasPCHSupport() const override;
248 bool hasASTFileSupport() const override;
249 bool hasCodeCompletionSupport() const override;
250};
251
253protected:
254 void ExecuteAction() override;
255 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &,
256 StringRef) override {
257 return nullptr;
258 }
259
260 bool usesPreprocessorOnly() const override { return true; }
261};
262
264protected:
265 void ExecuteAction() override;
266 std::unique_ptr<ASTConsumer> CreateASTConsumer(CompilerInstance &,
267 StringRef) override {
268 return nullptr;
269 }
270
271 bool usesPreprocessorOnly() const override { return true; }
272};
273
274//===----------------------------------------------------------------------===//
275// Preprocessor Actions
276//===----------------------------------------------------------------------===//
277
279protected:
280 void ExecuteAction() override;
281};
282
284protected:
285 void ExecuteAction() override;
286};
287
289protected:
290 void ExecuteAction() override;
291};
292
294protected:
295 void ExecuteAction() override;
296
297 bool hasPCHSupport() const override { return true; }
298};
299
301 StringRef ModuleName;
302 void ExecuteAction() override;
303
304public:
306 : ModuleName(ModuleName) {}
307};
308
309} // end namespace clang
310
311#endif
Defines the clang::FrontendAction interface and various convenience abstract classes (clang::ASTFront...
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
Abstract base class to use for AST consumer-based frontend actions.
Frontend action adaptor that merges ASTs together.
bool hasCodeCompletionSupport() const override
Does this action support use with code completion?
Definition: ASTMerge.cpp:112
void EndSourceFileAction() override
Callback at the end of processing a single input.
Definition: ASTMerge.cpp:83
TranslationUnitKind getTranslationUnitKind() override
For AST-based actions, the kind of translation unit we're handling.
Definition: ASTMerge.cpp:100
~ASTMergeAction() override
Definition: ASTMerge.cpp:93
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
Definition: ASTMerge.cpp:96
bool hasASTFileSupport() const override
Does this action support use with AST files?
Definition: ASTMerge.cpp:108
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
Definition: ASTMerge.cpp:33
bool BeginSourceFileAction(CompilerInstance &CI) override
Callback at the start of processing a single input.
Definition: ASTMerge.cpp:24
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
Definition: ASTMerge.cpp:20
bool hasPCHSupport() const override
Does this action support use with PCH?
Definition: ASTMerge.cpp:104
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
CompilerInstance - Helper class for managing a single instance of the Clang compiler.
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
Dump information about the given module file, to be used for basic debugging and discovery.
bool hasCodeCompletionSupport() const override
Does this action support use with code completion?
bool hasASTFileSupport() const override
Does this action support use with AST files?
bool hasIRSupport() const override
Does this action support use with IR files?
bool hasPCHSupport() const override
Does this action support use with PCH?
llvm::raw_ostream * OutputStream
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
void ExecuteAction() override
Implement the ExecuteAction interface by running Sema on the already-initialized AST consumer.
bool BeginInvocation(CompilerInstance &CI) override
Callback before starting processing a single input, giving the opportunity to modify the CompilerInvo...
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
Abstract base class for actions which can be performed by the frontend.
friend class ASTMergeAction
TranslationUnitKind getTranslationUnitKind() override
For AST-based actions, the kind of translation unit we're handling.
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
bool hasASTFileSupport() const override
Does this action support use with AST files?
bool shouldEraseOutputFiles() override
Callback at the end of processing a single input, to determine if the output files should be erased o...
TranslationUnitKind getTranslationUnitKind() override
For AST-based actions, the kind of translation unit we're handling.
bool hasASTFileSupport() const override
Does this action support use with AST files?
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
static std::unique_ptr< llvm::raw_pwrite_stream > CreateOutputFile(CompilerInstance &CI, StringRef InFile, std::string &OutputFile)
Creates file to write the PCH into and returns a stream to write it into.
bool BeginSourceFileAction(CompilerInstance &CI) override
Callback at the start of processing a single input.
TranslationUnitKind getTranslationUnitKind() override
For AST-based actions, the kind of translation unit we're handling.
static bool ComputeASTConsumerArguments(CompilerInstance &CI, std::string &Sysroot)
Compute the AST consumer arguments that will be used to create the PCHGenerator instance returned by ...
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
bool hasASTFileSupport() const override
Does this action support use with AST files?
bool shouldEraseOutputFiles() override
Callback at the end of processing a single input, to determine if the output files should be erased o...
GetDependenciesByModuleNameAction(StringRef ModuleName)
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
Abstract base class to use for preprocessor-based frontend actions.
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &, StringRef) override
Create the AST consumer object for this action, if supported.
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &, StringRef) override
Create the AST consumer object for this action, if supported.
void ExecuteAction() override
Callback to run the program action, using the initialized compiler instance.
bool hasPCHSupport() const override
Does this action support use with PCH?
Preprocessor-based frontend action that also loads PCH files.
bool usesPreprocessorOnly() const override
Does this action only use the preprocessor?
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
bool hasCodeCompletionSupport() const override
Does this action support use with code completion?
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
void ExecuteAction() override
Implement the ExecuteAction interface by running Sema on the already-initialized AST consumer.
std::unique_ptr< ASTConsumer > CreateASTConsumer(CompilerInstance &CI, StringRef InFile) override
Create the AST consumer object for this action, if supported.
bool hasCodeCompletionSupport() const override
Does this action support use with code completion?
void ExecuteAction() override
Implement the ExecuteAction interface by running Sema on the already-initialized AST consumer.
TranslationUnitKind
Describes the kind of translation unit being processed.
Definition: LangOptions.h:917
@ TU_Module
The translation unit is a module.
Definition: LangOptions.h:926
@ TU_Prefix
The translation unit is a prefix to a translation unit, and is not complete.
Definition: LangOptions.h:923