The S-Lang library includes a regular expression (RE) package that may be used by an application embedding the library. The RE syntax should be familiar to anyone acquainted with regular expressions. In this section the syntax of the S-Lang regular expressions is discussed.
NOTE: At the moment, the S-Lang regular expressions do not support
UTF-8 encoded strings. The S-Lang library will most likely migrate
to the use of the PCRE regular expression library, deprecating the
use of the S-Lang REs in the process. For these reasons, the user is
encouraged to make use of the pcre module if possible.
A regular expression specifies a pattern to be matched against a string, and has the property that the contcatenation of two REs is also a RE.
The S-Lang library supports the following standard regular expressions:
. match any character except newline
* matches zero or more occurrences of previous RE
+ matches one or more occurrences of previous RE
? matches zero or one occurrence of previous RE
^ matches beginning of a line
$ matches end of line
[ ... ] matches any single character between brackets.
For example, [-02468] matches `-' or any even digit.
and [-0-9a-z] matches `-' and any digit between 0 and 9
as well as letters a through z.
\< Match the beginning of a word.
\> Match the end of a word.
\( ... \)
\1, \2, ..., \9 Matches the match specified by nth \( ... \)
expression.
\c turn on case-sensitivity (default)
\C turn off case-sensitivity
\d match any digit
\e match ESC char
"^int " matches the "int " at the beginning of a line.
"\<money\>" matches "money" but only if it appears
as a separate word.
"^$" matches an empty line.
A more complex pattern is
"\(\<[a-zA-Z]+\>\)[ ]+\1\>"
\( and \) are used to define the text
matched by the enclosed regular expression, and then subsequently
referred to \1.
Finally, remember that when used in string literals either in the
S-Lang language or in the C language, care must be taken to
"double-up" the '\' character since both languages treat it
as an escape character.
There are several differences between S-Lang regular expressions and, e.g., egrep regular expressions.
The most notable difference is that the S-Lang regular expressions do
not support the OR operator | in expressions. This means
that "a|b" or "a\|b" do not have the meaning that they
have in regular expression packages that support egrep-style
expressions.
The other main difference is that while S-Lang regular expressions
support the grouping operators \( and \), they are
only used as a means of specifying the text that is matched. That
is, the expression
"@\([a-z]*\)@.*@\1@"
"xxx@abc@silly@abc@yyy", where the pattern \1
matches the text enclosed by the \( and \)
expressions. However, in the current implementation, the grouping
operators are not used to group regular expressions to form a single
regular expression. Thus expression such as "\(hello\)*" is
not a pattern to match zero or more occurrences of "hello"
as it is in e.g., egrep.
One question that comes up from time to time is why doesn't S-Lang simply employ some posix-compatible regular expression library. The simple answer is that, at the time of this writing, none exists that is available across all the platforms that the S-Lang library supports (Unix, VMS, OS/2, win32, win16, BEOS, MSDOS, and QNX) and can be distributed under both the GNU licenses. It is particularly important that the library and the interpreter support a common set of regular expressions in a platform independent manner.