From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sun, 8 Jun 2025 12:37:55 +0000 (+0200)
Subject: [3.13] gh-134976: document the exception type that can be raised by `s[i]` (GH-134977... 
X-Git-Tag: v3.13.5~15
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=47a828e5d33d2a13c9e4d923e42db14779807aea;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-134976: document the exception type that can be raised by `s[i]` (GH-134977) (#135259)

gh-134976: document the exception type that can be raised by `s[i]` (GH-134977)
(cherry picked from commit 158e5162bfaa8a49178ce2c3f2455c3e03b60157)

Co-authored-by: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index b279c693a6cc..a3c542745979 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -976,7 +976,7 @@ operations have the same priority as the corresponding numeric operations. [3]_
 | ``s * n`` or             | equivalent to adding *s* to    | (2)(7)   |
 | ``n * s``                | itself *n* times               |          |
 +--------------------------+--------------------------------+----------+
-| ``s[i]``                 | *i*\ th item of *s*, origin 0  | \(3)     |
+| ``s[i]``                 | *i*\ th item of *s*, origin 0  | (3)(9)   |
 +--------------------------+--------------------------------+----------+
 | ``s[i:j]``               | slice of *s* from *i* to *j*   | (3)(4)   |
 +--------------------------+--------------------------------+----------+
@@ -1108,6 +1108,9 @@ Notes:
    without copying any data and with the returned index being relative to
    the start of the sequence rather than the start of the slice.
 
+(9)
+   An :exc:`IndexError` is raised if *i* is outside the sequence range.
+
 
 .. _typesseq-immutable: