14
14
.B int \fIoptions\fP, int *\fIovector\fP, int \fIovecsize\fP,
16
16
.B int *\fIworkspace\fP, int \fIwscount\fP);
18
.B int pcre16_dfa_exec(const pcre16 *\fIcode\fP, "const pcre16_extra *\fIextra\fP,"
20
.B "PCRE_SPTR16 \fIsubject\fP," int \fIlength\fP, int \fIstartoffset\fP,
22
.B int \fIoptions\fP, int *\fIovector\fP, int \fIovecsize\fP,
24
.B int *\fIworkspace\fP, int \fIwscount\fP);
21
29
This function matches a compiled regular expression against a given subject
22
30
string, using an alternative matching algorithm that scans the subject string
23
31
just once (\fInot\fP Perl-compatible). Note that the main, Perl-compatible,
24
matching function is \fBpcre_exec()\fP. The arguments for this function are:
32
matching function is \fBpcre[16]_exec()\fP. The arguments for this function
26
35
\fIcode\fP Points to the compiled pattern
27
\fIextra\fP Points to an associated \fBpcre_extra\fP structure,
36
\fIextra\fP Points to an associated \fBpcre[16]_extra\fP structure,
29
38
\fIsubject\fP Points to the subject string
30
39
\fIlength\fP Length of the subject string, in bytes
52
61
PCRE_NOTEMPTY_ATSTART An empty string at the start of the subject
53
62
is not a valid match
54
63
PCRE_NO_START_OPTIMIZE Do not do "start-match" optimizations
64
PCRE_NO_UTF16_CHECK Do not check the subject for UTF-16
65
validity (only relevant if PCRE_UTF16
66
was set at compile time)
55
67
PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8
56
68
validity (only relevant if PCRE_UTF8
57
69
was set at compile time)
76
A \fBpcre_extra\fP structure contains the following fields:
88
A \fBpcre[16]_extra\fP structure contains the following fields:
78
\fIflags\fP Bits indicating which fields are set
79
\fIstudy_data\fP Opaque data from \fBpcre_study()\fP
80
\fImatch_limit\fP Limit on internal resource use
90
\fIflags\fP Bits indicating which fields are set
91
\fIstudy_data\fP Opaque data from \fBpcre[16]_study()\fP
92
\fImatch_limit\fP Limit on internal resource use
81
93
\fImatch_limit_recursion\fP Limit on internal recursion depth
82
\fIcallout_data\fP Opaque data passed back to callouts
83
\fItables\fP Points to character tables or is NULL
94
\fIcallout_data\fP Opaque data passed back to callouts
95
\fItables\fP Points to character tables or is NULL
96
\fImark\fP For passing back a *MARK pointer
97
\fIexecutable_jit\fP Opaque data from JIT compilation
85
99
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
86
PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
87
PCRE_EXTRA_TABLES. For this matching function, the \fImatch_limit\fP and
88
\fImatch_limit_recursion\fP fields are not used, and must not be set.
100
PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA,
101
PCRE_EXTRA_TABLES, PCRE_EXTRA_MARK and PCRE_EXTRA_EXECUTABLE_JIT. For this
102
matching function, the \fImatch_limit\fP and \fImatch_limit_recursion\fP fields
103
are not used, and must not be set. The PCRE_EXTRA_EXECUTABLE_JIT flag and
104
the corresponding variable are ignored.
90
106
There is a complete description of the PCRE native API in the