REGCMP(1)                            SysV                            REGCMP(1)



NAME
     regcmp - regular expression compile

SYNOPSIS
     regcmp [ - ] files

DESCRIPTION
     The regcmp command performs a function similar to regcmp(3X) and, in most
     cases, precludes the need for calling regcmp(3X) from C programs.  This
     saves on both execution time and program size.  The regcmp command
     compiles the regular expressions in file and places the output in file.i.
     If a simple dash (-) is used in place of a filename, regcmp directs the
     output to file.c.  The format of entries in file is a name (C variable),
     followed by one or more blanks, followed by a regular expression enclosed
     in double quotes.  The output of regcmp is C source code.  Compiled
     regular expressions are represented as extern char vectors.  All 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) will apply the regular expression named abc to line.
     Diagnostics are self-explanatory.

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"

     In the C program that uses the regcmp output,

          regex(telno, line, area, exch, rest)

     will apply the regular expression named telno to line.

SEE ALSO
     regcmp(3X).