Tools.h++ Class Reference

Public Member Operators
T*
operator()();
Advances self to the next element, dereferences the resulting iterator and returns its
value. If the iterator has advanced past the last item in the container, the element returned
will be a nil pointer equivalent to boolean false.
RWBoolean
operator++();
Advances self to the next element. If the iterator has been reset or just created, self will
reference the first element. If, before iteration, self referenced the last value in the list,
self will now referece an undefined value distinct from the reset value and a value
equivalent to false will be returned. Otherwise, a value equivalent to true is returned.
Note: no post-increment operator is provided.
RWBoolean
operator+=(size_type n);
Behaves as if operator++() had been applied n times
RWBoolean
operator--();
Moves self back to the immediately previous element. If the iterator has been reset or just
created, self operator will returna value equivalent to false, otherwise it will return a
value equivalent to true. If self references the the first element, it will now be in the reset
state. If self has been iterated past the last value in the list, it will now reference the last
item in the list. Note: no post-decrement operator is provided.
RWBoolean
operator-=(size_type n);
Behaves as if operator--() had been applied n times
Public Member Functions
RWTPtrDlist<T>*
container() const;
Returns a pointer to the collection being iterated over.
T*
findNext(const T* a);
Returns the first element t encountered while iterating self forward, such that the
expression (*t == *a) is true. If no such element exists, returns a nil pointer equivalent to
false. Leaves self referencing the found item, or "past the end."
T*