From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Date: Wed, 9 Jul 2025 07:39:55 +0000 (+0200)
Subject: gh-53243: Document `codecs.readbuffer_encode()` (#136284)
X-Git-Tag: v3.15.0a1~1043
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f1dcf3c7bf90961b8d5475154d3f28cfef0a054f;p=thirdparty%2FPython%2Fcpython.git

gh-53243: Document `codecs.readbuffer_encode()` (#136284)

Closes #53243
---

diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index efe211cd2db6..0e84f18dd4d5 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -265,6 +265,20 @@ wider range of codecs when working with binary files:
    :func:`iterencode`.
 
 
+.. function:: readbuffer_encode(buffer, errors=None, /)
+
+   Return a :class:`tuple` containing the raw bytes of *buffer*, a
+   :ref:`buffer-compatible object <bufferobjects>` or :class:`str`
+   (encoded to UTF-8 before processing), and their length in bytes.
+
+   The *errors* argument is ignored.
+
+   .. code-block:: pycon
+
+      >>> codecs.readbuffer_encode(b"Zito")
+      (b'Zito', 4)
+
+
 The module also provides the following constants which are useful for reading
 and writing to platform dependent files: