Revision: 1347
http://vcs.pcre.org/viewvc?view=rev&revision=1347
Author: ph10
Date: 2013-07-02 19:52:42 +0100 (Tue, 02 Jul 2013)
Log Message:
-----------
Clarify the action of PCRE_DFA_RESTART.
Modified Paths:
--------------
code/trunk/doc/pcrepartial.3
Modified: code/trunk/doc/pcrepartial.3
===================================================================
--- code/trunk/doc/pcrepartial.3 2013-07-02 18:37:36 UTC (rev 1346)
+++ code/trunk/doc/pcrepartial.3 2013-07-02 18:52:42 UTC (rev 1347)
@@ -1,4 +1,4 @@
-.TH PCREPARTIAL 3 "20 February 2013" "PCRE 8.33"
+.TH PCREPARTIAL 3 "02 July 2013" "PCRE 8.34"
.SH NAME
PCRE - Perl-compatible regular expressions
.SH "PARTIAL MATCHING IN PCRE"
@@ -280,6 +280,15 @@
not retain the previously partially-matched string. It is up to the calling
program to do that if it needs to.
.P
+That means that, for an unanchored pattern, if a continued match fails, it is
+not possible to try again at a new starting point. All this facility is capable
+of doing is continuing with the previous match attempt. In the previous
+example, if the second set of data is "ug23" the result is no match, even
+though there would be a match for "aug23" if the entire string were given at
+once. Depending on the application, this may or may not be what you want.
+The only way to allow for starting again at the next character is to retain the
+matched part of the subject and try a new complete match.
+.P
You can set the PCRE_PARTIAL_SOFT or PCRE_PARTIAL_HARD options with
PCRE_DFA_RESTART to continue partial matching over multiple segments. This
facility can be used to pass very long subject strings to the DFA matching
@@ -462,6 +471,6 @@
.rs
.sp
.nf
-Last updated: 20 February 2013
+Last updated: 02 July 2013
Copyright (c) 1997-2013 University of Cambridge.
.fi
