Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-02-21 22:50:55 +00:00
Code Issues Projects Releases Packages Wiki Activity

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

Browse source 
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>
This commit is contained in:
kovan 2026-02-10 11:13:40 +01:00 • committed by GitHub
parent 2c1ca6bb5b
commit 9b8d59c136
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 8 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/stdtypes.rst
View file

@ -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.