getwrd (2) --- get a word from a line buffer             02/04/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function getwrd (in, i, out)
                 integer in (ARB), out (ARB)
                 integer i

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Getwrd'  retrieves  the next word from the line buffer 'in'
                 at current position 'i', and places it in 'out'.  A word  is
                 a string of characters delimited by blanks or newlines (also
                 EOS,  if  the  word occurs at the end of the line).  The new
                 current position is updated in 'i', and the  length  of  the
                 word is returned as the function value.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 Any  blanks,  starting  at  the  current position 'i' in the
                 string, are skipped.  Characters from 'in' are  then  copied
                 to 'out', starting at position 'i', until the next character
                 to  be copied is either an EOS, a blank, or a NEWLINE.  When
                 this happens, the count of characters is returned.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 i, out


            _S_e_e _A_l_s_o

                 ctoc (2)






















            getwrd (2)                    - 1 -                    getwrd (2)