tread$ (6) --- read raw words from the terminal          03/25/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function tread$ (buf, nw, f)
                 integer buf(ARB), nw
                 file_des f

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Tread$'  is  the device-dependent driver for terminal line-
                 image i/o.  The first argument is an array  to  receive  the
                 words read; the second argument is the number of words to be
                 read;  the third argument is the file descriptor of the file
                 from which data will be read.  'Tread$' returns  the  number
                 of words placed in the receiving buffer if the read was suc-
                 cessful,  EOF  otherwise.   'Tread$'  is  not  intended  for
                 general use; it is not protected from user  error,  and  may
                 cause termination of the user's program if used incorrectly.
                 It should always be referenced through 'readf'.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Tread$'  calls  the  Primos  subroutine C1IN 'nw' times, or
                 until a NEWLINE or EOF is encountered.  C1IN gets  the  next
                 character from the terminal or command input stream.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 buf


            _C_a_l_l_s

                 Primos c1in


            _B_u_g_s

          |      The  semantics  of  'tread$'  are  a little shaky; since one
          |      character per word is stored in a terminal buffer,  'tread$'
                 actually reads characters instead of raw words.


            _S_e_e _A_l_s_o

                 readf (2), dread$ (6)








            tread$ (6)                    - 1 -                    tread$ (6)