REGCMP(1)							     REGCMP(1)

NAME    [Toc]    [Back]

     regcmp - regular expression compile

SYNOPSIS    [Toc]    [Back]

     regcmp [ -	] files

DESCRIPTION    [Toc]    [Back]

     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 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	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    [Toc]    [Back]

     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    [Toc]    [Back]

     regcmp(3G).


									PPPPaaaaggggeeee 1111