 |
ezEngine Release 26.3
|
|
ezEngine Release 26.3
|
A file writer that caches all written data and only opens and writes to the output file when everything is finished. Useful to ensure that only complete files are written, or nothing at all, in case of a crash. More...
#include <DeferredFileWriter.h>
Public Member Functions | |
| ~ezDeferredFileWriter () | |
| Upon destruction the file is closed and thus written, unless Discard was called before. | |
| void | SetOutput (ezStringView sFileToWriteTo, bool bOnlyWriteIfDifferent=false) |
| This must be configured before anything is written to the file. | |
| virtual ezResult | WriteBytes (const void *pWriteBuffer, ezUInt64 uiBytesToWrite) override |
| Writes a raw number of bytes from the buffer. This is the only method that must be implemented by derived classes. | |
| ezResult | Close (bool *out_pWasWrittenTo=nullptr) |
| Upon calling this the content is written to the file specified with SetOutput(). The return value is EZ_FAILURE if the file could not be opened or not completely written. | |
| void | Discard () |
| Calling this abandons the content and a later Close or destruction of the instance will no longer write anything to file. | |
 Public Member Functions inherited from ezStreamWriter | |
| ezStreamWriter () | |
| Constructor. | |
| virtual | ~ezStreamWriter () |
| Virtual destructor to ensure correct cleanup. | |
| virtual ezResult | Flush () |
| Flushes buffered data to the underlying storage, ensuring data persistence. | |
| template<typename T > | |
| ezResult | WriteWordValue (const T *pWordValue) |
| Helper method to write a word value correctly (copes with potentially different endianess) | |
| template<typename T > | |
| ezResult | WriteDWordValue (const T *pDWordValue) |
| Helper method to write a dword value correctly (copes with potentially different endianess) | |
| template<typename T > | |
| ezResult | WriteQWordValue (const T *pQWordValue) |
| Helper method to write a qword value correctly (copes with potentially different endianess) | |
| EZ_ALWAYS_INLINE void | WriteVersion (ezTypeVersion version) |
| Writes a type version to the stream. | |
| template<typename ArrayType , typename ValueType > | |
| ezResult | WriteArray (const ezArrayBase< ValueType, ArrayType > &array) |
| Writes an array of elements to the stream. | |
| template<typename ValueType , ezUInt16 uiSize> | |
| ezResult | WriteArray (const ezSmallArrayBase< ValueType, uiSize > &array) |
| Writes a small array of elements to the stream. | |
| template<typename ValueType , ezUInt32 uiSize> | |
| ezResult | WriteArray (const ValueType(&array)[uiSize]) |
| Writes a C style fixed array. | |
| template<typename KeyType , typename Comparer > | |
| ezResult | WriteSet (const ezSetBase< KeyType, Comparer > &set) |
| Writes a set. | |
| template<typename KeyType , typename ValueType , typename Comparer > | |
| ezResult | WriteMap (const ezMapBase< KeyType, ValueType, Comparer > &map) |
| Writes a map. | |
| template<typename KeyType , typename ValueType , typename Hasher > | |
| ezResult | WriteHashTable (const ezHashTableBase< KeyType, ValueType, Hasher > &hashTable) |
| Writes a hash table (note that the entry order might change on read) | |
| ezResult | WriteString (const ezStringView sStringView) |
| Writes a string. | |
A file writer that caches all written data and only opens and writes to the output file when everything is finished. Useful to ensure that only complete files are written, or nothing at all, in case of a crash.
|
overridevirtual |
Writes a raw number of bytes from the buffer. This is the only method that must be implemented by derived classes.
| pWriteBuffer | Source buffer containing data to write |
| uiBytesToWrite | Number of bytes to write from the buffer |
Implements ezStreamWriter.
1.9.8