unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

regcmp(1)                        User Commands                       regcmp(1)



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 out-
       put 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)  fol-
                lowed  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    "\({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 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(5).

       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 nega-
                       tive 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(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).    ATTRIBUTE   TYPEATTRIBUTE  VALUE  AvailabilitySUNWtoo
       CSIEnabled


SEE ALSO
       regcmp(3C), attributes(5), environ(5)



SunOS 5.10                        Dec 20 1996                        regcmp(1)