From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Wed, 27 Aug 2025 06:48:49 +0000 (+0200)
Subject: [3.14] gh-106318: Add example for `str.find()` (GH-134529) (#138174)
X-Git-Tag: v3.14.0rc3~129
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f4af7176c121b801e4c29705f1c44160e289a784;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-106318: Add example for `str.find()` (GH-134529) (#138174)

Co-authored-by: Blaise Pabon <blaise@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index a81a6704142d..027306b80533 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1909,6 +1909,14 @@ expression support in the :mod:`re` module).
    Return the lowest index in the string where substring *sub* is found within
    the slice ``s[start:end]``.  Optional arguments *start* and *end* are
    interpreted as in slice notation.  Return ``-1`` if *sub* is not found.
+   For example::
+
+      >>> 'spam, spam, spam'.find('sp')
+      0
+      >>> 'spam, spam, spam'.find('sp', 5)
+      6
+
+   See also :meth:`rfind` and :meth:`index`.
 
    .. note::