Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit fe8b255

Browse filesBrowse 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
Copy full SHA for fe8b255

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Dismiss banner
Expand file treeCollapse file tree

84 files changed

+4160
-4003
lines changed

‎c-api/arg.po

Copy file name to clipboardExpand all lines: c-api/arg.po
+88-79Lines changed: 88 additions & 79 deletions
Large diffs are not rendered by default.

‎c-api/call.po

Copy file name to clipboardExpand all lines: c-api/call.po
+11-11Lines 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

Copy file name to clipboardExpand all lines: c-api/capsule.po
+2-2Lines 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

Copy file name to clipboardExpand all lines: c-api/complex.po
+3-3Lines 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

Copy file name to clipboardExpand all lines: c-api/conversion.po
+26-24Lines 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

Copy file name to clipboardExpand all lines: c-api/dict.po
+4-4Lines 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

Copy file name to clipboardExpand all lines: c-api/exceptions.po
+15-15Lines 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 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.