


      REGCMP(1)                   (UNIX 5.0)                  REGCMP(1)



      NAME
           regcmp - regular expression compile

      SYNTAX
           regcmp [ - ] files

      DESCRIPTION
           Regcmp, in most cases, precludes the need for calling
           regcmp(3X) 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 a
           regular expression 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 into C programs, or file.c files may be compiled
           and later loaded.  In the C program which 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).


















      Page 1                                          (73 A2 02MT REV1)



