From cbf08d5a62c6b0d3e5224082f8e57d4bdd65503c Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Tue, 13 Jan 2026 13:23:26 +0100 Subject: [PATCH] [3.13] gh-106318: Add examples for str.replace() method (GH-143581) (GH-143788) (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 308da5eb1aa6..34e27f72d6ff 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. -- 2.47.3