Skip to content

Commit e17b9f3

Browse files
mattwang44mattwang44
authored
Merge pull request #915 from python/cron/sync/3.12
Sync with CPython 3.12
2 parents c4b0c7f + dbc9d22 commit e17b9f3

Some content is hidden

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

47 files changed

+7177
-6830
lines changed

‎c-api/cell.po

+20-10
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ msgid ""
1111
msgstr ""
1212
"Project-Id-Version: Python 3.12\n"
1313
"Report-Msgid-Bugs-To: \n"
14-
"POT-Creation-Date: 2021-09-13 00:11+0000\n"
14+
"POT-Creation-Date: 2024-07-10 00:04+0000\n"
1515
"PO-Revision-Date: 2022-10-16 15:33+0800\n"
1616
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1717
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -68,29 +68,39 @@ msgid ""
6868
msgstr "建立並回傳一個包含 *ob* 的新 cell 物件。參數可以為 ``NULL``。"
6969

7070
#: ../../c-api/cell.rst:42
71-
msgid "Return the contents of the cell *cell*."
72-
msgstr "回傳 cell 內容中的 *cell*。"
71+
msgid ""
72+
"Return the contents of the cell *cell*, which can be ``NULL``. If *cell* is "
73+
"not a cell object, returns ``NULL`` with an exception set."
74+
msgstr ""
75+
"回傳 cell 物件 *cell* 的內容，其可能為 ``NULL``。如果 *cell* 不是一個 cell 物"
76+
"件，則將回傳 ``NULL`` 並設定例外。"
7377

74-
#: ../../c-api/cell.rst:47
78+
#: ../../c-api/cell.rst:48
7579
msgid ""
7680
"Return the contents of the cell *cell*, but without checking that *cell* is "
7781
"non-``NULL`` and a cell object."
7882
msgstr ""
7983
"回傳 cell 物件 *cell* 的內容，但是不檢查 *cell* 是否非 ``NULL`` 並且為一個 "
8084
"cell 物件。"
8185

82-
#: ../../c-api/cell.rst:53
86+
#: ../../c-api/cell.rst:54
8387
msgid ""
8488
"Set the contents of the cell object *cell* to *value*. This releases the "
8589
"reference to any current content of the cell. *value* may be ``NULL``. "
86-
"*cell* must be non-``NULL``; if it is not a cell object, ``-1`` will be "
87-
"returned. On success, ``0`` will be returned."
90+
"*cell* must be non-``NULL``."
8891
msgstr ""
8992
"將 cell 物件 *cell* 的內容設為 *value*。這將釋放任何對 cell 物件當前內容的參"
90-
"照。*value* 可以為 ``NULL``。*cell* 必須不為 ``NULL``；如果它不是一個 cell 物"
91-
"件則將回傳 ``-1``。如果設定成功則將回傳 ``0``。"
93+
"照。*value* 可以為 ``NULL``。*cell* 必須不為 ``NULL``。"
94+
95+
#: ../../c-api/cell.rst:58
96+
msgid ""
97+
"On success, return ``0``. If *cell* is not a cell object, set an exception "
98+
"and return ``-1``."
99+
msgstr ""
100+
"在成功時回傳 ``0``。如果 *cell* 不是一個 cell 物件，則將設定例外並回傳 "
101+
"``-1``。"
92102

93-
#: ../../c-api/cell.rst:61
103+
#: ../../c-api/cell.rst:64
94104
msgid ""
95105
"Sets the value of the cell object *cell* to *value*. No reference counts "
96106
"are adjusted, and no checks are made for safety; *cell* must be non-``NULL`` "

‎c-api/complex.po

+56-31
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ msgid ""
77
msgstr ""
88
"Project-Id-Version: Python 3.12\n"
99
"Report-Msgid-Bugs-To: \n"
10-
"POT-Creation-Date: 2023-07-29 00:03+0000\n"
10+
"POT-Creation-Date: 2024-07-18 00:03+0000\n"
1111
"PO-Revision-Date: 2015-12-09 17:51+0000\n"
1212
"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
1313
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -52,136 +52,161 @@ msgid ""
5252
"The C structure which corresponds to the value portion of a Python complex "
5353
"number object. Most of the functions for dealing with complex number "
5454
"objects use structures of this type as input or output values, as "
55-
"appropriate. It is defined as::"
55+
"appropriate."
5656
msgstr ""
5757
"相對於 Python 複數物件之數值部分的 C 結構。大多數處理複數物件的函式根據需求會"
58-
"使用這種型別的結構作為輸入或輸出值。它定義為： ::"
58+
"使用這種型別的結構作為輸入或輸出值。"
5959

60-
#: ../../c-api/complex.rst:39
60+
#: ../../c-api/complex.rst:33
61+
msgid "The structure is defined as::"
62+
msgstr "該結構被定義為： ::"
63+
64+
#: ../../c-api/complex.rst:43
6165
msgid ""
6266
"Return the sum of two complex numbers, using the C :c:type:`Py_complex` "
6367
"representation."
6468
msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數之和。"
6569

66-
#: ../../c-api/complex.rst:45
70+
#: ../../c-api/complex.rst:49
6771
msgid ""
6872
"Return the difference between two complex numbers, using the C :c:type:"
6973
"`Py_complex` representation."
7074
msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數間的差。"
7175

72-
#: ../../c-api/complex.rst:51
76+
#: ../../c-api/complex.rst:55
7377
msgid ""
7478
"Return the negation of the complex number *num*, using the C :c:type:"
7579
"`Py_complex` representation."
7680
msgstr ""
7781
"以 C 的 :c:type:`Py_complex` 表示形式來回傳複數 *num* 的相反數 (negation)。"
7882

79-
#: ../../c-api/complex.rst:57
83+
#: ../../c-api/complex.rst:61
8084
msgid ""
8185
"Return the product of two complex numbers, using the C :c:type:`Py_complex` "
8286
"representation."
8387
msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數的乘積。"
8488

85-
#: ../../c-api/complex.rst:63
89+
#: ../../c-api/complex.rst:67
8690
msgid ""
8791
"Return the quotient of two complex numbers, using the C :c:type:`Py_complex` "
8892
"representation."
8993
msgstr "以 C 的 :c:type:`Py_complex` 表示形式來回傳兩個複數的商。"
9094

91-
#: ../../c-api/complex.rst:66
95+
#: ../../c-api/complex.rst:70
9296
msgid ""
9397
"If *divisor* is null, this method returns zero and sets :c:data:`errno` to :"
9498
"c:macro:`!EDOM`."
9599
msgstr ""
96100
"如果 *divisor* 為 null，則此方法會回傳零並將 :c:data:`errno` 設定為 :c:macro:"
97101
"`!EDOM`。"
98102

99-
#: ../../c-api/complex.rst:72
103+
#: ../../c-api/complex.rst:76
100104
msgid ""
101105
"Return the exponentiation of *num* by *exp*, using the C :c:type:"
102106
"`Py_complex` representation."
103107
msgstr ""
104108
"以 C 的 :c:type:`Py_complex` 表示形式來回傳 *num* 的 *exp* 次方的結果。"
105109

106-
#: ../../c-api/complex.rst:75
110+
#: ../../c-api/complex.rst:79
107111
msgid ""
108112
"If *num* is null and *exp* is not a positive real number, this method "
109113
"returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`."
110114
msgstr ""
111115
"如果 *num* 為 null 且 *exp* 不是正實數，則此方法會回傳零並將 :c:data:`errno` "
112116
"設定為 :c:macro:`!EDOM`。"
113117

114-
#: ../../c-api/complex.rst:80
118+
#: ../../c-api/complex.rst:84
115119
msgid "Complex Numbers as Python Objects"
116120
msgstr "作為 Python 物件的複數"
117121

118-
#: ../../c-api/complex.rst:85
122+
#: ../../c-api/complex.rst:89
119123
msgid ""
120124
"This subtype of :c:type:`PyObject` represents a Python complex number object."
121125
msgstr "這個 :c:type:`PyObject` 的子型別代表一個 Python 複數物件。"
122126

123-
#: ../../c-api/complex.rst:90
127+
#: ../../c-api/complex.rst:94
124128
msgid ""
125129
"This instance of :c:type:`PyTypeObject` represents the Python complex number "
126130
"type. It is the same object as :class:`complex` in the Python layer."
127131
msgstr ""
128132
"這個 :c:type:`PyTypeObject` 的實例代表 Python 複數型別。它與 Python 層中的 :"
129133
"class:`complex` 是同一個物件。"
130134

131-
#: ../../c-api/complex.rst:96
135+
#: ../../c-api/complex.rst:100
132136
msgid ""
133137
"Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :"
134138
"c:type:`PyComplexObject`. This function always succeeds."
135139
msgstr ""
136140
"如果其引數是一個 :c:type:`PyComplexObject` 或者是 :c:type:`PyComplexObject` "
137141
"的子型別，則會回傳 true。這個函式不會失敗。"
138142

139-
#: ../../c-api/complex.rst:102
143+
#: ../../c-api/complex.rst:106
140144
msgid ""
141145
"Return true if its argument is a :c:type:`PyComplexObject`, but not a "
142146
"subtype of :c:type:`PyComplexObject`. This function always succeeds."
143147
msgstr ""
144148
"如果其引數是一個 :c:type:`PyComplexObject`，但不是 :c:type:`PyComplexObject` "
145149
"的子型別，則會回傳 true。這個函式不會失敗。"
146150

147-
#: ../../c-api/complex.rst:108
151+
#: ../../c-api/complex.rst:112
148152
msgid ""
149153
"Create a new Python complex number object from a C :c:type:`Py_complex` "
150-
"value."
151-
msgstr "從 C 的 :c:type:`Py_complex` 值建立一個新的 Python 複數物件。"
152-
153-
#: ../../c-api/complex.rst:113
154-
msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*."
155-
msgstr "從 *real* 和 *imag* 回傳一個新的 :c:type:`PyComplexObject` 物件。"
154+
"value. Return ``NULL`` with an exception set on error."
155+
msgstr ""
156+
"從 C 的 :c:type:`Py_complex` 值建立一個新的 Python 複數物件。在錯誤時回傳 "
157+
"``NULL`` 並設定例外。"
156158

157159
#: ../../c-api/complex.rst:118
160+
msgid ""
161+
"Return a new :c:type:`PyComplexObject` object from *real* and *imag*. Return "
162+
"``NULL`` with an exception set on error."
163+
msgstr ""
164+
"從 *real* 和 *imag* 回傳一個新的 :c:type:`PyComplexObject` 物件。在錯誤時回"
165+
"傳 ``NULL`` 並設定例外。"
166+
167+
#: ../../c-api/complex.rst:124
158168
msgid "Return the real part of *op* as a C :c:expr:`double`."
159169
msgstr "以 C 的 :c:expr:`double` 形式回傳 *op* 的實部。"
160170

161-
#: ../../c-api/complex.rst:123
171+
#: ../../c-api/complex.rst:126
172+
msgid ""
173+
"Upon failure, this method returns ``-1.0`` with an exception set, so one "
174+
"should call :c:func:`PyErr_Occurred` to check for errors."
175+
msgstr ""
176+
"失敗時，此方法回傳 ``-1.0`` 並設定例外，因此應該呼叫 :c:func:"
177+
"`PyErr_Occurred` 來檢查錯誤。"
178+
179+
#: ../../c-api/complex.rst:132
162180
msgid "Return the imaginary part of *op* as a C :c:expr:`double`."
163181
msgstr "將 *op* 的虛部作為 C 的 :c:expr:`double` 回傳。"
164182

165-
#: ../../c-api/complex.rst:128
183+
#: ../../c-api/complex.rst:137
166184
msgid "Return the :c:type:`Py_complex` value of the complex number *op*."
167185
msgstr "回傳複數 *op* 的 :c:type:`Py_complex` 值。"
168186

169-
#: ../../c-api/complex.rst:130
187+
#: ../../c-api/complex.rst:139
170188
msgid ""
171189
"If *op* is not a Python complex number object but has a :meth:`~object."
172190
"__complex__` method, this method will first be called to convert *op* to a "
173191
"Python complex number object. If :meth:`!__complex__` is not defined then "
174192
"it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not "
175-
"defined then it falls back to :meth:`~object.__index__`. Upon failure, this "
176-
"method returns ``-1.0`` as a real value."
193+
"defined then it falls back to :meth:`~object.__index__`."
177194
msgstr ""
178195
"如果 *op* 不是 Python 複數物件，但有一個 :meth:`~object.__complex__` 方法，則"
179196
"首先會呼叫該方法將 *op* 轉換為 Python 複數物件。如果 :meth:`!__complex__` 並"
180197
"未定義，那麼它會回退到 :meth:`~object.__float__`。如果 :meth:`!__float__` 未"
181-
"定義，則它將繼續回退為 :meth:`~object.__index__`。失敗時，此方法回傳 "
182-
"``-1.0`` 作為實部值。"
198+
"定義，則它將繼續回退為 :meth:`~object.__index__`。"
183199

184-
#: ../../c-api/complex.rst:137
200+
#: ../../c-api/complex.rst:145
201+
msgid ""
202+
"Upon failure, this method returns :c:type:`Py_complex` with :c:member:"
203+
"`~Py_complex.real` set to ``-1.0`` and with an exception set, so one should "
204+
"call :c:func:`PyErr_Occurred` to check for errors."
205+
msgstr ""
206+
"失敗時，此方法回傳 :c:type:`Py_complex` 並將 :c:member:`~Py_complex.real` 設"
207+
"為 ``-1.0``，並設定例外，因此應該呼叫 :c:func:`PyErr_Occurred` 來檢查錯誤。"
208+
209+
#: ../../c-api/complex.rst:149
185210
msgid "Use :meth:`~object.__index__` if available."
186211
msgstr "如果可用則使用 :meth:`~object.__index__`。"
187212

0 commit comments

Comments
 (0)