Tools.h++ Manual

22-80 104011 Tandem Computers Incorporated
22
T last() const;
Returns (but does not remove) the last item in the list. The behavior is
undefined if the list is empty.
size_t occurrencesOf(const T& a) const;
Returns the number of objects in the list that are equal to the object a . Equality
is measured by the class-defined equality operator.
size_t occurrencesOf(RWBoolean (*testFun)
(const T&, void*),void* d) const;
Returns the number of objects in the list for which the user-defined "tester"
function pointed to by testFun returns TRUE . The tester function must have
the prototype:
RWBoolean yourTester (const T&, void* d);
For each item in the list this function will be called with the item as the first
argument. Client data may be passed through as parameter d .
void prepend(const T& a);
Adds the item a to the beginning of the list.
RWBoolean remove(const T& a);
Removes the first object which is equal to the object a and returns TRUE .
Returns FALSE if there is no such object. Equality is measured by the class-
defined equality operator.
RWBoolean remove(RWBoolean (*testFun)
(const T&, void*),void* d);
Removes the first object for which the user-defined tester function pointed to
by testFun returns TRUE , and returns TRUE . Returns FALSE if there is no
such object. The tester function must have the prototype:
RWBoolean yourTester (const T&, void* d);
For each item in the list this function will be called with the item as the first
argument. Client data may be passed through as parameter d .
size_t removeAll(const T& a);
Removes all objects which are equal to the object a . Returns the number of
objects removed. Equality is measured by the class-defined equality operator.