Tools.h++ Manual

22-58 104011 Tandem Computers Incorporated
22
RWTPtrSlistIterator<T>
Synopsis #include <rw/tpslist.h>
RWTPtrSlist<T> list;
RWTPtrSlistIterator<T> iterator(list);
Description Iterator for class RWTPtrSlist<T> , allowing sequential access to all the
elements of a singly-linked parameterized list. Elements are accessed in order,
from first to last.
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 constructor RWTPtrSlistIterator<T>(RWTPtrSlist<T>& c);
Constructs an iterator to be used with the list c .
Public member operators RWBoolean operator++();
Advances the iterator to the next item and returns TRUE . When the end of the
collection is reached, returns FALSE and the position of the iterator will be
undefined.
RWBoolean operator+=(size_t n);
Advances the iterator n positions and returns TRUE . When the end of the
collection is reached, returns FALSE and the position of the iterator will be
undefined.
T* operator()();
Advances the iterator to the next item and returns a pointer to it. When the
end of the collection is reached, returns nil and the position of the iterator will
be undefined.