[Python-checkins] bpo-43506: Doc: Update removal schedule for Py_UNICODE encoder APIs (GH-24885)
miss-islington
webhook-mailer at python.org
Tue Mar 16 00:48:21 EDT 2021
https://github.com/python/cpython/commit/a838e477a009bae4549f10bfd3396b8d5678415d
commit: a838e477a009bae4549f10bfd3396b8d5678415d
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2021-03-15T21:48:12-07:00
summary:
bpo-43506: Doc: Update removal schedule for Py_UNICODE encoder APIs (GH-24885)
See PEP 624.
(cherry picked from commit 1330338583d183250186a8123b99d2283e945b4f)
Co-authored-by: Inada Naoki <songofacandy at gmail.com>
files:
M Doc/c-api/unicode.rst
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
index 61841c2c205cd..8b1ed0810fb0c 100644
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -727,6 +727,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)
@@ -1060,7 +1064,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`.
@@ -1130,7 +1134,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`.
@@ -1204,7 +1208,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`.
@@ -1279,7 +1283,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`.
@@ -1317,7 +1321,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`.
@@ -1347,7 +1351,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`.
@@ -1378,7 +1382,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`.
@@ -1410,7 +1414,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`.
@@ -1442,7 +1446,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`.
@@ -1494,7 +1498,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`.
@@ -1526,7 +1530,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>`
More information about the Python-checkins
mailing list