Tools.h++ Manual

104011 Tandem Computers Incorporated 21-149
21
RWOrderedIterator
RWOrderedIterator
|
RWIterator
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 Tools.h++ 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.
Public constructors RWOrderedIterator(const RWOrdered& a);
Construct a RWOrderedIterator from a 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.