regcmp(1)                  DG/UX 4.30                   regcmp(1)



     NAME
          regcmp - regular expression compiler

     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.

          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 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) in the Programmer's Reference for the DG/UX
          System














     Licensed material--property of copyright holder(s)         Page 1