/[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 99 by ph10, Tue Mar 6 12:27: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 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_NEWLINE_ANY   Recognize any Unicode newline sequence
43      PCRE_NEWLINE_CR    Set CR as the newline sequence
44      PCRE_NEWLINE_CRLF  Set CRLF as the newline sequence
45      PCRE_NEWLINE_LF    Set LF as the newline sequence
46    PCRE_NOTBOL        Subject is not the beginning of a line    PCRE_NOTBOL        Subject is not the beginning of a line
47    PCRE_NOTEOL        Subject is not the end of a line    PCRE_NOTEOL        Subject is not the end of a line
48    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 53  The options are:
53    PCRE_DFA_SHORTEST  Return only the shortest match    PCRE_DFA_SHORTEST  Return only the shortest match
54    PCRE_DFA_RESTART   This is a restart after a partial match    PCRE_DFA_RESTART   This is a restart after a partial match
55  .sp  .sp
56  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
57  DFA algorithm is requested. Details are given in the  function. Details are given in the
58  .\" HREF  .\" HREF
59  \fBpcrematching\fP  \fBpcrematching\fP
60  .\"  .\"
# Line 61  A \fBpcre_extra\fP structure contains th Line 64  A \fBpcre_extra\fP structure contains th
64  .sp  .sp
65    \fIflags\fP        Bits indicating which fields are set    \fIflags\fP        Bits indicating which fields are set
66    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP
67    \fImatch_limit\fP  Limit on internal recursion    \fImatch_limit\fP  Limit on internal resource use
68      \fImatch_limit_recursion\fP  Limit on internal recursion depth
69    \fIcallout_data\fP Opaque data passed back to callouts    \fIcallout_data\fP Opaque data passed back to callouts
70    \fItables\fP       Points to character tables or is NULL    \fItables\fP       Points to character tables or is NULL
71  .sp  .sp
72  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,  The flag bits are PCRE_EXTRA_STUDY_DATA, PCRE_EXTRA_MATCH_LIMIT,
73  PCRE_EXTRA_CALLOUT_DATA, and PCRE_EXTRA_TABLES. For DFA matching, the  PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
74  \fImatch_limit\fP field is not used, and must not be set.  PCRE_EXTRA_TABLES. For this matching function, the \fImatch_limit\fP and
75    \fImatch_limit_recursion\fP fields are not used, and must not be set.
76  .P  .P
77  There is a complete description of the PCRE native API in the  There is a complete description of the PCRE native API in the
78  .\" HREF  .\" HREF
Legend:
Removed from v.77  
changed lines
  Added in v.99
  ViewVC Help
Powered by ViewVC 1.1.5