gh-113313: Note that slice support is not required for all sequences. (gh-113377)

This commit is contained in:
Raymond Hettinger 2023-12-21 15:54:59 -06:00 committed by GitHub
parent 31d8757b60
commit 6a5b4736e5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 3 deletions

View File

@ -2808,9 +2808,9 @@ through the object's keys; for sequences, it should iterate through the values.
.. method:: object.__getitem__(self, key)
Called to implement evaluation of ``self[key]``. For :term:`sequence` types,
the accepted keys should be integers and slice objects. Note that the
special interpretation of negative indexes (if the class wishes to emulate a
:term:`sequence` type) is up to the :meth:`__getitem__` method. If *key* is
the accepted keys should be integers. Optionally, they may support
:class:`slice` objects as well. Negative index support is also optional.
If *key* is
of an inappropriate type, :exc:`TypeError` may be raised; if *key* is a value
outside the set of indexes for the sequence (after any special
interpretation of negative values), :exc:`IndexError` should be raised. For