regcmp(1)
regcmp --
regular expression compile
Synopsis
regcmp [-] file . . .
Description
The
regcmp
command performs a function similar to
regcmp
and, in most cases, precludes
the need for calling
regcmp
from C programs.
Bypassing
regcmp
saves on both execution time and program size.
The command
regcmp
compiles the regular expressions in
file
and places the output in
file.i.
If the -
option is used, the output is placed in
file.c.
The format of entries in
file
is a name (C variable) followed by one or more blanks followed by
one or more regular expressions enclosed in double quotes.
The output of
regcmp
is C source code.
Compiled regular expressions are represented as
extern char
vectors.
file.i
files may thus be
#included
in C programs, or
file.c
files may be compiled and later loaded.
In the C program that uses the
regcmp
output,
regex(abc,line)
applies the regular expression named
abc
to
line.
Diagnostics are self-explanatory.
regcmp processes supplementary code set characters in files
according to the locale specified in the LC_CTYPE
environment variable (see LANG on
environ(5)).
Pattern searches are performed
on characters, not bytes, as described on
ed(1).
A backslash in the input quotes the next character(s).
The recognized characters that can follow a backslash are n, t, r, b, up to
three octal digits, and another backslash. Any other character is sent
through unchanged, but the backslash is removed.
Examples
name "([A-Za-z][A-Za-z0-9_])$0"
telno "\\({0,1}([2-9][01][1-9])$0\\){0,1} "
"([2-9][0-9]{2})$1[-]{0,1}"
"([0-9]{4})$2"
The three arguments to telno
shown above must all be entered on one line.
In the C program that uses the regcmp output,
regex(telno, line, area, exch, rest)
applies the regular expression named telno to line.
References
ed(1),
regcmp(3G)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004