REGCMP(1)            INTERACTIVE UNIX System            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 command regcmp compiles the reg-
               ular 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 vari-
               able) 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 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) 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).

















          Rev. C Software Development Set                            Page 1