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
bool	isDeviceFile () 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 118 of file FileEntry.h.

Constructor & Destructor Documentation

◆ FileEntryRef() [1/2]

clang::FileEntryRef::FileEntryRef ( )

delete

Referenced by hash_value, isSameRef(), operator!=, operator!=, operator!=, operator==, operator==, and operator==.

◆ FileEntryRef() [2/2]

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

inlineexplicit

Definition at line 160 of file FileEntry.h.

Member Function Documentation

◆ closeFile()

void clang::FileEntryRef::closeFile ( ) const

inline

Definition at line 367 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 170 of file FileEntry.h.

Referenced by FileMgr::MapEntryOptionalStorage< FileEntryRef >, getFileEntry(), getName(), and 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

◆ 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 167 of file FileEntry.h.

◆ getModificationTime()

time_t clang::FileEntryRef::getModificationTime ( ) const

inline

Definition at line 358 of file FileEntry.h.

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

Referenced by 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.

References getBaseMapEntry().

Referenced by clang::ModuleMap::addHeader(), clang::tooling::AtomicChange::AtomicChange(), clang::FrontendAction::BeginSourceFile(), checkMSVCHeaderSearch(), clang::CompilerInstance::cloneForModuleCompile(), compareCrossTUSourceLocs(), clang::SourceManager::createFileID(), diagnoseFrameworkInclude(), clang::sema::SemaPPCallbacks::FileChanged(), clang::FileManager::getBufferForFile(), 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(), 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 clang::CompilerInstance::cloneForModuleCompile().

◆ getSize()

off_t clang::FileEntryRef::getSize ( ) const

inline

Definition at line 350 of file FileEntry.h.

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

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

◆ getUID()

unsigned clang::FileEntryRef::getUID ( ) const

inline

Definition at line 352 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 354 of file FileEntry.h.

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

◆ isDeviceFile()

bool clang::FileEntryRef::isDeviceFile ( ) const

inline

Definition at line 363 of file FileEntry.h.

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

◆ isNamedPipe()

bool clang::FileEntryRef::isNamedPipe ( ) const

inline

Definition at line 362 of file FileEntry.h.

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

Referenced by clang::SourceManager::createFileID().

◆ isSameRef()

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

inline

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

Definition at line 138 of file FileEntry.h.

References FileEntryRef().

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 157 of file FileEntry.h.

References getFileEntry().

◆ updateFileEntryBufferSize()

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

inline

Definition at line 369 of file FileEntry.h.

References clang::cast(), and getBaseMapEntry().

◆ FileMgr::MapEntryOptionalStorage< FileEntryRef >

friend class FileMgr::MapEntryOptionalStorage< FileEntryRef >

friend

Definition at line 170 of file FileEntry.h.

References getBaseMapEntry(), and Next.

◆ 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 111 of file FileEntry.h.

References FileEntryRef(), getFileEntry(), and llvm::hash_value().

◆ llvm::DenseMapInfo< FileEntryRef >

friend struct llvm::DenseMapInfo< FileEntryRef >

friend

Definition at line 183 of file FileEntry.h.

◆ operator!= [1/3]

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

friend

Definition at line 102 of file FileEntry.h.

References FileEntryRef().

◆ operator!= [2/3]

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

friend

Definition at line 105 of file FileEntry.h.

References FileEntryRef().

◆ operator!= [3/3]

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

friend

Definition at line 99 of file FileEntry.h.

References FileEntryRef().

◆ operator== [1/3]

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

friend

Definition at line 93 of file FileEntry.h.

References FileEntryRef(), and getFileEntry().

◆ operator== [2/3]

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

friend

Definition at line 96 of file FileEntry.h.

References FileEntryRef(), and getFileEntry().

◆ 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 90 of file FileEntry.h.

References FileEntryRef(), and getFileEntry().

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()

◆ isDeviceFile()

◆ isNamedPipe()

◆ isSameRef()

◆ operator const FileEntry *()

◆ updateFileEntryBufferSize()

Friends And Related Symbol 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]