Tools.h++ Manual

22-16 104011 Tandem Computers Incorporated
22
T* find(RWBoolean (*testFun)(const
T*, void*), void* d) const;
Returns the first item in the list for which the user-defined "tester" function
pointed to by testFun returns TRUE . If there is no such item, then returns nil.
The tester function must have the prototype:
RWBoolean yourTester (const T* item, 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* first() const;
Returns (but does not remove) the first item in the list, or nil if the list is empty.
T* get();
Returns and removes the first item in the list, or nil if the list is empty.
size_t index(RWBoolean
(*testFun)(const T*, void*),
void* d) const;
Returns the index of the first item in the list for which the user-defined "tester"
function pointed to by testFun returns TRUE . If there is no such item, then
returns RW_NPOS . The tester function must have the prototype:
RWBoolean yourTester (const T* item, 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(T* a);
Appends the item pointed to by a to the end of the list. This item cannot be
inserted into more than one list, nor can it be inserted into the same list more
than once.
void insertAt(size_t i, T* a);
Insert the item pointed to by 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. The item cannot be inserted into more than one
list, nor can it be inserted into the same list more than once.
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, or nil if the list is empty.