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

Provides an iterator for RWTValMultiSet. More...

#include <rw/tvmset.h>

Public Member Functions
	RWTValMultiSetIterator (RWTValMultiSet< T, C, A > &h)
bool	operator++ ()
bool	operator() ()
RWTValMultiSet< T, C,A > *	container () const
T	key () const
void	reset ()
void	reset (RWTValMultiSet< T, C, A > &h)

Detailed Description

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

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

The order of iteration over an RWTValMultiSet 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/tvmset.h>
 RWTValMultiSet<T,C> vs;
 RWTValMultiSetIterator<T,C> itr(vs);

Persistence

None

Examples

 #include <rw/tvmset.h>
 #include <iostream>
 #include <rw/cstring.h>
 #include <functional>
 
 int main()
 {
    RWTValMultiSet<RWCString, std::greater<RWCString> > a;
    RWTValMultiSetIterator<RWCString,
      std::greater<RWCString> > itr(a);
 
    a.insert("John");
    a.insert("Steve");
    a.insert("Mark");
    a.insert("Steve");
 
    while(itr()) {
      std::cout << itr.key() << std::endl;
    }
 
    return 0;
 }

Program Output:

 Steve
 Steve
 Mark
 John