[Python-checkins] cpython: Document PyUnicode_Copy() and PyUnicode_EncodeCodePage()

[victor.stinner]

http://hg.python.org/cpython/rev/e7d94d35506b
changeset:   73898:e7d94d35506b
user:        Victor Stinner <victor.stinner at haypocalc.com>
date:        Fri Dec 09 00:18:11 2011 +0100
summary:
  Document PyUnicode_Copy() and PyUnicode_EncodeCodePage()

files:
  Doc/c-api/unicode.rst |  18 +++++++++++++++++-
  1 files changed, 17 insertions(+), 1 deletions(-)


diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst
--- a/Doc/c-api/unicode.rst
+++ b/Doc/c-api/unicode.rst
@@ -386,6 +386,13 @@
    .. versionadded:: 3.3
 
 
+.. c:function:: PyObject* PyUnicode_Copy(PyObject *unicode)
+
+   Get a new copy of a Unicode object.
+
+   .. versionadded:: 3.3
+
+
 .. c:function:: PyObject* PyUnicode_FromKindAndData(int kind, const void *buffer, \
                                                     Py_ssize_t size)
 
@@ -1379,6 +1386,15 @@
    raised by the codec.
 
 
+.. c:function:: PyObject* PyUnicode_EncodeCodePage(int code_page, PyObject *unicode, const char *errors)
+
+   Encode the Unicode object using the specified code page and return a Python
+   bytes object.  Return *NULL* if an exception was raised by the codec. Use
+   :c:data:`CP_ACP` code page to get the MBCS encoder.
+
+   .. versionadded:: 3.3
+
+
 .. c:function:: PyObject* PyUnicode_EncodeMBCS(const Py_UNICODE *s, Py_ssize_t size, const char *errors)
 
    Encode the :c:type:`Py_UNICODE` buffer of the given *size* using MBCS and return
@@ -1387,7 +1403,7 @@
 
    .. deprecated-removed:: 3.3 4.0
       Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using
-      :c:func:`PyUnicode_AsMBCSString`.
+      :c:func:`PyUnicode_AsMBCSString` or :c:func:`PyUnicode_EncodeCodePage`.
 
 
 Methods & Slots

-- 
Repository URL: http://hg.python.org/cpython