Tools.h++ Class Reference

RWGDlist(type)(type* a);
Construct a collection with one entry a.
RWGDlist(type)(const RWGDlist(type)& a);
Copy constructor. A shallow copy of a is made.
Assignment Operator
void
operator=(const RWGDlist(type)& a);
Assignment operator. A shallow copy of a is made.
Public Member Functions
type*
append(type* a);
Adds an item to the end of the collection. Returns nil if the insertion was unsuccessful.
void
apply(void (*ap)(type*, void*), void* );
Visits all the items in the collection in order, from first to last, calling the user-provided
function pointed to by ap for each item. This function should have prototype:
void yourApplyFunction(type* c, void*);
and can perform any operation on the object at address c. The last argument is useful for
passing data to the apply function.
type*&
at(size_t i);
const type*
at(size_t i) const;
Returns a pointer to the ith item in the collection. The first variant can be used as an
lvalue, the second cannot. The index i must be between zero and the number of items in
the collection less one, or an exception of type TOOL_INDEX will be thrown.
void
clear();
Removes all items in the collection.
RWBoolean
contains(yourTester t, const void* d) const;
Returns TRUE if the collection contains an item for which the user-defined function
pointed to by t finds a match with d.