/[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 435 by ph10, Sat Sep 5 10:20:44 2009 UTC revision 456 by ph10, Fri Oct 2 08:53:31 2009 UTC
# Line 32  whether or not a partial match is prefer Line 32  whether or not a partial match is prefer
32  though the details differ between the two matching functions. If both options  though the details differ between the two matching functions. If both options
33  are set, PCRE_PARTIAL_HARD takes precedence.  are set, PCRE_PARTIAL_HARD takes precedence.
34  .P  .P
35  Setting a partial matching option disables one of PCRE's optimizations. PCRE  Setting a partial matching option disables two of PCRE's optimizations. PCRE
36  remembers the last literal byte in a pattern, and abandons matching immediately  remembers the last literal byte in a pattern, and abandons matching immediately
37  if such a byte is not present in the subject string. This optimization cannot  if such a byte is not present in the subject string. This optimization cannot
38  be used for a subject string that might match only partially.  be used for a subject string that might match only partially. If the pattern
39    was studied, PCRE knows the minimum length of a matching string, and does not
40    bother to run the matching function on shorter strings. This optimization is
41    also disabled for partial matching.
42  .  .
43  .  .
44  .SH "PARTIAL MATCHING USING pcre_exec()"  .SH "PARTIAL MATCHING USING pcre_exec()"
# Line 53  instead of PCRE_ERROR_NOMATCH. If there Line 56  instead of PCRE_ERROR_NOMATCH. If there
56  vector, the first of them is set to the offset of the earliest character that  vector, the first of them is set to the offset of the earliest character that
57  was inspected when the partial match was found. For convenience, the second  was inspected when the partial match was found. For convenience, the second
58  offset points to the end of the string so that a substring can easily be  offset points to the end of the string so that a substring can easily be
59  extracted.  identified.
60  .P  .P
61  For the majority of patterns, the first offset identifies the start of the  For the majority of patterns, the first offset identifies the start of the
62  partially matched string. However, for patterns that contain lookbehind  partially matched string. However, for patterns that contain lookbehind
# Line 358  Cambridge CB2 3QH, England. Line 361  Cambridge CB2 3QH, England.
361  .rs  .rs
362  .sp  .sp
363  .nf  .nf
364  Last updated: 05 September 2009  Last updated: 29 September 2009
365  Copyright (c) 1997-2009 University of Cambridge.  Copyright (c) 1997-2009 University of Cambridge.
366  .fi  .fi
Legend:
Removed from v.435  
changed lines
  Added in v.456
  ViewVC Help
Powered by ViewVC 1.1.5