Tools.h++ Manual

104011 Tandem Computers Incorporated 23-5
23
RWGDlist(type)
RWGDlist(type)
|
RWDlist
|
RWSlist
Synopsis #include <rw/gdlist.h>
declare(RWGDlist, type )
RWGDlist (type) a ;
Description Class RWGDlist (type) represents a group of ordered elements of type type, not
accessible by an external key. Duplicates are allowed. This class is
implemented as a doubly-linked list. Objects of type RWGDlist (type) are
declared with macros defined in the standard C++ header file <generic.h>.
In order to find a particular item within the collection, a user-provided global
"tester" function is required to test for a "match", definable in any consistent
way. This function should have prototype:
RWBoolean yourTesterFunction (const type* c, const void* d);
The argument c is a candidate within the collection to be tested for a match.
The argument d is for your convenience and will be passed to
yourTesterFunction(). The function should return TRUE if a "match" is found
between c and d .
In order to simplify the following documentation, an imaginary typedef
typedef RWBoolean (* yourTester )(const type *, const void*);
has been used for this tester function.