dread$ (6) --- read raw words from disk                  02/24/82


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

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

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Dread$'  is an internal Subsystem routine that performs the
                 function of 'readf' for disk files only.  The first argument
                 specifies a string to receive the  words  read;  the  second
                 argument  is  the number of words to be read; and, the third
                 argument is the file descriptor of the file from which  data
                 will  be  read.  'Dread$' returns the number of words placed
                 in the receiving buffer if  the  read  was  successful;  EOF
                 otherwise.   'Dread$' 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

                 'Dread$' calls the Primos subroutine PRWF$$ to fill a buffer
                 with words from disk file 'f'.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 buf


            _C_a_l_l_s

                 move$, Primos prwf$$


            _B_u_g_s

                 EOF  is  returned  if  any  error  occurs;  the  user is not
                 informed of the actual error that occurs.


            _S_e_e _A_l_s_o

                 readf (2)









            dread$ (6)                    - 1 -                    dread$ (6)