RWTPtrSetIterator< T, C, A > Class Template Reference
[STL-based Collections]

Provides an iterator for RWTPtrSet. More...

#include <rw/tpset.h>

Public Member Functions
	RWTPtrSetIterator (RWTPtrSet< T, C, A > &t)
bool	operator++ ()
T *	operator() ()
RWTPtrSet< T, C,A > *	container () const
T *	key () const
void	reset ()
void	reset (RWTPtrSet< T, C, A > &t)

Detailed Description

template<class T, class C, class A = std:: allocator < T* >>
class RWTPtrSetIterator< T, C, A >

RWTPtrSetIterator provides an iterator interface to the C++ Standard Library-based collection represented by RWTPtrSet. (An STL iterator interface is provided through RWTPtrSet::iterator.)

The order of iteration over an RWTPtrSet is dependent on the comparator object supplied as applied to the values stored in the container.

The current item referenced by this iterator is undefined after construction or after a call to reset(). The iterator becomes valid after being advanced with either a pre-increment or operator()().

For both operator++() and operator()(), iterating past the last element will return a value equivalent to boolean false. Continued increments will return a value equivalent to false until reset() is called.

The value type must have operator== and operator< defined. This requirement is imposed by the C++ Standard Library.

Synopsis

 #include<rw/tpset.h>
 RWTPtrSet<T,C,A> set;
 RWTPtrSetIterator<T,C,A> itr(set);

Persistence

None

Examples

 #include <rw/tpset.h>
 #include <iostream>
 #include <rw/cstring.h>

 int main() {
    RWTPtrSet<RWCString,std::less<RWCString> > a;
    RWTPtrSetIterator<RWCString,std::less<RWCString> > itr(a);

    a.insert(new RWCString("John"));
    a.insert(new RWCString("Steve"));
    a.insert(new RWCString("Mark"));

    while(itr()) {
      std::cout << *itr.key() <<  std::endl;
    }

    a.clearAndDestroy();
    return 0;
 }

Program Output

 John
 Mark
 Steve