getkwd (2) --- look for keyword/value arguments          03/23/80


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function getkwd (keyword, value, length, default)
                 character keyword (ARB), value (ARB), default (ARB)
                 integer length

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Getkwd' searches the list of arguments supplied on the com-
                 mand  line  for  a  string  that  matches  the  contents  of
                 'keyword'.  'Keyword' must contain an EOS-terminated string.
                 If a matching argument is found, the  argument  string  that
                 immediately  follows  it in the argument list is returned in
                 the  array  'value';  otherwise,  the  string  contained  in
                 'default'  is  copied  into  'value'.   In  either case, the
                 length of the string returned in 'value' (excluding EOS)  is
                 returned  as the result of the function.  'Length' gives the
                 size of the 'value' array in words; no more than  'length'-1
                 characters will be copied.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Getarg'  is  called  to  access  each  successive  argument
                 string.  Each is compared to the supplied keyword, and if  a
                 match  is  found,  'getarg'  is called again to retrieve the
                 immediately following argument.  If  that  argument  doesn't
                 exist or if the keyword is not found, as much of the default
                 string  as  will  fit  is copied into the 'value' array, one
                 character at a time.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 value


            _C_a_l_l_s

                 equal, getarg


            _S_e_e _A_l_s_o

                 chkarg (2), getarg (2)










            getkwd (2)                    - 1 -                    getkwd (2)