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

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

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 f0b4b09ff10d..b75e5ceecf87 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1018,7 +1018,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)   |
 +--------------------------+--------------------------------+----------+
@@ -1150,6 +1150,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: