www.LinuxHowtos.org

re_comp

Section: C Library Functions (3)
Updated: 202-0-08
Index Return to Main Contents

NAME

re_comp, re_exec - BSD regex functions

LIBRARY

Standard C library (libc,~-lc)

SYNOPSIS

#define _REGEX_RE_COMP
#include <sys/types.h>
#include <regex.h>
[[deprecated]] char *re_comp(const char *regex);
[[deprecated]] int re_exec(const char *string);

DESCRIPTION

re_comp() is used to compile the nul-terminated regular expression pointed to by regex. The compiled pattern occupies a static area, the pattern buffer, which is overwritten by subsequent use of re_comp(). If regex is NULL, no operation is performed and the pattern buffer's contents are not altered. re_exec() is used to assess whether the nul-terminated string pointed to by string matches the previously compiled regex.

RETURN VALUE

re_comp() returns NULL on successful compilation of regex otherwise it returns a pointer to an appropriate error message. re_exec() returns 1 for a successful match, zero for failure.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
re_comp(), re_exec()	Thread safety	M-Unsafe

STANDARDS

None.

HISTORY

4.3BSD. These functions are obsolete; the functions documented in regcomp(3) should be used instead.