| 7 |
.B #include <pcre.h> |
.B #include <pcre.h> |
| 8 |
.PP |
.PP |
| 9 |
.SM |
.SM |
|
.br |
|
| 10 |
.B int pcre_exec(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP," |
.B int pcre_exec(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP," |
| 11 |
.ti +5n |
.ti +5n |
| 12 |
.B "const char *\fIsubject\fP," int \fIlength\fP, int \fIstartoffset\fP, |
.B "const char *\fIsubject\fP," int \fIlength\fP, int \fIstartoffset\fP, |
| 34 |
The options are: |
The options are: |
| 35 |
.sp |
.sp |
| 36 |
PCRE_ANCHORED Match only at the first position |
PCRE_ANCHORED Match only at the first position |
| 37 |
|
PCRE_BSR_ANYCRLF \eR matches only CR, LF, or CRLF |
| 38 |
|
PCRE_BSR_UNICODE \eR matches all Unicode line endings |
| 39 |
|
PCRE_NEWLINE_ANY Recognize any Unicode newline sequence |
| 40 |
|
PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences |
| 41 |
|
PCRE_NEWLINE_CR Set CR as the newline sequence |
| 42 |
|
PCRE_NEWLINE_CRLF Set CRLF as the newline sequence |
| 43 |
|
PCRE_NEWLINE_LF Set LF as the newline sequence |
| 44 |
PCRE_NOTBOL Subject is not the beginning of a line |
PCRE_NOTBOL Subject is not the beginning of a line |
| 45 |
PCRE_NOTEOL Subject is not the end of a line |
PCRE_NOTEOL Subject is not the end of a line |
| 46 |
PCRE_NOTEMPTY An empty string is not a valid match |
PCRE_NOTEMPTY An empty string is not a valid match |
| 47 |
|
PCRE_NO_START_OPTIMIZE Do not do "start-match" optimizations |
| 48 |
PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8 |
PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8 |
| 49 |
validity (only relevant if PCRE_UTF8 |
validity (only relevant if PCRE_UTF8 |
| 50 |
was set at compile time) |
was set at compile time) |
| 51 |
PCRE_PARTIAL Return PCRE_ERROR_PARTIAL for a partial match |
PCRE_PARTIAL Return PCRE_ERROR_PARTIAL for a partial match |
| 52 |
.sp |
.sp |
| 53 |
There are restrictions on what may appear in a pattern when partial matching is |
For details of partial matching, see the |
| 54 |
requested. |
.\" HREF |
| 55 |
|
\fBpcrepartial\fP |
| 56 |
|
.\" |
| 57 |
|
page. |
| 58 |
.P |
.P |
| 59 |
A \fBpcre_extra\fP structure contains the following fields: |
A \fBpcre_extra\fP structure contains the following fields: |
| 60 |
.sp |
.sp |
| 61 |
\fIflags\fP Bits indicating which fields are set |
\fIflags\fP Bits indicating which fields are set |
| 62 |
\fIstudy_data\fP Opaque data from \fBpcre_study()\fP |
\fIstudy_data\fP Opaque data from \fBpcre_study()\fP |
| 63 |
\fImatch_limit\fP Limit on internal recursion |
\fImatch_limit\fP Limit on internal resource use |
| 64 |
|
\fImatch_limit_recursion\fP Limit on internal recursion depth |
| 65 |
\fIcallout_data\fP Opaque data passed back to callouts |
\fIcallout_data\fP Opaque data passed back to callouts |
| 66 |
\fItables\fP Points to character tables or is NULL |
\fItables\fP Points to character tables or is NULL |
| 67 |
.sp |
.sp |
| 68 |
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT, |
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT, |
| 69 |
PCRE_EXTRA_CALLOUT_DATA, and PCRE_EXTRA_TABLES. |
PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and |
| 70 |
|
PCRE_EXTRA_TABLES. |
| 71 |
.P |
.P |
| 72 |
There is a complete description of the PCRE native API in the |
There is a complete description of the PCRE native API in the |
| 73 |
.\" HREF |
.\" HREF |