clang
6.0.0
|
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 } |
typedef std::vector< Decl * >::iterator | top_level_iterator |
typedef StoredDiagnostic * | stored_diag_iterator |
typedef const StoredDiagnostic * | stored_diag_const_iterator |
typedef std::vector< CachedCodeCompletionResult >::iterator | cached_completion_iterator |
typedef bool(* | DeclVisitorFn) (void *context, const Decl *D) |
Type for a function iterating over a number of declarations. More... | |
typedef std::pair< std::string, llvm::MemoryBuffer * > | RemappedFile |
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 () | |
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) |
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 |
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< 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, bool 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, bool CaptureDiagnostics=false, 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, bool CaptureDiagnostics=false, 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, bool CaptureDiagnostics=false, 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, bool CaptureDiagnostics=false, ArrayRef< RemappedFile > RemappedFiles=None, bool RemappedFilesKeepOriginalName=true, unsigned PrecompilePreambleAfterNParses=0, TranslationUnitKind TUKind=TU_Complete, bool CacheCodeCompletionResults=false, bool IncludeBriefCommentsInCodeCompletion=false, bool AllowPCHWithCompilerErrors=false, bool SkipFunctionBodies=false, bool SingleFileParse=false, bool UserFilesAreVolatile=false, bool ForSerialization=false, llvm::Optional< StringRef > ModuleFormat=llvm::None, std::unique_ptr< ASTUnit > *ErrAST=nullptr, IntrusiveRefCntPtr< 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.
typedef std::vector<CachedCodeCompletionResult>::iterator clang::ASTUnit::cached_completion_iterator |
typedef std::pair<std::string, llvm::MemoryBuffer *> clang::ASTUnit::RemappedFile |
typedef const StoredDiagnostic* clang::ASTUnit::stored_diag_const_iterator |
typedef std::vector<Decl *>::iterator clang::ASTUnit::top_level_iterator |
ASTUnit::~ASTUnit | ( | ) |
Definition at line 204 of file ASTUnit.cpp.
References clang::DiagnosticConsumer::EndSourceFile(), clang::DiagnosticsEngine::getClient(), getDiagnostics(), clang::CompilerInvocationBase::getPreprocessorOpts(), and clang::PreprocessorOptions::RemappedFileBuffers.
void ASTUnit::addFileLevelDecl | ( | Decl * | D | ) |
Add a new local file-level declaration.
Definition at line 2321 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(), 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 2044 of file ASTUnit.cpp.
References clang::PreprocessorOptions::addRemappedFile(), clang::PreprocessorOptions::clearRemappedFiles(), clang::FrontendOptions::CodeCompleteOpts, clang::FrontendOptions::CodeCompletionAt, clang::ParsedSourceLocation::Column, clang::TargetInfo::CreateTargetInfo(), clang::PreprocessorOptions::DetailedRecord, clang::ParsedSourceLocation::FileName, clang::FileManager::getVirtualFileSystem(), clang::CodeCompleteOptions::IncludeBriefComments, clang::CodeCompleteOptions::IncludeCodePatterns, clang::CodeCompleteOptions::IncludeGlobals, clang::CodeCompleteOptions::IncludeMacros, clang::ParsedSourceLocation::Line, Line, clang::InputKind::LLVM_IR, 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 1404 of file ASTUnit.cpp.
References clang::createVFSFromCompilerInvocation().
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 2362 of file ASTUnit.cpp.
|
inline |
Definition at line 417 of file ASTUnit.h.
Referenced by clang::cross_tu::CrossTranslationUnitContext::getCrossTUDefinition(), clang::index::indexASTUnit(), and makeStandaloneDiagnostic().
|
inline |
StringRef ASTUnit::getASTFileName | ( | ) | const |
If this ASTUnit came from an AST file, returns the filename for it.
Definition at line 1394 of file ASTUnit.cpp.
References clang::serialization::ModuleFile::FileName, and isMainFileAST().
ASTMutationListener * ASTUnit::getASTMutationListener | ( | ) |
Definition at line 652 of file ASTUnit.cpp.
IntrusiveRefCntPtr< ASTReader > ASTUnit::getASTReader | ( | ) | const |
Definition at line 648 of file ASTUnit.cpp.
std::unique_ptr< llvm::MemoryBuffer > ASTUnit::getBufferForFile | ( | StringRef | Filename, |
std::string * | ErrorStr = nullptr |
||
) |
Definition at line 665 of file ASTUnit.cpp.
|
inline |
|
inline |
|
inline |
|
inline |
ASTDeserializationListener * ASTUnit::getDeserializationListener | ( | ) |
Definition at line 658 of file ASTUnit.cpp.
|
inline |
Definition at line 407 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), makeStandaloneDiagnostic(), Reparse(), serialize(), and ~ASTUnit().
|
inline |
SourceLocation ASTUnit::getEndOfPreambleFileID | ( | ) | const |
Definition at line 2483 of file ASTUnit.cpp.
References clang::FileID::isInvalid().
|
inline |
Definition at line 444 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), and clang::cross_tu::CrossTranslationUnitContext::getCrossTUDefinition().
|
inline |
|
inline |
|
inline |
InputKind ASTUnit::getInputKind | ( | ) | const |
Determine the input kind this AST unit represents.
Definition at line 2574 of file ASTUnit.cpp.
References clang::InputKind::C, clang::LangOptions::CMK_ModuleMap, clang::InputKind::CUDA, clang::InputKind::CXX, getLangOpts(), clang::InputKind::ModuleMap, clang::InputKind::ObjC, clang::InputKind::ObjCXX, clang::InputKind::OpenCL, clang::InputKind::RenderScript, and clang::InputKind::Source.
|
inline |
Definition at line 429 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 2506 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 2405 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 2412 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::SourceManager::getMacroArgExpandedLocation(), getSourceManager(), SM, and clang::SourceManager::translateFileLineCol().
StringRef ASTUnit::getMainFileName | ( | ) | const |
Definition at line 1376 of file ASTUnit.cpp.
References clang::CompilerInvocation::getFrontendOpts(), and clang::FrontendOptions::Inputs.
Referenced by Reparse().
|
inline |
|
inline |
const FileEntry * ASTUnit::getPCHFile | ( | ) |
Get the PCH file if one was included.
Definition at line 2542 of file ASTUnit.cpp.
References clang::serialization::ModuleFile::File, and clang::serialization::ModuleFile::Kind.
|
inline |
|
inline |
|
inline |
|
inline |
Definition at line 415 of file ASTUnit.h.
Referenced by clang::index::indexASTUnit().
|
inline |
Definition at line 424 of file ASTUnit.h.
Referenced by serialize().
|
inline |
Definition at line 410 of file ASTUnit.h.
Referenced by checkAndSanitizeDiags(), and getLocation().
|
inline |
SourceLocation ASTUnit::getStartOfMainFileID | ( | ) | const |
Definition at line 2494 of file ASTUnit.cpp.
References clang::FileID::isInvalid().
|
inline |
bool ASTUnit::isInMainFileID | ( | SourceLocation | Loc | ) | const |
Definition at line 2472 of file ASTUnit.cpp.
References clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
bool ASTUnit::isInPreambleFileID | ( | SourceLocation | Loc | ) | const |
Definition at line 2461 of file ASTUnit.cpp.
References clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
|
inline |
Definition at line 402 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 2570 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 683 of file ASTUnit.cpp.
References clang::ASTReader::ARR_None, clang::ASTReader::ConfigurationMismatch, clang::ASTReader::Failure, clang::Decl::getDeclContext(), clang::PCHContainerReader::getFormat(), clang::Token::getIdentifierInfo(), clang::DeclContext::getLookupParent(), clang::IdentifierInfo::getName(), clang::vfs::getRealFileSystem(), clang::ASTReader::HadErrors, clang::DeclContext::isTranslationUnit(), 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::cross_tu::CrossTranslationUnitContext::loadExternalAST().
|
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 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 1641 of file ASTUnit.cpp.
References clang::PreprocessorOptions::AllowPCHWithCompilerErrors, clang::createInvocationFromCommandLine(), clang::createVFSFromCompilerInvocation(), clang::vfs::getRealFileSystem(), clang::PreprocessorOptions::RemappedFilesKeepOriginalName, 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 1604 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 1425 of file ASTUnit.cpp.
Referenced by clang::arcmt::MigrationProcess::applyTransform().
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 2422 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
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 2443 of file ASTUnit.cpp.
References clang::SourceLocation::getLocWithOffset(), clang::FileID::isInvalid(), and clang::SourceLocation::isInvalid().
|
inline |
Definition at line 540 of file ASTUnit.h.
References clang::SourceRange::getBegin(), and clang::SourceRange::getEnd().
|
inline |
Definition at line 546 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< 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 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 1736 of file ASTUnit.cpp.
References clang::PreprocessorOptions::addRemappedFile(), clang::PreprocessorOptions::clearRemappedFiles(), clang::CompilerInvocationBase::getDiagnosticOpts(), getDiagnostics(), getMainFileName(), clang::CompilerInvocationBase::getPreprocessorOpts(), 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 1795 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 2199 of file ASTUnit.cpp.
References serialize().
bool ASTUnit::serialize | ( | raw_ostream & | OS | ) |
Serialize this translation unit with the given output stream.
Definition at line 2245 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 228 of file ASTUnit.cpp.
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
|
inline |
Definition at line 470 of file ASTUnit.h.
Referenced by visitLocalTopLevelDecls().
|
inline |
Definition at line 477 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 2520 of file ASTUnit.cpp.
References isMainFileAST(), top_level_begin(), and top_level_end().
Referenced by indexTranslationUnit().
|
friend |