[3.14] gh-53243: Document codecs.readbuffer_encode() (GH-136284) (#136452)

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

Closes GH-53243
(cherry picked from commit f1dcf3c7bf)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2025-07-09 10:07:18 +02:00 committed by GitHub
parent 2cb5792836
commit 85df16b7fa
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

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