Tools.h++ Class Reference

Table Of Contents
is passed through from the call to applyToKeyAndValue(). This member function may
throw an RWFileErr exception.
RWoffset
baseLocation() const;
Returns the offset of this tree's starting location within the RWFileManager. This is the
value you will pass to a constructor as the start argument when you want to open one of
several trees stored in one managed file.
unsigned
cacheCount() const;
Returns the maximum number of nodes that may currently be cached.
unsigned
cacheCount(unsigned newcount);
Sets the number of nodes that should be cached to newcount. Returns the old number.
void
clear();
Removes all items from the collection.This member function may throw an RWFileErr
exception.
RWBoolean
contains(const char* ky) const;
Returns TRUE if the tree contains a key that is equal to the string pointed to by ky, and
FALSE otherwise. This member function may throw an RWFileErr exception.
size_t
entries();
Returns the number of items in the RWBTreeOnDisk. This member function may throw an
RWFileErr exception.
RWoffset
extraLocation(RWoffset newlocation);
Sets the location where this RWBTreeOnDisk keeps your own application-specific
information to newlocation. Returns the previous value.
RWBoolean
findKey( const char* ky, RWCString& foundKy)const ;
Returns TRUE if ky is found, otherwise FALSE. If successful, the found key is returned as
a reference in foundKy. This member function may throw an RWFileErr exception.
RWBoolean
findKeyAndValue( const char* ky,
RWCString& foundKy,
RWStoredValue& foundVal)const ;