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(3)						     Library Functions Manual							re_comp(3)

NAME

       re_comp, re_exec - Handle regular expressions

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <regex.h>

       char *re_comp(
	       char *string);

       int re_exec(
	       char *string);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       re_comp(), re_exec():  XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Points to the string that is to be matched or converted.

DESCRIPTION

       The  re_comp()  function converts a string into an internal form suitable for pattern matching.	The re_exec() function compares the string
       pointed to by the string parameter with the last string passed to the re_comp() function.

       When the re_comp() function is passed a value of 0 (zero) or NULL, the regular expression currently being converted remains unchanged.

       Strings passed to both the re_comp() and re_exec() functions may have trailing or embedded newline characters; however, these  strings  are
       terminated by a zero byte.

       The re_comp() and re_exec() functions support simple regular expressions, which are defined in the grep(1) reference page.

NOTES

       The re_comp() and re_exec() interfaces are scheduled to be withdrawn from a future version of the X/Open CAE Specification.

       These  interfaces  are  obsolete; they are guaranteed to function properly only in the C/POSIX locale and should be avoided.  Use the POSIX
       regcomp() interface in place of re_comp() and re_exec().

RETURN VALUES

       The re_comp() function returns a value of 0 (zero) when the string pointed to by the string parameter is successfully converted; otherwise,
       an error message string is returned.

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

RELATED INFORMATION

       Functions: regcomp(3)

       Commands: grep(1)

       Standards: standards(5) delim off

																	re_comp(3)