MATCH

     Returns a pattern that matches all the characters starting at the
     current character position and continuing up to and including the
     sequence of characters specified in the parameter string, range, or
     buffer.  The pattern that MATCH returns does not cross record (line)
     boundaries.

  Syntax

     pattern := MATCH ({string | range | buffer})

  Parameters

     string               A quoted string or an expression that evaluates to
                          a string.  MATCH stops matching when it finds the
                          end of this string.

     range                A range or an expression that evaluates to a
                          range.  MATCH forms a string out of the contents
                          of the range and stops matching when it reaches
                          the end of the resulting string.

     buffer               A buffer or an expression that evaluates to a
                          buffer.  MATCH forms a string out of the contents
                          of the buffer and stops matching when it reaches
                          the end of the resulting string.

  Examples

     The following assignment statement stores in pat1 a pattern that will
     match a string of characters starting with the current character
     position up to and including the characters "abc".

     pat1 := MATCH ('abc');

     The following procedure finds text within double angle brackets.  It
     moves the current character position to the beginning of the bracketed
     text, if it exists.  For example, this procedure would match the text
     <<abc>>.

     PROCEDURE user_angle_brackets
        paren_text    := '<<' + MATCH ('>>');
        found_range   := SEARCH_QUIETLY (paren_text, FORWARD, NO_EXACT);
        IF found_range = 0   ! No match
           THEN MESSAGE  ('No match found.');
           ELSE POSITION (found_range);
        ENDIF
     ENDPROCEDURE

  Related Topics

        SEARCH     SEARCH_QUIETLY