mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 19:34:08 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

closes bpo-43266: Improve array formatting. (GH-24573)

Browse source
This commit is contained in:
Erlend Egeberg Aasland 2021-02-19 16:32:31 +01:00 • committed by GitHub
parent 4a6bf276ed
commit 2d3e463e4a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/c-api/conversion.rst
View file

@ -25,7 +25,7 @@ functions :c:func:`snprintf` and :c:func:`vsnprintf`. Their purpose is to
guarantee consistent behavior in corner cases, which the Standard C functions do guarantee consistent behavior in corner cases, which the Standard C functions do
not. not.
The wrappers ensure that *str*[*size*-1] is always ``'\0'`` upon return. They The wrappers ensure that ``str[size-1]`` is always ``'\0'`` upon return. They
never write more than *size* bytes (including the trailing ``'\0'``) into str. never write more than *size* bytes (including the trailing ``'\0'``) into str.
Both functions require that ``str != NULL``, ``size > 0``, ``format != NULL`` Both functions require that ``str != NULL``, ``size > 0``, ``format != NULL``
and ``size < INT_MAX``. and ``size < INT_MAX``.
@ -34,13 +34,13 @@ The return value (*rv*) for these functions should be interpreted as follows:
* When ``0 <= rv < size``, the output conversion was successful and *rv* * When ``0 <= rv < size``, the output conversion was successful and *rv*
characters were written to *str* (excluding the trailing ``'\0'`` byte at characters were written to *str* (excluding the trailing ``'\0'`` byte at
*str*[*rv*]). ``str[rv]``).
* When ``rv >= size``, the output conversion was truncated and a buffer with * When ``rv >= size``, the output conversion was truncated and a buffer with
``rv + 1`` bytes would have been needed to succeed. *str*[*size*-1] is ``'\0'`` ``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is ``'\0'``
in this case. in this case.
* When ``rv < 0``, "something bad happened." *str*[*size*-1] is ``'\0'`` in * When ``rv < 0``, "something bad happened." ``str[size-1]`` is ``'\0'`` in
this case too, but the rest of *str* is undefined. The exact cause of the error this case too, but the rest of *str* is undefined. The exact cause of the error
depends on the underlying platform. depends on the underlying platform.