clang
10.0.0git
|
Utility class for loading a ASTContext from an AST file. More...
#include "clang/Frontend/ASTUnit.h"
Classes | |
struct | ASTWriterData |
struct | CachedCodeCompletionResult |
A cached code-completion result, which may be introduced in one of many different contexts. More... | |
class | ConcurrencyCheck |
struct | StandaloneDiagnostic |
struct | StandaloneFixIt |
Public Types | |
enum | WhatToLoad { LoadPreprocessorOnly, LoadASTOnly, LoadEverything } |
using | top_level_iterator = std::vector< Decl * >::iterator |
using | stored_diag_iterator = StoredDiagnostic * |
using | stored_diag_const_iterator = const StoredDiagnostic * |
using | cached_completion_iterator = std::vector< CachedCodeCompletionResult >::iterator |
using | DeclVisitorFn = bool(*)(void *context, const Decl *D) |
Type for a function iterating over a number of declarations. More... | |
using | RemappedFile = std::pair< std::string, llvm::MemoryBuffer * > |
A mapping from a file name to the memory buffer that stores the remapped contents of that file. More... | |
Public Member Functions | |
llvm::StringMap< unsigned > & | getCachedCompletionTypes () |
Retrieve the mapping from formatted type names to unique type identifiers. More... | |
std::shared_ptr< GlobalCodeCompletionAllocator > | getCachedCompletionAllocator () |
Retrieve the allocator used to cache global code completions. More... | |
CodeCompletionTUInfo & | getCodeCompletionTUInfo () |
ASTUnit (const ASTUnit &)=delete | |
ASTUnit & | operator= (const ASTUnit &)=delete |
~ASTUnit () | |
bool | isMainFileAST () const |
bool | isUnsafeToFree () const |
void | setUnsafeToFree (bool Value) |
const DiagnosticsEngine & | getDiagnostics () const |
DiagnosticsEngine & | getDiagnostics () |
const SourceManager & | getSourceManager () const |
SourceManager & | getSourceManager () |
const Preprocessor & | getPreprocessor () const |
Preprocessor & | getPreprocessor () |
std::shared_ptr< Preprocessor > | getPreprocessorPtr () const |
const ASTContext & | getASTContext () const |
ASTContext & | getASTContext () |
void | setASTContext (ASTContext *ctx) |
void | setPreprocessor (std::shared_ptr< Preprocessor > pp) |
void | enableSourceFileDiagnostics () |
Enable source-range based diagnostic messages. More... | |
bool | hasSema () const |
Sema & | getSema () const |
const LangOptions & | getLangOpts () const |
const HeaderSearchOptions & | getHeaderSearchOpts () const |
const PreprocessorOptions & | getPreprocessorOpts () const |
const FileManager & | getFileManager () const |
FileManager & | getFileManager () |
const FileSystemOptions & | getFileSystemOpts () const |
IntrusiveRefCntPtr< ASTReader > | getASTReader () const |
StringRef | getOriginalSourceFileName () const |
ASTMutationListener * | getASTMutationListener () |
ASTDeserializationListener * | getDeserializationListener () |
bool | getOnlyLocalDecls () const |
bool | getOwnsRemappedFileBuffers () const |
void | setOwnsRemappedFileBuffers (bool val) |
StringRef | getMainFileName () const |
StringRef | getASTFileName () const |
If this ASTUnit came from an AST file, returns the filename for it. More... | |
top_level_iterator | top_level_begin () |
top_level_iterator | top_level_end () |
std::size_t | top_level_size () const |
bool | top_level_empty () const |
void | addTopLevelDecl (Decl *D) |
Add a new top-level declaration. More... | |
void | addFileLevelDecl (Decl *D) |
Add a new local file-level declaration. More... | |
void | findFileRegionDecls (FileID File, unsigned Offset, unsigned Length, SmallVectorImpl< Decl *> &Decls) |
Get the decls that are contained in a file in the Offset/Length range. More... | |
unsigned & | getCurrentTopLevelHashValue () |
Retrieve a reference to the current top-level name hash value. More... | |
SourceLocation | getLocation (const FileEntry *File, unsigned Line, unsigned Col) const |
Get the source location for the given file:line:col triplet. More... | |
SourceLocation | getLocation (const FileEntry *File, unsigned Offset) const |
Get the source location for the given file:offset pair. More... | |
SourceLocation | mapLocationFromPreamble (SourceLocation Loc) const |
If Loc is a loaded location from the preamble, returns the corresponding local location of the main file, otherwise it returns Loc . More... | |
SourceLocation | mapLocationToPreamble (SourceLocation Loc) const |
If Loc is a local location of the main file but inside the preamble chunk, returns the corresponding loaded location from the preamble, otherwise it returns Loc . More... | |
bool | isInPreambleFileID (SourceLocation Loc) const |
bool | isInMainFileID (SourceLocation Loc) const |
SourceLocation | getStartOfMainFileID () const |
SourceLocation | getEndOfPreambleFileID () const |
SourceRange | mapRangeFromPreamble (SourceRange R) const |
SourceRange | mapRangeToPreamble (SourceRange R) const |
unsigned | getPreambleCounterForTests () const |
stored_diag_const_iterator | stored_diag_begin () const |
stored_diag_iterator | stored_diag_begin () |
stored_diag_const_iterator | stored_diag_end () const |
stored_diag_iterator | stored_diag_end () |
unsigned | stored_diag_size () const |
stored_diag_iterator | stored_diag_afterDriver_begin () |
cached_completion_iterator | cached_completion_begin () |
cached_completion_iterator | cached_completion_end () |
unsigned | cached_completion_size () const |
llvm::iterator_range< PreprocessingRecord::iterator > | getLocalPreprocessingEntities () const |
Returns an iterator range for the local preprocessing entities of the local Preprocessor, if this is a parsed source file, or the loaded preprocessing entities of the primary module if this is an AST file. More... | |
bool | visitLocalTopLevelDecls (void *context, DeclVisitorFn Fn) |
Iterate over local declarations (locally parsed if this is a parsed source file or the loaded declarations of the primary module if this is an AST file). More... | |
const FileEntry * | getPCHFile () |
Get the PCH file if one was included. More... | |
bool | isModuleFile () const |
Returns true if the ASTUnit was constructed from a serialized module file. More... | |
std::unique_ptr< llvm::MemoryBuffer > | getBufferForFile (StringRef Filename, std::string *ErrorStr=nullptr) |
TranslationUnitKind | getTranslationUnitKind () const |
Determine what kind of translation unit this AST represents. More... | |
InputKind | getInputKind () const |
Determine the input kind this AST unit represents. More... | |
bool | Reparse (std::shared_ptr< PCHContainerOperations > PCHContainerOps, ArrayRef< RemappedFile > RemappedFiles=None, IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS=nullptr) |
Reparse the source files using the same command-line options that were originally used to produce this translation unit. More... | |
void | ResetForParse () |
Free data that will be re-generated on the next parse. More... | |
void | CodeComplete (StringRef File, unsigned Line, unsigned Column, ArrayRef< RemappedFile > RemappedFiles, bool IncludeMacros, bool IncludeCodePatterns, bool IncludeBriefComments, CodeCompleteConsumer &Consumer, std::shared_ptr< PCHContainerOperations > PCHContainerOps, DiagnosticsEngine &Diag, LangOptions &LangOpts, SourceManager &SourceMgr, FileManager &FileMgr, SmallVectorImpl< StoredDiagnostic > &StoredDiagnostics, SmallVectorImpl< const llvm::MemoryBuffer *> &OwnedBuffers) |
Perform code completion at the given file, line, and column within this translation unit. More... | |
bool | Save (StringRef File) |
Save this translation unit to a file with the given name. More... | |
bool | serialize (raw_ostream &OS) |
Serialize this translation unit with the given output stream. More... | |
Static Public Member Functions | |
static std::unique_ptr< ASTUnit > | create (std::shared_ptr< CompilerInvocation > CI, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, CaptureDiagsKind CaptureDiagnostics, bool UserFilesAreVolatile) |
Create a ASTUnit. Gets ownership of the passed CompilerInvocation. More... | |
static std::unique_ptr< ASTUnit > | LoadFromASTFile (const std::string &Filename, const PCHContainerReader &PCHContainerRdr, WhatToLoad ToLoad, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, const FileSystemOptions &FileSystemOpts, bool UseDebugInfo=false, bool OnlyLocalDecls=false, ArrayRef< RemappedFile > RemappedFiles=None, CaptureDiagsKind CaptureDiagnostics=CaptureDiagsKind::None, bool AllowPCHWithCompilerErrors=false, bool UserFilesAreVolatile=false) |
Create a ASTUnit from an AST file. More... | |
static ASTUnit * | LoadFromCompilerInvocationAction (std::shared_ptr< CompilerInvocation > CI, std::shared_ptr< PCHContainerOperations > PCHContainerOps, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, FrontendAction *Action=nullptr, ASTUnit *Unit=nullptr, bool Persistent=true, StringRef ResourceFilesPath=StringRef(), bool OnlyLocalDecls=false, CaptureDiagsKind CaptureDiagnostics=CaptureDiagsKind::None, unsigned PrecompilePreambleAfterNParses=0, bool CacheCodeCompletionResults=false, bool IncludeBriefCommentsInCodeCompletion=false, bool UserFilesAreVolatile=false, std::unique_ptr< ASTUnit > *ErrAST=nullptr) |
Create an ASTUnit from a source file, via a CompilerInvocation object, by invoking the optionally provided ASTFrontendAction. More... | |
static std::unique_ptr< ASTUnit > | LoadFromCompilerInvocation (std::shared_ptr< CompilerInvocation > CI, std::shared_ptr< PCHContainerOperations > PCHContainerOps, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, FileManager *FileMgr, bool OnlyLocalDecls=false, CaptureDiagsKind CaptureDiagnostics=CaptureDiagsKind::None, unsigned PrecompilePreambleAfterNParses=0, TranslationUnitKind TUKind=TU_Complete, bool CacheCodeCompletionResults=false, bool IncludeBriefCommentsInCodeCompletion=false, bool UserFilesAreVolatile=false) |
LoadFromCompilerInvocation - Create an ASTUnit from a source file, via a CompilerInvocation object. More... | |
static ASTUnit * | LoadFromCommandLine (const char **ArgBegin, const char **ArgEnd, std::shared_ptr< PCHContainerOperations > PCHContainerOps, IntrusiveRefCntPtr< DiagnosticsEngine > Diags, StringRef ResourceFilesPath, bool OnlyLocalDecls=false, CaptureDiagsKind CaptureDiagnostics=CaptureDiagsKind::None, ArrayRef< RemappedFile > RemappedFiles=None, bool RemappedFilesKeepOriginalName=true, unsigned PrecompilePreambleAfterNParses=0, TranslationUnitKind TUKind=TU_Complete, bool CacheCodeCompletionResults=false, bool IncludeBriefCommentsInCodeCompletion=false, bool AllowPCHWithCompilerErrors=false, SkipFunctionBodiesScope SkipFunctionBodies=SkipFunctionBodiesScope::None, bool SingleFileParse=false, bool UserFilesAreVolatile=false, bool ForSerialization=false, bool RetainExcludedConditionalBlocks=false, llvm::Optional< StringRef > ModuleFormat=llvm::None, std::unique_ptr< ASTUnit > *ErrAST=nullptr, IntrusiveRefCntPtr< llvm::vfs::FileSystem > VFS=nullptr) |
LoadFromCommandLine - Create an ASTUnit from a vector of command line arguments, which must specify exactly one source file. More... | |
Friends | |
class | ConcurrencyCheck |
Utility class for loading a ASTContext from an AST file.
using clang::ASTUnit::cached_completion_iterator = std::vector<CachedCodeCompletionResult>::iterator |
using clang::ASTUnit::DeclVisitorFn = bool (*)(void *context, const Decl *D) |
using clang::ASTUnit::RemappedFile = std::pair<std::string, llvm::MemoryBuffer *> |
using clang::ASTUnit::stored_diag_const_iterator = const StoredDiagnostic * |
using clang::ASTUnit::top_level_iterator = std::vector<Decl *>::iterator |
|
delete |
ASTUnit::~ASTUnit | ( | ) |
Definition at line 250 of file ASTUnit.cpp.
References clang::DiagnosticConsumer::EndSourceFile(), clang::DiagnosticsEngine::getClient(), getDiagnostics(), and clang::PreprocessorOptions::RemappedFileBuffers.
void ASTUnit::addFileLevelDecl | ( | Decl * | D | ) |
Add a new local file-level declaration.
Definition at line 2411 of file ASTUnit.cpp.
References clang::SourceManager::getDecomposedLoc(), clang::SourceManager::getFileLoc(), clang::Decl::getLexicalDeclContext(), clang::Decl::getLocation(), clang::DeclContext::isFileContext(), clang::Decl::isFromASTFile(), clang::SourceLocation::isInvalid(), clang::SourceManager::isLocalSourceLocation(), Offset, and SM.
|
inline |
|
inline |
|
inline |
|
inline |
void ASTUnit::CodeComplete | ( | StringRef | File, |
unsigned | Line, | ||
unsigned | Column, | ||
ArrayRef< RemappedFile > | RemappedFiles, | ||
bool | IncludeMacros, | ||
bool | IncludeCodePatterns, | ||
bool | IncludeBriefComments, | ||
CodeCompleteConsumer & | Consumer, | ||
std::shared_ptr< PCHContainerOperations > | PCHContainerOps, | ||
DiagnosticsEngine & | Diag, | ||
LangOptions & | LangOpts, | ||
SourceManager & | SourceMgr, | ||
FileManager & | FileMgr, | ||
SmallVectorImpl< StoredDiagnostic > & | StoredDiagnostics, | ||
SmallVectorImpl< const llvm::MemoryBuffer *> & | OwnedBuffers | ||
) |
Perform code completion at the given file, line, and column within this translation unit.
File | The file in which code completion will occur. |
Line | The line at which code completion will occur. |
Column | The column at which code completion will occur. |
IncludeMacros | Whether to include macros in the code-completion results. |
IncludeCodePatterns | Whether to include code patterns (such as a for loop) in the code-completion results. |
IncludeBriefComments | Whether to include brief documentation within the set of code completions returned. |
FIXME: The Diag, LangOpts, SourceMgr, FileMgr, StoredDiagnostics, and OwnedBuffers parameters are all disgusting hacks. They will go away.
Definition at line 2136 of file ASTUnit.cpp.
References clang::PreprocessorOptions::addRemappedFile(), clang::All, clang::PreprocessorOptions::clearRemappedFiles(), clang::FrontendOptions::CodeCompleteOpts, clang::FrontendOptions::CodeCompletionAt, clang::ParsedSourceLocation::Column, clang::TargetInfo::CreateTargetInfo(), clang::PreprocessorOptions::DetailedRecord, clang::Error, clang::ParsedSourceLocation::FileName, clang::FileManager::getVirtualFileSystem(), clang::CodeCompleteOptions::IncludeBriefComments, clang::CodeCompleteOptions::IncludeCodePatterns, clang::CodeCompleteOptions::IncludeFixIts, clang::CodeCompleteConsumer::includeFixIts(), clang::CodeCompleteOptions::IncludeGlobals, clang::CodeCompleteOptions::IncludeMacros, clang::ParsedSourceLocation::Line, Line, clang::LLVM_IR, clang::CodeCompleteOptions::LoadExternal, clang::CodeCompleteConsumer::loadExternal(), clang::Preamble, clang::PreprocessorOptions::PrecompiledPreambleBytes, clang::ProcessWarningOptions(), clang::PreprocessorOptions::RetainRemappedFileBuffers, and clang::InputKind::Source.
|
static |
Create a ASTUnit. Gets ownership of the passed CompilerInvocation.
Definition at line 1492 of file ASTUnit.cpp.
References clang::createVFSFromCompilerInvocation().
Referenced by LoadFromCompilerInvocationAction().
void ASTUnit::enableSourceFileDiagnostics | ( | ) |
Enable source-range based diagnostic messages.
If diagnostic messages with source-range information are to be expected and AST comes not from file (e.g. after LoadFromCompilerInvocation) this function has to be called. The function is to be called only once and the AST should be associated with the same source file afterwards.
Definition at line 278 of file ASTUnit.cpp.
References clang::DiagnosticConsumer::BeginSourceFile(), clang::DiagnosticsEngine::getClient(), and getDiagnostics().
void ASTUnit::findFileRegionDecls | ( | FileID | File, |
unsigned | Offset, | ||
unsigned | Length, | ||
SmallVectorImpl< Decl *> & | Decls | ||
) |
Get the decls that are contained in a file in the Offset/Length range.
Length
can be 0 to indicate a point at Offset
instead of a range.
Definition at line 2452 of file ASTUnit.cpp.
References clang::FileID::isInvalid(), and Offset.
|
inline |
Definition at line 439 of file ASTUnit.h.
Referenced by clang::cross_tu::CrossTranslationUnitContext::getLookupName(), clang::cross_tu::CrossTranslationUnitContext::importDefinition(), clang::index::indexASTUnit(), clang::cross_tu::CrossTranslationUnitContext::loadExternalAST(), and makeStandaloneDiagnostic().
|
inline |
StringRef ASTUnit::getASTFileName | ( | ) | const |
If this ASTUnit came from an AST file, returns the filename for it.
Definition at line 1482 of file ASTUnit.cpp.
References clang::serialization::ModuleFile::FileName, and isMainFileAST().
ASTMutationListener * ASTUnit::getASTMutationListener | ( | ) |
Definition at line 722 of file ASTUnit.cpp.
IntrusiveRefCntPtr< ASTReader > ASTUnit::getASTReader | ( | ) | const |
Definition at line 718 of file ASTUnit.cpp.
std::unique_ptr< llvm::MemoryBuffer > ASTUnit::getBufferForFile | ( | StringRef | Filename, |
std::string * | ErrorStr = nullptr |
||
) |
Definition at line 735 of file ASTUnit.cpp.
References clang::AllWithoutNonErrorsFromIncludes, and clang::None.
|
inline |
|
inline |
|
inline |
Definition at line 316 of file ASTUnit.h.
References clang::XRayInstrKind::None.
|
inline |
Retrieve a reference to the current top-level name hash value.
Note: This is used internally by the top-level tracking action
Definition at line 543 of file ASTUnit.h.
References Line.
Referenced by LoadFromCompilerInvocationAction().
ASTDeserializationListener * ASTUnit::getDeserializationListener | ( | ) |
Definition at line 728 of file ASTUnit.cpp.
|
inline |
Definition at line 429 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), enableSourceFileDiagnostics(), LoadFromCompilerInvocationAction(), makeStandaloneDiagnostic(), Reparse(), serialize(), and ~ASTUnit().
|
inline |
SourceLocation ASTUnit::getEndOfPreambleFileID | ( | ) | const |
Definition at line 2573 of file ASTUnit.cpp.
References clang::FileID::isInvalid().
|
inline |
Definition at line 476 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), clang::cross_tu::CrossTranslationUnitContext::getLookupName(), and LoadFromCompilerInvocationAction().
|
inline |
|
inline |
|
inline |
Definition at line 466 of file ASTUnit.h.
Referenced by LoadFromCompilerInvocationAction().
InputKind ASTUnit::getInputKind | ( | ) | const |
Determine the input kind this AST unit represents.
Definition at line 2664 of file ASTUnit.cpp.
References clang::C, clang::LangOptions::CMK_ModuleMap, clang::CUDA, clang::CXX, getLangOpts(), clang::InputKind::ModuleMap, clang::ObjC, clang::ObjCXX, clang::OpenCL, clang::RenderScript, and clang::InputKind::Source.
|
inline |
Definition at line 461 of file ASTUnit.h.
Referenced by getInputKind(), and isModuleFile().
llvm::iterator_range< PreprocessingRecord::iterator > ASTUnit::getLocalPreprocessingEntities | ( | ) | const |
Returns an iterator range for the local preprocessing entities of the local Preprocessor, if this is a parsed source file, or the loaded preprocessing entities of the primary module if this is an AST file.
Definition at line 2596 of file ASTUnit.cpp.
References isMainFileAST().
SourceLocation ASTUnit::getLocation | ( | const FileEntry * | File, |
unsigned | Line, | ||
unsigned | Col | ||
) | const |
Get the source location for the given file:line:col triplet.
The difference with SourceManager::getLocation is that this method checks whether the requested location points inside the precompiled preamble in which case the returned source location will be a "loaded" one.
Definition at line 2495 of file ASTUnit.cpp.
References clang::SourceManager::getMacroArgExpandedLocation(), getSourceManager(), SM, and clang::SourceManager::translateFileLineCol().
SourceLocation ASTUnit::getLocation | ( | const FileEntry * | File, |
unsigned | Offset | ||
) | const |
Get the source location for the given file:offset pair.
Definition at line 2502 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::SourceManager::getMacroArgExpandedLocation(), getSourceManager(), SM, and clang::SourceManager::translateFileLineCol().
StringRef ASTUnit::getMainFileName | ( | ) | const |
Definition at line 1464 of file ASTUnit.cpp.
References clang::FrontendInputFile::getBuffer(), clang::FrontendInputFile::getFile(), and clang::FrontendInputFile::isFile().
Referenced by clang::cross_tu::CrossTranslationUnitContext::getLookupName(), LoadFromCompilerInvocationAction(), and Reparse().
|
inline |
|
inline |
const FileEntry * ASTUnit::getPCHFile | ( | ) |
Get the PCH file if one was included.
Definition at line 2632 of file ASTUnit.cpp.
References clang::serialization::ModuleFile::File, and clang::serialization::ModuleFile::Kind.
|
inline |
|
inline |
Definition at line 435 of file ASTUnit.h.
Referenced by clang::index::indexASTUnit().
|
inline |
|
inline |
|
inline |
Definition at line 437 of file ASTUnit.h.
Referenced by clang::index::indexASTUnit().
|
inline |
Definition at line 456 of file ASTUnit.h.
Referenced by serialize().
|
inline |
Definition at line 432 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), clang::cross_tu::CrossTranslationUnitContext::getImportedFromSourceLocation(), getLocation(), and LoadFromCompilerInvocationAction().
|
inline |
SourceLocation ASTUnit::getStartOfMainFileID | ( | ) | const |
Definition at line 2584 of file ASTUnit.cpp.
References clang::FileID::isInvalid().
|
inline |
bool ASTUnit::isInMainFileID | ( | SourceLocation | Loc | ) | const |
Definition at line 2562 of file ASTUnit.cpp.
References clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
bool ASTUnit::isInPreambleFileID | ( | SourceLocation | Loc | ) | const |
Definition at line 2551 of file ASTUnit.cpp.
References clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
|
inline |
Definition at line 424 of file ASTUnit.h.
Referenced by getASTFileName(), getLocalPreprocessingEntities(), isModuleFile(), and visitLocalTopLevelDecls().
bool ASTUnit::isModuleFile | ( | ) | const |
Returns true if the ASTUnit was constructed from a serialized module file.
Definition at line 2660 of file ASTUnit.cpp.
References getLangOpts(), clang::LangOptions::isCompilingModule(), and isMainFileAST().
|
static |
Create a ASTUnit from an AST file.
Filename | - The AST file to load. |
PCHContainerRdr | - The PCHContainerOperations to use for loading and creating modules. |
Diags | - The diagnostics engine to use for reporting errors; its lifetime is expected to extend past that of the returned ASTUnit. |
Definition at line 756 of file ASTUnit.cpp.
References clang::ASTReader::ARR_None, clang::ASTReader::ConfigurationMismatch, clang::ASTReader::Failure, clang::PCHContainerReader::getFormat(), clang::ASTReader::HadErrors, LoadASTOnly, LoadEverything, clang::ASTReader::Missing, clang::serialization::MK_MainFile, clang::ASTReader::OutOfDate, clang::ASTReader::setListener(), clang::ASTReader::Success, and clang::ASTReader::VersionMismatch.
Referenced by clang::FrontendAction::BeginSourceFile(), clang::cross_tu::CrossTranslationUnitContext::emitCrossTUDiagnostics(), and clang::ASTMergeAction::ExecuteAction().
|
static |
LoadFromCommandLine - Create an ASTUnit from a vector of command line arguments, which must specify exactly one source file.
ArgBegin | - The beginning of the argument vector. |
ArgEnd | - The end of the argument vector. |
PCHContainerOps | - The PCHContainerOperations to use for loading and creating modules. |
Diags | - The diagnostics engine to use for reporting errors; its lifetime is expected to extend past that of the returned ASTUnit. |
ResourceFilesPath | - The path to the compiler resource files. |
ModuleFormat | - If provided, uses the specific module format. |
ErrAST | - If non-null and parsing failed without any AST to return (e.g. because the PCH could not be loaded), this accepts the ASTUnit mainly to allow the caller to see the diagnostics. |
VFS | - A llvm::vfs::FileSystem to be used for all file accesses. Note that preamble is saved to a temporary directory on a RealFileSystem, so in order for it to be loaded correctly, VFS should have access to it(i.e., be an overlay over RealFileSystem). RealFileSystem will be used if VFS is nullptr. |
Definition at line 1729 of file ASTUnit.cpp.
References clang::PreprocessorOptions::AllowPCHWithCompilerErrors, clang::createInvocationFromCommandLine(), clang::createVFSFromCompilerInvocation(), clang::PreambleAndMainFile, clang::PreprocessorOptions::RemappedFilesKeepOriginalName, clang::PreprocessorOptions::RetainExcludedConditionalBlocks, and clang::PreprocessorOptions::SingleFileParseMode.
|
static |
LoadFromCompilerInvocation - Create an ASTUnit from a source file, via a CompilerInvocation object.
CI | - The compiler invocation to use; it must have exactly one input source file. The ASTUnit takes ownership of the CompilerInvocation object. |
PCHContainerOps | - The PCHContainerOperations to use for loading and creating modules. |
Diags | - The diagnostics engine to use for reporting errors; its lifetime is expected to extend past that of the returned ASTUnit. |
Definition at line 1692 of file ASTUnit.cpp.
References clang::FileManager::getFileSystemOpts().
|
static |
Create an ASTUnit from a source file, via a CompilerInvocation object, by invoking the optionally provided ASTFrontendAction.
CI | - The compiler invocation to use; it must have exactly one input source file. The ASTUnit takes ownership of the CompilerInvocation object. |
PCHContainerOps | - The PCHContainerOperations to use for loading and creating modules. |
Diags | - The diagnostics engine to use for reporting errors; its lifetime is expected to extend past that of the returned ASTUnit. |
Action | - The ASTFrontendAction to invoke. Its ownership is not transferred. |
Unit | - optionally an already created ASTUnit. Its ownership is not transferred. |
Persistent | - if true the returned ASTUnit will be complete. false means the caller is only interested in getting info through the provided |
ErrAST | - If non-null and parsing failed without any AST to return (e.g. because the PCH could not be loaded), this accepts the ASTUnit mainly to allow the caller to see the diagnostics. This will only receive an ASTUnit if a new one was created. If an already created ASTUnit was passed in Unit then the caller can check that. |
Definition at line 1512 of file ASTUnit.cpp.
References clang::FrontendAction::BeginSourceFile(), create(), clang::TargetInfo::CreateTargetInfo(), clang::FrontendAction::EndSourceFile(), clang::Error, clang::FrontendAction::Execute(), getCurrentTopLevelHashValue(), getDiagnostics(), getFileManager(), getHeaderSearchOpts(), getMainFileName(), getSourceManager(), clang::FrontendAction::getTranslationUnitKind(), clang::LLVM_IR, clang::ProcessWarningOptions(), clang::DiagnosticsEngine::Reset(), clang::HeaderSearchOptions::ResourceDir, clang::InputKind::Source, and clang::TU_Complete.
Referenced by clang::arcmt::MigrationProcess::applyTransform(), and clang::arcmt::checkForManualIssues().
SourceLocation ASTUnit::mapLocationFromPreamble | ( | SourceLocation | Loc | ) | const |
If Loc
is a loaded location from the preamble, returns the corresponding local location of the main file, otherwise it returns Loc
.
If.
Definition at line 2512 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::FileID::isInvalid(), clang::SourceLocation::isInvalid(), and clang::Preamble.
SourceLocation ASTUnit::mapLocationToPreamble | ( | SourceLocation | Loc | ) | const |
If Loc
is a local location of the main file but inside the preamble chunk, returns the corresponding loaded location from the preamble, otherwise it returns Loc
.
If.
Definition at line 2533 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::FileID::isInvalid(), clang::SourceLocation::isInvalid(), and clang::Preamble.
|
inline |
Definition at line 572 of file ASTUnit.h.
References clang::SourceRange::getBegin(), and clang::SourceRange::getEnd().
|
inline |
Definition at line 578 of file ASTUnit.h.
References clang::SourceRange::getBegin(), and clang::SourceRange::getEnd().
bool ASTUnit::Reparse | ( | std::shared_ptr< PCHContainerOperations > | PCHContainerOps, |
ArrayRef< RemappedFile > | RemappedFiles = None , |
||
IntrusiveRefCntPtr< llvm::vfs::FileSystem > | VFS = nullptr |
||
) |
Reparse the source files using the same command-line options that were originally used to produce this translation unit.
VFS | - A llvm::vfs::FileSystem to be used for all file accesses. Note that preamble is saved to a temporary directory on a RealFileSystem, so in order for it to be loaded correctly, VFS should give an access to this(i.e. be an overlay over RealFileSystem). FileMgr->getVirtualFileSystem() will be used if VFS is nullptr. |
Definition at line 1825 of file ASTUnit.cpp.
References clang::PreprocessorOptions::clearRemappedFiles(), getDiagnostics(), getMainFileName(), clang::Preamble, clang::ProcessWarningOptions(), clang::PreprocessorOptions::RemappedFileBuffers, clang::DiagnosticsEngine::Reset(), clang::Result, and clang::DiagnosticsEngine::setNumWarnings().
void ASTUnit::ResetForParse | ( | ) |
Free data that will be re-generated on the next parse.
Preamble-related data is not affected.
Definition at line 1883 of file ASTUnit.cpp.
Referenced by checkAndSanitizeDiags().
bool ASTUnit::Save | ( | StringRef | File | ) |
Save this translation unit to a file with the given name.
Definition at line 2296 of file ASTUnit.cpp.
References clang::Error, and serialize().
bool ASTUnit::serialize | ( | raw_ostream & | OS | ) |
Serialize this translation unit with the given output stream.
Definition at line 2335 of file ASTUnit.cpp.
References getDiagnostics(), getSema(), clang::DiagnosticsEngine::hasUncompilableErrorOccurred(), and serializeUnit().
Referenced by Save().
|
inline |
|
inline |
void ASTUnit::setPreprocessor | ( | std::shared_ptr< Preprocessor > | pp | ) |
Definition at line 274 of file ASTUnit.cpp.
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
Definition at line 502 of file ASTUnit.h.
Referenced by visitLocalTopLevelDecls().
|
inline |
Definition at line 509 of file ASTUnit.h.
Referenced by visitLocalTopLevelDecls().
|
inline |
bool ASTUnit::visitLocalTopLevelDecls | ( | void * | context, |
DeclVisitorFn | Fn | ||
) |
Iterate over local declarations (locally parsed if this is a parsed source file or the loaded declarations of the primary module if this is an AST file).
Definition at line 2610 of file ASTUnit.cpp.
References isMainFileAST(), top_level_begin(), and top_level_end().
Referenced by indexTranslationUnit().
|
friend |