lsfree (4) --- free linked string space                  03/23/80


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 subroutine lsfree (ptr, len)
                 pointer ptr
                 integer len

                 Library:  vlslb


            _F_u_n_c_t_i_o_n

                 The  first 'len' characters of the string specified by 'ptr'
                 are deallocated.  'Ptr' is updated to point to the remaining
                 characters.  If no characters remain ('len' is  longer  than
                 the string) 'ptr' is set to zero.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 The  string  is  traversed, setting all visited locations to
                 the value UNUSED, until 'len' characters or an EOS has  been
                 passed.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 ptr


            _B_u_g_s

                 Space is not available for reuse until after garbage collec-
                 tion.  This is done to avoid pointer fragmentation.

                 'Lsfree' is used for returning strings to the free list.  It
                 is not careful with pointers, so it should usually be called
                 only  to  completely deallocate a string (i.e.  "call lsfree
                 (ptr, ALL)").

                 Locally supported.


            _S_e_e _A_l_s_o

                 lsallo (4)













            lsfree (4)                    - 1 -                    lsfree (4)