DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

regcmp(CP)


regcmp -- regular expression compile

Syntax

regcmp [ - ] files

Description

The regcmp command performs a function similar to regcmp(S) and, in most cases, precludes the need to call regcmp(S) from C programs. This 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 will be 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 which 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(M)). Pattern searches are performed on characters, not bytes, as described on ed(C)).

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.

See also

ed(C), environ(M), regcmp(S)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003