IO::SafeFileStream Class Reference

#include <safefilestream.h>

Detailed Description

Wrapper around FileStream that will save to a temporary file and swap when closed.

Copyright

(C) 2016-2020 Individual contributors, see AUTHORS file

Inherits IO::FileStream.

Public Member Functions
	SafeFileStream ()
	constructor
virtual	~SafeFileStream ()
	destructor
virtual bool	Open ()
	open the stream
virtual void	Close ()
	close the stream
Public Member Functions inherited from IO::FileStream
	FileStream ()
	constructor
virtual	~FileStream ()
	destructor
virtual bool	CanRead () const override
	supports reading?
virtual bool	CanWrite () const override
	supports writing?
virtual bool	CanSeek () const override
	supports seeking?
virtual bool	CanBeMapped () const override
	supports memory mapping (read-only)?
virtual Size	GetSize () const override
	get the size of the stream in bytes
virtual Position	GetPosition () const override
	get the current position of the read/write cursor
virtual void	Write (const void *ptr, Size numBytes) override
	directly write to the stream
virtual Size	Read (void *ptr, Size numBytes) override
	directly read from the stream
virtual void	Seek (Offset offset, SeekOrigin origin) override
	seek in stream
virtual void	Flush () override
	flush unsaved data
virtual bool	Eof () const override
	return true if end-of-stream reached
virtual void *	Map () override
	map stream to memory
virtual void	Unmap () override
	unmap stream
virtual void *	MemoryMap () override
	memory map stream to memory
virtual void	MemoryUnmap () override
	unmap memory stream
Public Member Functions inherited from IO::Stream
	Stream ()
	constructor
virtual	~Stream ()
	destructor
void	SetURI (const URI &u)
	set stream location as URI
const URI &	GetURI () const
	get stream URI
virtual void	SetSize (Size s)
	set a new size for the stream
void	SetAccessMode (AccessMode m)
	set the access mode of the stream (default is ReadAccess)
AccessMode	GetAccessMode () const
	get the access mode of the stream
void	SetAccessPattern (AccessPattern p)
	set the prefered access pattern (default is Sequential)
AccessPattern	GetAccessPattern () const
	get the prefered access pattern
void	SetMediaType (const MediaType &t)
	set optional media type of stream content
const MediaType &	GetMediaType () const
	get optional media type
bool	IsOpen () const
	return true if currently open
bool	IsMapped () const
	return true if stream is currently mapped to memory
Public Member Functions inherited from Core::RefCounted
	RefCounted ()
	constructor
int	GetRefCount () const
	get the current refcount
void	AddRef ()
	increment refcount by one
void	Release ()
	decrement refcount and destroy object if refcount is zero
bool	IsInstanceOf (const Rtti &rtti) const
	return true if this object is instance of given class
bool	IsInstanceOf (const Util::String &className) const
	return true if this object is instance of given class by string
bool	IsInstanceOf (const Util::FourCC &classFourCC) const
	return true if this object is instance of given class by fourcc
bool	IsA (const Rtti &rtti) const
	return true if this object is instance of given class, or a derived class
bool	IsA (const Util::String &rttiName) const
	return true if this object is instance of given class, or a derived class, by string
bool	IsA (const Util::FourCC &rttiFourCC) const
	return true if this object is instance of given class, or a derived class, by fourcc
const Util::String &	GetClassName () const
	get the class name
Util::FourCC	GetClassFourCC () const
	get the class FourCC code

Protected Attributes
IO::URI	tmpUri
Protected Attributes inherited from IO::FileStream
FSWrapper::Handle	handle
FSWrapper::Handle	mapHandle
void *	mappedContent
Protected Attributes inherited from IO::Stream
URI	uri
AccessMode	accessMode
AccessPattern	accessPattern
bool	isOpen
bool	isMapped
MediaType	mediaType

Private Member Functions
	__DeclareClass (SafeFileStream)

Additional Inherited Members
Public Types inherited from IO::Stream
enum	AccessMode { ReadAccess , WriteAccess , AppendAccess , ReadWriteAccess }
	access modes More...
enum	AccessPattern { Random , Sequential }
	access prefered pattern More...
enum	SeekOrigin { Begin , Current , End }
	seek origins More...
typedef int64_t	Position
	typedefs
typedef int64_t	Offset
typedef int64_t	Size
Static Public Member Functions inherited from Core::RefCounted
static void	DumpRefCountingLeaks ()
	dump refcounting leaks, call at end of application (NEBULA_DEBUG builds only!)
Protected Member Functions inherited from Core::RefCounted
virtual	~RefCounted ()
	destructor (called when refcount reaches zero)

Constructor & Destructor Documentation

SafeFileStream()

IO::SafeFileStream::SafeFileStream

(

)

constructor

~SafeFileStream()

IO::SafeFileStream::~SafeFileStream ( )

virtual

destructor

Member Function Documentation

__DeclareClass()

IO::SafeFileStream::__DeclareClass ( SafeFileStream )

private

Close()

void IO::SafeFileStream::Close ( )

virtual

close the stream

Reimplemented from IO::FileStream.

Open()

bool IO::SafeFileStream::Open ( )

virtual

open the stream

Reimplemented from IO::FileStream.

Member Data Documentation

tmpUri

IO::URI IO::SafeFileStream::tmpUri

protected

---

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

• /github/workspace/code/foundation/io/safefilestream.h
• /github/workspace/code/foundation/io/safefilestream.cc