Tools.h++ Class Reference

const_iterator
end() const;
Returns an iterator positioned "just past" the last association in self.
size_type
entries() const;
Returns the number of associations in self.
float
fillRatio() const;
Returns the ratio entries()/capacity().
const K*
find(const K* key) const;
If there exists a key j in self that compares equal to *key, then j is returned.
Otherwise, returns rwnil.
value_type
find(bool (*fn)(value_type,void*), void* d) const;
If there exists an association a in self such that the expression ((*fn)(a,d)) is true,
then returns a. Otherwise, returns pair<rwnil,rwnil>. fn points to a user-defined
tester function which must have prototype:
bool yourTester(value_type a, void* d);
Client data may be passed through parameter d.
T*
findValue(const K* key);
const T*
findValue(const K* key) const;
If there exists a key j in self that compares equal to *key, returns the item associated
with j. Otherwise, returns rwnil.
const K*
findKeyAndValue(const K* key, T*& tr);
const K*
findKeyAndValue(const K* key, const T*& tr) const;
If there exists a key j in self that compares equal to *key, assigns the item associated
with j to tr, and returns j. Otherwise, returns rwnil and leaves the value of tr
unchanged.
bool
insert(K* key, T* a);
Adds key with associated item a to the collection. Returns true if the insertion is
successful, otherwise returns false. The function will return true unless the