From: Yongzi Li <204532581+Yzi-Li@users.noreply.github.com>
Date: Sun, 8 Jun 2025 12:28:55 +0000 (+0800)
Subject: gh-134976: document the exception type that can be raised by `s[i]` (#134977)
X-Git-Tag: v3.15.0a1~1357
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=158e5162bfaa8a49178ce2c3f2455c3e03b60157;p=thirdparty%2FPython%2Fcpython.git

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

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: