🌐 AI搜索 & 代理 主页
Skip to content

Commit fe8b255

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44
authored
Sync with CPython 3.10 (#321)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Wei-Hsiang (Matt) Wang <mattwang44@gmail.com>
1 parent 272e0c1 commit fe8b255

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

84 files changed

+4160
-4003
lines changed

‎c-api/arg.po‎

Lines changed: 88 additions & 79 deletions
Large diffs are not rendered by default.

‎c-api/call.po‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.10\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2022-06-11 14:46+0800\n"
12-
"PO-Revision-Date: 2022-06-12 14:46+0800\n"
11+
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
12+
"PO-Revision-Date: 2022-10-16 03:20+0800\n"
1313
"Last-Translator: Matt Wang <mattwag44@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
1515
"tw)\n"
@@ -18,7 +18,7 @@ msgstr ""
1818
"Content-Type: text/plain; charset=UTF-8\n"
1919
"Content-Transfer-Encoding: 8bit\n"
2020
"Plural-Forms: nplurals=1; plural=0;\n"
21-
"X-Generator: Poedit 3.1\n"
21+
"X-Generator: Poedit 3.1.1\n"
2222

2323
#: ../../c-api/call.rst:6
2424
msgid "Call Protocol"
@@ -525,10 +525,10 @@ msgstr ""
525525

526526
#: ../../c-api/call.rst:278
527527
msgid ""
528-
"Note that if you only pass :c:type:`PyObject *` args, :c:func:"
528+
"Note that if you only pass :c:expr:`PyObject *` args, :c:func:"
529529
"`PyObject_CallFunctionObjArgs` is a faster alternative."
530530
msgstr ""
531-
"注意，如果你只傳入 :c:type:`PyObject *` 引數，則 :c:func:"
531+
"注意，如果你只傳入 :c:expr:`PyObject *` 引數，則 :c:func:"
532532
"`PyObject_CallFunctionObjArgs` 是另一個更快速的選擇。"
533533

534534
#: ../../c-api/call.rst:281
@@ -556,10 +556,10 @@ msgstr "這等價於 Python 運算式 ``obj.name(arg1, arg2, ...)``。"
556556

557557
#: ../../c-api/call.rst:299
558558
msgid ""
559-
"Note that if you only pass :c:type:`PyObject *` args, :c:func:"
559+
"Note that if you only pass :c:expr:`PyObject *` args, :c:func:"
560560
"`PyObject_CallMethodObjArgs` is a faster alternative."
561561
msgstr ""
562-
"注意，如果你只傳入 :c:type:`PyObject *` 引數，則 :c:func:"
562+
"注意，如果你只傳入 :c:expr:`PyObject *` 引數，則 :c:func:"
563563
"`PyObject_CallMethodObjArgs` 是另一個更快速的選擇。"
564564

565565
#: ../../c-api/call.rst:302
@@ -568,11 +568,11 @@ msgstr "*name* 和 *format* 的型別已從 ``char *`` 更改。"
568568

569569
#: ../../c-api/call.rst:308
570570
msgid ""
571-
"Call a callable Python object *callable*, with a variable number of :c:type:"
571+
"Call a callable Python object *callable*, with a variable number of :c:expr:"
572572
"`PyObject *` arguments. The arguments are provided as a variable number of "
573573
"parameters followed by *NULL*."
574574
msgstr ""
575-
"呼叫一個可呼叫的 Python 物件 *callable*，附帶數量可變的 :c:type:`PyObject *` "
575+
"呼叫一個可呼叫的 Python 物件 *callable*，附帶數量可變的 :c:expr:`PyObject *` "
576576
"引數。這些引數是以位置在 *NULL* 後面、數量可變的參數來提供。"
577577

578578
#: ../../c-api/call.rst:315
@@ -585,11 +585,11 @@ msgstr "���等價於 Python 運算式 ``callable(arg1, arg2, ...)``。"
585585
msgid ""
586586
"Call a method of the Python object *obj*, where the name of the method is "
587587
"given as a Python string object in *name*. It is called with a variable "
588-
"number of :c:type:`PyObject *` arguments. The arguments are provided as a "
588+
"number of :c:expr:`PyObject *` arguments. The arguments are provided as a "
589589
"variable number of parameters followed by *NULL*."
590590
msgstr ""
591591
"呼叫 Python 物件 *obj* 中的一個 method，其中 method 名稱由 *name* 中的 "
592-
"Python 字串物件給定。被呼叫時會附帶數量可變的 :c:type:`PyObject *` 引數。這些"
592+
"Python 字串物件給定。被呼叫時會附帶數量可變的 :c:expr:`PyObject *` 引數。這些"
593593
"引數是以位置在 *NULL* 後面、且數量可變的參數來提供。"
594594

595595
#: ../../c-api/call.rst:332

‎c-api/capsule.po‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.10\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2021-09-13 00:11+0000\n"
10+
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
1111
"PO-Revision-Date: 2018-05-23 14:30+0000\n"
1212
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -30,7 +30,7 @@ msgstr ""
3030
#: ../../c-api/capsule.rst:17
3131
msgid ""
3232
"This subtype of :c:type:`PyObject` represents an opaque value, useful for C "
33-
"extension modules who need to pass an opaque value (as a :c:type:`void*` "
33+
"extension modules who need to pass an opaque value (as a :c:expr:`void*` "
3434
"pointer) through Python code to other C code. It is often used to make a C "
3535
"function pointer defined in one module available to other modules, so the "
3636
"regular import mechanism can be used to access C APIs defined in dynamically "

‎c-api/complex.po‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.10\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2021-09-13 00:11+0000\n"
10+
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
1111
"PO-Revision-Date: 2015-12-09 17:51+0000\n"
1212
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -135,11 +135,11 @@ msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*."
135135
msgstr ""
136136

137137
#: ../../c-api/complex.rst:118
138-
msgid "Return the real part of *op* as a C :c:type:`double`."
138+
msgid "Return the real part of *op* as a C :c:expr:`double`."
139139
msgstr ""
140140

141141
#: ../../c-api/complex.rst:123
142-
msgid "Return the imaginary part of *op* as a C :c:type:`double`."
142+
msgid "Return the imaginary part of *op* as a C :c:expr:`double`."
143143
msgstr ""
144144

145145
#: ../../c-api/complex.rst:128

‎c-api/conversion.po‎

Lines changed: 26 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.10\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2021-10-26 16:47+0000\n"
12+
"POT-Creation-Date: 2022-10-08 00:21+0000\n"
1313
"PO-Revision-Date: 2017-09-22 18:26+0000\n"
1414
"Last-Translator: Leon H.\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -55,58 +55,60 @@ msgid ""
5555
"The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. "
5656
"They never write more than *size* bytes (including the trailing ``'\\0'``) "
5757
"into str. Both functions require that ``str != NULL``, ``size > 0``, "
58-
"``format != NULL`` and ``size < INT_MAX``."
58+
"``format != NULL`` and ``size < INT_MAX``. Note that this means there is no "
59+
"equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine "
60+
"the necessary buffer size."
5961
msgstr ""
6062

61-
#: ../../c-api/conversion.rst:33
63+
#: ../../c-api/conversion.rst:34
6264
msgid ""
6365
"The return value (*rv*) for these functions should be interpreted as follows:"
6466
msgstr "當回傳值 (*rv*) 給這些函數應該被編譯如下："
6567

66-
#: ../../c-api/conversion.rst:35
68+
#: ../../c-api/conversion.rst:36
6769
msgid ""
6870
"When ``0 <= rv < size``, the output conversion was successful and *rv* "
6971
"characters were written to *str* (excluding the trailing ``'\\0'`` byte at "
7072
"``str[rv]``)."
7173
msgstr ""
7274

73-
#: ../../c-api/conversion.rst:39
75+
#: ../../c-api/conversion.rst:40
7476
msgid ""
7577
"When ``rv >= size``, the output conversion was truncated and a buffer with "
7678
"``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is "
7779
"``'\\0'`` in this case."
7880
msgstr ""
7981

80-
#: ../../c-api/conversion.rst:43
82+
#: ../../c-api/conversion.rst:44
8183
msgid ""
8284
"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in "
8385
"this case too, but the rest of *str* is undefined. The exact cause of the "
8486
"error depends on the underlying platform."
8587
msgstr ""
8688

87-
#: ../../c-api/conversion.rst:48
89+
#: ../../c-api/conversion.rst:49
8890
msgid ""
8991
"The following functions provide locale-independent string to number "
9092
"conversions."
9193
msgstr ""
9294

93-
#: ../../c-api/conversion.rst:52
95+
#: ../../c-api/conversion.rst:53
9496
msgid ""
95-
"Convert a string ``s`` to a :c:type:`double`, raising a Python exception on "
97+
"Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on "
9698
"failure. The set of accepted strings corresponds to the set of strings "
9799
"accepted by Python's :func:`float` constructor, except that ``s`` must not "
98100
"have leading or trailing whitespace. The conversion is independent of the "
99101
"current locale."
100102
msgstr ""
101103

102-
#: ../../c-api/conversion.rst:58
104+
#: ../../c-api/conversion.rst:59
103105
msgid ""
104106
"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:"
105107
"`ValueError` and return ``-1.0`` if the string is not a valid representation "
106108
"of a floating-point number."
107109
msgstr ""
108110

109-
#: ../../c-api/conversion.rst:62
111+
#: ../../c-api/conversion.rst:63
110112
msgid ""
111113
"If endptr is not ``NULL``, convert as much of the string as possible and set "
112114
"``*endptr`` to point to the first unconverted character. If no initial "
@@ -115,7 +117,7 @@ msgid ""
115117
"ValueError, and return ``-1.0``."
116118
msgstr ""
117119

118-
#: ../../c-api/conversion.rst:69
120+
#: ../../c-api/conversion.rst:70
119121
msgid ""
120122
"If ``s`` represents a value that is too large to store in a float (for "
121123
"example, ``\"1e500\"`` is such a string on many platforms) then if "
@@ -126,71 +128,71 @@ msgid ""
126128
"the first character after the converted value."
127129
msgstr ""
128130

129-
#: ../../c-api/conversion.rst:77
131+
#: ../../c-api/conversion.rst:78
130132
msgid ""
131133
"If any other error occurs during the conversion (for example an out-of-"
132134
"memory error), set the appropriate Python exception and return ``-1.0``."
133135
msgstr ""
134136

135-
#: ../../c-api/conversion.rst:86
137+
#: ../../c-api/conversion.rst:87
136138
msgid ""
137-
"Convert a :c:type:`double` *val* to a string using supplied *format_code*, "
139+
"Convert a :c:expr:`double` *val* to a string using supplied *format_code*, "
138140
"*precision*, and *flags*."
139141
msgstr ""
140142

141-
#: ../../c-api/conversion.rst:89
143+
#: ../../c-api/conversion.rst:90
142144
msgid ""
143145
"*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "
144146
"``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is "
145147
"ignored. The ``'r'`` format code specifies the standard :func:`repr` format."
146148
msgstr ""
147149

148-
#: ../../c-api/conversion.rst:94
150+
#: ../../c-api/conversion.rst:95
149151
msgid ""
150152
"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, "
151153
"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:"
152154
msgstr ""
153155

154-
#: ../../c-api/conversion.rst:97
156+
#: ../../c-api/conversion.rst:98
155157
msgid ""
156158
"``Py_DTSF_SIGN`` means to always precede the returned string with a sign "
157159
"character, even if *val* is non-negative."
158160
msgstr ""
159161

160-
#: ../../c-api/conversion.rst:100
162+
#: ../../c-api/conversion.rst:101
161163
msgid ""
162164
"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look "
163165
"like an integer."
164166
msgstr ""
165167

166-
#: ../../c-api/conversion.rst:103
168+
#: ../../c-api/conversion.rst:104
167169
msgid ""
168170
"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the "
169171
"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details."
170172
msgstr ""
171173

172-
#: ../../c-api/conversion.rst:107
174+
#: ../../c-api/conversion.rst:108
173175
msgid ""
174176
"If *ptype* is non-``NULL``, then the value it points to will be set to one "
175177
"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying "
176178
"that *val* is a finite number, an infinite number, or not a number, "
177179
"respectively."
178180
msgstr ""
179181

180-
#: ../../c-api/conversion.rst:111
182+
#: ../../c-api/conversion.rst:112
181183
msgid ""
182184
"The return value is a pointer to *buffer* with the converted string or "
183185
"``NULL`` if the conversion failed. The caller is responsible for freeing the "
184186
"returned string by calling :c:func:`PyMem_Free`."
185187
msgstr ""
186188

187-
#: ../../c-api/conversion.rst:120
189+
#: ../../c-api/conversion.rst:121
188190
msgid ""
189191
"Case insensitive comparison of strings. The function works almost "
190192
"identically to :c:func:`strcmp` except that it ignores the case."
191193
msgstr ""
192194

193-
#: ../../c-api/conversion.rst:126
195+
#: ../../c-api/conversion.rst:127
194196
msgid ""
195197
"Case insensitive comparison of strings. The function works almost "
196198
"identically to :c:func:`strncmp` except that it ignores the case."

‎c-api/dict.po‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.10\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2021-10-26 16:47+0000\n"
12+
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
1313
"PO-Revision-Date: 2017-09-22 18:26+0000\n"
1414
"Last-Translator: Liang-Bo Wang <me@liang2.tw>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -91,7 +91,7 @@ msgstr ""
9191
#: ../../c-api/dict.rst:75
9292
msgid ""
9393
"Insert *val* into the dictionary *p* using *key* as a key. *key* should be "
94-
"a :c:type:`const char*`. The key object is created using "
94+
"a :c:expr:`const char*`. The key object is created using "
9595
"``PyUnicode_FromString(key)``. Return ``0`` on success or ``-1`` on "
9696
"failure. This function *does not* steal a reference to *val*."
9797
msgstr ""
@@ -139,7 +139,7 @@ msgstr ""
139139
#: ../../c-api/dict.rst:120
140140
msgid ""
141141
"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
142-
"type:`const char*`, rather than a :c:type:`PyObject*`."
142+
"expr:`const char*`, rather than a :c:expr:`PyObject*`."
143143
msgstr ""
144144

145145
#: ../../c-api/dict.rst:123
@@ -187,7 +187,7 @@ msgid ""
187187
"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
188188
"first call to this function to start the iteration; the function returns "
189189
"true for each pair in the dictionary, and false once all pairs have been "
190-
"reported. The parameters *pkey* and *pvalue* should either point to :c:type:"
190+
"reported. The parameters *pkey* and *pvalue* should either point to :c:expr:"
191191
"`PyObject*` variables that will be filled in with each key and value, "
192192
"respectively, or may be ``NULL``. Any references returned through them are "
193193
"borrowed. *ppos* should not be altered during iteration. Its value "

‎c-api/exceptions.po‎

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python 3.10\n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2022-05-21 17:35+0000\n"
11+
"POT-Creation-Date: 2022-10-06 00:23+0000\n"
1212
"PO-Revision-Date: 2018-05-23 14:05+0000\n"
1313
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1414
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -32,8 +32,8 @@ msgid ""
3232
"occurred. Most C API functions don't clear this on success, but will set it "
3333
"to indicate the cause of the error on failure. Most C API functions also "
3434
"return an error indicator, usually ``NULL`` if they are supposed to return a "
35-
"pointer, or ``-1`` if they return an integer (exception: the :c:func:`PyArg_"
36-
"\\*` functions return ``1`` for success and ``0`` for failure)."
35+
"pointer, or ``-1`` if they return an integer (exception: the ``PyArg_*`` "
36+
"functions return ``1`` for success and ``0`` for failure)."
3737
msgstr ""
3838

3939
#: ../../c-api/exceptions.rst:20
@@ -223,12 +223,12 @@ msgstr ""
223223
#: ../../c-api/exceptions.rst:191
224224
msgid ""
225225
"This is a convenience function to raise :exc:`WindowsError`. If called with "
226-
"*ierr* of :c:data:`0`, the error code returned by a call to :c:func:"
227-
"`GetLastError` is used instead. It calls the Win32 function :c:func:"
228-
"`FormatMessage` to retrieve the Windows description of error code given by "
229-
"*ierr* or :c:func:`GetLastError`, then it constructs a tuple object whose "
230-
"first item is the *ierr* value and whose second item is the corresponding "
231-
"error message (gotten from :c:func:`FormatMessage`), and then calls "
226+
"*ierr* of ``0``, the error code returned by a call to :c:func:`GetLastError` "
227+
"is used instead. It calls the Win32 function :c:func:`FormatMessage` to "
228+
"retrieve the Windows description of error code given by *ierr* or :c:func:"
229+
"`GetLastError`, then it constructs a tuple object whose first item is the "
230+
"*ierr* value and whose second item is the corresponding error message "
231+
"(gotten from :c:func:`FormatMessage`), and then calls "
232232
"``PyErr_SetObject(PyExc_WindowsError, object)``. This function always "
233233
"returns ``NULL``."
234234
msgstr ""
@@ -393,10 +393,10 @@ msgstr ""
393393
#: ../../c-api/exceptions.rst:372
394394
msgid ""
395395
"Test whether the error indicator is set. If set, return the exception "
396-
"*type* (the first argument to the last call to one of the :c:func:`PyErr_Set"
397-
"\\*` functions or to :c:func:`PyErr_Restore`). If not set, return "
398-
"``NULL``. You do not own a reference to the return value, so you do not "
399-
"need to :c:func:`Py_DECREF` it."
396+
"*type* (the first argument to the last call to one of the ``PyErr_Set*`` "
397+
"functions or to :c:func:`PyErr_Restore`). If not set, return ``NULL``. You "
398+
"do not own a reference to the return value, so you do not need to :c:func:"
399+
"`Py_DECREF` it."
400400
msgstr ""
401401

402402
#: ../../c-api/exceptions.rst:378
@@ -884,7 +884,7 @@ msgstr ""
884884
msgid ""
885885
"All standard Python exceptions are available as global variables whose names "
886886
"are ``PyExc_`` followed by the Python exception name. These have the type :"
887-
"c:type:`PyObject*`; they are all class objects. For completeness, here are "
887+
"c:expr:`PyObject*`; they are all class objects. For completeness, here are "
888888
"all the variables:"
889889
msgstr ""
890890

@@ -1407,7 +1407,7 @@ msgstr ""
14071407
msgid ""
14081408
"All standard Python warning categories are available as global variables "
14091409
"whose names are ``PyExc_`` followed by the Python exception name. These have "
1410-
"the type :c:type:`PyObject*`; they are all class objects. For completeness, "
1410+
"the type :c:expr:`PyObject*`; they are all class objects. For completeness, "
14111411
"here are all the variables:"
14121412
msgstr ""
14131413

0 commit comments

Comments
 (0)