rmtabl (2) --- remove a symbol table                     03/23/80


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine rmtabl (table)
                 pointer table

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Rmtabl'  is  used  to  remove  a  symbol  table  created by
                 'mktabl'.  The sole argument is  the  address  of  a  symbol
                 table in dynamic storage space, as returned by 'mktabl'.

                 'Rmtabl'  deletes  each symbol still in the symbol table, so
                 it is not necessary to empty a symbol table before  deleting
                 it  (unless  symbol table nodes contain a pointer to dynamic
                 or linked-string storage, which cannot be reclaimed).

                 Please see the manual entry for 'dsinit' for instructions on
                 initializing the dynamic storage space used  by  the  symbol
                 table routines.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Rmtabl'  traverses  each  chain  headed  by  the hash table
                 created by 'mktabl'.  Each  symbol  table  node  encountered
                 along  the  way  is  returned  to  free storage by a call to
                 'dsfree'.  Once all symbols  are  removed,  the  hash  table
                 itself is returned by a similar call.


            _C_a_l_l_s

                 dsfree


            _S_e_e _A_l_s_o

                 mktabl  (2),  enter  (2), lookup (2), delete (2), dsget (2),
                 dsfree (2), dsinit (2), sctabl (2)
















            rmtabl (2)                    - 1 -                    rmtabl (2)