/[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 392 by ph10, Tue Mar 17 21:30:30 2009 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_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
47      PCRE_NEWLINE_CRLF  Set CRLF as the newline sequence
48      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 50  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 61  A \fBpcre_extra\fP structure contains th Line 68  A \fBpcre_extra\fP structure contains th
68  .sp  .sp
69    \fIflags\fP        Bits indicating which fields are set    \fIflags\fP        Bits indicating which fields are set
70    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP    \fIstudy_data\fP   Opaque data from \fBpcre_study()\fP
71    \fImatch_limit\fP  Limit on internal recursion    \fImatch_limit\fP  Limit on internal resource use
72      \fImatch_limit_recursion\fP  Limit on internal recursion depth
73    \fIcallout_data\fP Opaque data passed back to callouts    \fIcallout_data\fP Opaque data passed back to callouts
74    \fItables\fP       Points to character tables or is NULL    \fItables\fP       Points to character tables or is NULL
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_CALLOUT_DATA, and PCRE_EXTRA_TABLES. For DFA matching, the  PCRE_EXTRA_MATCH_LIMIT_RECURSION, PCRE_EXTRA_CALLOUT_DATA, and
78  \fImatch_limit\fP field is not used, and must not be set.  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.
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
82  .\" HREF  .\" HREF

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

  ViewVC Help
Powered by ViewVC 1.1.5