CeresEngine::MemoryDataStream Class Reference

A data stream that reads or writes data into a memory buffer. More...

#include <CeresEngine/Foundation/IO/Stream.hpp>

Inheritance diagram for CeresEngine::MemoryDataStream:

Public Member Functions
	MemoryDataStream ()
	Allocates a new empty memory data stream.
	MemoryDataStream (size_t size)
	Allocates a new chunk of memory and wraps it in a stream.
	MemoryDataStream (Byte *memory, size_t size, bool freeOnClose=false)
	Wrap an existing memory chunk in a stream.
	MemoryDataStream (const ByteMemoryView &buffer, bool freeOnClose=false)
	Wrap an existing memory chunk in a stream.
	MemoryDataStream (DataStream &stream)
	Copies all contents of the existing data stream into a memory stream.
	MemoryDataStream (const MemoryDataStream &)
	MemoryDataStream (MemoryDataStream &&) noexcept
	~MemoryDataStream () final
MemoryView< const Byte >	getData () const
	Gets a view to the underlying memory data.
MemoryView< Byte >	getData ()
	Gets a view to the underlying memory data.
bool	isGrowable () const
	Determines if write or seek calls can grow the underlying memory buffer.
bool	isSeekable (const Seek mode=Seek::Start) const noexcept final
	Checks if the stream is seekable.
void	seek (std::streamsize position, Seek mode=Seek::Start) final
	Changes the position of the data stream.
bool	isTellable () const noexcept final
	Checks if the stream knows it's current absolute position.
size_t	tell () final
	Gets the absolute stream position, in bytes.
bool	isSizeKnown () const noexcept final
	Checks if the stream knows the size of the data.
size_t	size () final
	Gets the number of bytes available on the stream.
bool	isReadable () const noexcept final
	Checks if the stream is readable.
size_t	read (void *data, size_t n) final
	Reads data from the data stream to a buffer of raw memory data with length n.
bool	isWritable () const noexcept final
	Checks if the stream is writable.
size_t	write (const void *data, size_t n) final
	Writes data to the data stream from a buffer of raw memory data with length n.
Public Member Functions inherited from CeresEngine::IInputStream
template<typename T >
size_t	read (const MemoryView< T > &memoryView)
	Reads data from the strea into a memory view.
template<typename T >
size_t	read (const StridedMemoryView< T > &memoryView)
	Reads data from the stream into a strided memory view.
Optional< String >	readString ()
	Reads data from the buffer as a C++ String.
template<typename T > requires std::is_trivially_copyable_v<T>
Optional< T >	read ()
	Reads a trivially copyable obhect from the stream.
virtual bool	invalidate ()
	In the stream is buffered, invalidates any buffered read data from the stream.
Public Member Functions inherited from CeresEngine::IStream
	IStream ()=default
	IStream (const IStream &) noexcept=delete
IStream &	operator= (const IStream &) noexcept=delete
	IStream (IStream &&) noexcept=default
IStream &	operator= (IStream &&) noexcept=default
virtual	~IStream () noexcept=default
void	skip (const size_t n)
	Skips n bytes from the data stream.
Public Member Functions inherited from CeresEngine::IOutputStream
template<typename T >
size_t	write (const MemoryView< const T > &memoryView)
	Writes data from a memory view to the stream.
template<typename T >
size_t	write (const StridedMemoryView< const T > &memoryView)
	Writes data from a strided memory view to the stream.
size_t	writeString (const StringView string)
	Writes a string to the data stream.
template<typename T > requires std::is_trivially_copyable_v<T>
bool	write (T value)
	Writes a trivially copyable object to the stream.
virtual bool	flush ()
	In the stream is buffered, invalidates any buffered write data from to stream.

Private Member Functions
bool	growIfNeeded (std::size_t desiredSize)
	Grows the memory stream if needed.

Private Attributes
ByteMemoryView	mBuffer
std::size_t	mSize = 0
std::size_t	mPosition = 0
bool	mOwnsBuffer = true

Additional Inherited Members
Public Types inherited from CeresEngine::IStream
enum class	Seek { Start = SEEK_SET , Current = SEEK_CUR , End = SEEK_END }
	An enumeration that describes how a data stream should be seeked. More...

Detailed Description

A data stream that reads or writes data into a memory buffer.

Constructor & Destructor Documentation

MemoryDataStream() [1/7]

CeresEngine::MemoryDataStream::MemoryDataStream ( )

explicit

Allocates a new empty memory data stream.

MemoryDataStream() [2/7]

CeresEngine::MemoryDataStream::MemoryDataStream ( size_t  size )

explicit

Allocates a new chunk of memory and wraps it in a stream.

Parameters

size	Size of the memory chunk in bytes.

MemoryDataStream() [3/7]

CeresEngine::MemoryDataStream::MemoryDataStream	(	Byte *	memory,
		size_t	size,
		bool	freeOnClose = false
	)

Wrap an existing memory chunk in a stream.

Parameters

memory	Memory to wrap the data stream around.
size	Size of the memory chunk in bytes.
freeOnClose	Should the memory buffer be freed when the data stream goes out of scope.

MemoryDataStream() [4/7]

CeresEngine::MemoryDataStream::MemoryDataStream	(	const ByteMemoryView &	buffer,
		bool	freeOnClose = false
	)

Wrap an existing memory chunk in a stream.

Parameters

buffer	Memory to wrap the data stream around.
freeOnClose	Should the memory buffer be freed when the data stream goes out of scope.

MemoryDataStream() [5/7]

CeresEngine::MemoryDataStream::MemoryDataStream ( DataStream &  stream )

explicit

Copies all contents of the existing data stream into a memory stream.

MemoryDataStream() [6/7]

CeresEngine::MemoryDataStream::MemoryDataStream

(

const MemoryDataStream &

)

MemoryDataStream() [7/7]

CeresEngine::MemoryDataStream::MemoryDataStream ( MemoryDataStream &&  )

noexcept

~MemoryDataStream()

CeresEngine::MemoryDataStream::~MemoryDataStream ( )

final

Member Function Documentation

getData() [1/2]

MemoryView< Byte > CeresEngine::MemoryDataStream::getData ( )

inline

Gets a view to the underlying memory data.

getData() [2/2]

MemoryView< const Byte > CeresEngine::MemoryDataStream::getData ( ) const

inline

Gets a view to the underlying memory data.

growIfNeeded()

bool CeresEngine::MemoryDataStream::growIfNeeded ( std::size_t  desiredSize )

private

Grows the memory stream if needed.

isGrowable()

bool CeresEngine::MemoryDataStream::isGrowable ( ) const

inline

Determines if write or seek calls can grow the underlying memory buffer.

isReadable()

bool CeresEngine::MemoryDataStream::isReadable ( ) const

inlinefinalvirtualnoexcept

Checks if the stream is readable.

If this method returns true, read() is safe to be called on this stream.

Reimplemented from CeresEngine::IInputStream.

isSeekable()

bool CeresEngine::MemoryDataStream::isSeekable ( const Seek  mode = Seek::Start ) const

inlinefinalvirtualnoexcept

Checks if the stream is seekable.

If this method returns true, seek() is safe to be called on this stream.

Reimplemented from CeresEngine::IStream.

isSizeKnown()

bool CeresEngine::MemoryDataStream::isSizeKnown ( ) const

inlinefinalvirtualnoexcept

Checks if the stream knows the size of the data.

If this method returns true, size() is safe to be called on this stream.

Reimplemented from CeresEngine::IStream.

isTellable()

bool CeresEngine::MemoryDataStream::isTellable ( ) const

inlinefinalvirtualnoexcept

Checks if the stream knows it's current absolute position.

If this method returns true, tell() is safe to be called on this stream.

Reimplemented from CeresEngine::IStream.

isWritable()

bool CeresEngine::MemoryDataStream::isWritable ( ) const

inlinefinalvirtualnoexcept

Checks if the stream is writable.

If this method returns true, write() is safe to be called on this stream.

Reimplemented from CeresEngine::IOutputStream.

read()

size_t CeresEngine::MemoryDataStream::read ( void *  data, size_t  n  )

finalvirtual

Reads data from the data stream to a buffer of raw memory data with length n.

Note

This method is only callable if isReadable() returns true.

Parameters

data	The memory location to which read data should be placed.
n	The maximum number of bytes to be read from the data stream.

Returns

The number of bytes actually read. Can be smaller than n. If 0, indicates that the stream has ended.

Reimplemented from CeresEngine::IInputStream.

seek()

void CeresEngine::MemoryDataStream::seek ( std::streamsize  position, Seek  mode = Seek::Start  )

finalvirtual

Changes the position of the data stream.

Note

This method is only callable if isSeekable() returns true.

Parameters

position	The position to set the data stream to.
mode	The mode to change the data stream position.

Reimplemented from CeresEngine::IStream.

size()

size_t CeresEngine::MemoryDataStream::size ( )

inlinefinalvirtual

Gets the number of bytes available on the stream.

Note

This method is only callable if isSizeKnown() returns true.

Reimplemented from CeresEngine::IStream.

tell()

size_t CeresEngine::MemoryDataStream::tell ( )

inlinefinalvirtual

Gets the absolute stream position, in bytes.

Note

This method is only callable if isTellable() returns true.

Reimplemented from CeresEngine::IStream.

write()

size_t CeresEngine::MemoryDataStream::write ( const void *  data, size_t  n  )

finalvirtual

Writes data to the data stream from a buffer of raw memory data with length n.

Note

This method is only callable if isWritable() returns true.

Parameters

data	The memory location to which written data should be copied from.
n	The maximum number of bytes to be write to the data stream.

Returns

The number of bytes actually written. Can be smaller than n, in that case the write operation must be repeated to ensure that all data was written. If 0, indicates that the stream has ended.

Reimplemented from CeresEngine::IOutputStream.

Member Data Documentation

mBuffer

ByteMemoryView CeresEngine::MemoryDataStream::mBuffer

private

mOwnsBuffer

bool CeresEngine::MemoryDataStream::mOwnsBuffer = true

private

mPosition

std::size_t CeresEngine::MemoryDataStream::mPosition = 0

private

mSize

std::size_t CeresEngine::MemoryDataStream::mSize = 0

private

---

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

• /Users/Rogiel/Developer/CeresEngine/Engine/Sources/CeresEngine/Foundation/IO/Stream.hpp