diff options
author | Martin Panter <vadmium+py@gmail.com> | 2016-12-24 08:25:15 (GMT) |
---|---|---|
committer | Martin Panter <vadmium+py@gmail.com> | 2016-12-24 08:25:15 (GMT) |
commit | 3dbd87f2b966c6e0477368773a6c61746d41a707 (patch) | |
tree | 1fe054b4c547e892042d6cd2a1f6272601b3bac5 | |
parent | 3310e146cc54e7b4e76641c57272ba6c12367876 (diff) | |
download | cpython-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.rst | 6 |
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``. |