diff options
author | Guido van Rossum <guido@python.org> | 1998-01-12 18:58:53 (GMT) |
---|---|---|
committer | Guido van Rossum <guido@python.org> | 1998-01-12 18:58:53 (GMT) |
commit | 97546399c72d8d144f07b408b4b6fa5b6edb4c1d (patch) | |
tree | 3a485c34ad0aad9df337dfd7ef49af6622f0cdba /Doc/lib | |
parent | 2b2b3f9bcb7d1cdf97b68f825489b5abfd42cf22 (diff) | |
download | cpython-97546399c72d8d144f07b408b4b6fa5b6edb4c1d.zip cpython-97546399c72d8d144f07b408b4b6fa5b6edb4c1d.tar.gz cpython-97546399c72d8d144f07b408b4b6fa5b6edb4c1d.tar.bz2 |
Document maxsplit arg for split(), with incompatibility note about 1.5
release bug.
Document groups() changed behaviour (now always returns tuple).
Diffstat (limited to 'Doc/lib')
-rw-r--r-- | Doc/lib/libre.tex | 15 |
1 files changed, 12 insertions, 3 deletions
diff --git a/Doc/lib/libre.tex b/Doc/lib/libre.tex index f3e8468..e692e7e 100644 --- a/Doc/lib/libre.tex +++ b/Doc/lib/libre.tex @@ -350,16 +350,23 @@ expression will be used several times in a single program. Split \var{string} by the occurrences of \var{pattern}. If capturing parentheses are used in pattern, then occurrences of patterns or subpatterns are also returned. + If \var{maxsplit} is nonzero, at most \var{maxsplit} splits + occur, and the remainder of the string is returned as the final + element of the list. (Incompatibility note: in the original Python + 1.5 release, \var{maxsplit} was ignored. This has been fixed in + later releases.) % \bcode\begin{verbatim} >>> re.split('[\W]+', 'Words, words, words.') ['Words', 'words', 'words', ''] >>> re.split('([\W]+)', 'Words, words, words.') ['Words', ', ', 'words', ', ', 'words', '.', ''] +>>> re.split('[\W]+', 'Words, words, words.', 1) +['Words', 'words, words.'] \end{verbatim}\ecode % This function combines and extends the functionality of - the old \code{regex.split()} and \code{regex.splitx()}. + the old \code{regsub.split()} and \code{regsub.splitx()}. \end{funcdesc} \begin{funcdesc}{sub}{pattern\, repl\, string\optional{, count=0}} @@ -499,8 +506,10 @@ After performing this match, \code{m.group(1)} is \code{'3'}, as is \code{m.grou \begin{funcdesc}{groups}{} Return a tuple containing all the subgroups of the match, from 1 up to however many groups are in the pattern. Groups that did not -participate in the match have values of \code{None}. If the tuple -would only be one element long, a string will be returned instead. +participate in the match have values of \code{None}. (Incompatibility +note: in the original Python 1.5 release, if the tuple was one element +long, a string would be returned instead. In later versions, a +singleton tuple is returned in such cases.) \end{funcdesc} \begin{funcdesc}{start}{group} |