A reference to a FileEntry that includes the name of the file as it was accessed by the FileManager's client. More...

#include "clang/Basic/FileEntry.h"

Classes
struct	MapValue
	Type stored in the StringMap. More...

Public Types
using	MapEntry = llvm::StringMapEntry< llvm::ErrorOr< MapValue > >
	Type used in the StringMap.

Public Member Functions
StringRef	getName () const
	The name of this FileEntry.

StringRef	getNameAsRequested () const
	The name of this FileEntry, as originally requested without applying any remappings for VFS 'use-external-name'.

const FileEntry &	getFileEntry () const

void	updateFileEntryBufferSize (unsigned BufferSize)

DirectoryEntryRef	getDir () const

off_t	getSize () const

unsigned	getUID () const

const llvm::sys::fs::UniqueID &	getUniqueID () const

time_t	getModificationTime () const

bool	isNamedPipe () const

void	closeFile () const

bool	isSameRef (const FileEntryRef &RHS) const
	Check if RHS referenced the file in exactly the same way.

	operator const FileEntry * () const
	Allow FileEntryRef to degrade into 'const FileEntry*' to facilitate incremental adoption.

	FileEntryRef ()=delete

	FileEntryRef (const MapEntry &ME)

const clang::FileEntryRef::MapEntry &	getMapEntry () const
	Expose the underlying MapEntry to simplify packing in a PointerIntPair or PointerUnion and allow construction in Optional.

const MapEntry &	getBaseMapEntry () const
	Retrieve the base MapEntry after redirects.

Friends
class	FileMgr::MapEntryOptionalStorage< FileEntryRef >

struct	llvm::DenseMapInfo< FileEntryRef >

bool	operator== (const FileEntryRef &LHS, const FileEntryRef &RHS)
	Check if the underlying FileEntry is the same, intentially ignoring whether the file was referenced with the same spelling of the filename.

bool	operator== (const FileEntry *LHS, const FileEntryRef &RHS)

bool	operator== (const FileEntryRef &LHS, const FileEntry *RHS)

bool	operator!= (const FileEntryRef &LHS, const FileEntryRef &RHS)

bool	operator!= (const FileEntry *LHS, const FileEntryRef &RHS)

bool	operator!= (const FileEntryRef &LHS, const FileEntry *RHS)

llvm::hash_code	hash_value (FileEntryRef Ref)
	Hash code is based on the FileEntry, not the specific named reference, just like operator==.

Detailed Description

A reference to a FileEntry that includes the name of the file as it was accessed by the FileManager's client.

Definition at line 57 of file FileEntry.h.

Member Typedef Documentation

◆ MapEntry

using clang::FileEntryRef::MapEntry = llvm::StringMapEntry<llvm::ErrorOr<MapValue> >

Type used in the StringMap.

Definition at line 117 of file FileEntry.h.

Constructor & Destructor Documentation

◆ FileEntryRef() [1/2]

clang::FileEntryRef::FileEntryRef ( )

delete

◆ FileEntryRef() [2/2]

clang::FileEntryRef::FileEntryRef ( const MapEntry & ME )

inlineexplicit

Definition at line 159 of file FileEntry.h.

Member Function Documentation

◆ closeFile()

void clang::FileEntryRef::closeFile ( ) const

inline

Definition at line 361 of file FileEntry.h.

References clang::FileEntry::closeFile(), and getFileEntry().

Referenced by clang::serialization::ModuleManager::addModule().

◆ getBaseMapEntry()

const MapEntry & clang::FileEntryRef::getBaseMapEntry ( ) const

inline

Retrieve the base MapEntry after redirects.

Definition at line 169 of file FileEntry.h.

Referenced by updateFileEntryBufferSize().

◆ getDir()

DirectoryEntryRef clang::FileEntryRef::getDir ( ) const

inline

Definition at line 78 of file FileEntry.h.

Referenced by clang::FileManager::getBypassFile(), clang::ModuleMap::isHeaderUnavailableInModule(), clang::Preprocessor::LookupFile(), and clang::ModuleMap::setUmbrellaHeaderAsWritten().

◆ getFileEntry()

const FileEntry & clang::FileEntryRef::getFileEntry ( ) const

inline

Definition at line 70 of file FileEntry.h.

Referenced by closeFile(), clang::FileManager::getBufferForFile(), clang::FileManager::getBypassFile(), getFileName(), getModificationTime(), getSize(), clang::FileManager::getSTDIN(), getUID(), getUniqueID(), isNamedPipe(), clang::Preprocessor::LookupFile(), clang::operator==(), clang::SourceManager::translateFile(), and clang::VerifyDiagnosticConsumer::UpdateParsedFileStatus().

◆ getMapEntry()

const clang::FileEntryRef::MapEntry & clang::FileEntryRef::getMapEntry ( ) const

inline

Expose the underlying MapEntry to simplify packing in a PointerIntPair or PointerUnion and allow construction in Optional.

Definition at line 166 of file FileEntry.h.

◆ getModificationTime()

time_t clang::FileEntryRef::getModificationTime ( ) const

inline

Definition at line 355 of file FileEntry.h.

References getFileEntry(), and clang::FileEntry::getModificationTime().

Referenced by clang::arcmt::FileRemapper::flushToFile(), clang::serialization::reader::HeaderFileInfoTrait::GetInternalKey(), and clang::Preprocessor::HandlePragmaDependency().

◆ getName()

StringRef clang::FileEntryRef::getName ( ) const

inline

The name of this FileEntry.

If a VFS uses 'use-external-name', this is the redirected name. See getRequestedName().

Definition at line 61 of file FileEntry.h.

Referenced by clang::ModuleMap::addHeader(), applyEditsToTemp(), clang::arcmt::MigrationProcess::applyTransform(), clang::tooling::AtomicChange::AtomicChange(), clang::FrontendAction::BeginSourceFile(), checkMSVCHeaderSearch(), compareCrossTUSourceLocs(), compileModule(), clang::SourceManager::createFileID(), diagnoseFrameworkInclude(), clang::tooling::dependencies::ModuleDepCollectorPP::EndOfMainFile(), clang::sema::SemaPPCallbacks::FileChanged(), clang::arcmt::FileRemapper::flushToFile(), clang::FileManager::getBufferForFile(), clang::SrcMgr::ContentCache::getBufferOrNone(), clang::FileManager::getBypassFile(), getFileName(), clang::serialization::reader::HeaderFileInfoTrait::GetInternalKey(), clang::FileManager::GetUniqueIDMapping(), clang::ModuleMap::isHeaderUnavailableInModule(), clang::CodeGen::CodeGenModule::isInNoSanitizeList(), clang::HeaderSearch::LookupSubframeworkHeader(), clang::Rewriter::overwriteChangedFiles(), clang::arcmt::FileRemapper::overwriteOriginal(), printLoc(), clang::index::SerializablePathCollection::tryStoreFilePath(), and clang::FixItRewriter::WriteFixedFiles().

◆ getNameAsRequested()

StringRef clang::FileEntryRef::getNameAsRequested ( ) const

inline

The name of this FileEntry, as originally requested without applying any remappings for VFS 'use-external-name'.

FIXME: this should be the semantics of getName(). See comment in FileManager::getFileRef().

Definition at line 68 of file FileEntry.h.

Referenced by compileModule().

◆ getSize()

off_t clang::FileEntryRef::getSize ( ) const

inline

Definition at line 347 of file FileEntry.h.

References getFileEntry(), and clang::FileEntry::getSize().

Referenced by clang::HeaderMap::Create(), clang::SrcMgr::ContentCache::getBufferOrNone(), clang::serialization::reader::HeaderFileInfoTrait::GetInternalKey(), clang::SrcMgr::ContentCache::getSize(), InitializeFileRemapping(), and clang::SourceManager::overrideFileContents().

◆ getUID()

unsigned clang::FileEntryRef::getUID ( ) const

inline

Definition at line 349 of file FileEntry.h.

References getFileEntry(), and clang::FileEntry::getUID().

Referenced by clang::HeaderSearch::getExistingFileInfo(), clang::HeaderSearch::getExistingLocalFileInfo(), clang::HeaderSearch::getFileInfo(), and clang::FileManager::GetUniqueIDMapping().

◆ getUniqueID()

const llvm::sys::fs::UniqueID & clang::FileEntryRef::getUniqueID ( ) const

inline

Definition at line 351 of file FileEntry.h.

References getFileEntry(), and clang::FileEntry::getUniqueID().

◆ isNamedPipe()

bool clang::FileEntryRef::isNamedPipe ( ) const

inline

Definition at line 359 of file FileEntry.h.

References getFileEntry(), and clang::FileEntry::isNamedPipe().

Referenced by clang::SourceManager::createFileID(), and clang::SrcMgr::ContentCache::getBufferOrNone().

◆ isSameRef()

bool clang::FileEntryRef::isSameRef ( const FileEntryRef & RHS ) const

inline

Check if RHS referenced the file in exactly the same way.

Definition at line 137 of file FileEntry.h.

Referenced by llvm::DenseMapInfo< clang::FileEntryRef >::isEqual().

◆ operator const FileEntry *()

clang::FileEntryRef::operator const FileEntry * ( ) const

inline

Allow FileEntryRef to degrade into 'const FileEntry*' to facilitate incremental adoption.

The goal is to avoid code churn due to dances like the following:

// Old code.
lvalue = rvalue;
 
// Temporary code from an incremental patch.
lvalue = &rvalue.getFileEntry();
 
// Final code.
lvalue = rvalue;

FIXME: Once FileEntryRef is "everywhere" and FileEntry::LastRef and FileEntry::getName have been deleted, delete this implicit conversion.

Definition at line 156 of file FileEntry.h.

◆ updateFileEntryBufferSize()

void clang::FileEntryRef::updateFileEntryBufferSize ( unsigned BufferSize )

inline

Definition at line 363 of file FileEntry.h.

References getBaseMapEntry().

Friends And Related Function Documentation

◆ FileMgr::MapEntryOptionalStorage< FileEntryRef >

friend class FileMgr::MapEntryOptionalStorage< FileEntryRef >

friend

Definition at line 169 of file FileEntry.h.

◆ hash_value

llvm::hash_code hash_value ( FileEntryRef Ref )

friend

Hash code is based on the FileEntry, not the specific named reference, just like operator==.

Definition at line 110 of file FileEntry.h.

◆ llvm::DenseMapInfo< FileEntryRef >

friend struct llvm::DenseMapInfo< FileEntryRef >

friend

Definition at line 182 of file FileEntry.h.

◆ operator!= [1/3]

bool operator!=	(	const FileEntry *	LHS,
		const FileEntryRef &	RHS
	)

friend

Definition at line 101 of file FileEntry.h.

◆ operator!= [2/3]

bool operator!=	(	const FileEntryRef &	LHS,
		const FileEntry *	RHS
	)

friend

Definition at line 104 of file FileEntry.h.

◆ operator!= [3/3]

bool operator!=	(	const FileEntryRef &	LHS,
		const FileEntryRef &	RHS
	)

friend

Definition at line 98 of file FileEntry.h.

◆ operator== [1/3]

bool operator==	(	const FileEntry *	LHS,
		const FileEntryRef &	RHS
	)

friend

Definition at line 92 of file FileEntry.h.

◆ operator== [2/3]

bool operator==	(	const FileEntryRef &	LHS,
		const FileEntry *	RHS
	)

friend

Definition at line 95 of file FileEntry.h.

◆ operator== [3/3]

bool operator==	(	const FileEntryRef &	LHS,
		const FileEntryRef &	RHS
	)

friend

Check if the underlying FileEntry is the same, intentially ignoring whether the file was referenced with the same spelling of the filename.

Definition at line 89 of file FileEntry.h.

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

include/clang/Basic/FileEntry.h

Classes

Public Types

Public Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ MapEntry

Constructor & Destructor Documentation

◆ FileEntryRef() [1/2]

◆ FileEntryRef() [2/2]

Member Function Documentation

◆ closeFile()

◆ getBaseMapEntry()

◆ getDir()

◆ getFileEntry()

◆ getMapEntry()

◆ getModificationTime()

◆ getName()

◆ getNameAsRequested()

◆ getSize()

◆ getUID()

◆ getUniqueID()

◆ isNamedPipe()

◆ isSameRef()

◆ operator const FileEntry *()

◆ updateFileEntryBufferSize()

Friends And Related Function Documentation

◆ FileMgr::MapEntryOptionalStorage< FileEntryRef >

◆ hash_value

◆ llvm::DenseMapInfo< FileEntryRef >

◆ operator!= [1/3]

◆ operator!= [2/3]

◆ operator!= [3/3]

◆ operator== [1/3]

◆ operator== [2/3]

◆ operator== [3/3]