Regexp - regular expression searching

SYNOPSIS

       #include <InterViews/regexp.h>

DESCRIPTION

       A  Regexp  encapsulates  a  regular expression pattern and
       defines operations for searching and matching the  pattern
       against  a  string.   The syntax of the regular expression
       pattern is the same as that for ed(1).  Information can be
       obtained  about  the  most  recent  match  of  the regular
       expression (and its sub-expressions).

PUBLIC OPERATIONS

       Regexp(const char* pattern)
       Regexp(const char* pattern, int length)
              Construct a new Regexp for pattern.

       int Match(const char* text, int length, int index)
              Attempt a match against text (of length length)  at
              position  index.  The return value is the length of
              the matching string, or a negative  number  if  the
              match failed.

       int Search(const char* text, int length, int index, int
              range)
              Search for a match in the string  text  (of  length
              length).   Matches  are attempted starting at posi-
              tions between index and index plus range.  If range
              is   positive   the  first  match  after  index  is
              reported.  If range is  negative  the  first  match
              before  index is reported.  The return value is the
              index of the starting position of the match,  or  a
              negative  number if there is no match in the speci-
              fied range.

       int BeginningOfMatch(int subexp)
       int EndOfMatch(int subexp)
              Return information about the most recent match.  If
              subexp   is  zero  (the  default),  information  is
              reported  for  the  complete  regular   expression.
              Other  values of subexp refer to sub-expressions in
              the pattern.  For example, if subexp is 2, informa-
              tion  is  returned for the sub-expression specified
              by the second pair of \( and \) delimiters  in  the
              pattern.

SEE ALSO

       ed(1)