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

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

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

revision 902 by ph10, Sat Jan 21 15:59:35 2012 UTC revision 903 by ph10, Sat Jan 21 16:37:17 2012 UTC
# Line 25  entered. Partial matching can also be us Line 25  entered. Partial matching can also be us
25  long and is not all available at once.  long and is not all available at once.
26  .P  .P
27  PCRE supports partial matching by means of the PCRE_PARTIAL_SOFT and  PCRE supports partial matching by means of the PCRE_PARTIAL_SOFT and
28  PCRE_PARTIAL_HARD options, which can be set when calling any of the matching  PCRE_PARTIAL_HARD options, which can be set when calling any of the matching
29  functions. For backwards compatibility, PCRE_PARTIAL is a synonym for  functions. For backwards compatibility, PCRE_PARTIAL is a synonym for
30  PCRE_PARTIAL_SOFT. The essential difference between the two options is whether  PCRE_PARTIAL_SOFT. The essential difference between the two options is whether
31  or not a partial match is preferred to an alternative complete match, though  or not a partial match is preferred to an alternative complete match, though
# Line 46  strings. This optimization is also disab Line 46  strings. This optimization is also disab
46  .SH "PARTIAL MATCHING USING pcre_exec() OR pcre16_exec()"  .SH "PARTIAL MATCHING USING pcre_exec() OR pcre16_exec()"
47  .rs  .rs
48  .sp  .sp
49  A partial match occurs during a call to \fBpcre_exec()\fP or  A partial match occurs during a call to \fBpcre_exec()\fP or
50  \fBpcre16_exec()\fP when the end of the subject string is reached successfully,  \fBpcre16_exec()\fP when the end of the subject string is reached successfully,
51  but matching cannot continue because more characters are needed. However, at  but matching cannot continue because more characters are needed. However, at
52  least one character in the subject must have been inspected. This character  least one character in the subject must have been inspected. This character
# Line 115  because it prefers an earlier partial ma Line 115  because it prefers an earlier partial ma
115  this reason, the assumption is made that the end of the supplied subject string  this reason, the assumption is made that the end of the supplied subject string
116  may not be the true end of the available data, and so, if \ez, \eZ, \eb, \eB,  may not be the true end of the available data, and so, if \ez, \eZ, \eb, \eB,
117  or $ are encountered at the end of the subject, the result is  or $ are encountered at the end of the subject, the result is
118  PCRE_ERROR_PARTIAL, provided that at least one character in the subject has  PCRE_ERROR_PARTIAL, provided that at least one character in the subject has
119  been inspected.  been inspected.
120  .P  .P
121  Setting PCRE_PARTIAL_HARD also affects the way UTF-8 and UTF-16  Setting PCRE_PARTIAL_HARD also affects the way UTF-8 and UTF-16
# Line 270  program to do that if it needs to. Line 270  program to do that if it needs to.
270  .P  .P
271  You can set the PCRE_PARTIAL_SOFT or PCRE_PARTIAL_HARD options with  You can set the PCRE_PARTIAL_SOFT or PCRE_PARTIAL_HARD options with
272  PCRE_DFA_RESTART to continue partial matching over multiple segments. This  PCRE_DFA_RESTART to continue partial matching over multiple segments. This
273  facility can be used to pass very long subject strings to the DFA matching  facility can be used to pass very long subject strings to the DFA matching
274  functions.  functions.
275  .  .
276  .  .
Legend:
Removed from v.902  
changed lines
  Added in v.903
webmaster@exim.org
 ViewVC Help
Powered by ViewVC 1.1.12