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
now reference the first element. If, before iteration, self referenced the last association in
the list, self will now reference 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 the operator++ member function had been applied n times
Public Member Functions
RWTPtrSlist<T>*
container() const;
Returns a pointer to the collection being iterated over.
T*
findNext(const T* a);
Returns the first element t encountered by iterating self forward, such that the expression
(*t == *a) is true. If no such element is found, returns nil. Leaves self referencing the
found item or "off the end."
T*
findNext(RWBoolean(*fn)(T*, void*), void* d);
Returns the first element t encountered by iterating self forward such that the
expression((*fn)(t,d)) is true. fn points to a user-defined tester function which must have
prototype:
bool yourTester(const T* a, void* d);
Client data may be passed through parameter d.
void
insertAfterPoint(T* p);
Inserts the pointer p into the container directly after the element pointed to by self.