Tools.h++ Class Reference

Table Of Contents
Returns the number of elements in self.
bool
find(const_reference a, value_type& k) const;
If there exists an element t in self such that the expression (t == a) is true, assigns t to k
and returns true. Otherwise, returns false and leaves the value of k unchanged.
bool
find(bool (*fn)(const_reference,void*), void* d,
value_type& k) const;
If there exists an element t in self such that the expression ((*fn)(t,d)) is true, assigns t to
k and returns true. Otherwise, returns false and leaves the value of k unchanged. fn points
to a user-defined tester function which must have prototype:
bool yourTester(const T& a, void* d);
Client data may be passed through parameter d.
reference
first();
const_reference
first() const;
Returns a reference to the first element of self.
size_type
index(const_reference a) const;
Returns the position of the first item t in self such that (t == a), or returns the static
member npos if no such item exists.
size_type
index(bool (*fn)(const_reference,void*), void* d) const;
Returns the position of the first item t in self such that((*fn)(t,d)) is true, or returns the
static member npos if no such item exists. fn points to a user-defined tester function
which must have prototype:
bool yourTester(const_reference a, void* d);
Client data may be passed through parameter d.
bool
insert(const_reference a);
Adds the item a to the end of the collection. Returns true.
void
insertAt(size_type i, const_reference a);
Inserts the item a in front of the item at position i in self. This position must be between 0
and the number of entries in the collection, otherwise the function throws an exception of
type RWBoundsErr.