set_insert (4) --- place given element in a set          07/20/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine set_insert (element, set)
                 integer element
                 pointer set

          |      Library: vswtmath (Subsystem mathematical library)


            _F_u_n_c_t_i_o_n

                 'Set_insert' is the primary means of placing a given element
                 in  a set.  'Element' must be an integer between one and the
                 maximum size of the set, inclusive; 'set' must be a  pointer
                 to  a  set data structure created by 'set_create'.  If it is
                 within range, the given element is marked "present"  in  the
                 bit vector associated with the 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

                 If the element is out of range, a call to 'error' is made to
                 inform  the  user and terminate the program.  Otherwise, the
                 location of the element in the bit vector is determined  and
                 a  few  logical  operations are employed to set the selected
                 bit.


            _C_a_l_l_s

                 error


            _S_e_e _A_l_s_o

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











            set_insert (4)                - 1 -                set_insert (4)