set_create (4) --- generate a new, initially empty set   07/20/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

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

          |      Library: vswtmath (Subsystem mathematical library)


            _F_u_n_c_t_i_o_n

                 '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=/lib/math/swtmlb_link.r.i"


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 '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.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 set


            _C_a_l_l_s

                 dsget, set_init


            _S_e_e _A_l_s_o

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








            set_create (4)                - 1 -                set_create (4)