CompilerInstance - Helper class for managing a single instance of the Clang compiler. More...

#include "clang/Frontend/CompilerInstance.h"

Inheritance diagram for clang::CompilerInstance:

Collaboration diagram for clang::CompilerInstance:

Public Member Functions
	CompilerInstance (std::shared_ptr< PCHContainerOperations > PCHContainerOps=std::make_shared< PCHContainerOperations >(), InMemoryModuleCache *SharedModuleCache=nullptr)

	~CompilerInstance () override

High-Level Operations
{
bool	ExecuteAction (FrontendAction &Act)
	ExecuteAction - Execute the provided action against the compiler's CompilerInvocation object. More...

Compiler Invocation and Options
} {
bool	hasInvocation () const

CompilerInvocation &	getInvocation ()

void	setInvocation (std::shared_ptr< CompilerInvocation > Value)
	setInvocation - Replace the current invocation. More...

bool	shouldBuildGlobalModuleIndex () const
	Indicates whether we should (re)build the global module index. More...

void	setBuildGlobalModuleIndex (bool Build)
	Set the flag indicating whether we should (re)build the global module index. More...

Forwarding Methods
} {
AnalyzerOptionsRef	getAnalyzerOpts ()

CodeGenOptions &	getCodeGenOpts ()

const CodeGenOptions &	getCodeGenOpts () const

DependencyOutputOptions &	getDependencyOutputOpts ()

const DependencyOutputOptions &	getDependencyOutputOpts () const

DiagnosticOptions &	getDiagnosticOpts ()

const DiagnosticOptions &	getDiagnosticOpts () const

FileSystemOptions &	getFileSystemOpts ()

const FileSystemOptions &	getFileSystemOpts () const

FrontendOptions &	getFrontendOpts ()

const FrontendOptions &	getFrontendOpts () const

HeaderSearchOptions &	getHeaderSearchOpts ()

const HeaderSearchOptions &	getHeaderSearchOpts () const

std::shared_ptr< HeaderSearchOptions >	getHeaderSearchOptsPtr () const

LangOptions &	getLangOpts ()

const LangOptions &	getLangOpts () const

PreprocessorOptions &	getPreprocessorOpts ()

const PreprocessorOptions &	getPreprocessorOpts () const

PreprocessorOutputOptions &	getPreprocessorOutputOpts ()

const PreprocessorOutputOptions &	getPreprocessorOutputOpts () const

TargetOptions &	getTargetOpts ()

const TargetOptions &	getTargetOpts () const

Diagnostics Engine
} {
bool	hasDiagnostics () const

DiagnosticsEngine &	getDiagnostics () const
	Get the current diagnostics engine. More...

void	setDiagnostics (DiagnosticsEngine *Value)
	setDiagnostics - Replace the current diagnostics engine. More...

DiagnosticConsumer &	getDiagnosticClient () const

VerboseOutputStream
} }
void	setVerboseOutputStream (raw_ostream &Value)
	Replace the current stream for verbose output. More...

void	setVerboseOutputStream (std::unique_ptr< raw_ostream > Value)
	Replace the current stream for verbose output. More...

raw_ostream &	getVerboseOutputStream ()
	Get the current stream for verbose output. More...

Target Info
} {
bool	hasTarget () const

TargetInfo &	getTarget () const

void	setTarget (TargetInfo *Value)
	Replace the current Target. More...

AuxTarget Info
} {
TargetInfo *	getAuxTarget () const

void	setAuxTarget (TargetInfo *Value)
	Replace the current AuxTarget. More...

Virtual File System
} {
llvm::vfs::FileSystem &	getVirtualFileSystem () const

File Manager
} {
bool	hasFileManager () const

FileManager &	getFileManager () const
	Return the current file manager to the caller. More...

void	resetAndLeakFileManager ()

void	setFileManager (FileManager *Value)
	Replace the current file manager and virtual file system. More...

Source Manager
} {
bool	hasSourceManager () const

SourceManager &	getSourceManager () const
	Return the current source manager. More...

void	resetAndLeakSourceManager ()

void	setSourceManager (SourceManager *Value)
	setSourceManager - Replace the current source manager. More...

Preprocessor
} {
bool	hasPreprocessor () const

Preprocessor &	getPreprocessor () const
	Return the current preprocessor. More...

std::shared_ptr< Preprocessor >	getPreprocessorPtr ()

void	resetAndLeakPreprocessor ()

void	setPreprocessor (std::shared_ptr< Preprocessor > Value)
	Replace the current preprocessor. More...

ASTContext
} {
bool	hasASTContext () const

ASTContext &	getASTContext () const

void	resetAndLeakASTContext ()

void	setASTContext (ASTContext *Value)
	setASTContext - Replace the current AST context. More...

void	setSema (Sema *S)
	Replace the current Sema; the compiler instance takes ownership of S. More...

ASTConsumer
} {
bool	hasASTConsumer () const

ASTConsumer &	getASTConsumer () const

std::unique_ptr< ASTConsumer >	takeASTConsumer ()
	takeASTConsumer - Remove the current AST consumer and give ownership to the caller. More...

void	setASTConsumer (std::unique_ptr< ASTConsumer > Value)
	setASTConsumer - Replace the current AST consumer; the compiler instance takes ownership of `Value`. More...

Semantic analysis
} {
bool	hasSema () const

Sema &	getSema () const

std::unique_ptr< Sema >	takeSema ()

void	resetAndLeakSema ()

Module Management
} {
IntrusiveRefCntPtr< ASTReader >	getModuleManager () const

void	setModuleManager (IntrusiveRefCntPtr< ASTReader > Reader)

std::shared_ptr< ModuleDependencyCollector >	getModuleDepCollector () const

void	setModuleDepCollector (std::shared_ptr< ModuleDependencyCollector > Collector)

std::shared_ptr< PCHContainerOperations >	getPCHContainerOperations () const

const PCHContainerWriter &	getPCHContainerWriter () const
	Return the appropriate PCHContainerWriter depending on the current CodeGenOptions. More...

const PCHContainerReader &	getPCHContainerReader () const
	Return the appropriate PCHContainerReader depending on the current CodeGenOptions. More...

Code Completion
} {
bool	hasCodeCompletionConsumer () const

CodeCompleteConsumer &	getCodeCompletionConsumer () const

void	setCodeCompletionConsumer (CodeCompleteConsumer *Value)
	setCodeCompletionConsumer - Replace the current code completion consumer; the compiler instance takes ownership of `Value`. More...

Frontend timer
} {
bool	hasFrontendTimer () const

llvm::Timer &	getFrontendTimer () const

Output Files
} {
void	addOutputFile (OutputFile &&OutFile)
	addOutputFile - Add an output file onto the list of tracked output files. More...

void	clearOutputFiles (bool EraseFiles)
	clearOutputFiles - Clear the output file list. More...

Public Member Functions inherited from clang::ModuleLoader
	ModuleLoader (bool BuildingModule=false)

virtual	~ModuleLoader ()

bool	buildingModule () const
	Returns true if this instance is building a module. More...

void	setBuildingModule (bool BuildingModuleFlag)
	Flag indicating whether this instance is building a module. More...

Construction Utility Methods
} {
void	createDiagnostics (DiagnosticConsumer *Client=nullptr, bool ShouldOwnClient=true)
	Create the diagnostics engine using the invocation's diagnostic options and replace any existing one with it. More...

FileManager *	createFileManager (IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS=nullptr)
	Create the file manager and replace any existing one with it. More...

void	createSourceManager (FileManager &FileMgr)
	Create the source manager and replace any existing one with it. More...

void	createPreprocessor (TranslationUnitKind TUKind)
	Create the preprocessor, using the invocation, file, and source managers, and replace any existing one with it. More...

std::string	getSpecificModuleCachePath ()

void	createASTContext ()
	Create the AST context. More...

void	createPCHExternalASTSource (StringRef Path, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors, void *DeserializationListener, bool OwnDeserializationListener)
	Create an external AST source to read a PCH file and attach it to the AST context. More...

void	createCodeCompletionConsumer ()
	Create a code completion consumer using the invocation; note that this will cause the source manager to truncate the input source file at the completion point. More...

void	createSema (TranslationUnitKind TUKind, CodeCompleteConsumer *CompletionConsumer)
	Create the Sema object to be used for parsing. More...

void	createFrontendTimer ()
	Create the frontend timer and replace any existing one with it. More...

std::unique_ptr< raw_pwrite_stream >	createDefaultOutputFile (bool Binary=true, StringRef BaseInput="", StringRef Extension="")
	Create the default output file (from the invocation's options) and add it to the list of tracked output files. More...

std::unique_ptr< raw_pwrite_stream >	createOutputFile (StringRef OutputPath, bool Binary, bool RemoveFileOnSignal, StringRef BaseInput, StringRef Extension, bool UseTemporary, bool CreateMissingDirectories=false)
	Create a new output file and add it to the list of tracked output files, optionally deriving the output path name. More...

std::unique_ptr< raw_pwrite_stream >	createOutputFile (StringRef OutputPath, std::error_code &Error, bool Binary, bool RemoveFileOnSignal, StringRef BaseInput, StringRef Extension, bool UseTemporary, bool CreateMissingDirectories, std::string ResultPathName, std::string TempPathName)
	Create a new output file, optionally deriving the output path name. More...

std::unique_ptr< raw_pwrite_stream >	createNullOutputFile ()

static IntrusiveRefCntPtr< DiagnosticsEngine >	createDiagnostics (DiagnosticOptions Opts, DiagnosticConsumer Client=nullptr, bool ShouldOwnClient=true, const CodeGenOptions *CodeGenOpts=nullptr)
	Create a DiagnosticsEngine object with a the TextDiagnosticPrinter. More...

static IntrusiveRefCntPtr< ASTReader >	createPCHExternalASTSource (StringRef Path, StringRef Sysroot, bool DisablePCHValidation, bool AllowPCHWithCompilerErrors, Preprocessor &PP, InMemoryModuleCache &ModuleCache, ASTContext &Context, const PCHContainerReader &PCHContainerRdr, ArrayRef< std::shared_ptr< ModuleFileExtension >> Extensions, ArrayRef< std::shared_ptr< DependencyCollector >> DependencyCollectors, void *DeserializationListener, bool OwnDeserializationListener, bool Preamble, bool UseGlobalModuleIndex)
	Create an external AST source to read a PCH file. More...

static CodeCompleteConsumer *	createCodeCompletionConsumer (Preprocessor &PP, StringRef Filename, unsigned Line, unsigned Column, const CodeCompleteOptions &Opts, raw_ostream &OS)
	Create a code completion consumer to print code completion results, at `Filename`, `Line`, and `Column`, to the given output stream `OS`. More...

Initialization Utility Methods
} {
bool	InitializeSourceManager (const FrontendInputFile &Input)
	InitializeSourceManager - Initialize the source manager to set InputFile as the main file. More...

void	setOutputStream (std::unique_ptr< llvm::raw_pwrite_stream > OutStream)
	} More...

std::unique_ptr< llvm::raw_pwrite_stream >	takeOutputStream ()

void	createModuleManager ()

bool	loadModuleFile (StringRef FileName)

ModuleLoadResult	loadModule (SourceLocation ImportLoc, ModuleIdPath Path, Module::NameVisibilityKind Visibility, bool IsInclusionDirective) override
	Attempt to load the given module. More...

void	loadModuleFromSource (SourceLocation ImportLoc, StringRef ModuleName, StringRef Source) override
	Attempt to load the given module from the specified source buffer. More...

void	makeModuleVisible (Module *Mod, Module::NameVisibilityKind Visibility, SourceLocation ImportLoc) override
	Make the given module visible. More...

bool	hadModuleLoaderFatalFailure () const

GlobalModuleIndex *	loadGlobalModuleIndex (SourceLocation TriggerLoc) override
	Load, create, or return global module. More...

bool	lookupMissingImports (StringRef Name, SourceLocation TriggerLoc) override
	Check global module index for missing imports. More...

void	addDependencyCollector (std::shared_ptr< DependencyCollector > Listener)

void	setExternalSemaSource (IntrusiveRefCntPtr< ExternalSemaSource > ESS)

InMemoryModuleCache &	getModuleCache () const

static bool	InitializeSourceManager (const FrontendInputFile &Input, DiagnosticsEngine &Diags, FileManager &FileMgr, SourceManager &SourceMgr, HeaderSearch *HS, DependencyOutputOptions &DepOpts, const FrontendOptions &Opts)
	InitializeSourceManager - Initialize the source manager to set InputFile as the main file. More...

Additional Inherited Members
Public Attributes inherited from clang::ModuleLoader
bool	HadFatalFailure = false

Detailed Description

CompilerInstance - Helper class for managing a single instance of the Clang compiler.

The CompilerInstance serves two purposes: (1) It manages the various objects which are necessary to run the compiler, for example the preprocessor, the target information, and the AST context. (2) It provides utility routines for constructing and manipulating the common Clang objects.

The compiler instance generally owns the instance of all the objects that it manages. However, clients can still share objects by manually setting the object and retaking ownership prior to destroying the CompilerInstance.

The compiler instance is intended to simplify clients, but not to lock them in to the compiler instance for everything. When possible, utility functions come in two forms; a short form that reuses the CompilerInstance objects, and a long form that takes explicit instances of any required objects.

Definition at line 72 of file CompilerInstance.h.

Constructor & Destructor Documentation

◆ CompilerInstance()

CompilerInstance::CompilerInstance	(	std::shared_ptr< PCHContainerOperations >	PCHContainerOps = `std::make_shared<PCHContainerOperations>()`,
		InMemoryModuleCache *	SharedModuleCache = `nullptr`
	)

explicit

Definition at line 58 of file CompilerInstance.cpp.

◆ ~CompilerInstance()

CompilerInstance::~CompilerInstance ( )

override

Definition at line 67 of file CompilerInstance.cpp.

Member Function Documentation

◆ addDependencyCollector()

void clang::CompilerInstance::addDependencyCollector ( std::shared_ptr< DependencyCollector > Listener )

inline

Definition at line 811 of file CompilerInstance.h.

Referenced by createPreprocessor().

◆ addOutputFile()

void CompilerInstance::addOutputFile ( OutputFile && OutFile )

addOutputFile - Add an output file onto the list of tracked output files.

Parameters

OutFile - The output file info.

Definition at line 635 of file CompilerInstance.cpp.

Referenced by createOutputFile().

◆ clearOutputFiles()

void CompilerInstance::clearOutputFiles ( bool EraseFiles )

clearOutputFiles - Clear the output file list.

The underlying output streams must have been closed beforehand.

Parameters

EraseFiles - If true, attempt to erase the files from disk.

Definition at line 639 of file CompilerInstance.cpp.

References getDiagnostics(), clang::transformer::remove(), and clang::DiagnosticsEngine::Report().

Referenced by clang::FrontendAction::BeginSourceFile(), and clang::FrontendAction::EndSourceFile().

◆ createASTContext()

void CompilerInstance::createASTContext ( )

Create the AST context.

Definition at line 482 of file CompilerInstance.cpp.

References getAuxTarget(), clang::Preprocessor::getBuiltinInfo(), clang::Preprocessor::getIdentifierTable(), getLangOpts(), getPreprocessor(), clang::Preprocessor::getSelectorTable(), clang::Preprocessor::getSourceManager(), getTarget(), and setASTContext().

Referenced by clang::FrontendAction::BeginSourceFile(), and createModuleManager().

◆ createCodeCompletionConsumer() [1/2]

void CompilerInstance::createCodeCompletionConsumer ( )

Create a code completion consumer using the invocation; note that this will cause the source manager to truncate the input source file at the completion point.

Definition at line 583 of file CompilerInstance.cpp.

References clang::FrontendOptions::CodeCompletionAt, clang::ParsedSourceLocation::Column, EnableCodeCompletion(), clang::ParsedSourceLocation::FileName, getFrontendOpts(), getPreprocessor(), clang::ParsedSourceLocation::Line, and setCodeCompletionConsumer().

Referenced by clang::ASTFrontendAction::ExecuteAction().

◆ createCodeCompletionConsumer() [2/2]

CodeCompleteConsumer * CompilerInstance::createCodeCompletionConsumer	(	Preprocessor &	PP,
		StringRef	Filename,
		unsigned	Line,
		unsigned	Column,
		const CodeCompleteOptions &	Opts,
		raw_ostream &	OS
	)

static

Create a code completion consumer to print code completion results, at Filename, Line, and Column, to the given output stream OS.

Definition at line 609 of file CompilerInstance.cpp.

References EnableCodeCompletion().

◆ createDefaultOutputFile()

std::unique_ptr< raw_pwrite_stream > CompilerInstance::createDefaultOutputFile	(	bool	Binary = `true`,
		StringRef	BaseInput = `""`,
		StringRef	Extension = `""`
	)

Create the default output file (from the invocation's options) and add it to the list of tracked output files.

The files created by this function always use temporary files to write to their result (that is, the data is written to a temporary file which will atomically replace the target output on success).

Returns: - Null on error.

Definition at line 671 of file CompilerInstance.cpp.

References createOutputFile(), and getFrontendOpts().

Referenced by clang::RewriteIncludesAction::BeginSourceFileAction(), clang::HTMLPrintAction::CreateASTConsumer(), clang::ASTPrintAction::CreateASTConsumer(), clang::RewriteObjCAction::CreateASTConsumer(), clang::GenerateModuleAction::CreateASTConsumer(), clang::RewriteMacrosAction::ExecuteAction(), clang::RewriteTestAction::ExecuteAction(), clang::PrintPreambleAction::ExecuteAction(), clang::PrintPreprocessedAction::ExecuteAction(), and GetOutputStream().

◆ createDiagnostics() [1/2]

void CompilerInstance::createDiagnostics	(	DiagnosticConsumer *	Client = `nullptr`,
		bool	ShouldOwnClient = `true`
	)

Create the diagnostics engine using the invocation's diagnostic options and replace any existing one with it.

Note that this routine also replaces the diagnostic client, allocating one if one is not provided.

Parameters

Client	If non-NULL, a diagnostic client that will be attached to (and, then, owned by) the DiagnosticsEngine inside this AST unit.
ShouldOwnClient	If Client is non-NULL, specifies whether the diagnostic object should take ownership of the client.

Definition at line 268 of file CompilerInstance.cpp.

References getCodeGenOpts(), and getDiagnosticOpts().

Referenced by clang::createInvocationFromCommandLine(), clang::tooling::ClangTool::run(), and clang::tooling::FrontendActionFactory::runInvocation().

◆ createDiagnostics() [2/2]

IntrusiveRefCntPtr< DiagnosticsEngine > CompilerInstance::createDiagnostics	(	DiagnosticOptions *	Opts,
		DiagnosticConsumer *	Client = `nullptr`,
		bool	ShouldOwnClient = `true`,
		const CodeGenOptions *	CodeGenOpts = `nullptr`
	)

static

Create a DiagnosticsEngine object with a the TextDiagnosticPrinter.

If no diagnostic client is provided, this creates a DiagnosticConsumer that is owned by the returned diagnostic object, if using directly the caller is responsible for releasing the returned DiagnosticsEngine's client eventually.

Parameters

Opts	- The diagnostic options; note that the created text diagnostic object contains a reference to these options.
Client	If non-NULL, a diagnostic client that will be attached to (and, then, owned by) the returned DiagnosticsEngine object.
CodeGenOpts	If non-NULL, the code gen options in use, which may be used by some diagnostics printers (for logging purposes only).

Returns: The new object on success, or null on failure.

Definition at line 275 of file CompilerInstance.cpp.

References clang::DiagnosticOptions::DiagnosticLogFile, clang::DiagnosticOptions::DiagnosticSerializationFile, clang::ProcessWarningOptions(), SetUpDiagnosticLog(), and SetupSerializedDiagnostics().

◆ createFileManager()

FileManager * CompilerInstance::createFileManager ( IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS = nullptr )

Create the file manager and replace any existing one with it.

Returns: The new file manager on success, or null on failure.

Definition at line 310 of file CompilerInstance.cpp.

References clang::createVFSFromCompilerInvocation(), getDiagnostics(), getFileSystemOpts(), and getInvocation().

Referenced by clang::FrontendAction::BeginSourceFile().

◆ createFrontendTimer()

void CompilerInstance::createFrontendTimer ( )

Create the frontend timer and replace any existing one with it.

Definition at line 600 of file CompilerInstance.cpp.

◆ createModuleManager()

void CompilerInstance::createModuleManager ( )

Definition at line 1474 of file CompilerInstance.cpp.

References createASTContext(), clang::PreprocessorOptions::DisablePCHValidation, getASTConsumer(), getASTContext(), getFrontendOpts(), getHeaderSearchOpts(), getModuleCache(), getPCHContainerReader(), getPreprocessor(), getPreprocessorOpts(), getSema(), getSourceManager(), hasASTConsumer(), hasASTContext(), hasSema(), clang::HeaderSearchOptions::ModulesValidateSystemHeaders, pruneModuleCache(), clang::ASTContext::setASTMutationListener(), clang::ASTReader::setDeserializationListener(), clang::ASTContext::setExternalSource(), clang::HeaderSearchOptions::Sysroot, clang::FrontendOptions::UseGlobalModuleIndex, and clang::HeaderSearchOptions::ValidateASTInputFilesContent.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::RewriteIncludesAction::BeginSourceFileAction(), loadGlobalModuleIndex(), loadModule(), and makeModuleVisible().

◆ createNullOutputFile()

std::unique_ptr< raw_pwrite_stream > CompilerInstance::createNullOutputFile ( )

Definition at line 678 of file CompilerInstance.cpp.

Referenced by GetOutputStream().

◆ createOutputFile() [1/2]

std::unique_ptr< raw_pwrite_stream > CompilerInstance::createOutputFile	(	StringRef	OutputPath,
		bool	Binary,
		bool	RemoveFileOnSignal,
		StringRef	BaseInput,
		StringRef	Extension,
		bool	UseTemporary,
		bool	CreateMissingDirectories = `false`
	)

Create a new output file and add it to the list of tracked output files, optionally deriving the output path name.

Returns: - Null on error.

Definition at line 683 of file CompilerInstance.cpp.

References addOutputFile(), getDiagnostics(), and clang::DiagnosticsEngine::Report().

Referenced by clang::GenerateModuleAction::CreateASTConsumer(), createDefaultOutputFile(), and clang::GeneratePCHAction::CreateOutputFile().

◆ createOutputFile() [2/2]

std::unique_ptr< llvm::raw_pwrite_stream > CompilerInstance::createOutputFile	(	StringRef	OutputPath,
		std::error_code &	Error,
		bool	Binary,
		bool	RemoveFileOnSignal,
		StringRef	BaseInput,
		StringRef	Extension,
		bool	UseTemporary,
		bool	CreateMissingDirectories,
		std::string *	ResultPathName,
		std::string *	TempPathName
	)

Create a new output file, optionally deriving the output path name.

If OutputPath is empty, then createOutputFile will derive an output path location as BaseInput, with any suffix removed, and Extension appended. If OutputPath is not stdout and UseTemporary is true, createOutputFile will create a new temporary file that must be renamed to OutputPath in the end.

Parameters

OutputPath	- If given, the path to the output file.
Error	[out] - On failure, the error.
BaseInput	- If `OutputPath` is empty, the input path name to use for deriving the output path.
Extension	- The extension to use for derived output names.
Binary	- The mode to open the file in.
RemoveFileOnSignal	- Whether the file should be registered with llvm::sys::RemoveFileOnSignal. Note that this is not safe for multithreaded use, as the underlying signal mechanism is not reentrant
UseTemporary	- Create a new temporary file that must be renamed to OutputPath in the end.
CreateMissingDirectories	- When `UseTemporary` is true, create missing directories in the output path.
ResultPathName	[out] - If given, the result path name will be stored here on success.
TempPathName	[out] - If given, the temporary file path name will be stored here on success.

Definition at line 706 of file CompilerInstance.cpp.

◆ createPCHExternalASTSource() [1/2]

void CompilerInstance::createPCHExternalASTSource	(	StringRef	Path,
		bool	DisablePCHValidation,
		bool	AllowPCHWithCompilerErrors,
		void *	DeserializationListener,
		bool	OwnDeserializationListener
	)

Create an external AST source to read a PCH file and attach it to the AST context.

Definition at line 493 of file CompilerInstance.cpp.

References getASTContext(), getFrontendOpts(), getHeaderSearchOpts(), getModuleCache(), getPCHContainerReader(), getPreprocessor(), getPreprocessorOpts(), clang::Preamble, and clang::PreprocessorOptions::PrecompiledPreambleBytes.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ createPCHExternalASTSource() [2/2]

IntrusiveRefCntPtr< ASTReader > CompilerInstance::createPCHExternalASTSource	(	StringRef	Path,
		StringRef	Sysroot,
		bool	DisablePCHValidation,
		bool	AllowPCHWithCompilerErrors,
		Preprocessor &	PP,
		InMemoryModuleCache &	ModuleCache,
		ASTContext &	Context,
		const PCHContainerReader &	PCHContainerRdr,
		ArrayRef< std::shared_ptr< ModuleFileExtension >>	Extensions,
		ArrayRef< std::shared_ptr< DependencyCollector >>	DependencyCollectors,
		void *	DeserializationListener,
		bool	OwnDeserializationListener,
		bool	Preamble,
		bool	UseGlobalModuleIndex
	)

static

Create an external AST source to read a PCH file.

Returns: - The new object on success, or null on failure.

Definition at line 506 of file CompilerInstance.cpp.

References clang::ASTReader::ARR_None, clang::ASTReader::ConfigurationMismatch, clang::ASTReader::Failure, clang::Preprocessor::getHeaderSearchInfo(), clang::HeaderSearch::getHeaderSearchOpts(), clang::ASTReader::HadErrors, clang::ASTReader::Missing, clang::serialization::MK_PCH, clang::serialization::MK_Preamble, clang::HeaderSearchOptions::ModulesValidateSystemHeaders, clang::ASTReader::OutOfDate, clang::ASTContext::setExternalSource(), clang::Preprocessor::setPredefines(), clang::ASTReader::Success, clang::HeaderSearchOptions::ValidateASTInputFilesContent, and clang::ASTReader::VersionMismatch.

◆ createPreprocessor()

void CompilerInstance::createPreprocessor ( TranslationUnitKind TUKind )

Create the preprocessor, using the invocation, file, and source managers, and replace any existing one with it.

Definition at line 379 of file CompilerInstance.cpp.

References addDependencyCollector(), clang::TargetInfo::adjust(), clang::ApplyHeaderSearchOptions(), clang::AttachDependencyGraphGen(), clang::AttachHeaderIncludeGen(), collectHeaderMaps(), collectIncludePCH(), collectVFSEntries(), clang::PreprocessorOptions::DetailedRecord, clang::DependencyOutputOptions::DOTOutputFile, getAuxTarget(), getDependencyOutputOpts(), getDiagnostics(), getFrontendOpts(), getHeaderSearchOpts(), getHeaderSearchOptsPtr(), getLangOpts(), getPCHContainerReader(), getPreprocessorOpts(), getPreprocessorOutputOpts(), getSourceManager(), getSpecificModuleCachePath(), getTarget(), clang::DependencyOutputOptions::HeaderIncludeOutputFile, InitializeFileRemapping(), clang::InitializePreprocessor(), clang::DependencyOutputOptions::ModuleDependencyOutputDir, clang::None, clang::DependencyOutputOptions::OutputFile, clang::DependencyOutputOptions::ShowHeaderIncludes, clang::DependencyOutputOptions::ShowIncludesDest, and clang::HeaderSearchOptions::Sysroot.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ createSema()

void CompilerInstance::createSema	(	TranslationUnitKind	TUKind,
		CodeCompleteConsumer *	CompletionConsumer
	)

Create the Sema object to be used for parsing.

Definition at line 622 of file CompilerInstance.cpp.

References getASTConsumer(), getASTContext(), and getPreprocessor().

Referenced by clang::ASTFrontendAction::ExecuteAction().

◆ createSourceManager()

void CompilerInstance::createSourceManager ( FileManager & FileMgr )

Create the source manager and replace any existing one with it.

Definition at line 323 of file CompilerInstance.cpp.

References getDiagnostics().

Referenced by clang::FrontendAction::BeginSourceFile(), and clang::tooling::FrontendActionFactory::runInvocation().

◆ ExecuteAction()

bool CompilerInstance::ExecuteAction ( FrontendAction & Act )

ExecuteAction - Execute the provided action against the compiler's CompilerInvocation object.

This function makes the following assumptions:

The invocation options should be initialized. This function does not handle the '-help' or '-version' options, clients should handle those directly.
The diagnostics engine should have already been created by the client.
No other CompilerInstance state should have been initialized (this is an unchecked error).
Clients should have initialized any LLVM target features that may be required.
Clients should eventually call llvm_shutdown() upon the completion of this routine to ensure that any managed objects are properly destroyed.

Note that this routine may write output to 'stderr'.

Parameters

Act	- The action to execute.

Returns: - True on success.

Definition at line 899 of file CompilerInstance.cpp.

References clang::TargetInfo::adjust(), clang::TargetInfo::adjustTargetOptions(), clang::TargetInfo::CreateTargetInfo(), clang::CUDA, getAuxTarget(), getCodeGenOpts(), getDiagnostics(), getFrontendOpts(), getHeaderSearchOpts(), getInvocation(), getLangOpts(), getTarget(), getTargetOpts(), clang::TargetInfo::getTriple(), getVerboseOutputStream(), hasDiagnostics(), hasTarget(), normalize(), clang::TargetInfo::noSignedCharForObjCBool(), clang::noteBottomOfStack(), clang::FrontendAction::PrepareToExecute(), clang::frontend::RewriteObjC, setAuxTarget(), clang::TargetInfo::setAuxTarget(), and setTarget().

Referenced by clang::ExecuteCompilerInvocation(), and clang::tooling::FrontendActionFactory::runInvocation().

◆ getAnalyzerOpts()

AnalyzerOptionsRef clang::CompilerInstance::getAnalyzerOpts ( )

inline

Definition at line 257 of file CompilerInstance.h.

Referenced by clang::ento::CreateAnalysisConsumer(), clang::ExecuteCompilerInvocation(), and clang::ento::ModelInjector::ModelInjector().

◆ getASTConsumer()

ASTConsumer& clang::CompilerInstance::getASTConsumer ( ) const

inline

Definition at line 491 of file CompilerInstance.h.

Referenced by createModuleManager(), createSema(), clang::ASTMergeAction::ExecuteAction(), setASTConsumer(), and setASTContext().

◆ getASTContext()

ASTContext& clang::CompilerInstance::getASTContext ( ) const

inline

Definition at line 468 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), createASTReader(), createModuleManager(), createPCHExternalASTSource(), createSema(), clang::VerifyPCHAction::ExecuteAction(), clang::ASTMergeAction::ExecuteAction(), makeStandaloneDiagnostic(), clang::ento::ModelInjector::ModelInjector(), setASTConsumer(), and setASTContext().

◆ getAuxTarget()

TargetInfo* clang::CompilerInstance::getAuxTarget ( ) const

inline

Definition at line 388 of file CompilerInstance.h.

Referenced by createASTContext(), createPreprocessor(), and ExecuteAction().

◆ getCodeCompletionConsumer()

CodeCompleteConsumer& clang::CompilerInstance::getCodeCompletionConsumer ( ) const

inline

Definition at line 566 of file CompilerInstance.h.

Referenced by clang::ASTFrontendAction::ExecuteAction().

◆ getCodeGenOpts() [1/2]

CodeGenOptions& clang::CompilerInstance::getCodeGenOpts ( )

inline

Definition at line 261 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::RewriteObjCAction::CreateASTConsumer(), clang::CodeGenAction::CreateASTConsumer(), createDiagnostics(), clang::CodeGenAction::ExecuteAction(), and ExecuteAction().

◆ getCodeGenOpts() [2/2]

const CodeGenOptions& clang::CompilerInstance::getCodeGenOpts ( ) const

inline

Definition at line 264 of file CompilerInstance.h.

◆ getDependencyOutputOpts() [1/2]

DependencyOutputOptions& clang::CompilerInstance::getDependencyOutputOpts ( )

inline

Definition at line 268 of file CompilerInstance.h.

Referenced by createPreprocessor(), and InitializeSourceManager().

◆ getDependencyOutputOpts() [2/2]

const DependencyOutputOptions& clang::CompilerInstance::getDependencyOutputOpts ( ) const

inline

Definition at line 271 of file CompilerInstance.h.

◆ getDiagnosticClient()

DiagnosticConsumer& clang::CompilerInstance::getDiagnosticClient ( ) const

inline

Definition at line 349 of file CompilerInstance.h.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), compileModuleImpl(), clang::FrontendAction::EndSourceFile(), clang::ento::ModelInjector::ModelInjector(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getDiagnosticOpts() [1/2]

DiagnosticOptions& clang::CompilerInstance::getDiagnosticOpts ( )

inline

Definition at line 275 of file CompilerInstance.h.

Referenced by clang::RewriteObjCAction::CreateASTConsumer(), clang::createChainedIncludesSource(), createDiagnostics(), clang::ASTMergeAction::ExecuteAction(), and clang::PrintDependencyDirectivesSourceMinimizerAction::ExecuteAction().

◆ getDiagnosticOpts() [2/2]

const DiagnosticOptions& clang::CompilerInstance::getDiagnosticOpts ( ) const

inline

Definition at line 278 of file CompilerInstance.h.

◆ getDiagnostics()

DiagnosticsEngine& clang::CompilerInstance::getDiagnostics ( ) const

inline

Get the current diagnostics engine.

Definition at line 341 of file CompilerInstance.h.

Referenced by clang::arcmt::CheckAction::BeginInvocation(), clang::arcmt::ModifyAction::BeginInvocation(), clang::arcmt::MigrateSourceAction::BeginInvocation(), clang::arcmt::MigrateAction::BeginInvocation(), clang::FixItRecompile::BeginInvocation(), clang::arcmt::ObjCMigrateAction::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), clang::FixItAction::BeginSourceFileAction(), clearOutputFiles(), compileAndLoadModule(), compileModuleImpl(), clang::GeneratePCHAction::ComputeASTConsumerArguments(), clang::RewriteObjCAction::CreateASTConsumer(), clang::CodeGenAction::CreateASTConsumer(), clang::GenerateModuleAction::CreateASTConsumer(), createFileManager(), clang::CreateFrontendBaseAction(), createOutputFile(), createPreprocessor(), createSourceManager(), clang::CodeGenAction::ExecuteAction(), ExecuteAction(), clang::ASTMergeAction::ExecuteAction(), clang::PrintDependencyDirectivesSourceMinimizerAction::ExecuteAction(), clang::ExecuteCompilerInvocation(), clang::FrontendAction::getCurrentModule(), getInputBufferForModule(), InitializeSourceManager(), loadModule(), loadModuleFromSource(), prepareToBuildModule(), and clang::FrontendAction::shouldEraseOutputFiles().

◆ getFileManager()

FileManager& clang::CompilerInstance::getFileManager ( ) const

inline

Return the current file manager to the caller.

Definition at line 408 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), collectIncludePCH(), compileModuleImpl(), clang::arcmt::MigrateSourceAction::CreateASTConsumer(), clang::CodeGenAction::CreateASTConsumer(), clang::arcmt::ObjCMigrateAction::CreateASTConsumer(), clang::FrontendAction::Execute(), clang::DumpModuleInfoAction::ExecuteAction(), clang::ASTMergeAction::ExecuteAction(), clang::PrintPreambleAction::ExecuteAction(), getInputBufferForModule(), InitializeSourceManager(), loadGlobalModuleIndex(), clang::ento::ModelInjector::ModelInjector(), prepareToBuildModule(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getFileSystemOpts() [1/2]

FileSystemOptions& clang::CompilerInstance::getFileSystemOpts ( )

inline

Definition at line 282 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), createFileManager(), clang::cross_tu::CrossTranslationUnitContext::emitCrossTUDiagnostics(), and clang::ASTMergeAction::ExecuteAction().

◆ getFileSystemOpts() [2/2]

const FileSystemOptions& clang::CompilerInstance::getFileSystemOpts ( ) const

inline

Definition at line 285 of file CompilerInstance.h.

◆ getFrontendOpts() [1/2]

FrontendOptions& clang::CompilerInstance::getFrontendOpts ( )

inline

Definition at line 289 of file CompilerInstance.h.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), clang::FixItAction::BeginSourceFileAction(), compileModuleImpl(), clang::GeneratePCHAction::ComputeASTConsumerArguments(), clang::ento::CreateAnalysisConsumer(), clang::arcmt::MigrateSourceAction::CreateASTConsumer(), clang::ASTPrintAction::CreateASTConsumer(), clang::ASTDumpAction::CreateASTConsumer(), clang::CodeGenAction::CreateASTConsumer(), clang::GeneratePCHAction::CreateASTConsumer(), clang::GenerateModuleAction::CreateASTConsumer(), clang::createChainedIncludesSource(), createCodeCompletionConsumer(), createDefaultOutputFile(), clang::CreateFrontendAction(), clang::CreateFrontendBaseAction(), createModuleManager(), clang::GeneratePCHAction::CreateOutputFile(), createPCHExternalASTSource(), createPreprocessor(), clang::FrontendAction::EndSourceFile(), clang::DumpModuleInfoAction::ExecuteAction(), clang::VerifyPCHAction::ExecuteAction(), ExecuteAction(), clang::ASTFrontendAction::ExecuteAction(), clang::ExecuteCompilerInvocation(), clang::FrontendAction::getCurrentModule(), InitializeSourceManager(), prepareToBuildModule(), and shouldBuildGlobalModuleIndex().

◆ getFrontendOpts() [2/2]

const FrontendOptions& clang::CompilerInstance::getFrontendOpts ( ) const

inline

Definition at line 292 of file CompilerInstance.h.

◆ getFrontendTimer()

llvm::Timer& clang::CompilerInstance::getFrontendTimer ( ) const

inline

Definition at line 582 of file CompilerInstance.h.

References Filename, Line, and clang::Preamble.

Referenced by clang::FrontendAction::Execute().

◆ getHeaderSearchOpts() [1/2]

HeaderSearchOptions& clang::CompilerInstance::getHeaderSearchOpts ( )

inline

Definition at line 296 of file CompilerInstance.h.

Referenced by clang::DumpModuleInfoAction::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), collectVFSEntries(), clang::GeneratePCHAction::ComputeASTConsumerArguments(), clang::CodeGenAction::CreateASTConsumer(), createModuleManager(), createPCHExternalASTSource(), createPreprocessor(), clang::CodeGenAction::ExecuteAction(), clang::VerifyPCHAction::ExecuteAction(), ExecuteAction(), and getSpecificModuleCachePath().

◆ getHeaderSearchOpts() [2/2]

const HeaderSearchOptions& clang::CompilerInstance::getHeaderSearchOpts ( ) const

inline

Definition at line 299 of file CompilerInstance.h.

◆ getHeaderSearchOptsPtr()

std::shared_ptr<HeaderSearchOptions> clang::CompilerInstance::getHeaderSearchOptsPtr ( ) const

inline

Definition at line 302 of file CompilerInstance.h.

Referenced by createPreprocessor().

◆ getInvocation()

CompilerInvocation& clang::CompilerInstance::getInvocation ( )

inline

Definition at line 236 of file CompilerInstance.h.

Referenced by clang::arcmt::CheckAction::BeginInvocation(), clang::arcmt::ModifyAction::BeginInvocation(), clang::arcmt::MigrateAction::BeginInvocation(), compileModuleImpl(), clang::createChainedIncludesSource(), createFileManager(), ExecuteAction(), getSpecificModuleCachePath(), makeStandaloneDiagnostic(), clang::ento::ModelInjector::ModelInjector(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getLangOpts() [1/2]

LangOptions& clang::CompilerInstance::getLangOpts ( )

inline

◆ getLangOpts() [2/2]

const LangOptions& clang::CompilerInstance::getLangOpts ( ) const

inline

Definition at line 309 of file CompilerInstance.h.

◆ getModuleCache()

InMemoryModuleCache& clang::CompilerInstance::getModuleCache ( ) const

inline

Definition at line 817 of file CompilerInstance.h.

Referenced by compileModuleImpl(), clang::GeneratePCHAction::CreateASTConsumer(), clang::GenerateModuleAction::CreateASTConsumer(), createASTReader(), createModuleManager(), createPCHExternalASTSource(), clang::VerifyPCHAction::ExecuteAction(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getModuleDepCollector()

std::shared_ptr< ModuleDependencyCollector > CompilerInstance::getModuleDepCollector ( ) const

Definition at line 148 of file CompilerInstance.cpp.

Referenced by compileModuleImpl().

◆ getModuleManager()

IntrusiveRefCntPtr< ASTReader > CompilerInstance::getModuleManager ( ) const

Definition at line 138 of file CompilerInstance.cpp.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::RewriteIncludesAction::BeginSourceFileAction(), compileAndLoadModule(), makeStandaloneDiagnostic(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getPCHContainerOperations()

std::shared_ptr<PCHContainerOperations> clang::CompilerInstance::getPCHContainerOperations ( ) const

inline

Definition at line 528 of file CompilerInstance.h.

Referenced by clang::arcmt::CheckAction::BeginInvocation(), clang::arcmt::ModifyAction::BeginInvocation(), clang::arcmt::MigrateAction::BeginInvocation(), compileModuleImpl(), clang::createChainedIncludesSource(), clang::cross_tu::CrossTranslationUnitContext::emitCrossTUDiagnostics(), clang::ento::ModelInjector::ModelInjector(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ getPCHContainerReader()

const PCHContainerReader& clang::CompilerInstance::getPCHContainerReader ( ) const

inline

Return the appropriate PCHContainerReader depending on the current CodeGenOptions.

Definition at line 548 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), collectIncludePCH(), createASTReader(), createModuleManager(), createPCHExternalASTSource(), createPreprocessor(), clang::FrontendAction::Execute(), clang::VerifyPCHAction::ExecuteAction(), clang::ASTMergeAction::ExecuteAction(), and loadGlobalModuleIndex().

◆ getPCHContainerWriter()

const PCHContainerWriter& clang::CompilerInstance::getPCHContainerWriter ( ) const

inline

Return the appropriate PCHContainerWriter depending on the current CodeGenOptions.

Definition at line 534 of file CompilerInstance.h.

Referenced by clang::GeneratePCHAction::CreateASTConsumer(), and clang::GenerateModuleAction::CreateASTConsumer().

◆ getPreprocessor()

Preprocessor& clang::CompilerInstance::getPreprocessor ( ) const

inline

Return the current preprocessor.

Definition at line 448 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), collectIncludePCH(), compileModuleImpl(), clang::ento::CreateAnalysisConsumer(), clang::HTMLPrintAction::CreateASTConsumer(), clang::arcmt::MigrateSourceAction::CreateASTConsumer(), clang::CodeGenAction::CreateASTConsumer(), clang::arcmt::ObjCMigrateAction::CreateASTConsumer(), clang::GeneratePCHAction::CreateASTConsumer(), clang::GenerateModuleAction::CreateASTConsumer(), createASTContext(), createASTReader(), createCodeCompletionConsumer(), createModuleManager(), createPCHExternalASTSource(), createSema(), clang::FrontendAction::EndSourceFile(), clang::FrontendAction::Execute(), clang::RewriteMacrosAction::ExecuteAction(), clang::RewriteTestAction::ExecuteAction(), clang::RewriteIncludesAction::ExecuteAction(), clang::DumpModuleInfoAction::ExecuteAction(), clang::VerifyPCHAction::ExecuteAction(), clang::PrintPreambleAction::ExecuteAction(), clang::PrintDependencyDirectivesSourceMinimizerAction::ExecuteAction(), clang::DumpRawTokensAction::ExecuteAction(), clang::DumpTokensAction::ExecuteAction(), clang::PreprocessOnlyAction::ExecuteAction(), clang::PrintPreprocessedAction::ExecuteAction(), clang::FrontendAction::getCurrentModule(), clang::arcmt::getFileRemappings(), getInputBufferForModule(), InitializeSourceManager(), loadGlobalModuleIndex(), loadModuleFile(), loadModuleMapForModuleBuild(), prepareToBuildModule(), and ReadOriginalFileName().

◆ getPreprocessorOpts() [1/2]

PreprocessorOptions& clang::CompilerInstance::getPreprocessorOpts ( )

inline

Definition at line 313 of file CompilerInstance.h.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), collectIncludePCH(), clang::CodeGenAction::CreateASTConsumer(), clang::GeneratePCHAction::CreateASTConsumer(), clang::createChainedIncludesSource(), createModuleManager(), createPCHExternalASTSource(), createPreprocessor(), clang::VerifyPCHAction::ExecuteAction(), and loadModule().

◆ getPreprocessorOpts() [2/2]

const PreprocessorOptions& clang::CompilerInstance::getPreprocessorOpts ( ) const

inline

Definition at line 316 of file CompilerInstance.h.

◆ getPreprocessorOutputOpts() [1/2]

PreprocessorOutputOptions& clang::CompilerInstance::getPreprocessorOutputOpts ( )

inline

Definition at line 320 of file CompilerInstance.h.

Referenced by clang::RewriteIncludesAction::BeginSourceFileAction(), clang::CreateFrontendBaseAction(), createPreprocessor(), clang::RewriteIncludesAction::ExecuteAction(), and clang::PrintPreprocessedAction::ExecuteAction().

◆ getPreprocessorOutputOpts() [2/2]

const PreprocessorOutputOptions& clang::CompilerInstance::getPreprocessorOutputOpts ( ) const

inline

Definition at line 323 of file CompilerInstance.h.

◆ getPreprocessorPtr()

std::shared_ptr<Preprocessor> clang::CompilerInstance::getPreprocessorPtr ( )

inline

Definition at line 453 of file CompilerInstance.h.

Referenced by makeStandaloneDiagnostic(), and clang::ento::ModelInjector::ModelInjector().

◆ getSema()

Sema& clang::CompilerInstance::getSema ( ) const

inline

Definition at line 509 of file CompilerInstance.h.

Referenced by createModuleManager(), clang::TemplightDumpAction::ExecuteAction(), and clang::ASTFrontendAction::ExecuteAction().

◆ getSourceManager()

SourceManager& clang::CompilerInstance::getSourceManager ( ) const

inline

Return the current source manager.

Definition at line 428 of file CompilerInstance.h.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), clang::FixItAction::BeginSourceFileAction(), compileModuleImpl(), clang::arcmt::MigrateSourceAction::CreateASTConsumer(), clang::arcmt::ObjCMigrateAction::CreateASTConsumer(), createModuleManager(), createPreprocessor(), clang::FrontendAction::EndSourceFile(), clang::CodeGenAction::ExecuteAction(), clang::PrintPreprocessedAction::ExecuteAction(), InitializeSourceManager(), loadModule(), loadModuleMapForModuleBuild(), clang::ento::ModelInjector::ModelInjector(), prepareToBuildModule(), and ReadOriginalFileName().

◆ getSpecificModuleCachePath()

std::string CompilerInstance::getSpecificModuleCachePath ( )

Definition at line 470 of file CompilerInstance.cpp.

References clang::HeaderSearchOptions::DisableModuleHash, getHeaderSearchOpts(), getInvocation(), and clang::CompilerInvocation::getModuleHash().

Referenced by clang::FrontendAction::BeginSourceFile(), and createPreprocessor().

◆ getTarget()

TargetInfo& clang::CompilerInstance::getTarget ( ) const

inline

Definition at line 376 of file CompilerInstance.h.

Referenced by createASTContext(), createPreprocessor(), clang::CodeGenAction::ExecuteAction(), ExecuteAction(), makeStandaloneDiagnostic(), and prepareToBuildModule().

◆ getTargetOpts() [1/2]

TargetOptions& clang::CompilerInstance::getTargetOpts ( )

inline

Definition at line 327 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::CodeGenAction::CreateASTConsumer(), clang::CodeGenAction::ExecuteAction(), and ExecuteAction().

◆ getTargetOpts() [2/2]

const TargetOptions& clang::CompilerInstance::getTargetOpts ( ) const

inline

Definition at line 330 of file CompilerInstance.h.

◆ getVerboseOutputStream()

raw_ostream& clang::CompilerInstance::getVerboseOutputStream ( )

inline

Get the current stream for verbose output.

Definition at line 366 of file CompilerInstance.h.

Referenced by ExecuteAction().

◆ getVirtualFileSystem()

llvm::vfs::FileSystem& clang::CompilerInstance::getVirtualFileSystem ( ) const

inline

Definition at line 397 of file CompilerInstance.h.

◆ hadModuleLoaderFatalFailure()

bool clang::CompilerInstance::hadModuleLoaderFatalFailure ( ) const

inline

Definition at line 803 of file CompilerInstance.h.

Referenced by makeStandaloneDiagnostic().

◆ hasASTConsumer()

bool clang::CompilerInstance::hasASTConsumer ( ) const

inline

Definition at line 489 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), and createModuleManager().

◆ hasASTContext()

bool clang::CompilerInstance::hasASTContext ( ) const

inline

Definition at line 466 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), createModuleManager(), and makeStandaloneDiagnostic().

◆ hasCodeCompletionConsumer()

bool clang::CompilerInstance::hasCodeCompletionConsumer ( ) const

inline

Definition at line 564 of file CompilerInstance.h.

Referenced by clang::ASTFrontendAction::ExecuteAction(), and clang::FrontendAction::getCurrentModule().

◆ hasDiagnostics()

bool clang::CompilerInstance::hasDiagnostics ( ) const

inline

Definition at line 338 of file CompilerInstance.h.

Referenced by ExecuteAction(), and clang::tooling::FrontendActionFactory::runInvocation().

◆ hasFileManager()

bool clang::CompilerInstance::hasFileManager ( ) const

inline

Definition at line 405 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile(), clang::FrontendAction::Execute(), and loadGlobalModuleIndex().

◆ hasFrontendTimer()

bool clang::CompilerInstance::hasFrontendTimer ( ) const

inline

Definition at line 580 of file CompilerInstance.h.

Referenced by clang::FrontendAction::Execute().

◆ hasInvocation()

bool clang::CompilerInstance::hasInvocation ( ) const

inline

Definition at line 234 of file CompilerInstance.h.

Referenced by makeStandaloneDiagnostic().

◆ hasPreprocessor()

bool clang::CompilerInstance::hasPreprocessor ( ) const

inline

Definition at line 445 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile(), clang::FrontendAction::Execute(), clang::ASTFrontendAction::ExecuteAction(), InitializeSourceManager(), loadGlobalModuleIndex(), and makeStandaloneDiagnostic().

◆ hasSema()

bool clang::CompilerInstance::hasSema ( ) const

inline

Definition at line 507 of file CompilerInstance.h.

Referenced by createModuleManager(), and clang::ASTFrontendAction::ExecuteAction().

◆ hasSourceManager()

bool clang::CompilerInstance::hasSourceManager ( ) const

inline

Definition at line 425 of file CompilerInstance.h.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ hasTarget()

bool clang::CompilerInstance::hasTarget ( ) const

inline

Definition at line 374 of file CompilerInstance.h.

Referenced by ExecuteAction(), and makeStandaloneDiagnostic().

◆ InitializeSourceManager() [1/2]

bool CompilerInstance::InitializeSourceManager ( const FrontendInputFile & Input )

InitializeSourceManager - Initialize the source manager to set InputFile as the main file.

Returns: True on success.

Definition at line 813 of file CompilerInstance.cpp.

References getDependencyOutputOpts(), getDiagnostics(), getFileManager(), getFrontendOpts(), getPreprocessor(), getSourceManager(), and hasPreprocessor().

Referenced by clang::FrontendAction::BeginSourceFile().

◆ InitializeSourceManager() [2/2]

bool CompilerInstance::InitializeSourceManager	(	const FrontendInputFile &	Input,
		DiagnosticsEngine &	Diags,
		FileManager &	FileMgr,
		SourceManager &	SourceMgr,
		HeaderSearch *	HS,
		DependencyOutputOptions &	DepOpts,
		const FrontendOptions &	Opts
	)

static

InitializeSourceManager - Initialize the source manager to set InputFile as the main file.

Returns: True on success.

Definition at line 821 of file CompilerInstance.cpp.

References clang::SrcMgr::C_System, clang::SrcMgr::C_System_ModuleMap, clang::SrcMgr::C_User, clang::SrcMgr::C_User_ModuleMap, clang::SourceManager::createFileID(), clang::FrontendInputFile::getBuffer(), clang::FileManager::getBufferForFile(), clang::FrontendInputFile::getFile(), clang::FileEntryRef::getFileEntry(), clang::FileManager::getFileRef(), clang::InputKind::getFormat(), clang::FrontendInputFile::getKind(), clang::SourceManager::getMainFileID(), clang::FileManager::getVirtualFile(), clang::FrontendInputFile::isBuffer(), clang::FileEntry::isNamedPipe(), clang::FrontendInputFile::isSystem(), clang::FileID::isValid(), clang::InputKind::ModuleMap, clang::SourceManager::overrideFileContents(), clang::DiagnosticsEngine::Report(), clang::SourceManager::setMainFileID(), and clang::SourceManager::Unowned.

◆ loadGlobalModuleIndex()

GlobalModuleIndex * CompilerInstance::loadGlobalModuleIndex ( SourceLocation TriggerLoc )

overridevirtual

Load, create, or return global module.

This function returns an existing global module index, if one had already been loaded or created, or loads one if it exists, or creates one if it doesn't exist. Also, importantly, if the index doesn't cover all the modules in the module map, it will be update to do so here, because of its use in searching for needed module imports and associated fixit messages.

Parameters

TriggerLoc The location for what triggered the load.

Returns: Returns null if load failed.

Implements clang::ModuleLoader.

Definition at line 2055 of file CompilerInstance.cpp.

References clang::ModuleLoader::buildingModule(), createModuleManager(), clang::Module::DefinitionLoc, clang::Error, clang::Module::getASTFile(), getFileManager(), clang::Preprocessor::getHeaderSearchInfo(), clang::HeaderSearch::getModuleMap(), getPCHContainerReader(), getPreprocessor(), hasFileManager(), hasPreprocessor(), clang::Module::Hidden, loadModule(), clang::ModuleMap::module_begin(), clang::ModuleMap::module_end(), clang::Module::Name, shouldBuildGlobalModuleIndex(), and clang::GlobalModuleIndex::writeIndex().

◆ loadModule()

ModuleLoadResult CompilerInstance::loadModule	(	SourceLocation	ImportLoc,
		ModuleIdPath	Path,
		Module::NameVisibilityKind	Visibility,
		bool	IsInclusionDirective
	)

overridevirtual

Attempt to load the given module.

This routine attempts to load the module described by the given parameters.

Parameters

ImportLoc	The location of the 'import' keyword.
Path	The identifiers (and their locations) of the module "path", e.g., "std.vector" would be split into "std" and "vector".
Visibility	The visibility provided for the names in the loaded module.
IsInclusionDirective	Indicates that this module is being loaded implicitly, due to the presence of an inclusion directive. Otherwise, it is being loaded due to an import declaration.

Returns: If successful, returns the loaded module. Otherwise, returns NULL to indicate that the module could not be loaded.

FIXME: perhaps we should (a) look for a module using the module name

Implements clang::ModuleLoader.

Definition at line 1619 of file CompilerInstance.cpp.

Referenced by loadGlobalModuleIndex().

◆ loadModuleFile()

bool CompilerInstance::loadModuleFile ( StringRef FileName )

Definition at line 1522 of file CompilerInstance.cpp.

References clang::ModuleMap::findModule(), clang::Preprocessor::getHeaderSearchInfo(), clang::Preprocessor::getIdentifierInfo(), clang::HeaderSearch::getModuleMap(), getPreprocessor(), and clang::Module::HasIncompatibleModuleFile.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ loadModuleFromSource()

void CompilerInstance::loadModuleFromSource	(	SourceLocation	Loc,
		StringRef	ModuleName,
		StringRef	Source
	)

overridevirtual

Attempt to load the given module from the specified source buffer.

Does not make any submodule visible; for that, use loadModule or makeModuleVisible.

Parameters

Loc	The location at which the module was loaded.
ModuleName	The name of the module to build.
Source	The source of the module: a (preprocessed) module map.

Implements clang::ModuleLoader.

Definition at line 1991 of file CompilerInstance.cpp.

References clang::C, compileModuleImpl(), getDiagnostics(), getLanguageFromOptions(), clang::isAlphanumeric(), clang::InputKind::ModuleMap, and clang::DiagnosticsEngine::Report().

◆ lookupMissingImports()

bool CompilerInstance::lookupMissingImports	(	StringRef	Name,
		SourceLocation	TriggerLoc
	)

overridevirtual

Check global module index for missing imports.

Parameters

Name	The symbol name to look for.
TriggerLoc	The location for what triggered the load.

Returns: Returns true if any modules with that symbol found.

Implements clang::ModuleLoader.

Definition at line 2125 of file CompilerInstance.cpp.

◆ makeModuleVisible()

void CompilerInstance::makeModuleVisible	(	Module *	Mod,
		Module::NameVisibilityKind	Visibility,
		SourceLocation	ImportLoc
	)

overridevirtual

Make the given module visible.

Implements clang::ModuleLoader.

Definition at line 2044 of file CompilerInstance.cpp.

References createModuleManager().

◆ resetAndLeakASTContext()

void clang::CompilerInstance::resetAndLeakASTContext ( )

inline

Definition at line 473 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile().

◆ resetAndLeakFileManager()

void clang::CompilerInstance::resetAndLeakFileManager ( )

inline

Definition at line 413 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile().

◆ resetAndLeakPreprocessor()

void clang::CompilerInstance::resetAndLeakPreprocessor ( )

inline

Definition at line 455 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile().

◆ resetAndLeakSema()

void CompilerInstance::resetAndLeakSema ( )

Definition at line 2148 of file CompilerInstance.cpp.

References takeSema().

Referenced by clang::FrontendAction::EndSourceFile().

◆ resetAndLeakSourceManager()

void clang::CompilerInstance::resetAndLeakSourceManager ( )

inline

Definition at line 433 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile().

◆ setASTConsumer()

void CompilerInstance::setASTConsumer ( std::unique_ptr< ASTConsumer > Value )

setASTConsumer - Replace the current AST consumer; the compiler instance takes ownership of Value.

Definition at line 123 of file CompilerInstance.cpp.

References getASTConsumer(), getASTContext(), and clang::ASTConsumer::Initialize().

Referenced by clang::FrontendAction::BeginSourceFile(), and clang::FrontendAction::EndSourceFile().

◆ setASTContext()

void CompilerInstance::setASTContext ( ASTContext * Value )

setASTContext - Replace the current AST context.

Definition at line 112 of file CompilerInstance.cpp.

References getASTConsumer(), getASTContext(), and clang::ASTConsumer::Initialize().

Referenced by clang::FrontendAction::BeginSourceFile(), createASTContext(), and clang::FrontendAction::EndSourceFile().

◆ setAuxTarget()

void CompilerInstance::setAuxTarget ( TargetInfo * Value )

Replace the current AuxTarget.

Definition at line 98 of file CompilerInstance.cpp.

Referenced by ExecuteAction().

◆ setBuildGlobalModuleIndex()

void clang::CompilerInstance::setBuildGlobalModuleIndex ( bool Build )

inline

Set the flag indicating whether we should (re)build the global module index.

Definition at line 249 of file CompilerInstance.h.

Referenced by compileModuleImpl().

◆ setCodeCompletionConsumer()

void CompilerInstance::setCodeCompletionConsumer ( CodeCompleteConsumer * Value )

setCodeCompletionConsumer - Replace the current code completion consumer; the compiler instance takes ownership of Value.

Definition at line 130 of file CompilerInstance.cpp.

Referenced by createCodeCompletionConsumer().

◆ setDiagnostics()

void CompilerInstance::setDiagnostics ( DiagnosticsEngine * Value )

setDiagnostics - Replace the current diagnostics engine.

Definition at line 83 of file CompilerInstance.cpp.

◆ setExternalSemaSource()

void CompilerInstance::setExternalSemaSource ( IntrusiveRefCntPtr< ExternalSemaSource > ESS )

Definition at line 2150 of file CompilerInstance.cpp.

◆ setFileManager()

void CompilerInstance::setFileManager ( FileManager * Value )

Replace the current file manager and virtual file system.

Definition at line 100 of file CompilerInstance.cpp.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), clang::FrontendAction::EndSourceFile(), makeStandaloneDiagnostic(), and clang::tooling::FrontendActionFactory::runInvocation().

◆ setInvocation()

void CompilerInstance::setInvocation ( std::shared_ptr< CompilerInvocation > Value )

setInvocation - Replace the current invocation.

Definition at line 71 of file CompilerInstance.cpp.

Referenced by clang::ento::ModelInjector::ModelInjector(), clang::tooling::FrontendActionFactory::runInvocation(), and clang::RewriteIncludesAction::RewriteImportsListener::visitModuleFile().

◆ setModuleDepCollector()

void CompilerInstance::setModuleDepCollector ( std::shared_ptr< ModuleDependencyCollector > Collector )

Definition at line 152 of file CompilerInstance.cpp.

◆ setModuleManager()

void CompilerInstance::setModuleManager ( IntrusiveRefCntPtr< ASTReader > Reader )

Definition at line 141 of file CompilerInstance.cpp.

Referenced by clang::FrontendAction::BeginSourceFile().

◆ setOutputStream()

void clang::CompilerInstance::setOutputStream ( std::unique_ptr< llvm::raw_pwrite_stream > OutStream )

inline

}

Definition at line 780 of file CompilerInstance.h.

◆ setPreprocessor()

void CompilerInstance::setPreprocessor ( std::shared_ptr< Preprocessor > Value )

Replace the current preprocessor.

Definition at line 108 of file CompilerInstance.cpp.

Referenced by clang::FrontendAction::BeginSourceFile(), and clang::FrontendAction::EndSourceFile().

◆ setSema()

void CompilerInstance::setSema ( Sema * S )

Replace the current Sema; the compiler instance takes ownership of S.

Definition at line 119 of file CompilerInstance.cpp.

Referenced by clang::FrontendAction::EndSourceFile().

◆ setSourceManager()

void CompilerInstance::setSourceManager ( SourceManager * Value )

setSourceManager - Replace the current source manager.

Definition at line 104 of file CompilerInstance.cpp.

Referenced by clang::FixItRecompile::BeginInvocation(), clang::FrontendAction::BeginSourceFile(), clang::FrontendAction::EndSourceFile(), and makeStandaloneDiagnostic().

◆ setTarget()

void CompilerInstance::setTarget ( TargetInfo * Value )

Replace the current Target.

Definition at line 97 of file CompilerInstance.cpp.

Referenced by ExecuteAction().

◆ setVerboseOutputStream() [1/2]

void CompilerInstance::setVerboseOutputStream ( raw_ostream & Value )

Replace the current stream for verbose output.

Definition at line 87 of file CompilerInstance.cpp.

◆ setVerboseOutputStream() [2/2]

void CompilerInstance::setVerboseOutputStream ( std::unique_ptr< raw_ostream > Value )

Replace the current stream for verbose output.

Definition at line 92 of file CompilerInstance.cpp.

◆ shouldBuildGlobalModuleIndex()

bool CompilerInstance::shouldBuildGlobalModuleIndex ( ) const

Indicates whether we should (re)build the global module index.

Definition at line 76 of file CompilerInstance.cpp.

References clang::FrontendOptions::GenerateGlobalModuleIndex, and getFrontendOpts().

Referenced by clang::FrontendAction::Execute(), and loadGlobalModuleIndex().

◆ takeASTConsumer()

std::unique_ptr<ASTConsumer> clang::CompilerInstance::takeASTConsumer ( )

inline

takeASTConsumer - Remove the current AST consumer and give ownership to the caller.

Definition at line 498 of file CompilerInstance.h.

Referenced by clang::FrontendAction::EndSourceFile(), and makeStandaloneDiagnostic().

◆ takeOutputStream()

std::unique_ptr<llvm::raw_pwrite_stream> clang::CompilerInstance::takeOutputStream ( )

inline

Definition at line 784 of file CompilerInstance.h.

Referenced by clang::CodeGenAction::CreateASTConsumer().

◆ takeSema()

std::unique_ptr< Sema > CompilerInstance::takeSema ( )

Definition at line 134 of file CompilerInstance.cpp.

Referenced by makeStandaloneDiagnostic(), and resetAndLeakSema().

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

include/clang/Frontend/CompilerInstance.h
lib/Frontend/CompilerInstance.cpp

Public Member Functions

Construction Utility Methods

Initialization Utility Methods

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CompilerInstance()

◆ ~CompilerInstance()

Member Function Documentation

◆ addDependencyCollector()

◆ addOutputFile()

◆ clearOutputFiles()

◆ createASTContext()

◆ createCodeCompletionConsumer() [1/2]

◆ createCodeCompletionConsumer() [2/2]

◆ createDefaultOutputFile()

◆ createDiagnostics() [1/2]

◆ createDiagnostics() [2/2]

◆ createFileManager()

◆ createFrontendTimer()

◆ createModuleManager()

◆ createNullOutputFile()

◆ createOutputFile() [1/2]

◆ createOutputFile() [2/2]

◆ createPCHExternalASTSource() [1/2]

◆ createPCHExternalASTSource() [2/2]

◆ createPreprocessor()

◆ createSema()

◆ createSourceManager()

◆ ExecuteAction()

◆ getAnalyzerOpts()

◆ getASTConsumer()

◆ getASTContext()

◆ getAuxTarget()

◆ getCodeCompletionConsumer()

◆ getCodeGenOpts() [1/2]

◆ getCodeGenOpts() [2/2]

◆ getDependencyOutputOpts() [1/2]

◆ getDependencyOutputOpts() [2/2]

◆ getDiagnosticClient()

◆ getDiagnosticOpts() [1/2]

◆ getDiagnosticOpts() [2/2]

◆ getDiagnostics()

◆ getFileManager()

◆ getFileSystemOpts() [1/2]

◆ getFileSystemOpts() [2/2]

◆ getFrontendOpts() [1/2]

◆ getFrontendOpts() [2/2]

◆ getFrontendTimer()

◆ getHeaderSearchOpts() [1/2]

◆ getHeaderSearchOpts() [2/2]

◆ getHeaderSearchOptsPtr()

◆ getInvocation()

◆ getLangOpts() [1/2]

◆ getLangOpts() [2/2]

◆ getModuleCache()

◆ getModuleDepCollector()

◆ getModuleManager()

◆ getPCHContainerOperations()

◆ getPCHContainerReader()

◆ getPCHContainerWriter()

◆ getPreprocessor()

◆ getPreprocessorOpts() [1/2]

◆ getPreprocessorOpts() [2/2]

◆ getPreprocessorOutputOpts() [1/2]

◆ getPreprocessorOutputOpts() [2/2]

◆ getPreprocessorPtr()

◆ getSema()

◆ getSourceManager()

◆ getSpecificModuleCachePath()

◆ getTarget()

◆ getTargetOpts() [1/2]

◆ getTargetOpts() [2/2]

◆ getVerboseOutputStream()

◆ getVirtualFileSystem()

◆ hadModuleLoaderFatalFailure()

◆ hasASTConsumer()

◆ hasASTContext()

◆ hasCodeCompletionConsumer()

◆ hasDiagnostics()