Tools.h++ Manual

104011 Tandem Computers Incorporated 22-109
22
Returns the index of the first object for which the user-defined tester function
pointed to by testFun returns TRUE , or RW_NPOS 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 .
void insert(const T& a);
Adds the item a to the end of the list.
void insertAt(size_t i, const T& a);
Insert the item a at the index position i . This position must be between zero
and the number of items in the list, or an exception of type TOOL_INDEX will
be thrown.
RWBoolean isEmpty() const;
Returns TRUE if there are no items in the list, FALSE otherwise.
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.