From 9bc4f2def3729c54d7f23e3b3c9fa209a98e47a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20v=2E=20L=C3=B6wis?= Date: Thu, 3 Jun 2004 09:55:28 +0000 Subject: Drop claims that Unicode always means UCS-2. Fixes #881861. --- Doc/api/concrete.tex | 7 ++++--- Doc/api/utilities.tex | 12 ++++++------ 2 files changed, 10 insertions(+), 9 deletions(-) diff --git a/Doc/api/concrete.tex b/Doc/api/concrete.tex index 2c4d45f..c9ca1e7 100644 --- a/Doc/api/concrete.tex +++ b/Doc/api/concrete.tex @@ -1109,9 +1109,10 @@ These are the UTF-16 codec APIs: the Unicode BOM mark (U+FEFF). In the other two modes, no BOM mark is prepended. - Note that \ctype{Py_UNICODE} data is being interpreted as UTF-16 - reduced to UCS-2. This trick makes it possible to add full UTF-16 - capabilities at a later point without comprimising the APIs. + If \var{Py_UNICODE_WIDE} is defined, a single \ctype{Py_UNICODE} + value may get represented as a surrogate pair. If it is not + defined, each \ctype{Py_UNICODE} values is interpreted as an + UCS-2 character. Returns \NULL{} if an exception was raised by the codec. \end{cfuncdesc} diff --git a/Doc/api/utilities.tex b/Doc/api/utilities.tex index 39ca932..f4fa899 100644 --- a/Doc/api/utilities.tex +++ b/Doc/api/utilities.tex @@ -780,14 +780,14 @@ PyArg_ParseTuple(args, "O|O:ref", &object, &callback) Same as \samp{s\#}. \item[\samp{u} (Unicode string) {[Py_UNICODE *]}] - Convert a null-terminated buffer of Unicode (UCS-2) data to a - Python Unicode object. If the Unicode buffer pointer is \NULL, - \code{None} is returned. + Convert a null-terminated buffer of Unicode (UCS-2 or UCS-4) + data to a Python Unicode object. If the Unicode buffer pointer + is \NULL, \code{None} is returned. \item[\samp{u\#} (Unicode string) {[Py_UNICODE *, int]}] - Convert a Unicode (UCS-2) data buffer and its length to a Python - Unicode object. If the Unicode buffer pointer is \NULL, the - length is ignored and \code{None} is returned. + Convert a Unicode (UCS-2 or UCS-4) data buffer and its length + to a Python Unicode object. If the Unicode buffer pointer + is \NULL, the length is ignored and \code{None} is returned. \item[\samp{i} (integer) {[int]}] Convert a plain C \ctype{int} to a Python integer object. -- cgit v0.12