From: kovan <xaum.io@gmail.com>
Date: Tue, 10 Feb 2026 10:13:40 +0000 (+0100)
Subject: gh-72798: Add mapping example to str.translate documentation (#144454)
X-Git-Tag: v3.15.0a6~16
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9b8d59c136c8016f88844b716ddbd11bc7defb84;p=thirdparty%2FPython%2Fcpython.git

gh-72798: Add mapping example to str.translate documentation (#144454)

Add an example showing how to use str.translate() with a dictionary
mapping directly, demonstrating character replacement and deletion.

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
---

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index b8c079faa93d..ffb5a053a6dc 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -2870,6 +2870,14 @@ expression support in the :mod:`re` module).
    You can use :meth:`str.maketrans` to create a translation map from
    character-to-character mappings in different formats.
 
+   The following example uses a mapping to replace ``'a'`` with ``'X'``,
+   ``'b'`` with ``'Y'``, and delete ``'c'``:
+
+   .. doctest::
+
+      >>> 'abc123'.translate({ord('a'): 'X', ord('b'): 'Y', ord('c'): None})
+      'XY123'
+
    See also the :mod:`codecs` module for a more flexible approach to custom
    character mappings.