xref: /illumos-gate/usr/src/man/man1/regcmp.1 (revision bbf21555)
te
Copyright 1989 AT&T Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
REGCMP 1 "Dec 20, 1996"
NAME
regcmp - regular expression compile
SYNOPSIS

regcmp [-] filename...
DESCRIPTION

The regcmp command performs a function similar to regcmp and, in most cases, precludes the need for calling regcmp from C programs. Bypassing regcmp saves on both execution time and program size. The command regcmp compiles the regular expressions in filename and places the output in filename.i.

OPTIONS
-

If the - option is used, the output is placed in filename.c. The format of entries in filename 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 is C source code. Compiled regular expressions are represented as extern char vectors. filename.i files may thus be #included in C programs, or filename.c files may be compiled and later loaded. In the C program that uses the regcmp output, regex(abc,line) applies the regular expression named abc to line. Diagnostics are self-explanatory.

EXAMPLES

Example 1 Examples of the regcmp command. name

"([A-Za-z][A-Za-z0-9_]*)$0"

telno

"\|\e({0,1}([2-9][01][1-9])$0\e){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 output,

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

applies the regular expression named telno to line.

ENVIRONMENT VARIABLES

A general description of the usage of the LC_* environmental variables can be found in environ(7). LC_CTYPE

Determines how regcmp handles characters. When LC_CTYPE is set to a valid value, regcmp can display and handle text and filenames containing valid characters for that locale.

LC_MESSAGES

Determines how diagnostic and informative messages are presented. This includes the language and style of the messages, and the correct form of affirmative and negative responses. In the "C" locale, the messages are presented in the default form found in the program itself (in most cases, U.S. English).

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
CSI Enabled
SEE ALSO

regcmp (3C), attributes (7), environ (7)