Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

regex(3) OSS Library Calls Reference Manual
(...)$n Returns the value of the enclosed regular expression (subexpression). The value
is stored in the location pointed to by the n+1th parameter in the se0, ... list
where n is a single digit. If there are fewer than n parameters in this list, the
behavior of regex( ) is undefined. A maximum of ten enclosed regular expres-
sions are allowed.
(...) Groups a regular expression. A regular expression in parentheses can be fol-
lowed by an operator like *, +, or {}. These operators have the same effect on a
group regular expression as they do on a single character.
All of these regular expression symbols are special characters. To use them as themselves, you
must escape them by preceding them with a backslash.
NOTES
The behavior of this function in locales other than POSIX is undefined.
This function can be called by native processes only.
CAUTIONS
Be sure to specify enough parameters in the se0, ... list to store the subexpressions being returned
by (...)$n. If not enough parameters are specified or there is not enough space in the location
pointed to by a given parameter to hold the returned subexpression, the results are undefined.
RETURN VALUES
On successful completion, the regex( ) function returns a pointer to the next unmatched character
in the string pointed to by subject. Otherwise, it returns a null pointer.
ERRORS
The regex() function does not return errors.
RELATED INFORMATION
Functions: re_comp(3), re_exec(3), regcmp(3), regcomp(3).
STANDARDS CONFORMANCE
The regcmp( ) function is defined in the XPG4 Version 2 specification.
5−172 Hewlett-Packard Company 527187-017