Tools.h++ Class Reference

Click on the banner to return to the Class Reference home page.
©Copyright 1996 Rogue Wave Software
RWGSlist(type)
Synopsis●
Description●
Persistence●
Public Constructors●
Assignment Operator●
Public Member Functions●
Synopsis
#include <rw/gslist.h>
declare(RWGSlist, type)
RWGSlist(type) a ;
Description
Class RWGSlist(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 singly-linked list. Objects
of type RWGSlist(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 documentation below, an imaginary typedef
typedef RWBoolean (*yourTester)(const type*, const void*);