/[pcre]/code/trunk/doc/pcre_dfa_exec.3
ViewVC logotype

Diff of /code/trunk/doc/pcre_dfa_exec.3

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 91 by nigel, Sat Feb 24 21:41:34 2007 UTC revision 392 by ph10, Tue Mar 17 21:30:30 2009 UTC
# Line 7  PCRE - Perl-compatible regular expressio Line 7  PCRE - Perl-compatible regular expressio
7  .B #include <pcre.h>  .B #include <pcre.h>
8  .PP  .PP
9  .SM  .SM
 .br  
10  .B int pcre_dfa_exec(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP,"  .B int pcre_dfa_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,
# Line 20  PCRE - Perl-compatible regular expressio Line 19  PCRE - Perl-compatible regular expressio
19  .rs  .rs
20  .sp  .sp
21  This function matches a compiled regular expression against a given subject  This function matches a compiled regular expression against a given subject
22  string, using a DFA matching algorithm (\fInot\fP Perl-compatible). Note that  string, using an alternative matching algorithm that scans the subject string
23  the main, Perl-compatible, matching function is \fBpcre_exec()\fP. The  just once (\fInot\fP Perl-compatible). Note that the main, Perl-compatible,
24  arguments for this function are:  matching function is \fBpcre_exec()\fP. The arguments for this function are:
25  .sp  .sp
26    \fIcode\fP         Points to the compiled pattern    \fIcode\fP         Points to the compiled pattern
27    \fIextra\fP        Points to an associated \fBpcre_extra\fP structure,    \fIextra\fP        Points to an associated \fBpcre_extra\fP structure,
# Line 40  arguments for this function are: Line 39  arguments for this function are:
39  The options are:  The options are:
40  .sp  .sp
41    PCRE_ANCHORED      Match only at the first position    PCRE_ANCHORED      Match only at the first position
42      PCRE_BSR_ANYCRLF   \eR matches only CR, LF, or CRLF
43      PCRE_BSR_UNICODE   \eR matches all Unicode line endings
44      PCRE_NEWLINE_ANY   Recognize any Unicode newline sequence
45      PCRE_NEWLINE_ANYCRLF  Recognize CR, LF, and CRLF as newline sequences
46    PCRE_NEWLINE_CR    Set CR as the newline sequence    PCRE_NEWLINE_CR    Set CR as the newline sequence
47    PCRE_NEWLINE_CRLF  Set CRLF as the newline sequence    PCRE_NEWLINE_CRLF  Set CRLF as the newline sequence
48    PCRE_NEWLINE_LF    Set LF as the newline sequence    PCRE_NEWLINE_LF    Set LF as the newline sequence
49    PCRE_NOTBOL        Subject is not the beginning of a line    PCRE_NOTBOL        Subject is not the beginning of a line
50    PCRE_NOTEOL        Subject is not the end of a line    PCRE_NOTEOL        Subject is not the end of a line
51    PCRE_NOTEMPTY      An empty string is not a valid match    PCRE_NOTEMPTY      An empty string is not a valid match
52      PCRE_NO_START_OPTIMIZE  Do not do "start-match" optimizations
53    PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8    PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8
54                         validity (only relevant if PCRE_UTF8                         validity (only relevant if PCRE_UTF8
55                         was set at compile time)                         was set at compile time)
# Line 53  The options are: Line 57  The options are:
57    PCRE_DFA_SHORTEST  Return only the shortest match    PCRE_DFA_SHORTEST  Return only the shortest match
58    PCRE_DFA_RESTART   This is a restart after a partial match    PCRE_DFA_RESTART   This is a restart after a partial match
59  .sp  .sp
60  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
61  DFA algorithm is requested. Details are given in the  function. Details are given in the
62  .\" HREF  .\" HREF
63  \fBpcrematching\fP  \fBpcrematching\fP
64  .\"  .\"
# Line 71  A \fBpcre_extra\fP structure contains th Line 75  A \fBpcre_extra\fP structure contains th
75  .sp  .sp
76  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
77  PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and  PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
78  PCRE_EXTRA_TABLES. For DFA matching, the \fImatch_limit\fP and  PCRE_EXTRA_TABLES. For this matching function, the \fImatch_limit\fP and
79  \fImatch_limit_recursion\fP fields are not used, and must not be set.  \fImatch_limit_recursion\fP fields are not used, and must not be set.
80  .P  .P
81  There is a complete description of the PCRE native API in the  There is a complete description of the PCRE native API in the

Legend:
Removed from v.91  
changed lines
  Added in v.392

  ViewVC Help
Powered by ViewVC 1.1.5