From: Raymond Hettinger <rhettinger@users.noreply.github.com>
Date: Thu, 10 Nov 2022 21:20:01 +0000 (-0600)
Subject: GH-99183: Document behavior of count() for empty substrings (GH-99339)
X-Git-Tag: v3.12.0a2~41
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2f4af2d99cffed6ba81e4b8fd886de6ae8625a3f;p=thirdparty%2FPython%2Fcpython.git

GH-99183: Document behavior of count() for empty substrings (GH-99339)
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 6701d794b511..332974e738c3 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1617,6 +1617,9 @@ expression support in the :mod:`re` module).
    range [*start*, *end*].  Optional arguments *start* and *end* are
    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.
+
 
 .. method:: str.encode(encoding="utf-8", errors="strict")
 
@@ -2698,6 +2701,9 @@ arbitrary binary data.
    The subsequence to search for may be any :term:`bytes-like object` or an
    integer in the range 0 to 255.
 
+   If *sub* is empty, returns the number of empty slices between characters
+   which is the length of the bytes object plus one.
+
    .. versionchanged:: 3.3
       Also accept an integer in the range 0 to 255 as the subsequence.