regcmp(1)                 (Advanced C Utilities)                  regcmp(1)


   NAME
         regcmp - regular expression compile

   SYNOPSIS
         regcmp [-] file...

   DESCRIPTION
         The regcmp(1) command performs a function similar to regcmp(3C) and,
         in most cases, precludes the need for calling regcmp(3C) from C
         programs.  Bypassing regcmp(3C) saves on both execution time and
         program size.  The command regcmp(1) compiles the regular expressions
         in file and places the output in file.i.  If the - option is used,
         the output is 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(1) 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 that uses the regcmp(1) output,
         regex(abc,line) applies 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"

         The three arguments to telno shown above must all be entered on one
         line.

         In the C program that uses the regcmp(1) output,

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

         applies the regular expression named telno to line.

   SEE ALSO
         regcmp(3G)













   7/91                                                                 Page 1