diff options
| author | qqwqqw689 <114795525+qqwqqw689@users.noreply.github.com> | 2024-02-13 14:23:10 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-02-13 14:23:10 (GMT) |
| commit | 5719aa23ab7f1c7a5f03309ca4044078a98e7b59 (patch) | |
| tree | 1cc98a11236ba851e0ab3c10d751b1d5bc275ef7 /Doc/c-api | |
| parent | f9f6156c5affc039d4ee6b6f4999daf0d5896428 (diff) | |
| download | cpython-5719aa23ab7f1c7a5f03309ca4044078a98e7b59.zip cpython-5719aa23ab7f1c7a5f03309ca4044078a98e7b59.tar.gz cpython-5719aa23ab7f1c7a5f03309ca4044078a98e7b59.tar.bz2 | |
gh-113437: Update documentation about PyUnicode_AsWideChar() function (GH-113455)
Diffstat (limited to 'Doc/c-api')
| -rw-r--r-- | Doc/c-api/unicode.rst | 7 |
1 files changed, 6 insertions, 1 deletions
diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst index 5541eaa..666ffe8 100644 --- a/Doc/c-api/unicode.rst +++ b/Doc/c-api/unicode.rst @@ -854,7 +854,12 @@ wchar_t Support Copy the Unicode object contents into the :c:type:`wchar_t` buffer *wstr*. At most *size* :c:type:`wchar_t` characters are copied (excluding a possibly trailing null termination character). Return the number of :c:type:`wchar_t` characters - copied or ``-1`` in case of an error. Note that the resulting :c:expr:`wchar_t*` + copied or ``-1`` in case of an error. + + When *wstr* is ``NULL``, instead return the *size* that would be required + to store all of *unicode* including a terminating null. + + Note that the resulting :c:expr:`wchar_t*` string may or may not be null-terminated. It is the responsibility of the caller to make sure that the :c:expr:`wchar_t*` string is null-terminated in case this is required by the application. Also, note that the :c:expr:`wchar_t*` string |