omatch (2) --- try to match a single pattern element     01/07/83


            _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function omatch (lin, i, pat, j)
                 character lin (ARB), pat (MAXPAT)
                 integer i, j

                 Library:  vswtlb (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Omatch'  attempts  to  match  a  single  pattern element at
                 "pat(j)" against a character at "lin(i)".  If the match suc-
                 ceeds, 'i' is incremented to point to  the  next  unexamined
                 character  in 'lin'.  The function return is YES if the pat-
                 tern element matched the text, NO otherwise.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Omatch' is essentially a case statement, treating each pat-
                 tern element specially.  Non-special characters are directly
                 compared.  The wild-card character matches  any  non-NEWLINE
                 character  in 'lin'.  Beginning-of-line is matched only when
          |      'i' is one.  End-of-line is matched only when "lin(i)" is  a
          |      NEWLINE  or  an  EOS.   'Locate'  is used to match character
                 classes.  If a character is matched, 'i' is  incremented  by
                 one.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 i


            _C_a_l_l_s

          *      locate, error


            _S_e_e _A_l_s_o

                 match (2), amatch (2), locate (2)















            omatch (2)                    - 1 -                    omatch (2)