/[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 77 by nigel, Sat Feb 24 21:40:45 2007 UTC revision 93 by nigel, Sat Feb 24 21:41:42 2007 UTC
# Line 1  Line 1 
1  .TH PCRE 3  .TH PCRE_DFA_EXEC 3
2  .SH NAME  .SH NAME
3  PCRE - Perl-compatible regular expressions  PCRE - Perl-compatible regular expressions
4  .SH SYNOPSIS  .SH SYNOPSIS
# Line 20  PCRE - Perl-compatible regular expressio Line 20  PCRE - Perl-compatible regular expressio
20  .rs  .rs
21  .sp  .sp
22  This function matches a compiled regular expression against a given subject  This function matches a compiled regular expression against a given subject
23  string, using a DFA matching algorithm (\fInot\fP Perl-compatible). Note that  string, using an alternative matching algorithm that scans the subject string
24  the main, Perl-compatible, matching function is \fBpcre_exec()\fP. The  just once (\fInot\fP Perl-compatible). Note that the main, Perl-compatible,
25  arguments for this function are:  matching function is \fBpcre_exec()\fP. The arguments for this function are:
26  .sp  .sp
27    \fIcode\fP         Points to the compiled pattern    \fIcode\fP         Points to the compiled pattern
28    \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 40  arguments for this function are:
40  The options are:  The options are:
41  .sp  .sp
42    PCRE_ANCHORED      Match only at the first position    PCRE_ANCHORED      Match only at the first position
43      PCRE_NEWLINE_ANY   Recognize any Unicode newline sequence
44      PCRE_NEWLINE_CR    Set CR as the newline sequence
45      PCRE_NEWLINE_CRLF  Set CRLF as the newline sequence
46      PCRE_NEWLINE_LF    Set LF as the newline sequence
47    PCRE_NOTBOL        Subject is not the beginning of a line    PCRE_NOTBOL        Subject is not the beginning of a line
48    PCRE_NOTEOL        Subject is not the end of a line    PCRE_NOTEOL        Subject is not the end of a line
49    PCRE_NOTEMPTY      An empty string is not a valid match    PCRE_NOTEMPTY      An empty string is not a valid match
# Line 50  The options are: Line 54  The options are:
54    PCRE_DFA_SHORTEST  Return only the shortest match    PCRE_DFA_SHORTEST  Return only the shortest match
55    PCRE_DFA_RESTART   This is a restart after a partial match    PCRE_DFA_RESTART   This is a restart after a partial match
56  .sp  .sp
57  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
58  DFA algorithm is requested. Details are given in the  function. Details are given in the
59  .\" HREF  .\" HREF
60  \fBpcrematching\fP  \fBpcrematching\fP
61  .\"  .\"
# Line 61  A \fBpcre_extra\fP structure contains th Line 65  A \fBpcre_extra\fP structure contains th
65  .sp  .sp
66    \fIflags\fP        Bits indicating which fields are set    \fIflags\fP        Bits indicating which fields are set
67    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP
68    \fImatch_limit\fP  Limit on internal recursion    \fImatch_limit\fP  Limit on internal resource use
69      \fImatch_limit_recursion\fP  Limit on internal recursion depth
70    \fIcallout_data\fP Opaque data passed back to callouts    \fIcallout_data\fP Opaque data passed back to callouts
71    \fItables\fP       Points to character tables or is NULL    \fItables\fP       Points to character tables or is NULL
72  .sp  .sp
73  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
74  PCRE_EXTRA_CALLOUT_DATA, and PCRE_EXTRA_TABLES. For DFA matching, the  PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
75  \fImatch_limit\fP field is not used, and must not be set.  PCRE_EXTRA_TABLES. For this matching function, the \fImatch_limit\fP and
76    \fImatch_limit_recursion\fP fields are not used, and must not be set.
77  .P  .P
78  There is a complete description of the PCRE native API in the  There is a complete description of the PCRE native API in the
79  .\" HREF  .\" HREF

Legend:
Removed from v.77  
changed lines
  Added in v.93

webmaster@exim.org
ViewVC Help
Powered by ViewVC 1.1.12