Tools.h++ Manual

22-110 104011 Tandem Computers Incorporated
22
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.
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.