|
Original |
Translation |
|
119
|
|
|
|
120
|
|
|
|
121
|
String conversion and formatting
|
Conversion et formatage de chaînes
|
|
122
|
Functions for number conversion and formatted string output.
|
Fonctions de conversion pour les nombres et pour la sortie des chaînes formattées.
|
|
123
|
|
124
|
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. Both functions require that ``str != NULL``, ``size > 0`` and ``format != NULL``.
|
|
|
125
|
If the platform doesn't have :cfunc:`vsnprintf` and the buffer size needed to avoid truncation exceeds *size* by more than 512 bytes, Python aborts with a *Py_FatalError*.
|
|
|
126
|
The return value (*rv*) for these functions should be interpreted as follows:
|
|
|
127
|
When ``0 <= rv < size``, the output conversion was successful and *rv* characters were written to *str* (excluding the trailing ``'\0'`` byte at *str*[*rv*]).
|
|
|
128
|
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'`` in this case.
|
|