clang
3.9.0
|
This class handles loading and caching of source files into memory. More...
#include <SourceManager.h>
Classes | |
struct | MemoryBufferSizes |
Public Types | |
typedef llvm::DenseMap< const FileEntry *, SrcMgr::ContentCache * > ::const_iterator | fileinfo_iterator |
Public Member Functions | |
SourceManager (DiagnosticsEngine &Diag, FileManager &FileMgr, bool UserFilesAreVolatile=false) | |
~SourceManager () | |
void | clearIDTables () |
DiagnosticsEngine & | getDiagnostics () const |
FileManager & | getFileManager () const |
void | setOverridenFilesKeepOriginalName (bool value) |
Set true if the SourceManager should report the original file name for contents of files that were overridden by other files. More... | |
bool | userFilesAreVolatile () const |
True if non-system source files should be treated as volatile (likely to change while trying to use them). More... | |
ModuleBuildStack | getModuleBuildStack () const |
Retrieve the module build stack. More... | |
void | setModuleBuildStack (ModuleBuildStack stack) |
Set the module build stack. More... | |
void | pushModuleBuildStack (StringRef moduleName, FullSourceLoc importLoc) |
Push an entry to the module build stack. More... | |
FileID | getMainFileID () const |
Returns the FileID of the main source file. More... | |
void | setMainFileID (FileID FID) |
Set the file ID for the main source file. More... | |
void | setPreambleFileID (FileID Preamble) |
Set the file ID for the precompiled preamble. More... | |
FileID | getPreambleFileID () const |
Get the file ID for the precompiled preamble if there is one. More... | |
FileID | createFileID (const FileEntry *SourceFile, SourceLocation IncludePos, SrcMgr::CharacteristicKind FileCharacter, int LoadedID=0, unsigned LoadedOffset=0) |
Create a new FileID that represents the specified file being #included from the specified IncludePosition. More... | |
FileID | createFileID (std::unique_ptr< llvm::MemoryBuffer > Buffer, SrcMgr::CharacteristicKind FileCharacter=SrcMgr::C_User, int LoadedID=0, unsigned LoadedOffset=0, SourceLocation IncludeLoc=SourceLocation()) |
Create a new FileID that represents the specified memory buffer. More... | |
FileID | getOrCreateFileID (const FileEntry *SourceFile, SrcMgr::CharacteristicKind FileCharacter) |
Get the FileID for SourceFile if it exists. More... | |
SourceLocation | createMacroArgExpansionLoc (SourceLocation Loc, SourceLocation ExpansionLoc, unsigned TokLength) |
Return a new SourceLocation that encodes the fact that a token from SpellingLoc should actually be referenced from ExpansionLoc, and that it represents the expansion of a macro argument into the function-like macro body. More... | |
SourceLocation | createExpansionLoc (SourceLocation Loc, SourceLocation ExpansionLocStart, SourceLocation ExpansionLocEnd, unsigned TokLength, int LoadedID=0, unsigned LoadedOffset=0) |
Return a new SourceLocation that encodes the fact that a token from SpellingLoc should actually be referenced from ExpansionLoc. More... | |
llvm::MemoryBuffer * | getMemoryBufferForFile (const FileEntry *File, bool *Invalid=nullptr) |
Retrieve the memory buffer associated with the given file. More... | |
void | overrideFileContents (const FileEntry *SourceFile, llvm::MemoryBuffer *Buffer, bool DoNotFree) |
Override the contents of the given source file by providing an already-allocated buffer. More... | |
void | overrideFileContents (const FileEntry *SourceFile, std::unique_ptr< llvm::MemoryBuffer > Buffer) |
void | overrideFileContents (const FileEntry *SourceFile, const FileEntry *NewFile) |
Override the given source file with another one. More... | |
bool | isFileOverridden (const FileEntry *File) |
Returns true if the file contents have been overridden. More... | |
void | disableFileContentsOverride (const FileEntry *File) |
Disable overridding the contents of a file, previously enabled with overrideFileContents. More... | |
void | setFileIsTransient (const FileEntry *SourceFile) |
Specify that a file is transient. More... | |
void | setAllFilesAreTransient (bool Transient) |
Specify that all files that are read during this compilation are transient. More... | |
llvm::MemoryBuffer * | getBuffer (FileID FID, SourceLocation Loc, bool *Invalid=nullptr) const |
Return the buffer for the specified FileID. More... | |
llvm::MemoryBuffer * | getBuffer (FileID FID, bool *Invalid=nullptr) const |
const FileEntry * | getFileEntryForID (FileID FID) const |
Returns the FileEntry record for the provided FileID. More... | |
const FileEntry * | getFileEntryForSLocEntry (const SrcMgr::SLocEntry &sloc) const |
Returns the FileEntry record for the provided SLocEntry. More... | |
StringRef | getBufferData (FileID FID, bool *Invalid=nullptr) const |
Return a StringRef to the source buffer data for the specified FileID. More... | |
unsigned | getNumCreatedFIDsForFileID (FileID FID) const |
Get the number of FileIDs (files and macros) that were created during preprocessing of FID , including it. More... | |
void | setNumCreatedFIDsForFileID (FileID FID, unsigned NumFIDs) const |
Set the number of FileIDs (files and macros) that were created during preprocessing of FID , including it. More... | |
FileID | getFileID (SourceLocation SpellingLoc) const |
Return the FileID for a SourceLocation. More... | |
StringRef | getFilename (SourceLocation SpellingLoc) const |
Return the filename of the file containing a SourceLocation. More... | |
SourceLocation | getLocForStartOfFile (FileID FID) const |
Return the source location corresponding to the first byte of the specified file. More... | |
SourceLocation | getLocForEndOfFile (FileID FID) const |
Return the source location corresponding to the last byte of the specified file. More... | |
SourceLocation | getIncludeLoc (FileID FID) const |
Returns the include location if FID is a #include'd file otherwise it returns an invalid location. More... | |
std::pair< SourceLocation, StringRef > | getModuleImportLoc (SourceLocation Loc) const |
SourceLocation | getExpansionLoc (SourceLocation Loc) const |
Given a SourceLocation object Loc , return the expansion location referenced by the ID. More... | |
SourceLocation | getFileLoc (SourceLocation Loc) const |
Given Loc , if it is a macro location return the expansion location or the spelling location, depending on if it comes from a macro argument or not. More... | |
std::pair< SourceLocation, SourceLocation > | getImmediateExpansionRange (SourceLocation Loc) const |
Return the start/end of the expansion information for an expansion location. More... | |
std::pair< SourceLocation, SourceLocation > | getExpansionRange (SourceLocation Loc) const |
Given a SourceLocation object, return the range of tokens covered by the expansion in the ultimate file. More... | |
SourceRange | getExpansionRange (SourceRange Range) const |
Given a SourceRange object, return the range of tokens covered by the expansion in the ultimate file. More... | |
SourceLocation | getSpellingLoc (SourceLocation Loc) const |
Given a SourceLocation object, return the spelling location referenced by the ID. More... | |
SourceLocation | getImmediateSpellingLoc (SourceLocation Loc) const |
Given a SourceLocation object, return the spelling location referenced by the ID. More... | |
std::pair< FileID, unsigned > | getDecomposedLoc (SourceLocation Loc) const |
Decompose the specified location into a raw FileID + Offset pair. More... | |
std::pair< FileID, unsigned > | getDecomposedExpansionLoc (SourceLocation Loc) const |
Decompose the specified location into a raw FileID + Offset pair. More... | |
std::pair< FileID, unsigned > | getDecomposedSpellingLoc (SourceLocation Loc) const |
Decompose the specified location into a raw FileID + Offset pair. More... | |
std::pair< FileID, unsigned > | getDecomposedIncludedLoc (FileID FID) const |
Returns the "included/expanded in" decomposed location of the given FileID. More... | |
unsigned | getFileOffset (SourceLocation SpellingLoc) const |
Returns the offset from the start of the file that the specified SourceLocation represents. More... | |
bool | isMacroArgExpansion (SourceLocation Loc, SourceLocation *StartLoc=nullptr) const |
Tests whether the given source location represents a macro argument's expansion into the function-like macro definition. More... | |
bool | isMacroBodyExpansion (SourceLocation Loc) const |
Tests whether the given source location represents the expansion of a macro body. More... | |
bool | isAtStartOfImmediateMacroExpansion (SourceLocation Loc, SourceLocation *MacroBegin=nullptr) const |
Returns true if the given MacroID location points at the beginning of the immediate macro expansion. More... | |
bool | isAtEndOfImmediateMacroExpansion (SourceLocation Loc, SourceLocation *MacroEnd=nullptr) const |
Returns true if the given MacroID location points at the character end of the immediate macro expansion. More... | |
bool | isInSLocAddrSpace (SourceLocation Loc, SourceLocation Start, unsigned Length, unsigned *RelativeOffset=nullptr) const |
Returns true if Loc is inside the [Start , +Length ) chunk of the source location address space. More... | |
bool | isInSameSLocAddrSpace (SourceLocation LHS, SourceLocation RHS, int *RelativeOffset) const |
Return true if both LHS and RHS are in the local source location address space or the loaded one. More... | |
const char * | getCharacterData (SourceLocation SL, bool *Invalid=nullptr) const |
Return a pointer to the start of the specified location in the appropriate spelling MemoryBuffer. More... | |
unsigned | getColumnNumber (FileID FID, unsigned FilePos, bool *Invalid=nullptr) const |
Return the column # for the specified file position. More... | |
unsigned | getSpellingColumnNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
unsigned | getExpansionColumnNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
unsigned | getPresumedColumnNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
unsigned | getLineNumber (FileID FID, unsigned FilePos, bool *Invalid=nullptr) const |
Given a SourceLocation, return the spelling line number for the position indicated. More... | |
unsigned | getSpellingLineNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
unsigned | getExpansionLineNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
unsigned | getPresumedLineNumber (SourceLocation Loc, bool *Invalid=nullptr) const |
const char * | getBufferName (SourceLocation Loc, bool *Invalid=nullptr) const |
Return the filename or buffer identifier of the buffer the location is in. More... | |
SrcMgr::CharacteristicKind | getFileCharacteristic (SourceLocation Loc) const |
Return the file characteristic of the specified source location, indicating whether this is a normal file, a system header, or an "implicit extern C" system header. More... | |
PresumedLoc | getPresumedLoc (SourceLocation Loc, bool UseLineDirectives=true) const |
Returns the "presumed" location of a SourceLocation specifies. More... | |
bool | isInMainFile (SourceLocation Loc) const |
Returns whether the PresumedLoc for a given SourceLocation is in the main file. More... | |
bool | isWrittenInSameFile (SourceLocation Loc1, SourceLocation Loc2) const |
Returns true if the spelling locations for both SourceLocations are part of the same file buffer. More... | |
bool | isWrittenInMainFile (SourceLocation Loc) const |
Returns true if the spelling location for the given location is in the main file buffer. More... | |
bool | isInSystemHeader (SourceLocation Loc) const |
Returns if a SourceLocation is in a system header. More... | |
bool | isInExternCSystemHeader (SourceLocation Loc) const |
Returns if a SourceLocation is in an "extern C" system header. More... | |
bool | isInSystemMacro (SourceLocation loc) |
Returns whether Loc is expanded from a macro in a system header. More... | |
unsigned | getFileIDSize (FileID FID) const |
The size of the SLocEntry that FID represents. More... | |
bool | isInFileID (SourceLocation Loc, FileID FID, unsigned *RelativeOffset=nullptr) const |
Given a specific FileID, returns true if Loc is inside that FileID chunk and sets relative offset (offset of Loc from beginning of FileID) to relativeOffset . More... | |
unsigned | getLineTableFilenameID (StringRef Str) |
Return the uniqued ID for the specified filename. More... | |
void | AddLineNote (SourceLocation Loc, unsigned LineNo, int FilenameID) |
Add a line note to the line table for the FileID and offset specified by Loc. More... | |
void | AddLineNote (SourceLocation Loc, unsigned LineNo, int FilenameID, bool IsFileEntry, bool IsFileExit, bool IsSystemHeader, bool IsExternCHeader) |
AddLineNote - Add a GNU line marker to the line table. More... | |
bool | hasLineTable () const |
Determine if the source manager has a line table. More... | |
LineTableInfo & | getLineTable () |
Retrieve the stored line table. More... | |
size_t | getContentCacheSize () const |
Return the total amount of physical memory allocated by the ContentCache allocator. More... | |
MemoryBufferSizes | getMemoryBufferSizes () const |
Return the amount of memory used by memory buffers, breaking down by heap-backed versus mmap'ed memory. More... | |
size_t | getDataStructureSizes () const |
Return the amount of memory used for various side tables and data structures in the SourceManager. More... | |
SourceLocation | translateFileLineCol (const FileEntry *SourceFile, unsigned Line, unsigned Col) const |
Get the source location for the given file:line:col triplet. More... | |
FileID | translateFile (const FileEntry *SourceFile) const |
Get the FileID for the given file. More... | |
SourceLocation | translateLineCol (FileID FID, unsigned Line, unsigned Col) const |
Get the source location in FID for the given line:col. More... | |
SourceLocation | getMacroArgExpandedLocation (SourceLocation Loc) const |
If Loc points inside a function macro argument, the returned location will be the macro location in which the argument was expanded. More... | |
bool | isBeforeInTranslationUnit (SourceLocation LHS, SourceLocation RHS) const |
Determines the order of 2 source locations in the translation unit. More... | |
bool | isBeforeInSLocAddrSpace (SourceLocation LHS, SourceLocation RHS) const |
Determines the order of 2 source locations in the "source location
address space". More... | |
bool | isBeforeInSLocAddrSpace (SourceLocation LHS, unsigned RHS) const |
Determines the order of a source location and a source location offset in the "source location address space". More... | |
fileinfo_iterator | fileinfo_begin () const |
fileinfo_iterator | fileinfo_end () const |
bool | hasFileInfo (const FileEntry *File) const |
void | PrintStats () const |
Print statistics to stderr. More... | |
void | dump () const |
unsigned | local_sloc_entry_size () const |
Get the number of local SLocEntries we have. More... | |
const SrcMgr::SLocEntry & | getLocalSLocEntry (unsigned Index, bool *Invalid=nullptr) const |
Get a local SLocEntry. This is exposed for indexing. More... | |
unsigned | loaded_sloc_entry_size () const |
Get the number of loaded SLocEntries we have. More... | |
const SrcMgr::SLocEntry & | getLoadedSLocEntry (unsigned Index, bool *Invalid=nullptr) const |
Get a loaded SLocEntry. This is exposed for indexing. More... | |
const SrcMgr::SLocEntry & | getSLocEntry (FileID FID, bool *Invalid=nullptr) const |
unsigned | getNextLocalOffset () const |
void | setExternalSLocEntrySource (ExternalSLocEntrySource *Source) |
std::pair< int, unsigned > | AllocateLoadedSLocEntries (unsigned NumSLocEntries, unsigned TotalSize) |
Allocate a number of loaded SLocEntries, which will be actually loaded on demand from the external source. More... | |
bool | isLoadedSourceLocation (SourceLocation Loc) const |
Returns true if Loc came from a PCH/Module. More... | |
bool | isLocalSourceLocation (SourceLocation Loc) const |
Returns true if Loc did not come from a PCH/Module. More... | |
bool | isLoadedFileID (FileID FID) const |
Returns true if FID came from a PCH/Module. More... | |
bool | isLocalFileID (FileID FID) const |
Returns true if FID did not come from a PCH/Module. More... | |
SourceLocation | getImmediateMacroCallerLoc (SourceLocation Loc) const |
Gets the location of the immediate macro caller, one level up the stack toward the initial macro typed into the source. More... | |
Friends | |
class | ASTReader |
class | ASTWriter |
This class handles loading and caching of source files into memory.
This object owns the MemoryBuffer objects for all of the loaded files and assigns unique FileID's for each unique #include chain.
The SourceManager can be queried for information about SourceLocation objects, turning them into either spelling or expansion locations. Spelling locations represent where the bytes corresponding to a token came from and expansion locations represent where the location is in the user's view. In the case of a macro expansion, for example, the spelling location indicates where the expanded token came from and the expansion location specifies where it was expanded.
Definition at line 549 of file SourceManager.h.
typedef llvm::DenseMap<const FileEntry*, SrcMgr::ContentCache*>::const_iterator clang::SourceManager::fileinfo_iterator |
Definition at line 1492 of file SourceManager.h.
SourceManager::SourceManager | ( | DiagnosticsEngine & | Diag, |
FileManager & | FileMgr, | ||
bool | UserFilesAreVolatile = false |
||
) |
Definition at line 361 of file SourceManager.cpp.
References clearIDTables(), and clang::DiagnosticsEngine::setSourceManager().
SourceManager::~SourceManager | ( | ) |
Definition at line 371 of file SourceManager.cpp.
void SourceManager::AddLineNote | ( | SourceLocation | Loc, |
unsigned | LineNo, | ||
int | FilenameID | ||
) |
Add a line note to the line table for the FileID and offset specified by Loc.
AddLineNote - Add a line note to the line table for the FileID and offset specified by Loc.
If FilenameID is -1, it is considered to be unspecified.
Definition at line 289 of file SourceManager.cpp.
References clang::SrcMgr::SLocEntry::getFile(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::Preprocessor::HandlePragmaSystemHeader().
void SourceManager::AddLineNote | ( | SourceLocation | Loc, |
unsigned | LineNo, | ||
int | FilenameID, | ||
bool | IsFileEntry, | ||
bool | IsFileExit, | ||
bool | IsSystemHeader, | ||
bool | IsExternCHeader | ||
) |
AddLineNote - Add a GNU line marker to the line table.
Definition at line 307 of file SourceManager.cpp.
References clang::SrcMgr::C_ExternCSystem, clang::SrcMgr::C_System, clang::SrcMgr::C_User, clang::SrcMgr::SLocEntry::getFile(), and clang::SrcMgr::SLocEntry::isFile().
std::pair< int, unsigned > SourceManager::AllocateLoadedSLocEntries | ( | unsigned | NumSLocEntries, |
unsigned | TotalSize | ||
) |
Allocate a number of loaded SLocEntries, which will be actually loaded on demand from the external source.
NumSLocEntries will be allocated, which occupy a total of TotalSize space in the global source view. The lowest ID and the base offset of the entries will be returned.
Definition at line 480 of file SourceManager.cpp.
References ID.
void SourceManager::clearIDTables | ( | ) |
Definition at line 394 of file SourceManager.cpp.
References clang::LineTableInfo::clear(), and createExpansionLoc().
Referenced by clang::CompilerInstance::ExecuteAction(), and SourceManager().
SourceLocation SourceManager::createExpansionLoc | ( | SourceLocation | Loc, |
SourceLocation | ExpansionLocStart, | ||
SourceLocation | ExpansionLocEnd, | ||
unsigned | TokLength, | ||
int | LoadedID = 0 , |
||
unsigned | LoadedOffset = 0 |
||
) |
Return a new SourceLocation that encodes the fact that a token from SpellingLoc should actually be referenced from ExpansionLoc.
Definition at line 600 of file SourceManager.cpp.
References clang::serialized_diags::create().
Referenced by clearIDTables(), clang::Lexer::Create_PragmaLexer(), clang::Preprocessor::CreateString(), clang::TokenLexer::Init(), and clang::TokenLexer::Lex().
|
inline |
Create a new FileID that represents the specified file being #included from the specified IncludePosition.
This translates NULL into standard input.
Definition at line 778 of file SourceManager.h.
References clang::SrcMgr::C_User.
Referenced by clang::tooling::applyAllReplacements(), applyEditsToTemp(), ConvertBackendLocation(), createFileID(), clang::index::SimpleFormatContext::createInMemoryFile(), clang::Preprocessor::EnterMainSourceFile(), getOrCreateFileID(), clang::ASTImporter::Import(), clang::CompilerInstance::InitializeSourceManager(), ParseDirective(), and clang::ModuleMap::parseModuleMapFile().
|
inline |
Create a new FileID that represents the specified memory buffer.
This does no caching of the buffer and takes ownership of the MemoryBuffer, so only pass a MemoryBuffer to this once.
Definition at line 792 of file SourceManager.h.
References createFileID().
SourceLocation SourceManager::createMacroArgExpansionLoc | ( | SourceLocation | Loc, |
SourceLocation | ExpansionLoc, | ||
unsigned | TokLength | ||
) |
Return a new SourceLocation that encodes the fact that a token from SpellingLoc should actually be referenced from ExpansionLoc, and that it represents the expansion of a macro argument into the function-like macro body.
Definition at line 591 of file SourceManager.cpp.
Referenced by updateConsecutiveMacroArgTokens().
void SourceManager::disableFileContentsOverride | ( | const FileEntry * | File | ) |
Disable overridding the contents of a file, previously enabled with overrideFileContents.
This should be called before parsing has begun.
Definition at line 664 of file SourceManager.cpp.
References isFileOverridden().
LLVM_DUMP_METHOD void SourceManager::dump | ( | ) | const |
Definition at line 2159 of file SourceManager.cpp.
References ID, and clang::None.
|
inline |
Definition at line 1493 of file SourceManager.h.
Referenced by PrintStats().
|
inline |
Definition at line 1494 of file SourceManager.h.
Referenced by PrintStats().
|
inline |
Return the buffer for the specified FileID.
If there is an error opening this buffer the first time, this manufactures a temporary buffer and returns a non-empty error string.
Definition at line 895 of file SourceManager.h.
References clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::html::AddHeaderFooterInternalBuiltinCSS(), clang::html::AddLineNumbers(), clang::Lexer::Create_PragmaLexer(), clang::Preprocessor::EnterSourceFile(), clang::html::EscapeText(), clang::CodeGenAction::ExecuteAction(), clang::DumpRawTokensAction::ExecuteAction(), clang::PrintPreprocessedAction::ExecuteAction(), findDirectives(), clang::format::FormatTokenLexer::FormatTokenLexer(), getBufferName(), getColumnNumber(), getLengthOnSingleLine(), clang::html::HighlightMacros(), isBeforeInTranslationUnit(), LexRawTokensFromMainFile(), NormalizeLine(), clang::ModuleMap::parseModuleMapFile(), clang::RewriteIncludesInInput(), clang::html::SyntaxHighlight(), and clang::TokenRewriter::TokenRewriter().
|
inline |
Definition at line 910 of file SourceManager.h.
References clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Return a StringRef to the source buffer data for the specified FileID.
FID | The file ID whose contents will be returned. |
Invalid | If non-NULL, will be set true if an error occurred. |
Definition at line 682 of file SourceManager.cpp.
References clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::arcmt::trans::MigrationContext::addPropertyAttribute(), adjustRemoval(), clang::Lexer::findLocationAfterToken(), clang::arcmt::trans::findSemiAfterLocation(), clang::tooling::formatAndApplyAllReplacements(), getBeginningOfFileToken(), clang::Rewriter::getEditBuffer(), clang::Lexer::getImmediateMacroName(), clang::Lexer::getImmediateMacroNameForDiagnostics(), clang::StringLiteral::getLocationOfByte(), clang::ASTContext::getRawCommentForDeclNoCache(), clang::Lexer::getRawToken(), clang::Lexer::getSourceText(), clang::Lexer::getSpelling(), clang::comments::Lexer::getSpelling(), clang::html::HighlightRange(), clang::Rewriter::IncreaseIndentation(), clang::Rewriter::InsertText(), LocPropertyAttribute(), onlyWhitespaceBetween(), clang::RawComment::RawComment(), clang::Rewriter::ReplaceText(), and clang::arcmt::trans::MigrationContext::rewritePropertyAttribute().
const char * SourceManager::getBufferName | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Return the filename or buffer identifier of the buffer the location is in.
Note that this name does not respect #line directives. Use getPresumedLoc for normal clients.
Definition at line 1441 of file SourceManager.cpp.
References getBuffer(), getFileID(), and isInvalid().
Referenced by clang::Preprocessor::CheckMacroName(), clang::CodeGen::CodeGenModule::EmitAnnotationUnit(), and clang::Preprocessor::EnterSourceFile().
const char * SourceManager::getCharacterData | ( | SourceLocation | SL, |
bool * | Invalid = nullptr |
||
) | const |
Return a pointer to the start of the specified location in the appropriate spelling MemoryBuffer.
getCharacterData - Return a pointer to the start of the specified location in the appropriate MemoryBuffer.
Invalid | If non-NULL, will be set true if an error occurs. |
Definition at line 1100 of file SourceManager.cpp.
References clang::SrcMgr::FileInfo::getContentCache(), getDecomposedSpellingLoc(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by addFixitForObjCARCConversion(), clang::Lexer::AdvanceToTokenCharacter(), clang::Lexer::Create_PragmaLexer(), clang::Preprocessor::DumpToken(), clang::Lexer::findLocationAfterToken(), GetFirstChar(), clang::Rewriter::getRewrittenText(), clang::Lexer::getSpelling(), clang::Preprocessor::getSpellingOfSingleCharacterNumericConstant(), clang::VerifyDiagnosticConsumer::HandleComment(), and NormalizeLine().
unsigned SourceManager::getColumnNumber | ( | FileID | FID, |
unsigned | FilePos, | ||
bool * | Invalid = nullptr |
||
) | const |
Return the column # for the specified file position.
getColumnNumber - Return the column # for the specified file position.
This is significantly cheaper to compute than the line number. This returns zero if the column number isn't known. This may only be called on a file sloc, so you must choose a spelling or expansion location before calling this method.
this is significantly cheaper to compute than the line number.
Definition at line 1125 of file SourceManager.cpp.
References getBuffer().
Referenced by buildFixItInsertionLine(), clang::TextDiagnostic::emitDiagnosticLoc(), getExpansionColumnNumber(), getPresumedLoc(), and getSpellingColumnNumber().
|
inline |
Return the total amount of physical memory allocated by the ContentCache allocator.
Definition at line 1412 of file SourceManager.h.
size_t SourceManager::getDataStructureSizes | ( | ) | const |
Return the amount of memory used for various side tables and data structures in the SourceManager.
Definition at line 2238 of file SourceManager.cpp.
|
inline |
Decompose the specified location into a raw FileID + Offset pair.
If the location is an expansion record, walk through it until we find the final location expanded.
Definition at line 1128 of file SourceManager.h.
References E, getFileID(), clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), and clang::SourceLocation::isFileID().
Referenced by buildFixItInsertionLine(), getExpansionColumnNumber(), getExpansionLineNumber(), getFileCharacteristic(), getPresumedLoc(), isInMainFile(), and ReadLineMarkerFlags().
Returns the "included/expanded in" decomposed location of the given FileID.
Definition at line 1961 of file SourceManager.cpp.
References getDecomposedLoc(), clang::SrcMgr::SLocEntry::getExpansion(), clang::SrcMgr::ExpansionInfo::getExpansionLocStart(), clang::SrcMgr::SLocEntry::getFile(), clang::SrcMgr::FileInfo::getIncludeLoc(), getSLocEntry(), clang::SrcMgr::SLocEntry::isExpansion(), clang::FileID::isInvalid(), and clang::SourceLocation::isValid().
Referenced by MoveUpIncludeHierarchy().
|
inline |
Decompose the specified location into a raw FileID + Offset pair.
The first element is the FileID, the second is the offset from the start of the buffer of the location.
Definition at line 1114 of file SourceManager.h.
References E, getFileID(), clang::SrcMgr::SLocEntry::getOffset(), and getSLocEntry().
Referenced by clang::ASTUnit::addFileLevelDecl(), clang::arcmt::trans::MigrationContext::addPropertyAttribute(), clang::TextDiagnostic::emitDiagnosticLoc(), clang::Lexer::findLocationAfterToken(), clang::arcmt::trans::findSemiAfterLocation(), getBeginningOfFileToken(), clang::Lexer::GetBeginningOfToken(), getDecomposedIncludedLoc(), getFileOffset(), clang::Lexer::getImmediateMacroName(), clang::Lexer::getImmediateMacroNameForDiagnostics(), getImmediateSpellingLoc(), clang::StringLiteral::getLocationOfByte(), getMacroArgExpandedLocation(), clang::tooling::getRangeSize(), clang::ASTContext::getRawCommentForDeclNoCache(), clang::Lexer::getRawToken(), clang::Lexer::getSourceText(), clang::Lexer::getSpelling(), clang::comments::Lexer::getSpelling(), clang::ASTImporter::Import(), clang::index::IndexingContext::importedModule(), isAtStartOfImmediateMacroExpansion(), isBeforeInTranslationUnit(), LocPropertyAttribute(), makeRangeFromFileLocs(), onlyWhitespaceBetween(), printLoc(), clang::RawComment::RawComment(), clang::arcmt::trans::MigrationContext::rewritePropertyAttribute(), and clang::ento::SuppressInlineDefensiveChecksVisitor::VisitNode().
|
inline |
Decompose the specified location into a raw FileID + Offset pair.
If the location is an expansion record, walk through it until we find its spelling record.
Definition at line 1147 of file SourceManager.h.
References E, getFileID(), clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), and clang::SourceLocation::isFileID().
Referenced by getCharacterData(), getSpellingColumnNumber(), and getSpellingLineNumber().
|
inline |
Definition at line 718 of file SourceManager.h.
Referenced by clang::ASTContext::getDiagnostics(), and ParseDirective().
unsigned SourceManager::getExpansionColumnNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1178 of file SourceManager.cpp.
References getColumnNumber(), getDecomposedExpansionLoc(), and isInvalid().
Referenced by llvm::DOTGraphTraits< ExplodedNode * >::getNodeLabel(), highlightRange(), and llvm::DOTGraphTraits< ExplodedNode * >::printLocation().
unsigned SourceManager::getExpansionLineNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1389 of file SourceManager.cpp.
References getDecomposedExpansionLoc(), getLineNumber(), and isInvalid().
Referenced by clang::CodeGen::CodeGenModule::EmitAnnotationLineNo(), llvm::DOTGraphTraits< ExplodedNode * >::getNodeLabel(), highlightRange(), and llvm::DOTGraphTraits< ExplodedNode * >::printLocation().
|
inline |
Given a SourceLocation object Loc
, return the expansion location referenced by the ID.
Definition at line 1056 of file SourceManager.h.
References clang::SourceLocation::isFileID().
Referenced by clang::Sema::ActOnEndOfTranslationUnit(), clang::Sema::ActOnUsingDirective(), clang::markup::AddFID(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P(), CompactPathDiagnostic(), clang::TextDiagnostic::emitDiagnosticLoc(), clang::markup::EmitLocation(), clang::Sema::findMacroSpelling(), clang::markup::GetFID(), getLengthOnSingleLine(), clang::Preprocessor::getModuleForLocation(), clang::Preprocessor::getModuleHeaderToIncludeForDiagnostics(), getNullabilityCompletenessCheckFileID(), clang::ASTContext::getRawCommentForDeclNoCache(), clang::Lexer::getRawToken(), clang::VerifyDiagnosticConsumer::HandleDiagnostic(), handleObjCOwnershipTypeAttr(), clang::ento::PathDiagnosticConsumer::HandlePathDiagnostic(), clang::html::HighlightMacros(), clang::html::HighlightRange(), clang::TokenLexer::Init(), clang::SourceLocation::print(), printLoc(), ReportControlFlow(), clang::RewriteMacrosInInput(), and clang::CodeGen::CGDebugInfo::setLocation().
std::pair< SourceLocation, SourceLocation > SourceManager::getExpansionRange | ( | SourceLocation | Loc | ) | const |
Given a SourceLocation object, return the range of tokens covered by the expansion in the ultimate file.
getExpansionRange - Given a SourceLocation object, return the range of tokens covered by the expansion in the ultimate file.
Definition at line 986 of file SourceManager.cpp.
References getImmediateExpansionRange(), and clang::SourceLocation::isFileID().
Referenced by clang::TextDiagnostic::emitDiagnosticLoc(), getExpansionRange(), getLengthOnSingleLine(), clang::html::HighlightMacros(), ReportEvent(), and clang::arcmt::writeARCDiagsToPlist().
|
inline |
Given a SourceRange object, return the range of tokens covered by the expansion in the ultimate file.
Definition at line 1085 of file SourceManager.h.
References clang::SourceRange::getBegin(), clang::SourceRange::getEnd(), and getExpansionRange().
SrcMgr::CharacteristicKind SourceManager::getFileCharacteristic | ( | SourceLocation | Loc | ) | const |
Return the file characteristic of the specified source location, indicating whether this is a normal file, a system header, or an "implicit extern C" system header.
getFileCharacteristic - return the file characteristic of the specified source location, indicating whether this is a normal file, a system header, or an "implicit extern C" system header.
This state can be modified with flags on GNU linemarker directives like:
which changes all source locations in the current file after that to be considered to be from a system header.
This state can be modified with flags on GNU linemarker directives like:
which changes all source locations in the current file after that to be considered to be from a system header.
Definition at line 1411 of file SourceManager.cpp.
References clang::SrcMgr::C_User, clang::LineEntry::FileKind, clang::LineTableInfo::FindNearestLineEntry(), getDecomposedExpansionLoc(), clang::SrcMgr::SLocEntry::getFile(), clang::SrcMgr::FileInfo::getFileCharacteristic(), getSLocEntry(), clang::SrcMgr::FileInfo::hasLineDirectives(), clang::SrcMgr::SLocEntry::isFile(), and clang::SourceLocation::isValid().
Referenced by clang::Preprocessor::HandleEndOfFile(), isInExternCSystemHeader(), and isInSystemHeader().
Returns the FileEntry record for the provided FileID.
Definition at line 926 of file SourceManager.h.
References clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::arcmt::MigrationProcess::applyTransform(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P(), clang::CacheTokens(), clang::TextDiagnostic::emitDiagnosticLoc(), clang::Preprocessor::EnterMainSourceFile(), clang::Preprocessor::EnterSourceFile(), clang::CodeGenAction::ExecuteAction(), clang::ModuleMap::getContainingModuleMapFile(), clang::PreprocessorLexer::getFileEntry(), getFilename(), clang::Lexer::getImmediateMacroNameForDiagnostics(), clang::ASTUnit::getMainFileName(), clang::Preprocessor::getModuleForLocation(), clang::Preprocessor::getModuleHeaderToIncludeForDiagnostics(), clang::LogDiagnosticPrinter::HandleDiagnostic(), clang::VerifyDiagnosticConsumer::HandleDiagnostic(), clang::ModuleMap::inferModuleFromLocation(), IsFromSameFile(), clang::CodeGen::CodeGenModule::isInSanitizerBlacklist(), clang::Preprocessor::LookupFile(), clang::Rewriter::overwriteChangedFiles(), printLoc(), PrintUnexpected(), clang::Preprocessor::SetCodeCompletionPoint(), clang::VerifyDiagnosticConsumer::UpdateParsedFileStatus(), clang::arcmt::writeARCDiagsToPlist(), and clang::FixItRewriter::WriteFixedFiles().
|
inline |
Returns the FileEntry record for the provided SLocEntry.
Definition at line 939 of file SourceManager.h.
References clang::SrcMgr::FileInfo::getContentCache(), and clang::SrcMgr::SLocEntry::getFile().
|
inline |
Return the FileID for a SourceLocation.
This is a very hot method that is used for all SourceManager queries that start with a SourceLocation object. It is responsible for finding the entry in SLocEntryTable which contains the specified location.
Definition at line 987 of file SourceManager.h.
Referenced by clang::markup::AddFID(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P(), checkConfigMacro(), checkObjCUnusedIvar(), clang::Lexer::Create_PragmaLexer(), clang::TextDiagnostic::emitDiagnosticLoc(), EvaluateDefined(), getBufferName(), clang::ModuleMap::getContainingModuleMapFile(), getDecomposedExpansionLoc(), getDecomposedLoc(), getDecomposedSpellingLoc(), clang::markup::GetFID(), getFilename(), getImmediateExpansionRange(), clang::Lexer::getImmediateMacroName(), clang::Lexer::getImmediateMacroNameForDiagnostics(), getLengthOnSingleLine(), getMacroArgExpansionFileIDs(), clang::Preprocessor::getModuleForLocation(), clang::Preprocessor::getModuleHeaderToIncludeForDiagnostics(), getModuleImportLoc(), getNullabilityCompletenessCheckFileID(), clang::LogDiagnosticPrinter::HandleDiagnostic(), clang::VerifyDiagnosticConsumer::HandleDiagnostic(), clang::ento::PathDiagnosticConsumer::HandlePathDiagnostic(), clang::html::HighlightMacros(), clang::html::HighlightRange(), highlightRange(), clang::ModuleMap::inferModuleFromLocation(), isAtEndOfImmediateMacroExpansion(), IsFromSameFile(), isMacroArgExpansion(), isMacroBodyExpansion(), isWrittenInMainFile(), isWrittenInSameFile(), clang::Lexer::makeFileCharRange(), mapDiagnosticRanges(), NormalizeLine(), ParseDirective(), PrintUnexpected(), retrieveMacroLocation(), Scan(), and shouldIgnoreMacro().
The size of the SLocEntry that FID
represents.
Definition at line 1551 of file SourceManager.cpp.
References getNextLocalOffset(), clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), and local_sloc_entry_size().
Referenced by getLocForEndOfFile().
|
inline |
Given Loc
, if it is a macro location return the expansion location or the spelling location, depending on if it comes from a macro argument or not.
Definition at line 1066 of file SourceManager.h.
References clang::SourceLocation::isFileID().
Referenced by clang::ASTUnit::addFileLevelDecl(), clang::index::IndexingContext::importedModule(), clang::SanitizerBlacklist::isBlacklistedLocation(), isPreprocessedEntityIfInFileID(), and makeStandaloneDiagnostic().
|
inline |
Definition at line 720 of file SourceManager.h.
Referenced by clang::tooling::Replacement::apply(), clang::tooling::formatAndApplyAllReplacements(), clang::BackendConsumer::getBestLocationFromDebugLoc(), clang::ModuleMap::isHeaderUnavailableInModule(), clang::ASTWriter::PreparePathForOutput(), and clang::ModuleMap::setUmbrellaHeader().
|
inline |
Return the filename of the file containing a SourceLocation.
Definition at line 998 of file SourceManager.h.
References getFileEntryForID(), and getFileID().
Referenced by clang::ento::LikelyFalsePositiveSuppressionBRVisitor::getEndPath(), clang::SanitizerBlacklist::isBlacklistedLocation(), makeStandaloneDiagnostic(), and PrintExpected().
|
inline |
Returns the offset from the start of the file that the specified SourceLocation represents.
This is not very meaningful for a macro ID.
Definition at line 1168 of file SourceManager.h.
References getDecomposedLoc().
Referenced by getLengthOnSingleLine(), clang::html::HighlightRange(), makeStandaloneDiagnostic(), makeStandaloneRange(), clang::RewriteMacrosInInput(), and clang::html::SyntaxHighlight().
std::pair< SourceLocation, SourceLocation > SourceManager::getImmediateExpansionRange | ( | SourceLocation | Loc | ) | const |
Return the start/end of the expansion information for an expansion location.
getImmediateExpansionRange - Loc is required to be an expansion location.
Loc
is required to be an expansion location.Return the start/end of the expansion information.
Definition at line 977 of file SourceManager.cpp.
References clang::SrcMgr::SLocEntry::getExpansion(), clang::SrcMgr::ExpansionInfo::getExpansionLocRange(), getFileID(), getSLocEntry(), and clang::SourceLocation::isMacroID().
Referenced by checkAllAtProps(), CheckMoveOnConstruction(), clang::Sema::DiagnoseAbsenceOfOverrideControl(), getExpansionRange(), GetFullTypeForDeclarator(), getImmediateMacroCallerLoc(), clang::Lexer::getImmediateMacroName(), clang::Lexer::getImmediateMacroNameForDiagnostics(), getMacroArgExpansionFileIDs(), handleObjCOwnershipTypeAttr(), mapDiagnosticRanges(), and retrieveMacroLocation().
|
inline |
Gets the location of the immediate macro caller, one level up the stack toward the initial macro typed into the source.
Definition at line 1576 of file SourceManager.h.
References getImmediateExpansionRange(), getImmediateSpellingLoc(), isMacroArgExpansion(), and clang::SourceLocation::isMacroID().
Referenced by getTopMostMacro(), IsFromSameFile(), and IsInAnyMacroBody().
SourceLocation SourceManager::getImmediateSpellingLoc | ( | SourceLocation | Loc | ) | const |
Given a SourceLocation object, return the spelling location referenced by the ID.
getImmediateSpellingLoc - Given a SourceLocation object, return the spelling location referenced by the ID.
This is the first level down towards the place where the characters that make up the lexed token can be found. This should not generally be used by clients.
Definition at line 966 of file SourceManager.cpp.
References getDecomposedLoc(), clang::SrcMgr::SLocEntry::getExpansion(), clang::SourceLocation::getLocWithOffset(), getSLocEntry(), clang::SrcMgr::ExpansionInfo::getSpellingLoc(), and clang::SourceLocation::isFileID().
Referenced by getImmediateMacroCallerLoc(), getMacroArgExpansionFileIDs(), clang::Lexer::makeFileCharRange(), and retrieveMacroLocation().
|
inline |
Returns the include location if FID
is a #include'd file otherwise it returns an invalid location.
Definition at line 1030 of file SourceManager.h.
References clang::SrcMgr::SLocEntry::getFile(), clang::SrcMgr::FileInfo::getIncludeLoc(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::Preprocessor::getModuleHeaderToIncludeForDiagnostics(), clang::Preprocessor::HandleEndOfFile(), and clang::ModuleMap::inferModuleFromLocation().
unsigned SourceManager::getLineNumber | ( | FileID | FID, |
unsigned | FilePos, | ||
bool * | Invalid = nullptr |
||
) | const |
Given a SourceLocation, return the spelling line number for the position indicated.
getLineNumber - Given a SourceLocation, return the spelling line number for the position indicated.
This requires building and caching a table of line offsets for the MemoryBuffer, so this is not cheap: use only when about to emit a diagnostic.
SourceLineCache for it on demand.
Definition at line 1289 of file SourceManager.cpp.
References ComputeLineNumbers(), clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), clang::SrcMgr::SLocEntry::isFile(), and clang::FileID::isInvalid().
Referenced by buildFixItInsertionLine(), clang::TextDiagnostic::emitDiagnosticLoc(), getExpansionLineNumber(), getPresumedLoc(), clang::ASTContext::getRawCommentForDeclNoCache(), getSpellingLineNumber(), clang::Rewriter::IncreaseIndentation(), and clang::Rewriter::InsertText().
LineTableInfo & SourceManager::getLineTable | ( | ) |
Retrieve the stored line table.
Definition at line 351 of file SourceManager.cpp.
unsigned SourceManager::getLineTableFilenameID | ( | StringRef | Str | ) |
Return the uniqued ID for the specified filename.
getLineTableFilenameID - Return the uniqued ID for the specified filename.
Definition at line 281 of file SourceManager.cpp.
Referenced by clang::Preprocessor::HandlePragmaSystemHeader().
|
inline |
Get a loaded SLocEntry. This is exposed for indexing.
Definition at line 1519 of file SourceManager.h.
Referenced by translateFile().
|
inline |
Get a local SLocEntry. This is exposed for indexing.
Definition at line 1509 of file SourceManager.h.
Referenced by translateFile().
|
inline |
Return the source location corresponding to the last byte of the specified file.
Definition at line 1018 of file SourceManager.h.
References getFileIDSize(), clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::ASTUnit::getEndOfPreambleFileID().
|
inline |
Return the source location corresponding to the first byte of the specified file.
Definition at line 1006 of file SourceManager.h.
References clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::html::AddHeaderFooterInternalBuiltinCSS(), clang::arcmt::trans::MigrationContext::addPropertyAttribute(), clang::tooling::Replacement::apply(), applyEditsToTemp(), applyRewrite(), ConvertBackendLocation(), clang::Lexer::Create_PragmaLexer(), clang::Preprocessor::EnterSourceFile(), clang::ASTReader::FindFileRegionDecls(), clang::Lexer::findLocationAfterToken(), clang::arcmt::trans::findSemiAfterLocation(), clang::edit::Commit::Edit::getFileLocation(), clang::edit::Commit::Edit::getInsertFromRange(), clang::StringLiteral::getLocationOfByte(), getPresumedLoc(), clang::Lexer::getRawToken(), clang::ASTUnit::PreambleData::getSourceRange(), clang::Lexer::getSpelling(), clang::ASTUnit::getStartOfMainFileID(), clang::Preprocessor::HandleEndOfFile(), clang::ASTImporter::Import(), LocPropertyAttribute(), clang::ASTUnit::mapLocationFromPreamble(), clang::ASTUnit::mapLocationToPreamble(), NormalizeLine(), clang::PTHLexer::PTHLexer(), and clang::arcmt::trans::MigrationContext::rewritePropertyAttribute().
SourceLocation SourceManager::getMacroArgExpandedLocation | ( | SourceLocation | Loc | ) | const |
If Loc
points inside a function macro argument, the returned location will be the macro location in which the argument was expanded.
If.
If a macro argument is used multiple times, the expanded location will be at the first expansion of the argument. e.g. MY_MACRO(foo); ^ Passing a file location pointing at 'foo', will yield a macro location where 'foo' was expanded into.
Definition at line 1934 of file SourceManager.cpp.
References getDecomposedLoc(), clang::SourceLocation::getLocWithOffset(), I, clang::SourceLocation::isFileID(), clang::FileID::isInvalid(), clang::SourceLocation::isInvalid(), and clang::SourceLocation::isValid().
Referenced by clang::ASTUnit::getLocation().
|
inline |
Returns the FileID of the main source file.
Definition at line 754 of file SourceManager.h.
Referenced by clang::CacheTokens(), clang::DoRewriteTest(), clang::Preprocessor::EnterMainSourceFile(), clang::CodeGenAction::ExecuteAction(), clang::DumpRawTokensAction::ExecuteAction(), clang::PrintPreprocessedAction::ExecuteAction(), clang::ASTUnit::getMainFileName(), clang::ASTUnit::getStartOfMainFileID(), clang::LogDiagnosticPrinter::HandleDiagnostic(), clang::Preprocessor::HandleEndOfFile(), clang::CompilerInstance::InitializeSourceManager(), clang::ASTUnit::isInMainFileID(), clang::CodeGen::CodeGenModule::isInSanitizerBlacklist(), isWrittenInMainFile(), LexRawTokensFromMainFile(), clang::Preprocessor::LookupFile(), clang::ASTUnit::mapLocationFromPreamble(), clang::ASTUnit::mapLocationToPreamble(), clang::RewriteIncludesInInput(), clang::RewriteMacrosInInput(), and clang::Preprocessor::SetCodeCompletionPoint().
llvm::MemoryBuffer * SourceManager::getMemoryBufferForFile | ( | const FileEntry * | File, |
bool * | Invalid = nullptr |
||
) |
Retrieve the memory buffer associated with the given file.
Invalid | If non-NULL, will be set true if an error occurs while retrieving the memory buffer. |
Definition at line 634 of file SourceManager.cpp.
Referenced by clang::Preprocessor::SetCodeCompletionPoint().
SourceManager::MemoryBufferSizes SourceManager::getMemoryBufferSizes | ( | ) | const |
Return the amount of memory used by memory buffers, breaking down by heap-backed versus mmap'ed memory.
Definition at line 2220 of file SourceManager.cpp.
|
inline |
Retrieve the module build stack.
Definition at line 734 of file SourceManager.h.
Referenced by clang::GenerateModuleAction::BeginSourceFileAction(), compileModuleImpl(), and clang::CompilerInstance::loadModule().
|
inline |
Definition at line 1043 of file SourceManager.h.
References getFileID(), and clang::ExternalSLocEntrySource::getModuleImportLoc().
|
inline |
Definition at line 1536 of file SourceManager.h.
Referenced by getFileIDSize(), and clang::TokenLexer::Init().
Get the number of FileIDs (files and macros) that were created during preprocessing of FID
, including it.
Definition at line 956 of file SourceManager.h.
References clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
|
inline |
Get the FileID for SourceFile
if it exists.
Otherwise, create a new FileID for the SourceFile
.
Definition at line 802 of file SourceManager.h.
References createFileID(), ID, clang::FileID::isValid(), and translateFile().
Referenced by clang::tooling::Replacement::apply(), and clang::tooling::formatAndApplyAllReplacements().
|
inline |
Get the file ID for the precompiled preamble if there is one.
Definition at line 768 of file SourceManager.h.
Referenced by clang::ASTUnit::getEndOfPreambleFileID(), clang::ASTUnit::PreambleData::getSourceRange(), clang::ASTUnit::isInPreambleFileID(), clang::ASTUnit::mapLocationFromPreamble(), and clang::ASTUnit::mapLocationToPreamble().
unsigned SourceManager::getPresumedColumnNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1185 of file SourceManager.cpp.
References clang::PresumedLoc::getColumn(), getPresumedLoc(), and isInvalid().
Referenced by clang::Sema::DiagnoseEmptyLoopBody().
unsigned SourceManager::getPresumedLineNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1395 of file SourceManager.cpp.
References clang::PresumedLoc::getLine(), getPresumedLoc(), and isInvalid().
Referenced by clang::comments::Sema::actOnHTMLEndTag(), CheckLists(), clang::comments::Parser::parseHTMLStartTag(), PrintExpected(), and PrintUnexpected().
PresumedLoc SourceManager::getPresumedLoc | ( | SourceLocation | Loc, |
bool | UseLineDirectives = true |
||
) | const |
Returns the "presumed" location of a SourceLocation specifies.
getPresumedLoc - This method returns the "presumed" location of a SourceLocation specifies.
A "presumed location" can be modified by #line or GNU line marker directives. This provides a view on the data that a user should see in diagnostics, for example.
Note that a presumed location is always given as the expansion point of an expansion location, not at the spelling location.
Loc
is invalid or the file containing Loc
has changed on disk), returns an invalid presumed location.A "presumed location" can be modified by #line or GNU line marker directives. This provides a view on the data that a user should see in diagnostics, for example.
Note that a presumed location is always given as the expansion point of an expansion location, not at the spelling location.
Definition at line 1456 of file SourceManager.cpp.
References Filename, clang::LineTableInfo::FindNearestLineEntry(), getColumnNumber(), clang::SrcMgr::FileInfo::getContentCache(), getDecomposedExpansionLoc(), clang::SrcMgr::SLocEntry::getFile(), clang::LineTableInfo::getFilename(), clang::SrcMgr::FileInfo::getIncludeLoc(), getLineNumber(), getLocForStartOfFile(), clang::SourceLocation::getLocWithOffset(), getSLocEntry(), clang::SrcMgr::FileInfo::hasLineDirectives(), clang::SrcMgr::SLocEntry::isFile(), and clang::SourceLocation::isInvalid().
Referenced by clang::DoPrintPreprocessedInput(), clang::CodeGen::CodeGenModule::EmitAnnotationLineNo(), clang::CodeGen::CodeGenModule::EmitAnnotationUnit(), clang::CodeGen::emitUpdateLocation(), getPresumedColumnNumber(), getPresumedLineNumber(), getTargetEntryUniqueInfo(), clang::LogDiagnosticPrinter::HandleDiagnostic(), clang::Preprocessor::HandlePragmaSystemHeader(), clang::SourceLocation::print(), ReadLineMarkerFlags(), and clang::CodeGen::CGDebugInfo::setLocation().
|
inline |
Definition at line 1527 of file SourceManager.h.
Referenced by EvaluateDefined(), getBuffer(), getBufferData(), getCharacterData(), getDecomposedExpansionLoc(), getDecomposedIncludedLoc(), getDecomposedLoc(), getDecomposedSpellingLoc(), getFileCharacteristic(), getFileEntryForID(), getFileIDSize(), getImmediateExpansionRange(), clang::Lexer::getImmediateMacroName(), getImmediateSpellingLoc(), getIncludeLoc(), getLineNumber(), getLocForEndOfFile(), getLocForStartOfFile(), getNullabilityCompletenessCheckFileID(), getNumCreatedFIDsForFileID(), getPresumedLoc(), clang::index::IndexingContext::importedModule(), clang::Rewriter::IncreaseIndentation(), clang::Rewriter::InsertText(), isAtEndOfImmediateMacroExpansion(), isAtStartOfImmediateMacroExpansion(), isInFileID(), isInMainFile(), isMacroArgExpansion(), isMacroBodyExpansion(), clang::Lexer::makeFileCharRange(), setNumCreatedFIDsForFileID(), translateFile(), translateLineCol(), and clang::ento::SuppressInlineDefensiveChecksVisitor::VisitNode().
unsigned SourceManager::getSpellingColumnNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1171 of file SourceManager.cpp.
References getColumnNumber(), getDecomposedSpellingLoc(), and isInvalid().
Referenced by clang::format::ContinuationIndenter::addTokenToState().
unsigned SourceManager::getSpellingLineNumber | ( | SourceLocation | Loc, |
bool * | Invalid = nullptr |
||
) | const |
Definition at line 1383 of file SourceManager.cpp.
References getDecomposedSpellingLoc(), getLineNumber(), and isInvalid().
Referenced by ParseDirective().
|
inline |
Given a SourceLocation object, return the spelling location referenced by the ID.
This is the place where the characters that make up the lexed token can be found.
Definition at line 1095 of file SourceManager.h.
References clang::SourceLocation::isFileID().
Referenced by clang::TokenConcatenation::AvoidConcat(), clang::Sema::DiagnoseAbsenceOfOverrideControl(), clang::Lexer::GetBeginningOfToken(), GetFirstChar(), clang::Lexer::getImmediateMacroName(), clang::Lexer::getImmediateMacroNameForDiagnostics(), clang::StringLiteral::getLocationOfByte(), clang::tooling::getRangeSize(), clang::ASTImporter::Import(), clang::Lexer::isAtEndOfMacroExpansion(), isInSystemMacro(), mapDiagnosticRanges(), clang::SourceLocation::print(), and shouldIgnoreDueToReservedName().
Definition at line 1495 of file SourceManager.h.
Referenced by clang::Preprocessor::HandleEndOfFile().
|
inline |
Determine if the source manager has a line table.
Definition at line 1401 of file SourceManager.h.
bool SourceManager::isAtEndOfImmediateMacroExpansion | ( | SourceLocation | Loc, |
SourceLocation * | MacroEnd = nullptr |
||
) | const |
Returns true if the given MacroID location points at the character end of the immediate macro expansion.
MacroEnd | If non-null and function returns true, it is set to the character end location of the immediate macro expansion. |
Definition at line 1057 of file SourceManager.cpp.
References clang::SrcMgr::SLocEntry::getExpansion(), clang::SrcMgr::ExpansionInfo::getExpansionLocEnd(), clang::SrcMgr::ExpansionInfo::getExpansionLocStart(), getFileID(), clang::SourceLocation::getLocWithOffset(), getSLocEntry(), clang::SrcMgr::SLocEntry::isExpansion(), isInFileID(), clang::FileID::isInvalid(), clang::SrcMgr::ExpansionInfo::isMacroArgExpansion(), clang::SourceLocation::isMacroID(), and clang::SourceLocation::isValid().
Referenced by clang::Lexer::isAtEndOfMacroExpansion().
bool SourceManager::isAtStartOfImmediateMacroExpansion | ( | SourceLocation | Loc, |
SourceLocation * | MacroBegin = nullptr |
||
) | const |
Returns true if the given MacroID location points at the beginning of the immediate macro expansion.
MacroBegin | If non-null and function returns true, it is set to the begin location of the immediate macro expansion. |
Definition at line 1022 of file SourceManager.cpp.
References getDecomposedLoc(), clang::SrcMgr::SLocEntry::getExpansion(), clang::SrcMgr::ExpansionInfo::getExpansionLocStart(), getSLocEntry(), clang::SrcMgr::SLocEntry::isExpansion(), clang::FileID::isInvalid(), clang::SrcMgr::ExpansionInfo::isMacroArgExpansion(), clang::SourceLocation::isMacroID(), and clang::SourceLocation::isValid().
Referenced by CheckMoveOnConstruction(), and clang::Lexer::isAtStartOfMacroExpansion().
|
inline |
Determines the order of 2 source locations in the "source location address space".
Definition at line 1472 of file SourceManager.h.
Referenced by clang::TokenLexer::Lex().
|
inline |
Determines the order of a source location and a source location offset in the "source location address space".
Note that we always consider source locations loaded from
Definition at line 1480 of file SourceManager.h.
bool SourceManager::isBeforeInTranslationUnit | ( | SourceLocation | LHS, |
SourceLocation | RHS | ||
) | const |
Determines the order of 2 source locations in the translation unit.
Definition at line 2034 of file SourceManager.cpp.
References clang::InBeforeInTUCacheEntry::clear(), getBuffer(), clang::InBeforeInTUCacheEntry::getCachedResult(), getDecomposedLoc(), I, clang::InBeforeInTUCacheEntry::isCacheValid(), clang::SourceLocation::isValid(), MoveUpIncludeHierarchy(), clang::InBeforeInTUCacheEntry::setCommonLoc(), and clang::InBeforeInTUCacheEntry::setQueryFIDs().
Referenced by clang::RawCommentList::addComment(), clang::PreprocessingRecord::addPreprocessedEntity(), clang::format::AffectedRangeManager::affectsCharSourceRange(), compare(), comparePiece(), clang::Sema::diagnoseIgnoredQualifiers(), diagnoseRepeatedUseOfWeak(), clang::PPConditionalDirectiveRecord::findConditionalDirectiveRegionLoc(), clang::MacroDirective::findDirectiveAtLoc(), clang::DeclSpec::Finish(), clang::Preprocessor::getLastMacroWithSpelling(), clang::FunctionDecl::getReturnTypeSourceRange(), clang::PPConditionalDirectiveRecord::CondDirectiveLoc::Comp::operator()(), clang::format::WhitespaceManager::Change::IsBeforeInFile::operator()(), clang::PPConditionalDirectiveRecord::rangeIntersectsConditionalDirective(), and removePunyEdges().
Returns true if the file contents have been overridden.
Definition at line 861 of file SourceManager.h.
Referenced by disableFileContentsOverride().
|
inline |
Returns if a SourceLocation is in an "extern C" system header.
Definition at line 1356 of file SourceManager.h.
References clang::SrcMgr::C_ExternCSystem, and getFileCharacteristic().
|
inline |
Given a specific FileID, returns true if Loc
is inside that FileID chunk and sets relative offset (offset of Loc
from beginning of FileID) to relativeOffset
.
Definition at line 1371 of file SourceManager.h.
References clang::SrcMgr::SLocEntry::getOffset(), and getSLocEntry().
Referenced by clang::Lexer::getImmediateMacroName(), clang::Lexer::getSourceText(), isAtEndOfImmediateMacroExpansion(), clang::ASTUnit::isInMainFileID(), clang::ASTUnit::isInPreambleFileID(), isPreprocessedEntityIfInFileID(), makeRangeFromFileLocs(), clang::ASTUnit::mapLocationFromPreamble(), and clang::ASTUnit::mapLocationToPreamble().
bool SourceManager::isInMainFile | ( | SourceLocation | Loc | ) | const |
Returns whether the PresumedLoc for a given SourceLocation is in the main file.
This computes the "presumed" location for a SourceLocation, then checks whether it came from a file other than the main file. This is different from isWrittenInMainFile() because it takes line marker directives into account.
Definition at line 1527 of file SourceManager.cpp.
References clang::LineTableInfo::FindNearestLineEntry(), getDecomposedExpansionLoc(), clang::SrcMgr::SLocEntry::getFile(), clang::SrcMgr::FileInfo::getIncludeLoc(), getSLocEntry(), clang::SrcMgr::FileInfo::hasLineDirectives(), clang::SrcMgr::SLocEntry::isFile(), and clang::SourceLocation::isInvalid().
Referenced by clang::Sema::ActOnEndOfTranslationUnit(), clang::Sema::ActOnUsingDirective(), clang::CodeGen::CodeGenPGO::assignRegionCounters(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER(), clang::ObjCMethodCall::canBeOverridenInSubclass(), CheckUnreachable(), diagnoseUseOfInternalDeclInInlineFunction(), getFirstStackedCallToHeaderFile(), clang::Preprocessor::getModuleForLocation(), clang::Preprocessor::getModuleHeaderToIncludeForDiagnostics(), isMainFileLoc(), clang::Preprocessor::LookupFile(), and mayInlineDecl().
|
inline |
Return true if both LHS
and RHS
are in the local source location address space or the loaded one.
If it's true and RelativeOffset
is non-null, it will be set to the offset of RHS
relative to LHS
.
Definition at line 1238 of file SourceManager.h.
Referenced by isEmptyARCMTMacroStatement(), and updateConsecutiveMacroArgTokens().
|
inline |
Returns true if Loc
is inside the [Start
, +Length
) chunk of the source location address space.
If it's true and RelativeOffset
is non-null, it will be set to the relative offset of Loc
inside the chunk.
Definition at line 1213 of file SourceManager.h.
References Length.
|
inline |
Returns if a SourceLocation is in a system header.
Definition at line 1351 of file SourceManager.h.
References clang::SrcMgr::C_User, and getFileCharacteristic().
Referenced by clang::Sema::ActOnAtEnd(), clang::Sema::ActOnComment(), clang::ASTContext::addComment(), clang::ast_matchers::AST_POLYMORPHIC_MATCHER(), clang::Sema::BuildCXXNew(), clang::Sema::CheckEquivalentExceptionSpec(), clang::Sema::checkInitMethod(), clang::Preprocessor::CheckMacroName(), clang::Sema::DiagnoseAbsenceOfOverrideControl(), DiagnoseNamespaceInlineMismatch(), DoEmitAvailabilityWarning(), clang::index::generateUSRForMacro(), clang::TemplateDeclInstantiator::InstantiateTypedefNameDecl(), isForbiddenTypeAllowed(), clang::ento::CallEvent::isInSystemHeader(), isInSystemMacro(), clang::Sema::isLibstdcxxEagerExceptionSpecHack(), isLibstdcxxPointerReturnFalseHack(), clang::Sema::makeUnavailableInSystemHeader(), clang::Sema::maybeAddCUDAHostDeviceAttrs(), mayInlineDecl(), clang::Sema::MergeTypedefNameDecl(), clang::Sema::ParseObjCSelectorExpression(), and shouldIgnoreDueToReservedName().
|
inline |
Returns whether Loc
is expanded from a macro in a system header.
Definition at line 1361 of file SourceManager.h.
References getSpellingLoc(), isInSystemHeader(), and clang::SourceLocation::isMacroID().
Referenced by clang::Sema::ActOnCastExpr().
Returns true if FID
came from a PCH/Module.
Definition at line 1564 of file SourceManager.h.
Referenced by clang::Preprocessor::EnterMainSourceFile(), clang::ASTUnit::findFileRegionDecls(), clang::VerifyDiagnosticConsumer::HandleDiagnostic(), and isLocalFileID().
|
inline |
Returns true if Loc
came from a PCH/Module.
Definition at line 1554 of file SourceManager.h.
Returns true if FID
did not come from a PCH/Module.
Definition at line 1570 of file SourceManager.h.
References isLoadedFileID().
|
inline |
Returns true if Loc
did not come from a PCH/Module.
Definition at line 1559 of file SourceManager.h.
Referenced by clang::ASTUnit::addFileLevelDecl().
bool SourceManager::isMacroArgExpansion | ( | SourceLocation | Loc, |
SourceLocation * | StartLoc = nullptr |
||
) | const |
Tests whether the given source location represents a macro argument's expansion into the function-like macro definition.
StartLoc | If non-null and function returns true, it is set to the start location of the macro argument expansion. |
Such source locations only appear inside of the expansion locations representing where a particular function-like macro was expanded.
Definition at line 1001 of file SourceManager.cpp.
References clang::SrcMgr::SLocEntry::getExpansion(), clang::SrcMgr::ExpansionInfo::getExpansionLocStart(), getFileID(), getSLocEntry(), clang::SrcMgr::ExpansionInfo::isMacroArgExpansion(), and clang::SourceLocation::isMacroID().
Referenced by checkLocForMacroArgExpansion(), checkRangesForMacroArgExpansion(), clang::Lexer::GetBeginningOfToken(), getImmediateMacroCallerLoc(), clang::Lexer::getImmediateMacroNameForDiagnostics(), getMacroArgExpansionFileIDs(), clang::ASTContext::getRawCommentForDeclNoCache(), and retrieveMacroLocation().
bool SourceManager::isMacroBodyExpansion | ( | SourceLocation | Loc | ) | const |
Tests whether the given source location represents the expansion of a macro body.
This is equivalent to testing whether the location is part of a macro expansion but not the expansion of an argument to a function-like macro.
Definition at line 1014 of file SourceManager.cpp.
References clang::SrcMgr::SLocEntry::getExpansion(), getFileID(), getSLocEntry(), clang::SrcMgr::ExpansionInfo::isMacroBodyExpansion(), and clang::SourceLocation::isMacroID().
Referenced by DiagnoseUnusedComparison(), and IsInAnyMacroBody().
|
inline |
Returns true if the spelling location for the given location is in the main file buffer.
This check ignores line marker directives.
Definition at line 1346 of file SourceManager.h.
References getFileID(), and getMainFileID().
Referenced by clang::Sema::ActOnModuleInclude(), IsFromSameFile(), and clang::RewriteMacrosInInput().
|
inline |
Returns true if the spelling locations for both SourceLocations are part of the same file buffer.
This check ignores line marker directives.
Definition at line 1338 of file SourceManager.h.
References getFileID().
Referenced by IsFromSameFile(), removePunyEdges(), and updateConsecutiveMacroArgTokens().
|
inline |
Get the number of loaded SLocEntries we have.
Definition at line 1516 of file SourceManager.h.
Referenced by translateFile().
|
inline |
Get the number of local SLocEntries we have.
Definition at line 1506 of file SourceManager.h.
Referenced by getFileIDSize(), clang::Preprocessor::HandleEndOfFile(), clang::PreprocessorLexer::PreprocessorLexer(), and translateFile().
void SourceManager::overrideFileContents | ( | const FileEntry * | SourceFile, |
llvm::MemoryBuffer * | Buffer, | ||
bool | DoNotFree | ||
) |
Override the contents of the given source file by providing an already-allocated buffer.
SourceFile | the source file whose contents will be overridden. |
Buffer | the memory buffer whose contents will be used as the data in the given source file. |
DoNotFree | If true, then the buffer will not be freed when the source manager is destroyed. |
Definition at line 641 of file SourceManager.cpp.
Referenced by compileModuleImpl(), InitializeFileRemapping(), clang::CompilerInstance::InitializeSourceManager(), overrideFileContents(), and clang::Preprocessor::SetCodeCompletionPoint().
|
inline |
Definition at line 846 of file SourceManager.h.
References overrideFileContents().
void SourceManager::overrideFileContents | ( | const FileEntry * | SourceFile, |
const FileEntry * | NewFile | ||
) |
Override the given source file with another one.
SourceFile | the source file which will be overridden. |
NewFile | the file whose contents will be used as the data instead of the contents of the given source file. |
Definition at line 653 of file SourceManager.cpp.
References clang::FileEntry::getSize().
void SourceManager::PrintStats | ( | ) | const |
Print statistics to stderr.
Definition at line 2131 of file SourceManager.cpp.
References E, fileinfo_begin(), fileinfo_end(), and I.
Referenced by clang::FrontendAction::EndSourceFile().
|
inline |
Push an entry to the module build stack.
Definition at line 745 of file SourceManager.h.
Referenced by clang::GenerateModuleAction::BeginSourceFileAction(), and compileModuleImpl().
|
inline |
Specify that all files that are read during this compilation are transient.
Definition at line 883 of file SourceManager.h.
Referenced by clang::GenerateModuleAction::BeginSourceFileAction().
|
inline |
Definition at line 1538 of file SourceManager.h.
Referenced by clang::ASTReader::ASTReader().
void SourceManager::setFileIsTransient | ( | const FileEntry * | SourceFile | ) |
Specify that a file is transient.
Definition at line 677 of file SourceManager.cpp.
Referenced by clang::GenerateModuleAction::BeginSourceFileAction().
|
inline |
Set the file ID for the main source file.
Definition at line 757 of file SourceManager.h.
Referenced by clang::CompilerInstance::InitializeSourceManager().
|
inline |
Set the module build stack.
Definition at line 739 of file SourceManager.h.
Referenced by compileModuleImpl().
Set the number of FileIDs (files and macros) that were created during preprocessing of FID
, including it.
Definition at line 967 of file SourceManager.h.
References clang::SrcMgr::SLocEntry::getFile(), getSLocEntry(), and clang::SrcMgr::SLocEntry::isFile().
Referenced by clang::Preprocessor::HandleEndOfFile().
|
inline |
Set true if the SourceManager should report the original file name for contents of files that were overridden by other files.
Defaults to true.
Definition at line 725 of file SourceManager.h.
Referenced by InitializeFileRemapping().
|
inline |
Set the file ID for the precompiled preamble.
Definition at line 762 of file SourceManager.h.
References clang::FileID::isInvalid().
Get the FileID for the given file.
If the source file is included multiple times, the FileID will be the first inclusion.
Definition at line 1607 of file SourceManager.cpp.
References getActualFileUID(), clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), getLoadedSLocEntry(), getLocalSLocEntry(), clang::FileEntry::getName(), getSLocEntry(), I, clang::SrcMgr::SLocEntry::isFile(), clang::FileID::isInvalid(), clang::FileID::isValid(), loaded_sloc_entry_size(), and local_sloc_entry_size().
Referenced by getOrCreateFileID(), ParseDirective(), and translateFileLineCol().
SourceLocation SourceManager::translateFileLineCol | ( | const FileEntry * | SourceFile, |
unsigned | Line, | ||
unsigned | Col | ||
) | const |
Get the source location for the given file:line:col triplet.
If the source file is included multiple times, the source location will be based upon the first inclusion.
If the source file is included multiple times, the source location will be based upon an arbitrary inclusion.
Definition at line 1593 of file SourceManager.cpp.
References translateFile(), and translateLineCol().
Referenced by clang::CodeGenAction::ExecuteAction(), clang::BackendConsumer::getBestLocationFromDebugLoc(), clang::ASTUnit::getLocation(), and ParseDirective().
SourceLocation SourceManager::translateLineCol | ( | FileID | FID, |
unsigned | Line, | ||
unsigned | Col | ||
) | const |
Get the source location in FID
for the given line:col.
Get the source location in.
Returns null location if FID
is not a file SLocEntry.
Definition at line 1722 of file SourceManager.cpp.
References ComputeLineNumbers(), clang::SrcMgr::FileInfo::getContentCache(), clang::SrcMgr::SLocEntry::getFile(), clang::SourceLocation::getLocWithOffset(), clang::SrcMgr::SLocEntry::getOffset(), getSLocEntry(), clang::SrcMgr::SLocEntry::isFile(), and clang::FileID::isInvalid().
Referenced by NormalizeLine(), ParseDirective(), and translateFileLineCol().
|
inline |
True if non-system source files should be treated as volatile (likely to change while trying to use them).
Definition at line 731 of file SourceManager.h.
|
friend |
Definition at line 1682 of file SourceManager.h.
|
friend |
Definition at line 1683 of file SourceManager.h.