RWOrderedIterator(3C++)

Name
     RWOrderedIterator - Rogue Wave library class

Synopsis
              #include <rw/ordcltn.h>



              RWOrdered a ;
          RWOrderedIterator iter(a);




Description
     Iterator for class RWOrdered.  Traverses the collection from the first to
     the last item. Like all Rogue Wave iterators, the "current item" is
     undefined immediately after construction -- you must define it by using
     operator() or some other (valid) operation.  Once the iterator has
     advanced beyond the end of the collection it is no longer valid --
     continuing to use it will bring undefined results.

Persistence
     None

Public Constructors
              RWOrderedIterator(const RWOrdered& a);


     Construct an RWOrderedIterator from an RWOrdered.  Immediately after
     construction the position of the iterator is undefined.

Public Member Operator
              virtual RWCollectable*
          operator()();


     Redefined from class RWIterator.  Advances the iterator to the next item
     and returns it. Returns nil when the end of the collection is reached.

Public Member Functions
              virtual RWCollectable*
          findNext(const RWCollectable*);


     Redefined from class RWIterator.  Moves iterator to the next item which
     isEqual to the item pointed to by target and returns it.  If no item is
     found, returns nil and the position of the iterator will be undefined.

              virtual RWCollectable*
          key() const;
     Redefined from class RWIterator.  Returns the item at the current
     iterator position.

              virtual void
          reset();


     Redefined from class RWIterator.  Resets the iterator to its starting
     state.