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

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

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

revision 902 by ph10, Sat Jan 14 11:16:23 2012 UTC revision 903 by ph10, Sat Jan 21 16:37:17 2012 UTC
# Line 50  long and is not all available at once. Line 50  long and is not all available at once.
50  </P>  </P>
51  <P>  <P>
52  PCRE supports partial matching by means of the PCRE_PARTIAL_SOFT and  PCRE supports partial matching by means of the PCRE_PARTIAL_SOFT and
53  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
54  functions. For backwards compatibility, PCRE_PARTIAL is a synonym for  functions. For backwards compatibility, PCRE_PARTIAL is a synonym for
55  PCRE_PARTIAL_SOFT. The essential difference between the two options is whether  PCRE_PARTIAL_SOFT. The essential difference between the two options is whether
56  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 70  strings. This optimization is also disab Line 70  strings. This optimization is also disab
70  </P>  </P>
71  <br><a name="SEC2" href="#TOC1">PARTIAL MATCHING USING pcre_exec() OR pcre16_exec()</a><br>  <br><a name="SEC2" href="#TOC1">PARTIAL MATCHING USING pcre_exec() OR pcre16_exec()</a><br>
72  <P>  <P>
73  A partial match occurs during a call to <b>pcre_exec()</b> or  A partial match occurs during a call to <b>pcre_exec()</b> or
74  <b>pcre16_exec()</b> when the end of the subject string is reached successfully,  <b>pcre16_exec()</b> when the end of the subject string is reached successfully,
75  but matching cannot continue because more characters are needed. However, at  but matching cannot continue because more characters are needed. However, at
76  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 144  because it prefers an earlier partial ma Line 144  because it prefers an earlier partial ma
144  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
145  may not be the true end of the available data, and so, if \z, \Z, \b, \B,  may not be the true end of the available data, and so, if \z, \Z, \b, \B,
146  or $ are encountered at the end of the subject, the result is  or $ are encountered at the end of the subject, the result is
147  PCRE_ERROR_PARTIAL.  PCRE_ERROR_PARTIAL, provided that at least one character in the subject has
148    been inspected.
149  </P>  </P>
150  <P>  <P>
151  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 294  program to do that if it needs to. Line 295  program to do that if it needs to.
295  <P>  <P>
296  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
297  PCRE_DFA_RESTART to continue partial matching over multiple segments. This  PCRE_DFA_RESTART to continue partial matching over multiple segments. This
298  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
299  functions.  functions.
300  </P>  </P>
301  <br><a name="SEC8" href="#TOC1">MULTI-SEGMENT MATCHING WITH pcre_exec() OR pcre16_exec()</a><br>  <br><a name="SEC8" href="#TOC1">MULTI-SEGMENT MATCHING WITH pcre_exec() OR pcre16_exec()</a><br>
# Line 434  Cambridge CB2 3QH, England. Line 435  Cambridge CB2 3QH, England.
435  </P>  </P>
436  <br><a name="SEC11" href="#TOC1">REVISION</a><br>  <br><a name="SEC11" href="#TOC1">REVISION</a><br>
437  <P>  <P>
438  Last updated: 08 January 2012  Last updated: 21 January 2012
439  <br>  <br>
440  Copyright &copy; 1997-2012 University of Cambridge.  Copyright &copy; 1997-2012 University of Cambridge.
441  <br>  <br>

Legend:
Removed from v.902  
changed lines
  Added in v.903

  ViewVC Help
Powered by ViewVC 1.1.5