RWvistreamIterator< T > Class Template Reference

Input iterator that reads successive elements from the input stream for which it was constructed. More...

#include <rw/vstream.h>

Public Member Functions
	RWvistreamIterator ()
	RWvistreamIterator (RWvistream &s)
const T &	operator* () const
RWvistreamIterator &	operator++ ()
RWvistreamIterator	operator++ (int)
const T *	operator-> () const

Related Symbols
(Note that these are not member symbols.)
bool	operator!= (const RWvistreamIterator< T > &lhs, const RWvistreamIterator< T > &rhs)
bool	operator== (const RWvistreamIterator< T > &lhs, const RWvistreamIterator< T > &rhs)

Detailed Description

template<typename T>
class RWvistreamIterator< T >

Class RWvistreamIterator is an input iterator that reads (using operator>>) successive elements from the input stream for which it was constructed. After it is constructed, and every time operator++() or operator++(int) is used, the iterator reads and stores a value of T.

The constructor with no arguments always constructs and end-of-stream input iterator object, which is the only legitimate iterator to be used for the end condition. The result of operator*() on an end-of-stream iterator is undefined. For any other iterator value, a const T& is returned. The result of operator->() on an end-of stream iterator is not defined. For any other iterator value, a const T* is returned. The behavior of a program that applies operator++() to an end-of-stream iterator is undefined. It is impossible to store things into RWvistream iterators.

Constructor & Destructor Documentation

RWvistreamIterator() [1/2]

template<typename T >

RWvistreamIterator< T >::RWvistreamIterator ( )

inline

Constructs an end-of-stream iterator.

RWvistreamIterator() [2/2]

template<typename T >

RWvistreamIterator< T >::RWvistreamIterator ( RWvistream & s )

inline

Constructs an iterator that will use s as the source for all extraction operations. Extracts a single value of type T from the stream s. If the extraction fails, this iterator becomes an end-of-stream iterator, otherwise this iterator becomes a non-end-of-stream iterator.

Member Function Documentation

operator*()

template<typename T >

const T & RWvistreamIterator< T >::operator* ( ) const

inline

Returns a reference to the last value read from the underlying stream.

operator++() [1/2]

template<typename T >

RWvistreamIterator & RWvistreamIterator< T >::operator++ ( )

inline

Extracts an item from the underlying stream and returns a reference to self. If the extraction operation fails, this iterator becomes an end-of-stream iterator.

operator++() [2/2]

template<typename T >

RWvistreamIterator RWvistreamIterator< T >::operator++ ( int )

inline

Makes a copy of self, extracts an item from the underlying stream and, returns the copy that was made before the extraction. If the extract operation fails, this iterator becomes an end-of-stream iterator.

operator->()

template<typename T >

const T * RWvistreamIterator< T >::operator-> ( ) const

inline

Returns a pointer to the last value read from the underlying stream.

Friends And Related Symbol Documentation

operator!=

template<typename T >

bool operator!= ( const RWvistreamIterator< T > & lhs, const RWvistreamIterator< T > & rhs )

friend

Returns true if lhs is not equal to rhs, otherwise false.

Two end-of-stream iterators are always equal. An end-of-stream iterator is not equal to a non-end-of-stream iterator. Two non-end-of-stream iterators are equal when they are associated with the same stream.

operator==

template<typename T >

bool operator== ( const RWvistreamIterator< T > & lhs, const RWvistreamIterator< T > & rhs )

friend

Returns true if lhs is equal to rhs, otherwise false.

Two end-of-stream iterators are always equal. An end-of-stream iterator is not equal to a non-end-of-stream iterator. Two non-end-of-stream iterators are equal when they are associated with the same stream.