| 29 |
</b><br> |
</b><br> |
| 30 |
<P> |
<P> |
| 31 |
This function matches a compiled regular expression against a given subject |
This function matches a compiled regular expression against a given subject |
| 32 |
string, using a DFA matching algorithm (<i>not</i> Perl-compatible). Note that |
string, using an alternative matching algorithm that scans the subject string |
| 33 |
the main, Perl-compatible, matching function is <b>pcre_exec()</b>. The |
just once (<i>not</i> Perl-compatible). Note that the main, Perl-compatible, |
| 34 |
arguments for this function are: |
matching function is <b>pcre_exec()</b>. The arguments for this function are: |
| 35 |
<pre> |
<pre> |
| 36 |
<i>code</i> Points to the compiled pattern |
<i>code</i> Points to the compiled pattern |
| 37 |
<i>extra</i> Points to an associated <b>pcre_extra</b> structure, |
<i>extra</i> Points to an associated <b>pcre_extra</b> structure, |
| 49 |
The options are: |
The options are: |
| 50 |
<pre> |
<pre> |
| 51 |
PCRE_ANCHORED Match only at the first position |
PCRE_ANCHORED Match only at the first position |
| 52 |
|
PCRE_NEWLINE_ANY Recognize any Unicode newline sequence |
| 53 |
PCRE_NEWLINE_CR Set CR as the newline sequence |
PCRE_NEWLINE_CR Set CR as the newline sequence |
| 54 |
PCRE_NEWLINE_CRLF Set CRLF as the newline sequence |
PCRE_NEWLINE_CRLF Set CRLF as the newline sequence |
| 55 |
PCRE_NEWLINE_LF Set LF as the newline sequence |
PCRE_NEWLINE_LF Set LF as the newline sequence |
| 63 |
PCRE_DFA_SHORTEST Return only the shortest match |
PCRE_DFA_SHORTEST Return only the shortest match |
| 64 |
PCRE_DFA_RESTART This is a restart after a partial match |
PCRE_DFA_RESTART This is a restart after a partial match |
| 65 |
</pre> |
</pre> |
| 66 |
There are restrictions on what may appear in a pattern when matching using the |
There are restrictions on what may appear in a pattern when using this matching |
| 67 |
DFA algorithm is requested. Details are given in the |
function. Details are given in the |
| 68 |
<a href="pcrematching.html"><b>pcrematching</b></a> |
<a href="pcrematching.html"><b>pcrematching</b></a> |
| 69 |
documentation. |
documentation. |
| 70 |
</P> |
</P> |
| 80 |
</pre> |
</pre> |
| 81 |
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT, |
The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT, |
| 82 |
PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and |
PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and |
| 83 |
PCRE_EXTRA_TABLES. For DFA matching, the <i>match_limit</i> and |
PCRE_EXTRA_TABLES. For this matching function, the <i>match_limit</i> and |
| 84 |
<i>match_limit_recursion</i> fields are not used, and must not be set. |
<i>match_limit_recursion</i> fields are not used, and must not be set. |
| 85 |
</P> |
</P> |
| 86 |
<P> |
<P> |