@@ -24,17 +24,17 @@ msgstr ""
24
24
#: c-api/arg.rst:8
25
25
msgid ""
26
26
"These functions are useful when creating your own extensions functions and "
27
- "methods. Additional information and examples are available "
28
- "in :ref: `extending-index`."
27
+ "methods. Additional information and examples are available in :ref: "
28
+ "`extending-index`."
29
29
msgstr ""
30
30
31
31
#: c-api/arg.rst:12
32
32
msgid ""
33
- "The first three of these functions "
34
- "described, :c: func:`PyArg_ParseTuple `, :c:func:`PyArg_ParseTupleAndKeywords`, "
35
- "and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell "
36
- "the function about the expected arguments. The format strings use the same "
37
- "syntax for each of these functions."
33
+ "The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c: "
34
+ "func:`PyArg_ParseTupleAndKeywords `, and :c:func:`PyArg_Parse`, all use "
35
+ "*format strings* which are used to tell the function about the expected "
36
+ "arguments. The format strings use the same syntax for each of these "
37
+ "functions."
38
38
msgstr ""
39
39
40
40
#: c-api/arg.rst:19
@@ -99,10 +99,10 @@ msgstr ""
99
99
100
100
#: c-api/arg.rst:61
101
101
msgid ""
102
- "To ensure that the underlying buffer may be safely borrowed, the "
103
- "object's :c: member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. "
104
- "This disallows common mutable objects such as :class:`bytearray`, but also "
105
- "some read-only objects such as :class:`memoryview` of :class:`bytes`."
102
+ "To ensure that the underlying buffer may be safely borrowed, the object's :c: "
103
+ "member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
104
+ "disallows common mutable objects such as :class:`bytearray`, but also some "
105
+ "read-only objects such as :class:`memoryview` of :class:`bytes`."
106
106
msgstr ""
107
107
108
108
#: c-api/arg.rst:67
@@ -114,11 +114,11 @@ msgstr ""
114
114
115
115
#: c-api/arg.rst:73
116
116
msgid ""
117
- "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the "
118
- "macro :c:macro: `PY_SSIZE_T_CLEAN` must be defined before "
119
- "including :file:` Python.h`. On Python 3.9 and older, the type of the length "
120
- "argument is :c:type: `Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is "
121
- "defined, or int otherwise."
117
+ "For all ``#`` variants of formats (``s#``, ``y#``, etc.), the macro :c:macro: "
118
+ "`PY_SSIZE_T_CLEAN` must be defined before including :file:`Python.h`. On "
119
+ "Python 3.9 and older, the type of the length argument is :c:type: "
120
+ "`Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is defined, or int "
121
+ "otherwise."
122
122
msgstr ""
123
123
124
124
#: c-api/arg.rst:80
@@ -139,8 +139,8 @@ msgstr ""
139
139
msgid ""
140
140
"This format does not accept :term:`bytes-like objects <bytes-like object>`. "
141
141
"If you want to accept filesystem paths and convert them to C character "
142
- "strings, it is preferable to use the ``O&`` format "
143
- "with :c:func: `PyUnicode_FSConverter` as *converter*."
142
+ "strings, it is preferable to use the ``O&`` format with :c:func: "
143
+ "`PyUnicode_FSConverter` as *converter*."
144
144
msgstr ""
145
145
146
146
#: c-api/arg.rst:96
@@ -163,8 +163,8 @@ msgstr ""
163
163
164
164
#: c-api/arg.rst:106
165
165
msgid ""
166
- "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char "
167
- "\\ *, : c:type:`Py_ssize_t`]"
166
+ "``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\ *, : "
167
+ "c:type:`Py_ssize_t`]"
168
168
msgstr ""
169
169
170
170
#: c-api/arg.rst:107
@@ -239,8 +239,8 @@ msgstr ""
239
239
240
240
#: c-api/arg.rst:141
241
241
msgid ""
242
- "``y#`` (read-only :term:`bytes-like object`) [const char "
243
- "\\ *, :c:type: `Py_ssize_t`]"
242
+ "``y#`` (read-only :term:`bytes-like object`) [const char \\ *, :c:type: "
243
+ "`Py_ssize_t`]"
244
244
msgstr ""
245
245
246
246
#: c-api/arg.rst:142
@@ -267,9 +267,9 @@ msgstr ""
267
267
#: c-api/arg.rst:151
268
268
msgid ""
269
269
"Requires that the Python object is a :class:`bytearray` object, without "
270
- "attempting any conversion. Raises :exc:`TypeError` if the object is not "
271
- "a : class:`bytearray` object. The C variable may also be declared "
272
- "as :c:expr: `PyObject*`."
270
+ "attempting any conversion. Raises :exc:`TypeError` if the object is not a : "
271
+ "class:`bytearray` object. The C variable may also be declared as :c:expr: "
272
+ "`PyObject*`."
273
273
msgstr ""
274
274
275
275
#: c-api/arg.rst:155
@@ -291,8 +291,8 @@ msgstr ""
291
291
msgid ""
292
292
"This format accepts any object which implements the read-write buffer "
293
293
"interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
294
- "The buffer may contain embedded null bytes. The caller have to "
295
- "call :c:func: `PyBuffer_Release` when it is done with the buffer."
294
+ "The buffer may contain embedded null bytes. The caller have to call :c:func: "
295
+ "`PyBuffer_Release` when it is done with the buffer."
296
296
msgstr ""
297
297
298
298
#: c-api/arg.rst:166
@@ -320,8 +320,8 @@ msgstr ""
320
320
msgid ""
321
321
":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
322
322
"the encoded data into this buffer and adjust *\\ *buffer* to reference the "
323
- "newly allocated storage. The caller is responsible for "
324
- "calling :c:func: `PyMem_Free` to free the allocated buffer after use."
323
+ "newly allocated storage. The caller is responsible for calling :c:func: "
324
+ "`PyMem_Free` to free the allocated buffer after use."
325
325
msgstr ""
326
326
327
327
#: c-api/arg.rst:183
@@ -339,8 +339,8 @@ msgstr ""
339
339
340
340
#: c-api/arg.rst:188
341
341
msgid ""
342
- "``es#`` (:class:`str`) [const char \\ *encoding, char "
343
- "\\ * \\ *buffer, :c:type: `Py_ssize_t` \\ *buffer_length]"
342
+ "``es#`` (:class:`str`) [const char \\ *encoding, char \\ * \\ *buffer, :c:type: "
343
+ "`Py_ssize_t` \\ *buffer_length]"
344
344
msgstr ""
345
345
346
346
#: c-api/arg.rst:189
@@ -417,11 +417,10 @@ msgstr ""
417
417
#: c-api/arg.rst:232
418
418
msgid ""
419
419
"These formats allow representing Python numbers or single characters as C "
420
- "numbers. Formats that require :class:`int`, :class:`float` "
421
- "or :class:`complex` can also use the corresponding special "
422
- "methods :meth:`~object.__index__`, :meth:`~object.__float__` "
423
- "or :meth:`~object.__complex__` to convert the Python object to the required "
424
- "type."
420
+ "numbers. Formats that require :class:`int`, :class:`float` or :class:"
421
+ "`complex` can also use the corresponding special methods :meth:`~object."
422
+ "__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to "
423
+ "convert the Python object to the required type."
425
424
msgstr ""
426
425
427
426
#: c-api/arg.rst:238
@@ -591,9 +590,9 @@ msgstr ""
591
590
#: c-api/arg.rst:307
592
591
msgid ""
593
592
"Store a Python object (without any conversion) in a C object pointer. The C "
594
- "program thus receives the actual object that was passed. A "
595
- "new :term: `strong reference` to the object is not created (i.e. its "
596
- "reference count is not increased). The pointer stored is not ``NULL``."
593
+ "program thus receives the actual object that was passed. A new :term: "
594
+ "`strong reference` to the object is not created (i.e. its reference count is "
595
+ "not increased). The pointer stored is not ``NULL``."
597
596
msgstr ""
598
597
599
598
#: c-api/arg.rst:313
@@ -627,12 +626,12 @@ msgstr ""
627
626
628
627
#: c-api/arg.rst:330
629
628
msgid ""
630
- "where *object* is the Python object to be converted and *address* is "
631
- "the :c: expr:`void*` argument that was passed to the ``PyArg_Parse*`` "
632
- "function. The returned *status* should be ``1`` for a successful conversion "
633
- "and ``0`` if the conversion has failed. When the conversion fails, the "
634
- "*converter* function should raise an exception and leave the content of "
635
- "*address* unmodified."
629
+ "where *object* is the Python object to be converted and *address* is the :c: "
630
+ "expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
631
+ "returned *status* should be ``1`` for a successful conversion and ``0`` if "
632
+ "the conversion has failed. When the conversion fails, the *converter* "
633
+ "function should raise an exception and leave the content of *address* "
634
+ "unmodified."
636
635
msgstr ""
637
636
638
637
#: c-api/arg.rst:339
@@ -646,8 +645,8 @@ msgstr ""
646
645
647
646
#: c-api/arg.rst:345
648
647
msgid ""
649
- "Examples of converters: :c:func:`PyUnicode_FSConverter` "
650
- "and :c:func: `PyUnicode_FSDecoder`."
648
+ "Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func: "
649
+ "`PyUnicode_FSDecoder`."
651
650
msgstr ""
652
651
653
652
#: c-api/arg.rst:348
@@ -727,8 +726,8 @@ msgstr ""
727
726
#: c-api/arg.rst:390
728
727
msgid ""
729
728
"The list of format units ends here; the string after the semicolon is used "
730
- "as the error message *instead* of the default error message. ``:`` and "
731
- "``;`` mutually exclude each other."
729
+ "as the error message *instead* of the default error message. ``:`` and ``; "
730
+ "`` mutually exclude each other."
732
731
msgstr ""
733
732
734
733
#: c-api/arg.rst:394
@@ -779,10 +778,9 @@ msgstr ""
779
778
msgid ""
780
779
"Parse the parameters of a function that takes both positional and keyword "
781
780
"parameters into local variables. The *keywords* argument is a ``NULL``-"
782
- "terminated array of keyword parameter names. Empty names "
783
- "denote :ref:`positional-only parameters <positional-only_parameter>`. "
784
- "Returns true on success; on failure, it returns false and raises the "
785
- "appropriate exception."
781
+ "terminated array of keyword parameter names. Empty names denote :ref:"
782
+ "`positional-only parameters <positional-only_parameter>`. Returns true on "
783
+ "success; on failure, it returns false and raises the appropriate exception."
786
784
msgstr ""
787
785
788
786
#: c-api/arg.rst:437
@@ -891,10 +889,10 @@ msgid ""
891
889
"When memory buffers are passed as parameters to supply data to build "
892
890
"objects, as for the ``s`` and ``s#`` formats, the required data is copied. "
893
891
"Buffers provided by the caller are never referenced by the objects created "
894
- "by :c:func:`Py_BuildValue`. In other words, if your code "
895
- "invokes :c:func: `malloc` and passes the allocated memory "
896
- "to :c:func:`Py_BuildValue`, your code is responsible for "
897
- "calling :c:func:`free` for that memory once :c:func: `Py_BuildValue` returns."
892
+ "by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func: "
893
+ "`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your "
894
+ "code is responsible for calling :c:func:`free` for that memory once :c:func: "
895
+ "`Py_BuildValue` returns."
898
896
msgstr ""
899
897
900
898
#: c-api/arg.rst:533
@@ -1083,9 +1081,9 @@ msgid ""
1083
1081
"Pass a Python object untouched but create a new :term:`strong reference` to "
1084
1082
"it (i.e. its reference count is incremented by one). If the object passed in "
1085
1083
"is a ``NULL`` pointer, it is assumed that this was caused because the call "
1086
- "producing the argument found an error and set an exception. "
1087
- "Therefore, :c: func:`Py_BuildValue` will return ``NULL`` but won't raise an "
1088
- "exception. If no exception has been raised yet, :exc:`SystemError` is set."
1084
+ "producing the argument found an error and set an exception. Therefore, :c: "
1085
+ "func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If "
1086
+ "no exception has been raised yet, :exc:`SystemError` is set."
1089
1087
msgstr ""
1090
1088
1091
1089
#: c-api/arg.rst:640
@@ -1114,9 +1112,9 @@ msgstr ""
1114
1112
#: c-api/arg.rst:649
1115
1113
msgid ""
1116
1114
"Convert *anything* to a Python object through a *converter* function. The "
1117
- "function is called with *anything* (which should be compatible "
1118
- "with :c:expr: `void*`) as its argument and should return a \" new\" Python "
1119
- "object, or ``NULL`` if an error occurred."
1115
+ "function is called with *anything* (which should be compatible with :c:expr: "
1116
+ "`void*`) as its argument and should return a \" new\" Python object, or "
1117
+ "``NULL`` if an error occurred."
1120
1118
msgstr ""
1121
1119
1122
1120
#: c-api/arg.rst:655
0 commit comments