NAME

set_create - generate a new, initially empty set

SYNOPSIS


pointer function set_create (set, size)
pointer set
integer size


DESCRIPTION

'Set_create' is used to create a Pascal-style bit vector representation
for a set of integers from 1 to 'size'.
The function return and the variable 'set' are set to the address
in dynamic storage of the newly-created set.

All set manipulation routines make use of dynamic storage,
which must be initialized before use.
See 'dsinit' for further information.

Note that all set manipulation routines have long names.
To avoid unique name conflicts with other routines, any Ratfor
program using the set routines should include the following
statement:


include "=src=/lcl/lib/swtmlb.u/swtmlb_link.r.i"

IMPLEMENTATION

'Set_create' calls 'dsget' to obtain a contiguous array of 16-bit
words that is large enough to represent a bit vector with 'size'
elements.
The first word of this array is set to 'size' for use by other
set manipulation routines.
A call to 'set_init' then insures that the new set is empty.

ARGUMENTS MODIFIED

set

CALLS

dsget, set_init

SEE ALSO

other set routines ('set_?*') (4)