| 8 |
.PP |
.PP |
| 9 |
.SM |
.SM |
| 10 |
.br |
.br |
| 11 |
.B pcre *pcre_compile(const char *\fIpattern\fR, int \fIoptions\fR, |
.B pcre *pcre_compile(const char *\fIpattern\fP, int \fIoptions\fP, |
| 12 |
.ti +5n |
.ti +5n |
| 13 |
.B const char **\fIerrptr\fR, int *\fIerroffset\fR, |
.B const char **\fIerrptr\fP, int *\fIerroffset\fP, |
| 14 |
.ti +5n |
.ti +5n |
| 15 |
.B const unsigned char *\fItableptr\fR); |
.B const unsigned char *\fItableptr\fP); |
| 16 |
|
. |
| 17 |
.SH DESCRIPTION |
.SH DESCRIPTION |
| 18 |
.rs |
.rs |
| 19 |
.sp |
.sp |
| 20 |
This function compiles a regular expression into an internal form. Its |
This function compiles a regular expression into an internal form. Its |
| 21 |
arguments are: |
arguments are: |
| 22 |
|
.sp |
| 23 |
\fIpattern\fR A zero-terminated string containing the |
\fIpattern\fR A zero-terminated string containing the |
| 24 |
regular expression to be compiled |
regular expression to be compiled |
| 25 |
\fIoptions\fR Zero or more option bits |
\fIoptions\fR Zero or more option bits |
| 27 |
\fIerroffset\fR Offset in pattern where error was found |
\fIerroffset\fR Offset in pattern where error was found |
| 28 |
\fItableptr\fR Pointer to character tables, or NULL to |
\fItableptr\fR Pointer to character tables, or NULL to |
| 29 |
use the built-in default |
use the built-in default |
| 30 |
|
.sp |
| 31 |
The option bits are: |
The option bits are: |
| 32 |
|
.sp |
| 33 |
PCRE_ANCHORED Force pattern anchoring |
PCRE_ANCHORED Force pattern anchoring |
| 34 |
|
PCRE_AUTO_CALLOUT Compile automatic callouts |
| 35 |
PCRE_CASELESS Do caseless matching |
PCRE_CASELESS Do caseless matching |
| 36 |
PCRE_DOLLAR_ENDONLY $ not to match newline at end |
PCRE_DOLLAR_ENDONLY $ not to match newline at end |
| 37 |
PCRE_DOTALL . matches anything including NL |
PCRE_DOTALL . matches anything including NL |
| 46 |
PCRE_NO_UTF8_CHECK Do not check the pattern for UTF-8 |
PCRE_NO_UTF8_CHECK Do not check the pattern for UTF-8 |
| 47 |
validity (only relevant if |
validity (only relevant if |
| 48 |
PCRE_UTF8 is set) |
PCRE_UTF8 is set) |
| 49 |
|
.sp |
| 50 |
PCRE must be compiled with UTF-8 support in order to use PCRE_UTF8 |
PCRE must be built with UTF-8 support in order to use PCRE_UTF8 and |
| 51 |
(or PCRE_NO_UTF8_CHECK). |
PCRE_NO_UTF8_CHECK. |
| 52 |
|
.P |
| 53 |
The yield of the function is a pointer to a private data structure that |
The yield of the function is a pointer to a private data structure that |
| 54 |
contains the compiled pattern, or NULL if an error was detected. |
contains the compiled pattern, or NULL if an error was detected. |
| 55 |
|
.P |
| 56 |
There is a complete description of the PCRE API in the |
There is a complete description of the PCRE native API in the |
| 57 |
.\" HREF |
.\" HREF |
| 58 |
\fBpcreapi\fR |
\fBpcreapi\fR |
| 59 |
.\" |
.\" |
| 60 |
|
page and a description of the POSIX API in the |
| 61 |
|
.\" HREF |
| 62 |
|
\fBpcreposix\fR |
| 63 |
|
.\" |
| 64 |
page. |
page. |