regcmp(1)                                               regcmp(1)



     NAME
          regcmp - regular expression compile

     SYNOPSIS
          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 - flag 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.

     EXAMPLE
          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.

     FILES
          /usr/bin/regcmp

     SEE ALSO
          regcmp(3X).














     Page 1                                        (last mod. 1/16/87)