Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
Developer Support
QNX Documentation Library
QNX Developer Support

QNX Developer Support

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

[Previous] [Contents] [Index] [Next]

re_exec()

Execute a regular expression

Synopsis:

#include <unix.h>

int re_exec( char *s );

Arguments:

s
A pointer to the string that you want to compare to the current regular expression. This string must end with a null byte and may include newline characters.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.


Note: This function is in libc.a, but not in libc.so (in order to save space).

Description:

The re_exec() function compares the string pointed to by the string argument with the last regular expression passed to re_comp().

The re_comp() and re_exec() functions support simple regular expressions. The regular expressions of the form \{m\}, \{m,\}, or \{m,n\} aren't supported.


Note: For better portability, use regcomp(), regerror(), and regexec() instead of these functions.

Returns:

1
The string matches the last compiled regular expression.
0
The string doesn't match the last compiled regular expression.
-1
The compiled regular expression is invalid (indicating an internal error).

Classification:

Legacy Unix

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

re_comp(), regcomp(), regerror(), regexec()

grep in the Utilities Reference


[Previous] [Contents] [Index] [Next]