Tools.h++ Manual

23-8 104011 Tandem Computers Incorporated
23
type * first() const;
Returns the first item of the collection.
type * get();
Returns and removes the first item of the collection.
type * insert( type * e);
Adds an item to the end of the collection and returns it. Returns nil if the
insertion was unsuccessful.
void insertAt(size_t indx, type* e);
Adds a new item to the collection at position indx . The item previously at
position i is moved to i+1 , etc. The index indx must be between 0 and the
number of items in the collection, or an exception of type TOOL_INDEX will be
thrown.
RWBoolean isEmpty() const;
Returns TRUE if the collection is empty, otherwise FALSE .
type * last() const;
Returns the last item of the collection.
size_t occurrencesOf( yourTester t,
const void* d) const;
Returns the number of occurrences in the collection for which the user-
provided function pointed to by t finds a match with d .
size_t occurrencesOfReference(const
type * e) const;
Returns the number of items in the collection with the address e .
type * prepend( type * a);
Adds an item to the beginning of the collection. Returns nil if the insertion
was unsuccessful.
type * remove( yourTester t, const void*
d);
Removes and returns the first item from the collection for which the user-
provided function pointed to by t finds a match with d , or returns nil if no
item is found.
type* removeReference(const type* e);
Removes and returns the first item from the collection with the address e , or
returns nil if no item is found.