From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 23 May 2025 09:53:19 +0000 (+0200)
Subject: [3.13] gh-106318: Add example for `str.count()` (GH-134519) (#134573)
X-Git-Tag: v3.13.4~50
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1dbb644a5b458aebc48022d2c28d16dfd8ae0d73;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-106318: Add example for `str.count()` (GH-134519) (#134573)

Co-authored-by: Blaise Pabon <blaise@gmail.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index a856047f2d6e..2c1ca4627795 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1669,8 +1669,18 @@ expression support in the :mod:`re` module).
    interpreted as in slice notation.
 
    If *sub* is empty, returns the number of empty strings between characters
-   which is the length of the string plus one.
-
+   which is the length of the string plus one. For example::
+
+      >>> 'spam, spam, spam'.count('spam')
+      3
+      >>> 'spam, spam, spam'.count('spam', 5)
+      2
+      >>> 'spam, spam, spam'.count('spam', 5, 10)
+      1
+      >>> 'spam, spam, spam'.count('eggs')
+      0
+      >>> 'spam, spam, spam'.count('')
+      17
 
 .. method:: str.encode(encoding="utf-8", errors="strict")