Tools.h++ Manual

22-104 104011 Tandem Computers Incorporated
22
void prepend(const T& a);
Prepends the value
a
to the beginning of the vector. The collection will
automatically be resized if this causes the number of items in the collection to
exceed the capacity.
RWBoolean remove(const T& a);
Performs a linear search, removing 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.
size_t removeAll(const T& a);
Removes all items which are equal to
a
, returning the number removed.
Equality is measured by the class-defined equality operator.
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 object in the collection. An exception of type
TOOL_INDEX
will be thrown if the list is empty.
T removeLast();
Removes and returns the last object in the collection. An exception of type
TOOL_INDEX
will be thrown if the list is empty.
void resize(size_t N);
Changes the capacity of the collection to
N
. Note that the number of objects in
the collection does not change, just the capacity.