From: Fred Drake <fdrake@acm.org>
Date: Sat, 16 Mar 2002 05:58:12 +0000 (+0000)
Subject: Clarify the descriptions of the positive and negative lookbehind assertions.
X-Git-Tag: v2.3c1~6475
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f275803fe9839218afec165a51d0e7217964d248;p=thirdparty%2FPython%2Fcpython.git

Clarify the descriptions of the positive and negative lookbehind assertions.
Added examples of positive lookbehind assertions.
This closes SF bug #529708.
---

diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex
index ca829df0e2a7..9bad62a72895 100644
--- a/Doc/lib/libre.tex
+++ b/Doc/lib/libre.tex
@@ -272,18 +272,39 @@ followed by \code{'Asimov'}.
 
 \item[\code{(?<=...)}] Matches if the current position in the string
 is preceded by a match for \regexp{...} that ends at the current
-position.  This is called a positive lookbehind assertion.
-\regexp{(?<=abc)def} will match \samp{abcdef}, since the lookbehind
-will back up 3 characters and check if the contained pattern matches.
-The contained pattern must only match strings of some fixed length,
-meaning that \regexp{abc} or \regexp{a|b} are allowed, but \regexp{a*}
-isn't.
+position.  This is called a \dfn{positive lookbehind assertion}.
+\regexp{(?<=abc)def} will find a match in \samp{abcdef}, since the
+lookbehind will back up 3 characters and check if the contained
+pattern matches.  The contained pattern must only match strings of
+some fixed length, meaning that \regexp{abc} or \regexp{a|b} are
+allowed, but \regexp{a*} and \regexp{a\{3,4\}} are not.  Note that
+patterns which start with positive lookbehind assertions will never
+match at the beginning of the string being searched; you will most
+likely want to use the \function{search()} function rather than the
+\function{match()} function:
+
+\begin{verbatim}
+>>> import re
+>>> m = re.search('(?<=abc)def', 'abdef')
+>>> m.group(0)
+'def'
+\end{verbatim}
+
+This example looks for a word following a hyphen:
+
+\begin{verbatim}
+>>> m = re.search('(?<=-)\w+', 'spam-egg')
+>>> m.group(0)
+'egg'
+\end{verbatim}
 
 \item[\code{(?<!...)}] Matches if the current position in the string
-is not preceded by a match for \regexp{...}.  This
-is called a negative lookbehind assertion.  Similar to positive lookbehind
+is not preceded by a match for \regexp{...}.  This is called a
+\dfn{negative lookbehind assertion}.  Similar to positive lookbehind
 assertions, the contained pattern must only match strings of some
-fixed length.
+fixed length.  Patterns which start with negative lookbehind
+assertions will may match at the beginning of the string being
+searched.
 
 \end{list}