Tools.h++ Class Reference

Inserts the object pointed to by a into the iterator's associated collection in the position
immediately after the iterator's current position which remains unchanged.
T*
key() const;
Returns a pointer to the object at the iterator's current position. The results are undefined if the
iterator is no longer valid.
T*
remove();
Removes and returns the object at the iterator's current position from the iterator's associated
collection. Afterwards, the iterator will be positioned at the element immediately before the
removed element. Returns nil if unsuccessful in which case the position of the iterator is
undefined. This function is relatively inefficient for a singly-linked list.
T*
removeNext(const T* a);
Advances the iterator to the first element that is equal to the object pointed to by a, then removes
and returns it. Afterwards, the iterator will be positioned at the element immediately before the
removed element. Returns nil if unsuccessful in which case the position of the iterator is
undefined. Equality is measured by the class-defined equality operator for type T.
T*
removeNext(RWBoolean (*testFun)(T*, void*), void*);
Advances the iterator to the first element for which the tester function pointed to by testFun
returns TRUE, then removes and returns it. Afterwards, the iterator will be positioned at the
element immediately before the removed element. Returns nil if unsuccessful in which case the
position of the iterator is undefined.
void
reset();
Resets the iterator to the state it had immediately after construction.
void
reset(RWTPtrSlist<T>& c);
Resets the iterator to iterate over the collection c.