summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15>2011-07-22 10:00:10 +0000
committerph10 <ph10@2f5784b3-3f2a-0410-8824-cb99058d5e15>2011-07-22 10:00:10 +0000
commitbb65c65e877ce6304c601a4b2a2de1b02df458ad (patch)
treefb55955f5a77cb4c256b2b7c27188262cefc01c5 /doc
parent9d81b5c355dfc5a992ef852bf5cec778bee502fe (diff)
downloadpcre-bb65c65e877ce6304c601a4b2a2de1b02df458ad.tar.gz
Make (*MARK) work in positive assertions.
git-svn-id: svn://vcs.exim.org/pcre/code/trunk@630 2f5784b3-3f2a-0410-8824-cb99058d5e15
Diffstat (limited to 'doc')
-rw-r--r--doc/pcrepattern.312
1 files changed, 9 insertions, 3 deletions
diff --git a/doc/pcrepattern.3 b/doc/pcrepattern.3
index a75159a..38e9689 100644
--- a/doc/pcrepattern.3
+++ b/doc/pcrepattern.3
@@ -2492,8 +2492,10 @@ failing negative assertion, they cause an error if encountered by
.P
If any of these verbs are used in an assertion or subroutine subpattern
(including recursive subpatterns), their effect is confined to that subpattern;
-it does not extend to the surrounding pattern. Note that such subpatterns are
-processed as anchored at the point where they are tested.
+it does not extend to the surrounding pattern, with one exception: a *MARK that
+is encountered in a positive assertion \fIis\fP passed back (compare capturing
+parentheses in assertions). Note that such subpatterns are processed as
+anchored at the point where they are tested.
.P
The new verbs make use of what was previously invalid syntax: an opening
parenthesis followed by an asterisk. They are generally of the form
@@ -2584,6 +2586,10 @@ indicates which of the two alternatives matched. This is a more efficient way
of obtaining this information than putting each alternative in its own
capturing parentheses.
.P
+If (*MARK) is encountered in a positive assertion, its name is recorded and
+passed back if it is the last-encountered. This does not happen for negative
+assetions.
+.P
A name may also be returned after a failed match if the final path through the
pattern involves (*MARK). However, unless (*MARK) used in conjunction with
(*COMMIT), this is unlikely to happen for an unanchored pattern because, as the
@@ -2755,6 +2761,6 @@ Cambridge CB2 3QH, England.
.rs
.sp
.nf
-Last updated: 20 July 2011
+Last updated: 22 July 2011
Copyright (c) 1997-2011 University of Cambridge.
.fi