Skip to content

Docs: C API: Clarify what happens when null bytes are passed to PyUnicode_AsUTF8 #127458

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jan 20, 2025
Merged

Docs: C API: Clarify what happens when null bytes are passed to PyUnicode_AsUTF8 #127458

Changes from 4 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
680651c
Document what happens when PyUnicode_AsUTF8() is given embedded null …
ZeroIntensity Nov 30, 2024
8bfd541
Suggest PyUnicode_AsUTF8AndSize for user input.
ZeroIntensity Nov 30, 2024
52e9117
Switch to a note instead of a warning.
ZeroIntensity Nov 30, 2024
1b393d4
Update Doc/c-api/unicode.rst
ZeroIntensity Dec 1, 2024
040608b
Update Doc/c-api/unicode.rst
ZeroIntensity Dec 1, 2024
6fb8cbe
Play with the wording a little bit.
ZeroIntensity Dec 15, 2024
3c7b6be
Add a reference.
ZeroIntensity Jan 13, 2025
0eac45f
Update Doc/c-api/unicode.rst
ZeroIntensity Jan 13, 2025
35e0783
Switch the wording away from 'user input'
ZeroIntensity Jan 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions Doc/c-api/unicode.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1035,6 +1035,13 @@ These are the UTF-8 codec APIs:

As :c:func:`PyUnicode_AsUTF8AndSize`, but does not store the size.

.. note::

This function does not handle null bytes within the unicode object. As a result, the length of the
returned string (from ``strlen()``) could be smaller than the length of the
passed unicode object, if the string contained embedded null characters. When handling user input,
it is recommended to use :c:func:`PyUnicode_AsUTF8AndSize` instead.

.. versionadded:: 3.3

.. versionchanged:: 3.7
Expand Down
Loading