CeresEngine::AsyncBinaryReader Class Reference

A reader that parses data from an underlying input stream as binary data. More...

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

Public Types
using	Seek = Stream::Seek

Public Member Functions
	AsyncBinaryReader (AsyncInputStream inputStream)
	AsyncBinaryReader (IAsyncInputStream &inputStream)
template<typename T , typename... Args>
Async< T >	read (Args &&... args)
	Reads a binary representation of T from the stream.
template<typename T , typename... Args>
Async< Optional< T > >	tryRead (Args &&... args)
	Tries to read a data type from the stream.
Async< size_t >	read (void *data, const size_t n)
	Reads data from the data stream to a buffer of raw memory data with length n.
bool	isSeekable (const Seek mode=Seek::Start) const noexcept
	Checks if the stream is seekable.
Async	seek (const std::streamsize position, const Seek mode=Seek::Start)
	Changes the position of the data stream.
Async	skip (const size_t n)
	Skips n bytes from the data stream.
bool	isTellable () const noexcept
	Checks if the stream knows it's current absolute position.
Async< size_t >	tell ()
	Gets the absolute stream position, in bytes.
bool	isSizeKnown () const noexcept
	Checks if the stream knows the size of the data.
Async< size_t >	size ()
	Gets the number of bytes available on the stream.
AsyncInputStream &	getInputStream ()
	The input stream to which data will be read from.
const AsyncInputStream &	getInputStream () const
	The input stream to which data will be read from.

Private Attributes
AsyncInputStream	mInputStream
	The input stream to which data will be read from.

Detailed Description

A reader that parses data from an underlying input stream as binary data.

Member Typedef Documentation

Seek

using CeresEngine::AsyncBinaryReader::Seek = Stream::Seek

Constructor & Destructor Documentation

AsyncBinaryReader() [1/2]

CeresEngine::AsyncBinaryReader::AsyncBinaryReader ( AsyncInputStream  inputStream )

inlineexplicit

AsyncBinaryReader() [2/2]

CeresEngine::AsyncBinaryReader::AsyncBinaryReader ( IAsyncInputStream &  inputStream )

inlineexplicit

Member Function Documentation

getInputStream() [1/2]

AsyncInputStream & CeresEngine::AsyncBinaryReader::getInputStream ( )

inline

The input stream to which data will be read from.

getInputStream() [2/2]

const AsyncInputStream & CeresEngine::AsyncBinaryReader::getInputStream ( ) const

inline

The input stream to which data will be read from.

isSeekable()

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

inlinenoexcept

Checks if the stream is seekable.

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

isSizeKnown()

bool CeresEngine::AsyncBinaryReader::isSizeKnown ( ) const

inlinenoexcept

Checks if the stream knows the size of the data.

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

isTellable()

bool CeresEngine::AsyncBinaryReader::isTellable ( ) const

inlinenoexcept

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

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

read() [1/2]

template<typename T , typename... Args>

Async< T > CeresEngine::AsyncBinaryReader::read ( Args &&...  args )

inline

Reads a binary representation of T from the stream.

Note

The actual decoding of the data is done by BinaryCodec.

read() [2/2]

Async< size_t > CeresEngine::AsyncBinaryReader::read ( void *  data, const size_t  n  )

inline

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.

seek()

Async CeresEngine::AsyncBinaryReader::seek ( const std::streamsize  position, const Seek  mode = Seek::Start  )

inline

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.

size()

Async< size_t > CeresEngine::AsyncBinaryReader::size ( )

inline

Gets the number of bytes available on the stream.

Note

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

skip()

Async CeresEngine::AsyncBinaryReader::skip ( const size_t  n )

inline

Skips n bytes from the data stream.

tell()

Async< size_t > CeresEngine::AsyncBinaryReader::tell ( )

inline

Gets the absolute stream position, in bytes.

Note

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

tryRead()

template<typename T , typename... Args>

Async< Optional< T > > CeresEngine::AsyncBinaryReader::tryRead ( Args &&...  args )

inline

Tries to read a data type from the stream.

If the read fails, returns an empty optional.

Member Data Documentation

mInputStream

AsyncInputStream CeresEngine::AsyncBinaryReader::mInputStream

private

The input stream to which data will be read from.

---

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

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