Skip to content

Commit 23b9377

Browse files
authored
gh-143420: Clarify sequence behavior for slice indexes (#143422)
1 parent e22b685 commit 23b9377

File tree

2 files changed

+10
-7
lines changed

2 files changed

+10
-7
lines changed

Doc/library/array.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
--------------
1010

1111
This module defines an object type which can compactly represent an array of
12-
basic values: characters, integers, floating-point numbers. Arrays are sequence
12+
basic values: characters, integers, floating-point numbers. Arrays are mutable :term:`sequence`
1313
types and behave very much like lists, except that the type of objects stored in
1414
them is constrained. The type is specified at object creation time by using a
1515
:dfn:`type code`, which is a single character. The following type codes are
@@ -93,7 +93,7 @@ The module defines the following type:
9393
otherwise, the initializer's iterator is passed to the :meth:`extend` method
9494
to add initial items to the array.
9595

96-
Array objects support the ordinary sequence operations of indexing, slicing,
96+
Array objects support the ordinary :ref:`mutable <typesseq-mutable>` :term:`sequence` operations of indexing, slicing,
9797
concatenation, and multiplication. When using slice assignment, the assigned
9898
value must be an array object with the same type code; in all other cases,
9999
:exc:`TypeError` is raised. Array objects also implement the buffer interface,

Doc/library/stdtypes.rst

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1093,11 +1093,14 @@ Notes:
10931093
still ``0``.
10941094

10951095
(4)
1096-
The slice of *s* from *i* to *j* is defined as the sequence of items with index
1097-
*k* such that ``i <= k < j``. If *i* or *j* is greater than ``len(s)``, use
1098-
``len(s)``. If *i* is omitted or ``None``, use ``0``. If *j* is omitted or
1099-
``None``, use ``len(s)``. If *i* is greater than or equal to *j*, the slice is
1100-
empty.
1096+
The slice of *s* from *i* to *j* is defined as the sequence of items with
1097+
index *k* such that ``i <= k < j``.
1098+
1099+
* If *i* is omitted or ``None``, use ``0``.
1100+
* If *j* is omitted or ``None``, use ``len(s)``.
1101+
* If *i* or *j* is less than ``-len(s)``, use ``0``.
1102+
* If *i* or *j* is greater than ``len(s)``, use ``len(s)``.
1103+
* If *i* is greater than or equal to *j*, the slice is empty.
11011104

11021105
(5)
11031106
The slice of *s* from *i* to *j* with step *k* is defined as the sequence of

0 commit comments

Comments
 (0)