https://github.com/python/cpython/commit/af9f783a7e9bfdca94ce5b9619c1b82a32d9e170
commit: af9f783a7e9bfdca94ce5b9619c1b82a32d9e170
branch: main
author: Adorilson Bezerra <[email protected]>
committer: encukou <[email protected]>
date: 2026-01-09T09:01:00+01:00
summary:
gh-106318: Add examples for str.replace() method (GH-143581)
files:
M Doc/library/stdtypes.rst
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index ae197f765d1e16..e7c757405371c3 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2398,6 +2398,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.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
