

            maksub (2) --- make substitution string                  01/07/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function maksub (arg, from, delim, sub)
                 character arg (ARB), delim, sub (MAXPAT)
                 integer from

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Maksub'  converts  the  character  representation of a sub-
                 stitution string starting at "arg(from)"  into  an  internal
                 form   in   'sub'.    Conversion  proceeds  until  there  is
                 insufficient room in 'sub' to proceed or until the character
                 in 'delim' is encountered.  The function return is the  next
                 unexamined position in 'arg'.

                 For a full discussion of the syntax of substitution strings,
                 see either _I_n_t_r_o_d_u_c_t_i_o_n _t_o _t_h_e _S_o_f_t_w_a_r_e _T_o_o_l_s _T_e_x_t _E_d_i_t_o_r or
                 _S_o_f_t_w_a_r_e _T_o_o_l_s.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 Straightforward   scan   of  the  substitution  string.   At
                 present,  the  metacharacter  sequences  in  a  substitution
                 string  are  "&" (meaning the string matched) and "@<digit>"
                 (meaning the <digit>th tagged subpattern matched).  'Esc' is
                 used to handle escape sequences; all  other  characters  are
                 substituted literally.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 sub


            _C_a_l_l_s

                 addset, esc, type


            _S_e_e _A_l_s_o

                 makpat  (2),  addset  (2),  change  (1),  ed  (1),  se  (1),
                 _I_n_t_r_o_d_u_c_t_i_o_n _t_o _t_h_e _S_o_f_t_w_a_r_e  _T_o_o_l_s  _T_e_x_t  _E_d_i_t_o_r,  _S_o_f_t_w_a_r_e
                 _T_o_o_l_s.










            maksub (2)                    - 1 -                    maksub (2)


