Skip to content

bpo-43506: Doc: Update removal schedule for Py_UNICODE encoder APIs #24885

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Mar 16, 2021
Merged

bpo-43506: Doc: Update removal schedule for Py_UNICODE encoder APIs #24885

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 15 additions & 11 deletions Doc/c-api/unicode.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -725,6 +725,10 @@ Extension modules can continue using them, as they will not be removed in Python
:c:type:`Py_UNICODE` buffer of the given *size* by ASCII digits 0--9
according to their decimal value. Return ``NULL`` if an exception occurs.

.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`Py_UNICODE_TODECIMAL`.


.. c:function:: Py_UNICODE* PyUnicode_AsUnicodeAndSize(PyObject *unicode, Py_ssize_t *size)

Expand Down Expand Up @@ -1043,7 +1047,7 @@ These are the generic codec APIs:
to be used is looked up using the Python codec registry. Return ``NULL`` if an
exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsEncodedString`.

Expand Down Expand Up @@ -1116,7 +1120,7 @@ These are the UTF-8 codec APIs:
return a Python bytes object. Return ``NULL`` if an exception was raised by
the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsUTF8String`, :c:func:`PyUnicode_AsUTF8AndSize` or
:c:func:`PyUnicode_AsEncodedString`.
Expand Down Expand Up @@ -1190,7 +1194,7 @@ These are the UTF-32 codec APIs:

Return ``NULL`` if an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsUTF32String` or :c:func:`PyUnicode_AsEncodedString`.

Expand Down Expand Up @@ -1265,7 +1269,7 @@ These are the UTF-16 codec APIs:

Return ``NULL`` if an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsUTF16String` or :c:func:`PyUnicode_AsEncodedString`.

Expand Down Expand Up @@ -1303,7 +1307,7 @@ These are the UTF-7 codec APIs:
nonzero, whitespace will be encoded in base-64. Both are set to zero for the
Python "utf-7" codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsEncodedString`.

Expand Down Expand Up @@ -1333,7 +1337,7 @@ These are the "Unicode Escape" codec APIs:
Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Unicode-Escape and
return a bytes object. Return ``NULL`` if an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsUnicodeEscapeString`.

Expand Down Expand Up @@ -1364,7 +1368,7 @@ These are the "Raw Unicode Escape" codec APIs:
Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Raw-Unicode-Escape
and return a bytes object. Return ``NULL`` if an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsRawUnicodeEscapeString` or
:c:func:`PyUnicode_AsEncodedString`.
Expand Down Expand Up @@ -1396,7 +1400,7 @@ ordinals and only these are accepted by the codecs during encoding.
return a Python bytes object. Return ``NULL`` if an exception was raised by
the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsLatin1String` or
:c:func:`PyUnicode_AsEncodedString`.
Expand Down Expand Up @@ -1428,7 +1432,7 @@ codes generate errors.
return a Python bytes object. Return ``NULL`` if an exception was raised by
the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsASCIIString` or
:c:func:`PyUnicode_AsEncodedString`.
Expand Down Expand Up @@ -1480,7 +1484,7 @@ These are the mapping codec APIs:
*mapping* object and return the result as a bytes object. Return ``NULL`` if
an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_AsCharmapString` or
:c:func:`PyUnicode_AsEncodedString`.
Expand Down Expand Up @@ -1512,7 +1516,7 @@ The following codec API is special in that maps Unicode to Unicode.
character *mapping* table to it and return the resulting Unicode object.
Return ``NULL`` when an exception was raised by the codec.

.. deprecated-removed:: 3.3 4.0
.. deprecated-removed:: 3.3 3.11
Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
:c:func:`PyUnicode_Translate`. or :ref:`generic codec based API
<codec-registry>`
Expand Down