summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin Panter <vadmium+py@gmail.com>2016-12-24 08:25:15 (GMT)
committerMartin Panter <vadmium+py@gmail.com>2016-12-24 08:25:15 (GMT)
commit3dbd87f2b966c6e0477368773a6c61746d41a707 (patch)
tree1fe054b4c547e892042d6cd2a1f6272601b3bac5
parent3310e146cc54e7b4e76641c57272ba6c12367876 (diff)
downloadcpython-3dbd87f2b966c6e0477368773a6c61746d41a707.zip
cpython-3dbd87f2b966c6e0477368773a6c61746d41a707.tar.gz
cpython-3dbd87f2b966c6e0477368773a6c61746d41a707.tar.bz2
Issue #1446619: Account for negative slice direction in description
Based on suggestion from Fumihiro Bessho.
-rw-r--r--Doc/library/stdtypes.rst6
1 files changed, 4 insertions, 2 deletions
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 1e19fd4..4174f79 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -942,8 +942,10 @@ Notes:
The slice of *s* from *i* to *j* with step *k* is defined as the sequence of
items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other words,
the indices are ``i``, ``i+k``, ``i+2*k``, ``i+3*k`` and so on, stopping when
- *j* is reached (but never including *j*). If *i* or *j* is greater than
- ``len(s)``, use ``len(s)``. If *i* or *j* are omitted or ``None``, they become
+ *j* is reached (but never including *j*). When *k* is positive,
+ *i* and *j* are reduced to ``len(s)`` if they are greater.
+ When *k* is negative, *i* and *j* are reduced to ``len(s) - 1`` if
+ they are greater. If *i* or *j* are omitted or ``None``, they become
"end" values (which end depends on the sign of *k*). Note, *k* cannot be zero.
If *k* is ``None``, it is treated like ``1``.