IInputStream Class Reference

Represents an input stream. More...

Detailed Description

Represents an input stream.

Public Member Functions
virtual size_t	read (char *dst, size_t size)=0
	Reads up to size bytes from stream. Blocking (waiting for new data) is allowed. More...
size_t	read (std::span< std::byte > destination)
	Reads up to destination.size() bytes from stream. Blocking (waiting for new data) is allowed. More...
void	readExact (char *dst, size_t size)
	Reads exact size bytes from stream. Blocking (waiting for new data) is allowed. More...
template<typename T >
T	deserialize ()
template<typename T >
IInputStream &	operator>> (T &dst)
template<typename T >
IInputStream &	operator>> (T &&dst)

Member Function Documentation

deserialize()

template<typename T >

T IInputStream::deserialize

inline

Reads data using AUI serialization (see AUI/Traits/serializable.h)

Parameters

t	value to write

operator>>() [1/2]

template<typename T >

IInputStream & IInputStream::operator>>

(

T &&

dst

)

Reads data using AUI serialization (see AUI/Traits/serializable.h)

Parameters

t	value to write

operator>>() [2/2]

template<typename T >

IInputStream & IInputStream::operator>>

(

T &

dst

)

Reads data using AUI serialization (see AUI/Traits/serializable.h)

Parameters

t	value to write

read() [1/2]

virtual size_t IInputStream::read ( char *  dst, size_t  size  )

pure virtual

Reads up to size bytes from stream. Blocking (waiting for new data) is allowed.

Sneaky exceptions

An implementation can throw any exception that subclasses AIOException.

Parameters

dst	destination buffer
size	destination buffer's size. > 0

Returns

number of read bytes (including 0)

Implemented in AByteBufferInputStream, AConcatInputStream, ADynamicPipe, AFileInputStream, ALimitedInputStream, APipe, ARandomInputStream, AStringStream, AStrongByteBufferInputStream, PipeInputStream, and ATcpSocket.

read() [2/2]

size_t IInputStream::read ( std::span< std::byte >  destination )

inline

Reads up to destination.size() bytes from stream. Blocking (waiting for new data) is allowed.

Sneaky exceptions

An implementation can throw any exception that subclasses AIOException.

Parameters

dst	destination buffer
size	destination buffer's size. > 0

Returns

number of read bytes (including 0)

readExact()

void IInputStream::readExact ( char *  dst, size_t  size  )

inline

Reads exact size bytes from stream. Blocking (waiting for new data) is allowed.

Sneaky exceptions

An implementation can throw any exception that subclasses AIOException.

Exceptions

Throws

AEOFException when could not read EXACT size bytes.

Parameters

dst	destination buffer.
size	destination buffer's size.

#include <AUI/IO/IInputStream.h>

---

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

• aui.core/src/AUI/IO/IInputStream.h

Inheritance diagram for IInputStream: