From ef4a70b63f313e835bb35efa76ea866594d464a7 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:52:53 +0200 Subject: [PATCH] [3.13] gh-48181: Document `codecs.charmap_build` (GH-135997) (#136124) gh-48181: Document `codecs.charmap_build` (GH-135997) (cherry picked from commit 2bdd50309f543f449d7d82b64ed6f60ae0aa80b9) Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> --- Doc/library/codecs.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index 95600953e5aa..962c81d599e8 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -53,6 +53,14 @@ any codec: :exc:`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more information on codec error handling. +.. function:: charmap_build(string) + + Return a mapping suitable for encoding with a custom single-byte encoding. + Given a :class:`str` *string* of up to 256 characters representing a + decoding table, returns either a compact internal mapping object + ``EncodingMap`` or a :class:`dictionary ` mapping character ordinals + to byte values. Raises a :exc:`TypeError` on invalid input. + The full details for each codec can also be looked up directly: .. function:: lookup(encoding) -- 2.47.3