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)