summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin v. Löwis <martin@v.loewis.de>2004-06-03 09:55:28 (GMT)
committerMartin v. Löwis <martin@v.loewis.de>2004-06-03 09:55:28 (GMT)
commit9bc4f2def3729c54d7f23e3b3c9fa209a98e47a9 (patch)
tree0537df5b6656cc3ee93314e0e8e75d94f6ba20a4
parent4a9b8069e0e63bd010e58b118fe7d58e8256a11b (diff)
downloadcpython-9bc4f2def3729c54d7f23e3b3c9fa209a98e47a9.zip
cpython-9bc4f2def3729c54d7f23e3b3c9fa209a98e47a9.tar.gz
cpython-9bc4f2def3729c54d7f23e3b3c9fa209a98e47a9.tar.bz2
Drop claims that Unicode always means UCS-2. Fixes #881861.
-rw-r--r--Doc/api/concrete.tex7
-rw-r--r--Doc/api/utilities.tex12
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.