NAME

       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
              positions 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
              specified 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,  information  is  returned  for  the  sub-expression
              specified by the second pair of \( and \) delimiters in the pattern.

SEE ALSO

       ed(1)

InterViews                                         23 May 1989                                        Regexp(3I)