@@ -25,17 +25,17 @@ msgstr "剖析引數與建置數值"
2525#: ../../c-api/arg.rst:8
2626msgid ""
2727"These functions are useful when creating your own extension functions and "
28- "methods. Additional information and examples are available in :ref: "
29- "`extending-index`."
28+ "methods. Additional information and examples are available "
29+ "in :ref: `extending-index`."
3030msgstr ""
3131
3232#: ../../c-api/arg.rst:12
3333msgid ""
34- "The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c: "
35- "func:`PyArg_ParseTupleAndKeywords `, and :c:func:`PyArg_Parse`, all use "
36- "*format strings* which are used to tell the function about the expected "
37- "arguments. The format strings use the same syntax for each of these "
38- "functions."
34+ "The first three of these functions "
35+ "described, :c: func:`PyArg_ParseTuple `, :c:func:`PyArg_ParseTupleAndKeywords`, "
36+ "and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell "
37+ "the function about the expected arguments. The format strings use the same "
38+ "syntax for each of these functions."
3939msgstr ""
4040
4141#: ../../c-api/arg.rst:19
@@ -108,10 +108,10 @@ msgstr ""
108108
109109#: ../../c-api/arg.rst:70
110110msgid ""
111- "To ensure that the underlying buffer may be safely borrowed, the object's :c: "
112- "member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
113- "disallows common mutable objects such as :class:`bytearray`, but also some "
114- "read-only objects such as :class:`memoryview` of :class:`bytes`."
111+ "To ensure that the underlying buffer may be safely borrowed, the "
112+ "object's :c: member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. "
113+ "This disallows common mutable objects such as :class:`bytearray`, but also "
114+ "some read-only objects such as :class:`memoryview` of :class:`bytes`."
115115msgstr ""
116116
117117#: ../../c-api/arg.rst:76
@@ -139,8 +139,8 @@ msgstr ""
139139msgid ""
140140"This format does not accept :term:`bytes-like objects <bytes-like object>`. "
141141"If you want to accept filesystem paths and convert them to C character "
142- "strings, it is preferable to use the ``O&`` format with :c:func: "
143- "`PyUnicode_FSConverter` as *converter*."
142+ "strings, it is preferable to use the ``O&`` format "
143+ "with :c:func: `PyUnicode_FSConverter` as *converter*."
144144msgstr ""
145145
146146#: ../../c-api/arg.rst:96
@@ -163,11 +163,11 @@ msgstr ""
163163
164164#: ../../c-api/arg.rst:106
165165msgid ""
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`]"
168168msgstr ""
169- "``s#`` (:class:`str`、唯讀的 :term:`bytes-like object`) [const char \\ *, :c: "
170- "type:`Py_ssize_t`]"
169+ "``s#`` (:class:`str`、唯讀的 :term:`bytes-like object`) [const char "
170+ "\\ *, :c: type:`Py_ssize_t`]"
171171
172172#: ../../c-api/arg.rst:107
173173msgid ""
@@ -244,11 +244,11 @@ msgstr ""
244244
245245#: ../../c-api/arg.rst:141
246246msgid ""
247- "``y#`` (read-only :term:`bytes-like object`) [const char \\ *, :c:type: "
248- "`Py_ssize_t`]"
247+ "``y#`` (read-only :term:`bytes-like object`) [const char "
248+ "\\ *, :c:type: `Py_ssize_t`]"
249249msgstr ""
250- "``y#`` (唯讀的 :term:`bytes-like object`) [const char \\ *, :c:type: "
251- "`Py_ssize_t`]"
250+ "``y#`` (唯讀的 :term:`bytes-like object`) [const char "
251+ "\\ *, :c:type: `Py_ssize_t`]"
252252
253253#: ../../c-api/arg.rst:142
254254msgid ""
@@ -274,9 +274,9 @@ msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
274274#: ../../c-api/arg.rst:151
275275msgid ""
276276"Requires that the Python object is a :class:`bytearray` object, without "
277- "attempting any conversion. Raises :exc:`TypeError` if the object is not a : "
278- "class:`bytearray` object. The C variable may also be declared as :c:expr: "
279- "`PyObject*`."
277+ "attempting any conversion. Raises :exc:`TypeError` if the object is not "
278+ "a : class:`bytearray` object. The C variable may also be declared "
279+ "as :c:expr: `PyObject*`."
280280msgstr ""
281281
282282#: ../../c-api/arg.rst:155
@@ -298,8 +298,8 @@ msgstr "``w*`` (可讀寫 :term:`bytes-like object`) [Py_buffer]"
298298msgid ""
299299"This format accepts any object which implements the read-write buffer "
300300"interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
301- "The buffer may contain embedded null bytes. The caller have to call :c:func: "
302- "`PyBuffer_Release` when it is done with the buffer."
301+ "The buffer may contain embedded null bytes. The caller have to "
302+ "call :c:func: `PyBuffer_Release` when it is done with the buffer."
303303msgstr ""
304304
305305#: ../../c-api/arg.rst:166
@@ -327,8 +327,8 @@ msgstr ""
327327msgid ""
328328":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
329329"the encoded data into this buffer and adjust *\\ *buffer* to reference the "
330- "newly allocated storage. The caller is responsible for calling :c:func: "
331- "`PyMem_Free` to free the allocated buffer after use."
330+ "newly allocated storage. The caller is responsible for "
331+ "calling :c:func: `PyMem_Free` to free the allocated buffer after use."
332332msgstr ""
333333
334334#: ../../c-api/arg.rst:183
@@ -348,11 +348,11 @@ msgstr ""
348348
349349#: ../../c-api/arg.rst:188
350350msgid ""
351- "``es#`` (:class:`str`) [const char \\ *encoding, char \\ * \\ *buffer, :c:type: "
352- "`Py_ssize_t` \\ *buffer_length]"
351+ "``es#`` (:class:`str`) [const char \\ *encoding, char "
352+ "\\ * \\ *buffer, :c:type: `Py_ssize_t` \\ *buffer_length]"
353353msgstr ""
354- "``es#`` (:class:`str`) [const char \\ *encoding, char \\ * \\ *buffer, :c:type: "
355- "`Py_ssize_t` \\ *buffer_length]"
354+ "``es#`` (:class:`str`) [const char \\ *encoding, char "
355+ "\\ * \\ *buffer, :c:type: `Py_ssize_t` \\ *buffer_length]"
356356
357357#: ../../c-api/arg.rst:189
358358msgid ""
@@ -428,10 +428,11 @@ msgstr "數字"
428428#: ../../c-api/arg.rst:232
429429msgid ""
430430"These formats allow representing Python numbers or single characters as C "
431- "numbers. Formats that require :class:`int`, :class:`float` or :class:"
432- "`complex` can also use the corresponding special methods :meth:`~object."
433- "__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to "
434- "convert the Python object to the required type."
431+ "numbers. Formats that require :class:`int`, :class:`float` "
432+ "or :class:`complex` can also use the corresponding special "
433+ "methods :meth:`~object.__index__`, :meth:`~object.__float__` "
434+ "or :meth:`~object.__complex__` to convert the Python object to the required "
435+ "type."
435436msgstr ""
436437
437438#: ../../c-api/arg.rst:238
@@ -451,8 +452,8 @@ msgid ""
451452"Convert a nonnegative Python integer to an unsigned tiny integer, stored in "
452453"a C :c:expr:`unsigned char`."
453454msgstr ""
454- "將一個 Python 非負整數轉換成無符號 tiny integer(小整數),儲存在 C 的 :c: "
455- "expr:`unsigned`"
455+ "將一個 Python 非負整數轉換成無符號 tiny integer(小整數),儲存在 C "
456+ "的 :c: expr:`unsigned`"
456457
457458#: ../../c-api/arg.rst:248 ../../c-api/arg.rst:627
458459msgid "``B`` (:class:`int`) [unsigned char]"
@@ -463,8 +464,8 @@ msgid ""
463464"Convert a Python integer to a tiny integer without overflow checking, stored "
464465"in a C :c:expr:`unsigned char`."
465466msgstr ""
466- "將一個 Python 整數轉換成 tiny integer,轉換過程無溢位檢查,儲存在 C 的 :c: "
467- "expr:`unsigned char`。"
467+ "將一個 Python 整數轉換成 tiny integer,轉換過程無溢位檢查,儲存在 C "
468+ "的 :c: expr:`unsigned char`。"
468469
469470#: ../../c-api/arg.rst:252 ../../c-api/arg.rst:621
470471msgid "``h`` (:class:`int`) [short int]"
@@ -611,9 +612,9 @@ msgstr "``O`` (object) [PyObject \\*]"
611612#: ../../c-api/arg.rst:307
612613msgid ""
613614"Store a Python object (without any conversion) in a C object pointer. The C "
614- "program thus receives the actual object that was passed. A new :term: "
615- "`strong reference` to the object is not created (i.e. its reference count is "
616- "not increased). The pointer stored is not ``NULL``."
615+ "program thus receives the actual object that was passed. A "
616+ "new :term: `strong reference` to the object is not created (i.e. its "
617+ "reference count is not increased). The pointer stored is not ``NULL``."
617618msgstr ""
618619
619620#: ../../c-api/arg.rst:313
@@ -647,12 +648,12 @@ msgstr "status = converter(object, address);"
647648
648649#: ../../c-api/arg.rst:330
649650msgid ""
650- "where *object* is the Python object to be converted and *address* is the :c: "
651- "expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
652- "returned *status* should be ``1`` for a successful conversion and ``0`` if "
653- "the conversion has failed. When the conversion fails, the *converter* "
654- "function should raise an exception and leave the content of *address* "
655- "unmodified."
651+ "where *object* is the Python object to be converted and *address* is "
652+ "the :c: expr:`void*` argument that was passed to the ``PyArg_Parse*`` "
653+ "function. The returned *status* should be ``1`` for a successful conversion "
654+ "and ``0`` if the conversion has failed. When the conversion fails, the "
655+ "*converter* function should raise an exception and leave the content of "
656+ "*address* unmodified."
656657msgstr ""
657658
658659#: ../../c-api/arg.rst:339
@@ -666,8 +667,8 @@ msgstr ""
666667
667668#: ../../c-api/arg.rst:345
668669msgid ""
669- "Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func: "
670- "`PyUnicode_FSDecoder`."
670+ "Examples of converters: :c:func:`PyUnicode_FSConverter` "
671+ "and :c:func: `PyUnicode_FSDecoder`."
671672msgstr ""
672673
673674#: ../../c-api/arg.rst:348
@@ -747,8 +748,8 @@ msgstr "``;``"
747748#: ../../c-api/arg.rst:390
748749msgid ""
749750"The list of format units ends here; the string after the semicolon is used "
750- "as the error message *instead* of the default error message. ``:`` and ``; "
751- "`` mutually exclude each other."
751+ "as the error message *instead* of the default error message. ``:`` and "
752+ "``;`` mutually exclude each other."
752753msgstr ""
753754
754755#: ../../c-api/arg.rst:394
@@ -807,9 +808,9 @@ msgstr ""
807808
808809#: ../../c-api/arg.rst:441
809810msgid ""
810- "The *keywords* parameter declaration is :c:expr:`char * const *` in C and :c: "
811- "expr:`const char * const *` in C++. This can be overridden with the :c:macro: "
812- "`PY_CXX_CONST` macro."
811+ "The *keywords* parameter declaration is :c:expr:`char * const *` in C "
812+ "and :c: expr:`const char * const *` in C++. This can be overridden with "
813+ "the :c:macro: `PY_CXX_CONST` macro."
813814msgstr ""
814815
815816#: ../../c-api/arg.rst:445
@@ -820,9 +821,9 @@ msgstr "新增對\\ :ref:`僅限位置參數 <positional-only_parameter>`\\ 的
820821
821822#: ../../c-api/arg.rst:449
822823msgid ""
823- "The *keywords* parameter has now type :c:expr:`char * const *` in C and :c: "
824- "expr:`const char * const *` in C++, instead of :c:expr:`char **`. Added "
825- "support for non-ASCII keyword parameter names."
824+ "The *keywords* parameter has now type :c:expr:`char * const *` in C "
825+ "and :c: expr:`const char * const *` in C++, instead of :c:expr:`char **`. "
826+ "Added support for non-ASCII keyword parameter names."
826827msgstr ""
827828
828829#: ../../c-api/arg.rst:458
@@ -960,10 +961,10 @@ msgid ""
960961"When memory buffers are passed as parameters to supply data to build "
961962"objects, as for the ``s`` and ``s#`` formats, the required data is copied. "
962963"Buffers provided by the caller are never referenced by the objects created "
963- "by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func: "
964- "`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your "
965- "code is responsible for calling :c:func:`free` for that memory once :c:func: "
966- "`Py_BuildValue` returns."
964+ "by :c:func:`Py_BuildValue`. In other words, if your code "
965+ "invokes :c:func: `malloc` and passes the allocated memory "
966+ "to :c:func:`Py_BuildValue`, your code is responsible for "
967+ "calling :c:func:`free` for that memory once :c:func: `Py_BuildValue` returns."
967968msgstr ""
968969
969970#: ../../c-api/arg.rst:568
@@ -1127,16 +1128,16 @@ msgid ""
11271128"Convert a C :c:expr:`int` representing a byte to a Python :class:`bytes` "
11281129"object of length 1."
11291130msgstr ""
1130- "將一個 C 中代表一個位元組的 :c:expr:`int` 轉換成 Python 中長度為一的 :class: "
1131- "`bytes`。"
1131+ "將一個 C 中代表一個位元組的 :c:expr:`int` 轉換成 Python 中長度為一 "
1132+ "的 :class: `bytes`。"
11321133
11331134#: ../../c-api/arg.rst:655
11341135msgid ""
11351136"Convert a C :c:expr:`int` representing a character to Python :class:`str` "
11361137"object of length 1."
11371138msgstr ""
1138- "將一個 C 中代表一個字元的 :c:expr:`int` 轉換成 Python 中長度為一的 :class: "
1139- "`str`。"
1139+ "將一個 C 中代表一個字元的 :c:expr:`int` 轉換成 Python 中長度為一 "
1140+ "的 :class: `str`。"
11401141
11411142#: ../../c-api/arg.rst:659
11421143msgid "Convert a C :c:expr:`double` to a Python floating-point number."
@@ -1159,9 +1160,9 @@ msgid ""
11591160"Pass a Python object untouched but create a new :term:`strong reference` to "
11601161"it (i.e. its reference count is incremented by one). If the object passed in "
11611162"is a ``NULL`` pointer, it is assumed that this was caused because the call "
1162- "producing the argument found an error and set an exception. Therefore, :c: "
1163- "func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If "
1164- "no exception has been raised yet, :exc:`SystemError` is set."
1163+ "producing the argument found an error and set an exception. "
1164+ "Therefore, :c: func:`Py_BuildValue` will return ``NULL`` but won't raise an "
1165+ "exception. If no exception has been raised yet, :exc:`SystemError` is set."
11651166msgstr ""
11661167
11671168#: ../../c-api/arg.rst:677
@@ -1179,8 +1180,8 @@ msgstr "``N`` (object) [PyObject \\*]"
11791180#: ../../c-api/arg.rst:681
11801181msgid ""
11811182"Same as ``O``, except it doesn't create a new :term:`strong reference`. "
1182- "Useful when the object is created by a call to an object constructor in the "
1183- "argument list."
1183+ "Useful when the object is created by a call to an object in the argument "
1184+ "list."
11841185msgstr ""
11851186
11861187#: ../../c-api/arg.rst:685
@@ -1190,9 +1191,9 @@ msgstr "``O&`` (object) [*converter*, *anything*]"
11901191#: ../../c-api/arg.rst:686
11911192msgid ""
11921193"Convert *anything* to a Python object through a *converter* function. The "
1193- "function is called with *anything* (which should be compatible with :c:expr: "
1194- "`void*`) as its argument and should return a \" new\" Python object, or "
1195- "``NULL`` if an error occurred."
1194+ "function is called with *anything* (which should be compatible "
1195+ "with :c:expr: `void*`) as its argument and should return a \" new\" Python "
1196+ "object, or ``NULL`` if an error occurred."
11961197msgstr ""
11971198
11981199#: ../../c-api/arg.rst:692
0 commit comments