UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
FCachedFileHandle Class Reference

#include <IPlatformFileCachedWrapper.h>

+ Inheritance diagram for FCachedFileHandle:

Public Member Functions

 FCachedFileHandle (IFileHandle *InFileHandle, bool bInReadable, bool bInWritable)
 
virtual ~FCachedFileHandle ()
 
virtual int64 Tell () override
 
virtual bool Seek (int64 NewPosition) override
 
virtual bool SeekFromEnd (int64 NewPositionRelativeToEnd=0) override
 
virtual bool Read (uint8 *Destination, int64 BytesToRead) override
 
virtual bool ReadAt (uint8 *Destination, int64 BytesToRead, int64 Offset) override
 
virtual bool Write (const uint8 *Source, int64 BytesToWrite) override
 
virtual int64 Size () override
 
virtual bool Flush (const bool bFullFlush=false) override
 
virtual bool Truncate (int64 NewSize) override
 
virtual void ShrinkBuffers () override
 
- Public Member Functions inherited from IFileHandle
virtual ~IFileHandle ()
 

Constructor & Destructor Documentation

◆ FCachedFileHandle()

FCachedFileHandle::FCachedFileHandle ( IFileHandle InFileHandle,
bool  bInReadable,
bool  bInWritable 
)
inline

◆ ~FCachedFileHandle()

virtual FCachedFileHandle::~FCachedFileHandle ( )
inlinevirtual

Member Function Documentation

◆ Flush()

virtual bool FCachedFileHandle::Flush ( const bool  bFullFlush = false)
inlineoverridevirtual

Flushes file handle to disk.

Parameters
bFullFlushtrue to flush everything about the file (including its meta-data) with a strong guarantee that it will be on disk by the time this function returns, or false to let the operating/file system have more leeway about when the data actually gets written to disk
Returns
true if operation completed successfully.

Implements IFileHandle.

◆ Read()

virtual bool FCachedFileHandle::Read ( uint8 Destination,
int64  BytesToRead 
)
inlineoverridevirtual

Read bytes from the file.

Parameters
DestinationBuffer to holds the results, should be at least BytesToRead in size.
BytesToReadNumber of bytes to read into the destination.
Returns
true if the operation completed successfully. Returns false if a read is attempted while the read position is already at the end of the file.
Remarks
If BytesToRead is larger than the bytes remaining in the file from the current read position the Read() will return true if the underlying file read could read all remaining bytes.

Implements IFileHandle.

◆ ReadAt()

virtual bool FCachedFileHandle::ReadAt ( uint8 Destination,
int64  BytesToRead,
int64  Offset 
)
inlineoverridevirtual

Implements IFileHandle.

◆ Seek()

virtual bool FCachedFileHandle::Seek ( int64  NewPosition)
inlineoverridevirtual

Change the current write or read position.

Parameters
NewPositionnew write or read position
Returns
true if the operation completed successfully.

Implements IFileHandle.

◆ SeekFromEnd()

virtual bool FCachedFileHandle::SeekFromEnd ( int64  NewPositionRelativeToEnd = 0)
inlineoverridevirtual

Change the current write or read position, relative to the end of the file.

Parameters
NewPositionRelativeToEndnew write or read position, relative to the end of the file should be <=0!
Returns
true if the operation completed successfully.

Implements IFileHandle.

◆ ShrinkBuffers()

virtual void FCachedFileHandle::ShrinkBuffers ( )
inlineoverridevirtual

Minimizes optional system or process cache kept for the file.

Reimplemented from IFileHandle.

◆ Size()

virtual int64 FCachedFileHandle::Size ( )
inlineoverridevirtual

Return the total size of the file

Reimplemented from IFileHandle.

◆ Tell()

virtual int64 FCachedFileHandle::Tell ( )
inlineoverridevirtual

Return the current write or read position.

Implements IFileHandle.

◆ Truncate()

virtual bool FCachedFileHandle::Truncate ( int64  NewSize)
inlineoverridevirtual

Truncate the file to the given size (in bytes).

Parameters
NewSizeTruncated file size (in bytes).
Returns
true if the operation completed successfully.

Implements IFileHandle.

◆ Write()

virtual bool FCachedFileHandle::Write ( const uint8 Source,
int64  BytesToWrite 
)
inlineoverridevirtual

Write bytes to the file.

Parameters
SourceBuffer to write, should be at least BytesToWrite in size.
BytesToWriteNumber of bytes to write.
Returns
true if the operation completed successfully.

Implements IFileHandle.


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