#include <ApplePlatformFile.h>

Inheritance diagram for FApplePlatformFile:

Public Member Functions
virtual bool	FileExists (const TCHAR *Filename) override

virtual int64	FileSize (const TCHAR *Filename) override

virtual bool	DeleteFile (const TCHAR *Filename) override

virtual bool	IsReadOnly (const TCHAR *Filename) override

virtual bool	MoveFile (const TCHAR To, const TCHAR From) override

virtual bool	SetReadOnly (const TCHAR *Filename, bool bNewReadOnlyValue) override

virtual FDateTime	GetTimeStamp (const TCHAR *Filename) override

virtual void	SetTimeStamp (const TCHAR *Filename, const FDateTime DateTime) override

virtual FDateTime	GetAccessTimeStamp (const TCHAR *Filename) override

virtual FString	GetFilenameOnDisk (const TCHAR *Filename) override

virtual ESymlinkResult	IsSymlink (const TCHAR *Filename) override

virtual IFileHandle *	OpenRead (const TCHAR *Filename, bool bAllowWrite=false) override

virtual IFileHandle *	OpenWrite (const TCHAR *Filename, bool bAppend=false, bool bAllowRead=false) override

virtual FOpenMappedResult	OpenMappedEx (const TCHAR *Filename, EOpenReadFlags OpenOptions=EOpenReadFlags::None, int64 MaximumSize=0) override

virtual bool	DirectoryExists (const TCHAR *Directory) override

virtual bool	CreateDirectory (const TCHAR *Directory) override

virtual bool	DeleteDirectory (const TCHAR *Directory) override

virtual FFileStatData	GetStatData (const TCHAR *FilenameOrDirectory) override

virtual bool	IterateDirectory (const TCHAR *Directory, FDirectoryVisitor &Visitor) override

virtual bool	IterateDirectoryStat (const TCHAR *Directory, FDirectoryStatVisitor &Visitor) override

virtual bool	CopyFile (const TCHAR To, const TCHAR From, EPlatformFileRead ReadFlags=EPlatformFileRead::None, EPlatformFileWrite WriteFlags=EPlatformFileWrite::None) override

Public Member Functions inherited from IPhysicalPlatformFile
virtual bool	ShouldBeUsed (IPlatformFile Inner, const TCHAR CmdLine) const override

virtual CORE_API bool	Initialize (IPlatformFile Inner, const TCHAR CmdLine) override

virtual IPlatformFile *	GetLowerLevel () override

virtual void	SetLowerLevel (IPlatformFile *NewLowerLevel) override

virtual const TCHAR *	GetName () const override

Public Member Functions inherited from IPlatformFile
CORE_API	IPlatformFile ()

virtual CORE_API	~IPlatformFile ()

virtual void	SetSandboxEnabled (bool bInEnabled)

virtual bool	IsSandboxEnabled () const

virtual void	InitializeAfterSetActive ()

virtual void	InitializeAfterProjectFilePath ()

virtual void	MakeUniquePakFilesForTheseFiles (const TArray< TArray< FString > > &InFiles)

virtual void	InitializeNewAsyncIO ()

virtual void	AddLocalDirectories (TArray< FString > &LocalDirectories)

virtual void	BypassSecurity (bool bInBypass)

virtual void	Tick ()

virtual bool	DeleteFiles (const TArrayView< const TCHAR * > &Filenames)

virtual bool	HasMarkOfTheWeb (FStringView Filename, FString *OutSourceURL=nullptr)

virtual bool	SetMarkOfTheWeb (FStringView Filename, bool bNewStatus, const FString *InSourceURL=nullptr)

virtual CORE_API FFileOpenResult	OpenRead (const TCHAR *Filename, EOpenReadFlags Flags)

virtual FFileOpenResult	OpenReadNoBuffering (const TCHAR *Filename, EOpenReadFlags Flags)

virtual IFileHandle *	OpenReadNoBuffering (const TCHAR *Filename, bool bAllowWrite=false)

virtual CORE_API FFileOpenResult	OpenWrite (const TCHAR *Filename, EOpenWriteFlags Flags)

virtual CORE_API bool	FileJournalIsAvailable (const TCHAR VolumeOrPath=nullptr, ELogVerbosity::Type OutErrorLevel=nullptr, FString *OutError=nullptr)

virtual CORE_API uint64	FileJournalGetMaximumSize (const TCHAR VolumeOrPath=nullptr, ELogVerbosity::Type OutErrorLevel=nullptr, FString *OutError=nullptr) const

virtual CORE_API EFileJournalResult	FileJournalGetLatestEntry (const TCHAR VolumeName, FFileJournalId &OutJournalId, FFileJournalEntryHandle &OutEntryHandle, FString OutError=nullptr)

virtual CORE_API bool	FileJournalIterateDirectory (const TCHAR Directory, FDirectoryJournalVisitorFunc Visitor, FString OutError=nullptr)

virtual CORE_API FFileJournalData	FileJournalGetFileData (const TCHAR FilenameOrDirectory, FString OutError=nullptr)

virtual CORE_API EFileJournalResult	FileJournalReadModified (const TCHAR VolumeName, const FFileJournalId &JournalIdOfStartingEntry, const FFileJournalEntryHandle &StartingJournalEntry, TMap< FFileJournalFileHandle, FString > &KnownDirectories, TSet< FString > &OutModifiedDirectories, FFileJournalEntryHandle &OutNextJournalEntry, FString OutError=nullptr)

virtual CORE_API FString	FileJournalGetVolumeName (FStringView InPath)

virtual CORE_API FFileOpenAsyncResult	OpenAsyncRead (const TCHAR *Filename, EOpenReadFlags Flags)

virtual CORE_API IAsyncReadFileHandle *	OpenAsyncRead (const TCHAR *Filename, bool bAllowWrite=false)

virtual void	SetAsyncMinimumPriority (EAsyncIOPriorityAndFlags MinPriority)

virtual CORE_API IMappedFileHandle *	OpenMapped (const TCHAR *Filename)

virtual CORE_API void	GetTimeStampPair (const TCHAR PathA, const TCHAR PathB, FDateTime &OutTimeStampA, FDateTime &OutTimeStampB)

virtual CORE_API FDateTime	GetTimeStampLocal (const TCHAR *Filename)

virtual CORE_API bool	IterateDirectory (const TCHAR *Directory, FDirectoryVisitorFunc Visitor)

virtual CORE_API bool	IterateDirectoryStat (const TCHAR *Directory, FDirectoryStatVisitorFunc Visitor)

virtual CORE_API bool	IterateDirectoryRecursively (const TCHAR *Directory, FDirectoryVisitor &Visitor)

virtual CORE_API bool	IterateDirectoryStatRecursively (const TCHAR *Directory, FDirectoryStatVisitor &Visitor)

virtual CORE_API bool	IterateDirectoryRecursively (const TCHAR *Directory, FDirectoryVisitorFunc Visitor)

virtual CORE_API bool	IterateDirectoryStatRecursively (const TCHAR *Directory, FDirectoryStatVisitorFunc Visitor)

virtual CORE_API void	FindFiles (TArray< FString > &FoundFiles, const TCHAR Directory, const TCHAR FileExtension)

virtual CORE_API void	FindFilesRecursively (TArray< FString > &FoundFiles, const TCHAR Directory, const TCHAR FileExtension)

virtual CORE_API bool	DeleteDirectoryRecursively (const TCHAR *Directory)

virtual CORE_API bool	CreateDirectoryTree (const TCHAR *Directory)

virtual CORE_API bool	CopyDirectoryTree (const TCHAR DestinationDirectory, const TCHAR Source, bool bOverwriteAllExisting)

virtual CORE_API FString	ConvertToAbsolutePathForExternalAppForRead (const TCHAR *Filename)

virtual CORE_API FString	ConvertToAbsolutePathForExternalAppForWrite (const TCHAR *Filename)

virtual bool	SendMessageToServer (const TCHAR Message, IFileServerMessageHandler Handler)

virtual bool	DoesCreatePublicFiles ()

virtual void	SetCreatePublicFiles (bool bCreatePublicFiles)

virtual int64	GetAllowedBytesToWriteThrottledStorage (const TCHAR *DestinationPath=nullptr)

Protected Member Functions
virtual FString	NormalizeFilename (const TCHAR *Filename)

virtual FString	NormalizeDirectory (const TCHAR *Directory)

Additional Inherited Members
Public Types inherited from IPlatformFile
enum class	EOpenReadFlags : uint8 { None = 0 , AllowWrite = 1 << 0 , AllowDelete = 1 << 1 , NoBuffering = 1 << 2 }

enum class	EOpenWriteFlags : uint8 { None = 0 , AllowRead = 1 << 0 , Append = 1 << 1 }

typedef TFunctionRef< bool(const TCHAR *, bool)>	FDirectoryVisitorFunc

typedef TFunctionRef< bool(const TCHAR *, const FFileStatData &)>	FDirectoryStatVisitorFunc

typedef TFunctionRef< bool(const TCHAR *, const FFileJournalData &)>	FDirectoryJournalVisitorFunc

Static Public Member Functions inherited from IPlatformFile
static CORE_API IPlatformFile &	GetPlatformPhysical ()

static CORE_API const TCHAR *	GetPhysicalTypeName ()

Detailed Description

Mac File I/O implementation

Member Function Documentation

◆ CopyFile()

bool FApplePlatformFile::CopyFile	(	const TCHAR *	To,
		const TCHAR *	From,
		EPlatformFileRead	ReadFlags = `EPlatformFileRead::None`,
		EPlatformFileWrite	WriteFlags = `EPlatformFileWrite::None`
	)

overridevirtual

Copy a file. This will fail if the destination file already exists.

Parameters

To	File to copy to.
From	File to copy from.
ReadFlags	Source file read options.
WriteFlags	Destination file write options.

Returns: true if the file was copied successfully.

Reimplemented from IPlatformFile.

◆ CreateDirectory()

bool FApplePlatformFile::CreateDirectory ( const TCHAR * Directory )

overridevirtual

Create a directory and return true if the directory was created or already existed.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ DeleteDirectory()

bool FApplePlatformFile::DeleteDirectory ( const TCHAR * Directory )

overridevirtual

Delete a directory and return true if the directory was deleted or otherwise does not exist.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ DeleteFile()

bool FApplePlatformFile::DeleteFile ( const TCHAR * Filename )

overridevirtual

Delete a file and return true if the file exists. Will not delete read only files.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ DirectoryExists()

bool FApplePlatformFile::DirectoryExists ( const TCHAR * Directory )

overridevirtual

Return true if the directory exists.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ FileExists()

bool FApplePlatformFile::FileExists ( const TCHAR * Filename )

overridevirtual

Return true if the file exists.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ FileSize()

int64 FApplePlatformFile::FileSize ( const TCHAR * Filename )

overridevirtual

Return the size of the file, or -1 if it doesn't exist.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ GetAccessTimeStamp()

FDateTime FApplePlatformFile::GetAccessTimeStamp ( const TCHAR * Filename )

overridevirtual

Return the last access time of a file. Returns FDateTime::MinValue() on failure

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ GetFilenameOnDisk()

FString FApplePlatformFile::GetFilenameOnDisk ( const TCHAR * Filename )

overridevirtual

For case insensitive filesystems, returns the full path of the file with the same case as in the filesystem

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ GetStatData()

FFileStatData FApplePlatformFile::GetStatData ( const TCHAR * FilenameOrDirectory )

overridevirtual

Return the stat data for the given file or directory. Check the FFileStatData::bIsValid member before using the returned data

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ GetTimeStamp()

FDateTime FApplePlatformFile::GetTimeStamp ( const TCHAR * Filename )

overridevirtual

Return the modification time of a file. Returns FDateTime::MinValue() on failure

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ IsReadOnly()

bool FApplePlatformFile::IsReadOnly ( const TCHAR * Filename )

overridevirtual

Return true if the file is read only.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ IsSymlink()

ESymlinkResult FApplePlatformFile::IsSymlink ( const TCHAR * Filename )

overridevirtual

Return true if the file is a symbolic link

Reimplemented from IPlatformFile.

◆ IterateDirectory()

bool FApplePlatformFile::IterateDirectory	(	const TCHAR *	Directory,
		FDirectoryVisitor &	Visitor
	)

overridevirtual

Call the Visit function of the visitor once for each file or directory in a single directory. This function does not explore subdirectories.

Parameters

Directory	The directory to iterate the contents of.
Visitor	Visitor to call for each element of the directory

Returns: false if the directory did not exist or if the visitor returned false.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ IterateDirectoryStat()

bool FApplePlatformFile::IterateDirectoryStat	(	const TCHAR *	Directory,
		FDirectoryStatVisitor &	Visitor
	)

overridevirtual

Call the Visit function of the visitor once for each file or directory in a single directory. This function does not explore subdirectories.

Parameters

Directory	The directory to iterate the contents of.
Visitor	Visitor to call for each element of the directory

Returns: false if the directory did not exist or if the visitor returned false.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ MoveFile()

bool FApplePlatformFile::MoveFile	(	const TCHAR *	To,
		const TCHAR *	From
	)

overridevirtual

Attempt to move a file. Return true if successful. Will not overwrite existing files.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ NormalizeDirectory()

FString FApplePlatformFile::NormalizeDirectory ( const TCHAR * Directory )

protectedvirtual

Reimplemented in FIOSPlatformFile.

◆ NormalizeFilename()

FString FApplePlatformFile::NormalizeFilename ( const TCHAR * Filename )

protectedvirtual

Mac File I/O implementation

Reimplemented in FIOSPlatformFile.

◆ OpenMappedEx()

FOpenMappedResult FApplePlatformFile::OpenMappedEx	(	const TCHAR *	Filename,
		EOpenReadFlags	OpenOptions = `EOpenReadFlags::None`,
		int64	MaximumSize = `0`
	)

overridevirtual

Open a file for async reading. This call does hit the disk; it is synchronous open.

Parameters

Filename	File to be mapped. This doesn't actually map anything, just opens the file.
OpenOptions	Allows specifying map to be writable via AllowWrite or be ReadOnly by deafault.

Returns: Close the file by deleting the handle. A non-null return value does mean the file exists. Null can be returned for many reasons even if the file exists. Perhaps this platform does not support mapped files, or this file is compressed in a pak file. Generally you attempt to open mapped, and if that fails, then use other file operations instead.

Reimplemented from IPlatformFile.

◆ OpenRead()

IFileHandle * FApplePlatformFile::OpenRead	(	const TCHAR *	Filename,
		bool	bAllowWrite = `false`
	)

overridevirtual

Attempt to open a file for reading. Please consider using the new overload that takes EReadFlags instead of bools as parameters.

Parameters

Filename	file to be opened
bAllowWrite	(applies to certain platforms only) whether this file is allowed to be written to by other processes. This flag is needed to open files that are currently being written to as well.

Returns: If successful will return a non-nullptr pointer. Close the file by deleting the handle.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ OpenWrite()

IFileHandle * FApplePlatformFile::OpenWrite	(	const TCHAR *	Filename,
		bool	bAppend = `false`,
		bool	bAllowRead = `false`
	)

overridevirtual

Attempt to open a file for writing. If successful will return a non-nullptr pointer. Close the file by deleting the handle.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ SetReadOnly()

bool FApplePlatformFile::SetReadOnly	(	const TCHAR *	Filename,
		bool	bNewReadOnlyValue
	)

overridevirtual

Attempt to change the read only status of a file. Return true if successful.

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

◆ SetTimeStamp()

void FApplePlatformFile::SetTimeStamp	(	const TCHAR *	Filename,
		const FDateTime	DateTime
	)

overridevirtual

Sets the modification time of a file

Implements IPlatformFile.

Reimplemented in FIOSPlatformFile.

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

Engine/Source/Runtime/Core/Public/Apple/ApplePlatformFile.h
Engine/Source/Runtime/Core/Private/Apple/ApplePlatformFile.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ CopyFile()

◆ CreateDirectory()

◆ DeleteDirectory()

◆ DeleteFile()

◆ DirectoryExists()

◆ FileExists()

◆ FileSize()

◆ GetAccessTimeStamp()

◆ GetFilenameOnDisk()

◆ GetStatData()

◆ GetTimeStamp()

◆ IsReadOnly()

◆ IsSymlink()

◆ IterateDirectory()

◆ IterateDirectoryStat()

◆ MoveFile()

◆ NormalizeDirectory()

◆ NormalizeFilename()

◆ OpenMappedEx()

◆ OpenRead()

◆ OpenWrite()

◆ SetReadOnly()

◆ SetTimeStamp()