From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 9 Jan 2026 15:30:11 +0000 (+0100)
Subject: [3.14] gh-106318: Add examples for str.rfind() method (GH-143582) (#143616)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=426683e7b72cf0f7fa7824a2ddcd348ff0f7e6c7;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-106318: Add examples for str.rfind() method (GH-143582) (#143616)

gh-106318: Add examples for str.rfind() method (GH-143582)
(cherry picked from commit c696f33d9ee425d7acd5de90d5418a3280444962)

Co-authored-by: Adorilson Bezerra <adorilson@gmail.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 987031e48160..7663c15cc1a7 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2416,6 +2416,16 @@ expression support in the :mod:`re` module).
    Return the highest index in the string where substring *sub* is found, such
    that *sub* is contained within ``s[start:end]``.  Optional arguments *start*
    and *end* are interpreted as in slice notation.  Return ``-1`` on failure.
+   For example:
+
+   .. doctest::
+
+      >>> 'spam, spam, spam'.rfind('sp')
+      12
+      >>> 'spam, spam, spam'.rfind('sp', 0, 10)
+      6
+
+   See also :meth:`find` and :meth:`rindex`.
 
 
 .. method:: str.rindex(sub[, start[, end]])