| 8 |
.PP |
.PP |
| 9 |
.SM |
.SM |
| 10 |
.br |
.br |
| 11 |
.B pcre_extra *pcre_study(const pcre *\fIcode\fR, int \fIoptions\fR, |
.B pcre_extra *pcre_study(const pcre *\fIcode\fP, int \fIoptions\fP, |
| 12 |
.ti +5n |
.ti +5n |
| 13 |
.B const char **\fIerrptr\fR); |
.B const char **\fIerrptr\fP); |
| 14 |
|
. |
| 15 |
.SH DESCRIPTION |
.SH DESCRIPTION |
| 16 |
.rs |
.rs |
| 17 |
.sp |
.sp |
| 18 |
This function studies a compiled pattern, to see if additional information can |
This function studies a compiled pattern, to see if additional information can |
| 19 |
be extracted that might speed up matching. Its arguments are: |
be extracted that might speed up matching. Its arguments are: |
| 20 |
|
.sp |
| 21 |
\fIcode\fR A compiled regular expression |
\fIcode\fP A compiled regular expression |
| 22 |
\fIoptions\fR Options for \fBpcre_study()\fR |
\fIoptions\fP Options for \fBpcre_study()\fP |
| 23 |
\fIerrptr\fR Where to put an error message |
\fIerrptr\fP Where to put an error message |
| 24 |
|
.sp |
| 25 |
|
If the function succeeds, it returns a value that can be passed to |
| 26 |
|
\fBpcre_exec()\fP via its \fIextra\fP argument. |
| 27 |
|
.P |
| 28 |
If the function returns NULL, either it could not find any additional |
If the function returns NULL, either it could not find any additional |
| 29 |
information, or there was an error. You can tell the difference by looking at |
information, or there was an error. You can tell the difference by looking at |
| 30 |
the error value. It is NULL in first case. |
the error value. It is NULL in first case. |
| 31 |
|
.P |
| 32 |
There are currently no options defined; the value of the second argument should |
There are currently no options defined; the value of the second argument should |
| 33 |
always be zero. |
always be zero. |
| 34 |
|
.P |
| 35 |
There is a complete description of the PCRE API in the |
There is a complete description of the PCRE native API in the |
| 36 |
|
.\" HREF |
| 37 |
|
\fBpcreapi\fP |
| 38 |
|
.\" |
| 39 |
|
page and a description of the POSIX API in the |
| 40 |
.\" HREF |
.\" HREF |
| 41 |
\fBpcreapi\fR |
\fBpcreposix\fP |
| 42 |
.\" |
.\" |
| 43 |
page. |
page. |