From 8df0238e0a60856ce050803c6b80950085004d04 Mon Sep 17 00:00:00 2001 From: Adorilson Bezerra Date: Fri, 9 Jan 2026 08:01:00 +0000 Subject: [PATCH] gh-106318: Add examples for str.replace() method (GH-143581) (cherry picked from commit af9f783a7e9bfdca94ce5b9619c1b82a32d9e170) Co-authored-by: Adorilson Bezerra --- Doc/library/stdtypes.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst index 308da5eb1aa6b1..34e27f72d6ff5c 100644 --- a/Doc/library/stdtypes.rst +++ b/Doc/library/stdtypes.rst @@ -2271,6 +2271,14 @@ expression support in the :mod:`re` module). Return a copy of the string with all occurrences of substring *old* replaced by *new*. If *count* is given, only the first *count* occurrences are replaced. If *count* is not specified or ``-1``, then all occurrences are replaced. + For example: + + .. doctest:: + + >>> 'spam, spam, spam'.replace('spam', 'eggs') + 'eggs, eggs, eggs' + >>> 'spam, spam, spam'.replace('spam', 'eggs', 1) + 'eggs, spam, spam' .. versionchanged:: 3.13 *count* is now supported as a keyword argument.