gvlarg (2) --- obtain the value of a key-letter argument  01/07/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function gvlarg (str, state)
                 character str (ARB)
                 integer state (4)

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Gvlarg'  returns  the  next  argument and updates the state
                 vector; it is normally used in conjunction with 'gklarg' and
                 'gfnarg'.  If  the  next  argument  begins  with  a  hyphen,
                 'gvlarg'  returns  an empty string.  'Gvlarg' returns EOF if
                 the argument list has been exhausted; otherwise  it  returns
                 OK.

                 'Gvlarg'  exists  solely  to hide the structure of the state
                 vector when an argument must be  fetched  between  calls  to
                 'gklarg' and 'gfnarg'.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 Trivial.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 str, state


            _C_a_l_l_s

                 error, getarg


            _S_e_e _A_l_s_o

                 gfnarg (2), gklarg (2)

















            gvlarg (2)                    - 1 -                    gvlarg (2)