Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Issue #13617: Document that the result PyUnicode_AsUnicode() and 

PyUnicode_AsWideChar() may contain embedded null characters.

Patch written by Arnaud Calmettes.
This commit is contained in:
Victor Stinner 2011-12-18 19:39:53 +01:00
parent 3b3b1189ce
commit 28a545e234
2 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
Doc/ACKS.txt
View File

@ -33,6 +33,7 @@ docs@python.org), and we'll be glad to correct the problem.
* Keith Briggs * Keith Briggs
* Ian Bruntlett * Ian Bruntlett
* Lee Busby * Lee Busby
* Arnaud Calmettes
* Lorenzo M. Catucci * Lorenzo M. Catucci
* Carl Cerecke * Carl Cerecke
* Mauro Cicognini * Mauro Cicognini

11
Doc/c-api/unicode.rst
View File

@ -327,8 +327,11 @@ APIs:
.. cfunction:: Py_UNICODE* PyUnicode_AsUnicode(PyObject *unicode) .. cfunction:: Py_UNICODE* PyUnicode_AsUnicode(PyObject *unicode)
Return a read-only pointer to the Unicode object's internal :ctype:`Py_UNICODE` Return a read-only pointer to the Unicode object's internal
buffer, *NULL* if *unicode* is not a Unicode object. :c:type:`Py_UNICODE` buffer, *NULL* if *unicode* is not a Unicode object.
Note that the resulting :c:type:`Py_UNICODE*` string may contain embedded
null characters, which would cause the string to be truncated when used in
most C functions.
.. cfunction:: Py_ssize_t PyUnicode_GetSize(PyObject *unicode) .. cfunction:: Py_ssize_t PyUnicode_GetSize(PyObject *unicode)
@ -391,7 +394,9 @@ wchar_t Support
copied or -1 in case of an error. Note that the resulting :ctype:`wchar_t` copied or -1 in case of an error. Note that the resulting :ctype:`wchar_t`
string may or may not be 0-terminated. It is the responsibility of the caller string may or may not be 0-terminated. It is the responsibility of the caller
to make sure that the :ctype:`wchar_t` string is 0-terminated in case this is to make sure that the :ctype:`wchar_t` string is 0-terminated in case this is
required by the application. required by the application. Also, note that the :c:type:`wchar_t*` string
might contain null characters, which would cause the string to be truncated
when used with most C functions.
.. versionchanged:: 2.5 .. versionchanged:: 2.5
This function returned an :ctype:`int` type and used an :ctype:`int` This function returned an :ctype:`int` type and used an :ctype:`int`