lsgetf (4) --- read an arbitrarily long linked string    01/03/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function lsgetf (ptr, fd)
                 pointer ptr
                 file_des fd

                 Library:  vlslb


            _F_u_n_c_t_i_o_n

                 'Lsgetf'  reads  characters  from the file specified by 'fd'
                 into a linked string until a NEWLINE character is  read.   A
                 pointer  to  the  string is returned in 'ptr'.  The function
                 value is the number of characters read, or  EOF  if  end-of-
                 file was encountered before a NEWLINE was seen.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 A  new  string  of  zero  length is allocated with a call to
                 'lsallo' and 'ptr' is set to point to it.  Subroutine  'get-
                 lin'  is  then  called  repeatedly  until  a line whose last
                 character (before the EOS) is a NEWLINE is returned, or end-
                 of-file is encountered.  Each line returned is  then  joined
                 to the end of the linked string with a call to 'lsjoin'.  If
                 EOF  is  encountered  before  a  NEWLINE is seen, the entire
                 string is deallocated with a call to 'lsfree'.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 ptr


            _C_a_l_l_s

                 getlin, lsallo, lsjoin, lsmake, lspos


            _B_u_g_s

                 Locally supported.


            _S_e_e _A_l_s_o

                 lsputf (4)










            lsgetf (4)                    - 1 -                    lsgetf (4)