clang 22.0.0git
Public Member Functions | List of all members
clang::IncrementalAction Class Reference

A custom action enabling the incremental processing functionality. More...

#include "/home/buildbot/as-worker-4/publish-doxygen-docs/llvm-project/clang/lib/Interpreter/IncrementalAction.h"

Inheritance diagram for clang::IncrementalAction:
[legend]

Public Member Functions

 IncrementalAction (CompilerInstance &Instance, llvm::LLVMContext &LLVMCtx, llvm::Error &Err, Interpreter &I, std::unique_ptr< ASTConsumer > Consumer=nullptr)
 
FrontendActiongetWrapped () const
 
TranslationUnitKind getTranslationUnitKind () override
 For AST-based actions, the kind of translation unit we're handling.
 
std::unique_ptr< ASTConsumerCreateASTConsumer (CompilerInstance &CI, StringRef InFile) 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.
 
void EndSourceFile () override
 Perform any per-file post processing, deallocate per-file objects, and run statistics and output file cleanup code.
 
void FinalizeAction ()
 
void CacheCodeGenModule ()
 Cache the current CodeGen module to preserve internal references.
 
llvm::Module * getCachedCodeGenModule () const
 Access the cached CodeGen module.
 
CodeGeneratorgetCodeGen () const
 Access the current code generator.
 
std::unique_ptr< llvm::Module > GenModule ()
 Generate an LLVM module for the most recent parsed input.
 
- Public Member Functions inherited from clang::WrapperFrontendAction
 WrapperFrontendAction (std::unique_ptr< FrontendAction > WrappedAction)
 Construct a WrapperFrontendAction from an existing action, taking ownership of it.
 
bool usesPreprocessorOnly () const override
 Does this action only use the preprocessor?
 
TranslationUnitKind getTranslationUnitKind () override
 For AST-based actions, the kind of translation unit we're handling.
 
bool hasPCHSupport () const override
 Does this action support use with PCH?
 
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 hasCodeCompletionSupport () const override
 Does this action support use with code completion?
 
- Public Member Functions inherited from clang::FrontendAction
 FrontendAction ()
 
virtual ~FrontendAction ()
 
CompilerInstancegetCompilerInstance () const
 
void setCompilerInstance (CompilerInstance *Value)
 
bool isCurrentFileAST () const
 
const FrontendInputFilegetCurrentInput () const
 
StringRef getCurrentFile () const
 
StringRef getCurrentFileOrBufferName () const
 
InputKind getCurrentFileKind () const
 
ASTUnitgetCurrentASTUnit () const
 
ModulegetCurrentModule () const
 
std::unique_ptr< ASTUnittakeCurrentASTUnit ()
 
void setCurrentInput (const FrontendInputFile &CurrentInput, std::unique_ptr< ASTUnit > AST=nullptr)
 
virtual bool isModelParsingAction () const
 Is this action invoked on a model file?
 
bool PrepareToExecute (CompilerInstance &CI)
 Prepare the action to execute on the given compiler instance.
 
bool BeginSourceFile (CompilerInstance &CI, const FrontendInputFile &Input)
 Prepare the action for processing the input file Input.
 
llvm::Error Execute ()
 Set the source manager's main input file, and run the action.
 

Additional Inherited Members

- Protected Member Functions inherited from clang::WrapperFrontendAction
bool PrepareToExecuteAction (CompilerInstance &CI) override
 Prepare to execute the action on the given CompilerInstance.
 
std::unique_ptr< ASTConsumerCreateASTConsumer (CompilerInstance &CI, StringRef InFile) override
 Create the AST consumer object for this action, if supported.
 
bool BeginInvocation (CompilerInstance &CI) override
 Callback before starting processing a single input, giving the opportunity to modify the CompilerInvocation or do some other action before BeginSourceFileAction is called.
 
bool BeginSourceFileAction (CompilerInstance &CI) override
 Callback at the start of processing a single input.
 
void ExecuteAction () override
 Callback to run the program action, using the initialized compiler instance.
 
void EndSourceFile () override
 Perform any per-file post processing, deallocate per-file objects, and run statistics and output file cleanup code.
 
void EndSourceFileAction () override
 Callback at the end of processing a single input.
 
bool shouldEraseOutputFiles () override
 Callback at the end of processing a single input, to determine if the output files should be erased or not.
 
Implementation Action Interface
- Protected Attributes inherited from clang::WrapperFrontendAction
std::unique_ptr< FrontendActionWrappedAction
 

Detailed Description

A custom action enabling the incremental processing functionality.

The usual FrontendAction expects one call to ExecuteAction and once it sees a call to EndSourceFile it deletes some of the important objects such as Preprocessor and Sema assuming no further input will come.

IncrementalAction ensures it keep its underlying action's objects alive as long as the IncrementalParser needs them.

Definition at line 33 of file IncrementalAction.h.

Constructor & Destructor Documentation

◆ IncrementalAction()

clang::IncrementalAction::IncrementalAction ( CompilerInstance Instance,
llvm::LLVMContext &  LLVMCtx,
llvm::Error &  Err,
Interpreter I,
std::unique_ptr< ASTConsumer Consumer = nullptr 
)

Member Function Documentation

◆ CacheCodeGenModule()

void clang::IncrementalAction::CacheCodeGenModule ( )

Cache the current CodeGen module to preserve internal references.

Definition at line 90 of file IncrementalAction.cpp.

References GenModule().

◆ CreateASTConsumer()

std::unique_ptr< ASTConsumer > clang::IncrementalAction::CreateASTConsumer ( CompilerInstance CI,
StringRef  InFile 
)
overridevirtual

Create the AST consumer object for this action, if supported.

This routine is called as part of BeginSourceFile(), which will fail if the AST consumer cannot be created. This will not be called if the action has indicated that it only uses the preprocessor.

Parameters
CI- The current compiler instance, provided as a convenience, see getCompilerInstance().
InFile- The current input file, provided as a convenience, see getCurrentFile().
Returns
The new AST consumer, or null on failure.

Reimplemented from clang::WrapperFrontendAction.

Definition at line 59 of file IncrementalAction.cpp.

References clang::C, and clang::WrapperFrontendAction::CreateASTConsumer().

◆ EndSourceFile()

void clang::IncrementalAction::EndSourceFile ( )
overridevirtual

Perform any per-file post processing, deallocate per-file objects, and run statistics and output file cleanup code.

Reimplemented from clang::WrapperFrontendAction.

Definition at line 79 of file IncrementalAction.cpp.

References clang::WrapperFrontendAction::EndSourceFile(), and getWrapped().

Referenced by FinalizeAction().

◆ ExecuteAction()

void clang::IncrementalAction::ExecuteAction ( )
overridevirtual

Callback to run the program action, using the initialized compiler instance.

This is guaranteed to only be called between BeginSourceFileAction() and EndSourceFileAction().

Reimplemented from clang::WrapperFrontendAction.

Definition at line 74 of file IncrementalAction.cpp.

References clang::Sema::CurContext, clang::WrapperFrontendAction::ExecuteAction(), clang::FrontendAction::getCompilerInstance(), and clang::CompilerInstance::getSema().

◆ FinalizeAction()

void clang::IncrementalAction::FinalizeAction ( )

Definition at line 84 of file IncrementalAction.cpp.

References EndSourceFile().

◆ GenModule()

std::unique_ptr< llvm::Module > clang::IncrementalAction::GenModule ( )

Generate an LLVM module for the most recent parsed input.

Definition at line 98 of file IncrementalAction.cpp.

References getCodeGen(), clang::CompilerInstance::getPreprocessorOpts(), ID, and clang::PreprocessorOptions::Includes.

Referenced by CacheCodeGenModule(), and clang::IncrementalParser::RegisterPTU().

◆ getCachedCodeGenModule()

llvm::Module * clang::IncrementalAction::getCachedCodeGenModule ( ) const

Access the cached CodeGen module.

Definition at line 94 of file IncrementalAction.cpp.

◆ getCodeGen()

CodeGenerator * clang::IncrementalAction::getCodeGen ( ) const

Access the current code generator.

Definition at line 122 of file IncrementalAction.cpp.

References getWrapped(), and clang::FrontendAction::hasIRSupport().

Referenced by GenModule(), and clang::IncrementalParser::RegisterPTU().

◆ getTranslationUnitKind()

TranslationUnitKind clang::IncrementalAction::getTranslationUnitKind ( )
inlineoverridevirtual

For AST-based actions, the kind of translation unit we're handling.

Reimplemented from clang::WrapperFrontendAction.

Definition at line 51 of file IncrementalAction.h.

References clang::TU_Incremental.

◆ getWrapped()

FrontendAction * clang::IncrementalAction::getWrapped ( ) const
inline

Definition at line 49 of file IncrementalAction.h.

References clang::WrapperFrontendAction::WrappedAction.

Referenced by EndSourceFile(), and getCodeGen().


The documentation for this class was generated from the following files: