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

Provides an iterator for RWTValSet. More...

#include <rw/tvset.h>

Public Member Functions
	RWTValSetIterator (RWTValSet< T, C, A > &s)
bool	operator++ ()
bool	operator() ()
RWTValSet< T, C,A > *	container () const
T	key () const
void	reset ()
void	reset (RWTValSet< T, C, A > &s)

Detailed Description

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

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

The order of iteration over an RWTValSet is dependent on the supplied comparator object parameter C 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 returns a value equivalent to boolean false. Continued increments 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/tvset.h>
 RWTValSet<T,C,A> vs;
 RWTValSetIterator<T,C,A> itr(vs);

Persistence

None

Examples

 #include <rw/tvset.h>
 #include <rw/cstring.h>
 #include <iostream>
 #include <functional>
 
 int main()
 {
    RWTValSet<RWCString,std::greater<RWCString> > a;
    RWTValSetIterator<RWCString,std::greater<RWCString> > itr(a);
 
    a.insert("John");
    a.insert("Steve");
    a.insert("Mark");
 
    //Rejected, duplicates are not allowed
    a.insert("Steve");
 
    while(itr()) {
      std::cout << itr.key() << std::endl;
    }
 
    return 0;
 }

Program Output:

 Steve
 Mark
 John