summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorEzio Melotti <ezio.melotti@gmail.com>2012-05-09 11:59:24 (GMT)
committerEzio Melotti <ezio.melotti@gmail.com>2012-05-09 11:59:24 (GMT)
commit95f42a86dda8e26ef13a3ce67461e00705173929 (patch)
treeba47efdb51f2cc21395bf8a9a463990574ac113e /Doc
parent284fa08eb783a48f98eabda25aaaebefb5937cce (diff)
downloadcpython-95f42a86dda8e26ef13a3ce67461e00705173929.zip
cpython-95f42a86dda8e26ef13a3ce67461e00705173929.tar.gz
cpython-95f42a86dda8e26ef13a3ce67461e00705173929.tar.bz2
#14763: fix documentation for string.split/rsplit.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/string.rst15
1 files changed, 8 insertions, 7 deletions
diff --git a/Doc/library/string.rst b/Doc/library/string.rst
index c3d1cdc..77f1e8e 100644
--- a/Doc/library/string.rst
+++ b/Doc/library/string.rst
@@ -905,14 +905,15 @@ not be removed until Python 3. The functions defined in this module are:
Return a list of the words of the string *s*. If the optional second argument
*sep* is absent or ``None``, the words are separated by arbitrary strings of
- whitespace characters (space, tab, newline, return, formfeed). If the second
+ whitespace characters (space, tab, newline, return, formfeed). If the second
argument *sep* is present and not ``None``, it specifies a string to be used as
the word separator. The returned list will then have one more item than the
- number of non-overlapping occurrences of the separator in the string. The
- optional third argument *maxsplit* defaults to 0. If it is nonzero, at most
- *maxsplit* number of splits occur, and the remainder of the string is returned
- as the final element of the list (thus, the list will have at most
- ``maxsplit+1`` elements).
+ number of non-overlapping occurrences of the separator in the string.
+ If *maxsplit* is given, at most *maxsplit* number of splits occur, and the
+ remainder of the string is returned as the final element of the list (thus,
+ the list will have at most ``maxsplit+1`` elements). If *maxsplit* is not
+ specified or ``-1``, then there is no limit on the number of splits (all
+ possible splits are made).
The behavior of split on an empty string depends on the value of *sep*. If *sep*
is not specified, or specified as ``None``, the result will be an empty list.
@@ -925,7 +926,7 @@ not be removed until Python 3. The functions defined in this module are:
Return a list of the words of the string *s*, scanning *s* from the end. To all
intents and purposes, the resulting list of words is the same as returned by
:func:`split`, except when the optional third argument *maxsplit* is explicitly
- specified and nonzero. When *maxsplit* is nonzero, at most *maxsplit* number of
+ specified and nonzero. If *maxsplit* is given, at most *maxsplit* number of
splits -- the *rightmost* ones -- occur, and the remainder of the string is
returned as the first element of the list (thus, the list will have at most
``maxsplit+1`` elements).