vtoc (2) --- convert PL/I varying string to EOS-terminated string  03/23/80


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function vtoc (var, str, len)
                 integer var (ARB), len
                 character str (ARB)

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Vtoc'  is  used  to convert a PL/I character-varying string
                 into a standard Subsystem EOS-terminated string.  The  first
                 argument  is  the  character-varying string to be converted;
                 the second is a string to receive the result; the  third  is
                 the  maximum  length  of  the  result  string.  The function
                 return is the number of  characters  in  the  result  string
                 after the conversion.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Vtoc'  uses  the  standard Subsystem macro 'fpchar' to pull
                 characters from the PL/I string one at  a  time,  and  place
                 them in the result string.  Conversion stops when the result
                 string  fills  or when all the characters in the PL/I string
                 have been moved.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 str


            _S_e_e _A_l_s_o

                 other conversion routines ('cto?*' and '?*toc') (2)





















            vtoc (2)                      - 1 -                      vtoc (2)