Tools.h++ Manual

104011 Tandem Computers Incorporated 22-81
22
size_t removeAll(RWBoolean (*testFun)
(const T&, void*), void* d);
Removes all objects for which the user-defined tester function pointed to by
testFun returns TRUE . Returns the number of objects removed. 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 .
T removeAt(size_t i);
Removes and returns the object at index i . An exception of type TOOL_INDEX
will be thrown if i is not a valid index. Valid indices are from zero to the
number of items in the list less one.
T removeFirst();
Removes and returns the first item in the list. The behavior is undefined if the
list is empty.
T removeLast()
Removes and returns the last item in the list. The behavior is undefined if the
list is empty.