Tools.h++ Manual

22-82 104011 Tandem Computers Incorporated
22
RWTValDlistIterator<T>
Synopsis #include <rw/tvdlist.h>
RWTValDlist<T> list;
RWTValDlistIterator<T> iterator(list);
Description Iterator for class RWTValDlist<T> , allowing sequential access to all the
elements of a doubly-linked parameterized list. Elements are accessed in
order, in either direction.
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 RWTValDlistIterator<T>(RWTValDlist<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--();
Retreats the iterator to the previous item and returns TRUE . When the
beginning 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.