byteme::IstreamReader< Pointer_ > Class Template Reference

Read bytes from a std::istream. More...

#include <IstreamReader.hpp>

Inheritance diagram for byteme::IstreamReader< Pointer_ >:

Collaboration diagram for byteme::IstreamReader< Pointer_ >:

Public Member Functions
	IstreamReader (Pointer_ input, const IstreamReaderOptions &options)
bool	load ()
const unsigned char *	buffer () const
std::size_t	available () const
Public Member Functions inherited from byteme::Reader

Detailed Description

template<class Pointer_>
class byteme::IstreamReader< Pointer_ >

Read bytes from a std::istream.

Template Parameters

Pointer_

Pointer to a class providing an input stream of bytes, satisfying the std::istream interface. This is most typically a std::unique_ptr<std::istream> > but a concrete subclass may also be used to encourage compiler devirtualization. Either a raw or smart pointer may be used depending on how the lifetime of the pointed-to object is managed.

This is just a wrapper around std::istream::read, mostly to avoid having to remember the correct way to check for end of file.

Constructor & Destructor Documentation

IstreamReader()

template<class Pointer_ >

byteme::IstreamReader< Pointer_ >::IstreamReader ( Pointer_ input, const IstreamReaderOptions & options )

inline

Parameters

input	Pointer to an input stream.
options	Further options.

Member Function Documentation

available()

template<class Pointer_ >

std::size_t byteme::IstreamReader< Pointer_ >::available ( ) const

inlinevirtual

This method should only be called after load() has been called and returns true. The return value is generally expected to be positive; however, it is possible to return a zero. Note that zero values should not be interpreted as the end of the source, which is strictly only defined by load() returning false.

Returns

Number of available bytes in buffer().

Implements byteme::Reader.

buffer()

template<class Pointer_ >

const unsigned char * byteme::IstreamReader< Pointer_ >::buffer ( ) const

inlinevirtual

This method should only be called after load() has been called and returns true.

Returns

Pointer to the start of an array containing the available bytes. The number of available bytes is provided in available().

Implements byteme::Reader.

load()

template<class Pointer_ >

bool byteme::IstreamReader< Pointer_ >::load ( )

inlinevirtual

Read the next chunk of bytes from the input source. To read the entire source, this function should be called repeatedly until false is returned. After returning false once, the behavior of subsequent calls is undefined.

Returns

Boolean indicating whether the read was successful. If false, it can be assumed that the end of the source was reached.

Implements byteme::Reader.

---

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

• byteme/IstreamReader.hpp