re_exec(3) [freebsd man page]

RE_COMP(3)						   BSD Library Functions Manual 						RE_COMP(3)

NAME

     re_comp, re_exec -- regular expression handler

LIBRARY

     Compatibility Library (libcompat, -lcompat)

SYNOPSIS

     #include <unistd.h>

     char *
     re_comp(const char *s);

     int
     re_exec(const char *s);

DESCRIPTION

     This interface is made obsolete by regex(3).

     The re_comp() function compiles a string into an internal form suitable for pattern matching.  The re_exec() function checks the argument
     string against the last string passed to re_comp().

     The re_comp() function returns 0 if the string s was compiled successfully; otherwise a string containing an error message is returned.  If
     re_comp() is passed 0 or a null string, it returns without changing the currently compiled regular expression.

     The re_exec() function returns 1 if the string s matches the last compiled regular expression, 0 if the string s failed to match the last
     compiled regular expression, and -1 if the compiled regular expression was invalid (indicating an internal error).

     The strings passed to both re_comp() and re_exec() may have trailing or embedded newline characters; they are terminated by NULs.	The regu-
     lar expressions recognized are described in the manual entry for ed(1), given the above difference.

DIAGNOSTICS

     The re_exec() function returns -1 for an internal error.

     The re_comp() function returns ``no previous regular expression'' or one of the strings generated by regerror(3).

SEE ALSO

     ed(1), egrep(1), ex(1), fgrep(1), grep(1), regex(3)

HISTORY

     The re_comp() and re_exec() functions appeared in 4.0BSD.

BSD
								   June 4, 1993 							       BSD

re_comp(3C)						   Standard C Library Functions 					       re_comp(3C)

NAME

       re_comp, re_exec - compile and execute regular expressions

SYNOPSIS

       #include <re_comp.h>

       char *re_comp(const char *string);

       int re_exec(const char *string);

DESCRIPTION

       The  re_comp() function converts a regular expression string (RE) into an internal form suitable for pattern matching.  The re_exec() func-
       tion compares the string pointed to by the string argument with the last regular expression passed to re_comp().

       If re_comp() is called with a null pointer argument, the current regular expression remains unchanged.

       Strings passed to both re_comp() and re_exec() must be terminated by a null byte, and may include NEWLINE characters.

       The re_comp() and re_exec() functions support simple regular expressions, which are defined on the  regexp(5)  manual  page.  The   regular
       expressions of the form {m}, {m,}, or {m,n} are not supported.

RETURN VALUES

       The  re_comp()  function  returns a null pointer when the string pointed to by the string argument is successfully converted.  Otherwise, a
       pointer to one of the following error message strings is returned:

       No previous regular expression
       Regular expression too long
       unmatched (
       missing ]
       too many () pairs
       unmatched )

       Upon successful completion, re_exec() returns 1 if string matches the last compiled regular expression.	Otherwise, re_exec() returns 0	if
       string  fails  to  match the last compiled regular expression, and -1 if the compiled regular expression is invalid (indicating an internal
       error).

ERRORS

       No errors are defined.

USAGE

       For portability to implementations conforming to X/Open standards prior to SUS, regcomp(3C) and regexec(3C) are preferred  to  these  func-
       tions.  See standards(5).

SEE ALSO

       grep(1), regcmp(1), regcmp(3C), regcomp(3C), regexec(3C), regexpr(3GEN), regexp(5), standards(5)

SunOS 5.10							    26 Feb 1997 						       re_comp(3C)