vtgetl (2) --- get a line from the VTH screen            07/11/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function vtgetl (str, row, column, length)
                 character str (ARB)
                 integer row, column, length

          |      Library: vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Vtgetl' transfers data from the internal screen buffer to a
                 string  supplied by the user.  'Row' and 'column' locate the
                 starting position of the input field on the screen, and  the
                 argument 'length' specifies its length.  The function return
                 is the actual length of the of the string returned in 'str'.
                 Note  that 'vtgetl' doesn't actually perform a read; it sim-
                 ply returns what is in the internal screen buffer.  'Vtread'
                 must be called beforehand to allow the user to enter data.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 A check is made to see that the  'row'  argument  is  within
                 bounds,  and  if  not,  the  string  returned is EOS and the
                 length returned is  0.   If  the  'column'  and/or  'length'
                 arguments cause a request that is off the screen, the string
                 is  truncated to the edge of the screen buffer.  Then a loop
                 simply retrieves  characters  from  the  screen  buffer  and
                 places them in 'str', and the length of the retrieved string
                 returned.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 str


            _S_e_e _A_l_s_o

                 vtread (2), and other vt?* routines (2)

















            vtgetl (2)                    - 1 -                    vtgetl (2)