Skip to content

Commit a48e697

Browse files
pydoc-zh-tw[bot]github-actions[bot]mattwang44claude
authored
Sync with CPython 3.14 (#1224)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: W. H. Wang <mattwang44@gmail.com> Co-authored-by: Claude <noreply@anthropic.com>
1 parent d85b1ba commit a48e697

File tree

11 files changed

+1556
-1341
lines changed

11 files changed

+1556
-1341
lines changed

c-api/dict.po

Lines changed: 143 additions & 90 deletions
Large diffs are not rendered by default.

c-api/set.po

Lines changed: 54 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ msgid ""
66
msgstr ""
77
"Project-Id-Version: Python 3.14\n"
88
"Report-Msgid-Bugs-To: \n"
9-
"POT-Creation-Date: 2026-01-15 00:15+0000\n"
9+
"POT-Creation-Date: 2026-04-12 00:25+0000\n"
1010
"PO-Revision-Date: 2018-05-23 14:07+0000\n"
1111
"Last-Translator: Adrian Liaw <adrianliaw2000@gmail.com>\n"
1212
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -70,44 +70,48 @@ msgid ""
7070
"Return true if *p* is a :class:`set` object or an instance of a subtype. "
7171
"This function always succeeds."
7272
msgstr ""
73-
"如果 *p* 是 :class:`set` 物件或是子類別的實例,則回傳 true。此函式總會成功執行。"
73+
"如果 *p* 是 :class:`set` 物件或是子類別的實例,則回傳 true。此函式總會成功執"
74+
"行。"
7475

7576
#: ../../c-api/set.rst:60
7677
msgid ""
7778
"Return true if *p* is a :class:`frozenset` object or an instance of a "
7879
"subtype. This function always succeeds."
7980
msgstr ""
80-
"如果 *p* 是 :class:`frozenset` 物件或是子類別的實例,則回傳 true。此函式總會成功執行。"
81+
"如果 *p* 是 :class:`frozenset` 物件或是子類別的實例,則回傳 true。此函式總會"
82+
"成功執行。"
8183

8284
#: ../../c-api/set.rst:65
8385
msgid ""
8486
"Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or "
8587
"an instance of a subtype. This function always succeeds."
8688
msgstr ""
87-
"如果 *p* 是 :class:`set` 物件、:class:`frozenset` 物件,或是子類別的實例,則回傳 true。"
88-
"此函式總會成功執行。"
89+
"如果 *p* 是 :class:`set` 物件、:class:`frozenset` 物件,或是子類別的實例,"
90+
"回傳 true。此函式總會成功執行。"
8991

9092
#: ../../c-api/set.rst:70
9193
msgid ""
9294
"Return true if *p* is a :class:`set` object but not an instance of a "
9395
"subtype. This function always succeeds."
9496
msgstr ""
95-
"如果 *p* 是 :class:`set` 物件但不是子類別的實例,則回傳 true。此函式總會成功執行。"
97+
"如果 *p* 是 :class:`set` 物件但不是子類別的實例,則回傳 true。此函式總會成功"
98+
"執行。"
9699

97100
#: ../../c-api/set.rst:77
98101
msgid ""
99102
"Return true if *p* is a :class:`set` object or a :class:`frozenset` object "
100103
"but not an instance of a subtype. This function always succeeds."
101104
msgstr ""
102-
"如果 *p* 是 :class:`set` 物件或 :class:`frozenset` 物件但不是子類別的實例,則回傳 "
103-
"true。此函式總會成功執行。"
105+
"如果 *p* 是 :class:`set` 物件或 :class:`frozenset` 物件但不是子類別的實例,"
106+
"回傳 true。此函式總會成功執行。"
104107

105108
#: ../../c-api/set.rst:83
106109
msgid ""
107110
"Return true if *p* is a :class:`frozenset` object but not an instance of a "
108111
"subtype. This function always succeeds."
109112
msgstr ""
110-
"如果 *p* 是 :class:`frozenset` 物件但不是子類別的實例,則回傳 true。此函式總會成功執行。"
113+
"如果 *p* 是 :class:`frozenset` 物件但不是子類別的實例,則回傳 true。此函式總"
114+
"會成功執行。"
111115

112116
#: ../../c-api/set.rst:89
113117
msgid ""
@@ -118,32 +122,38 @@ msgid ""
118122
"(``c=set(s)``)."
119123
msgstr ""
120124

121-
#: ../../c-api/set.rst:98
125+
#: ../../c-api/set.rst:97 ../../c-api/set.rst:110
126+
msgid ""
127+
"The operation is atomic on :term:`free threading <free-threaded build>` when "
128+
"*iterable* is a :class:`set`, :class:`frozenset` or :class:`dict`."
129+
msgstr ""
130+
131+
#: ../../c-api/set.rst:103
122132
msgid ""
123133
"Return a new :class:`frozenset` containing objects returned by the "
124134
"*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset. "
125135
"Return the new set on success or ``NULL`` on failure. Raise :exc:"
126136
"`TypeError` if *iterable* is not actually iterable."
127137
msgstr ""
128138

129-
#: ../../c-api/set.rst:104
139+
#: ../../c-api/set.rst:114
130140
msgid ""
131141
"The following functions and macros are available for instances of :class:"
132142
"`set` or :class:`frozenset` or instances of their subtypes."
133143
msgstr ""
134144

135-
#: ../../c-api/set.rst:112
145+
#: ../../c-api/set.rst:122
136146
msgid ""
137147
"Return the length of a :class:`set` or :class:`frozenset` object. Equivalent "
138148
"to ``len(anyset)``. Raises a :exc:`SystemError` if *anyset* is not a :class:"
139149
"`set`, :class:`frozenset`, or an instance of a subtype."
140150
msgstr ""
141151

142-
#: ../../c-api/set.rst:119
152+
#: ../../c-api/set.rst:129
143153
msgid "Macro form of :c:func:`PySet_Size` without error checking."
144154
msgstr ""
145155

146-
#: ../../c-api/set.rst:124
156+
#: ../../c-api/set.rst:134
147157
msgid ""
148158
"Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is "
149159
"encountered. Unlike the Python :meth:`~object.__contains__` method, this "
@@ -153,7 +163,14 @@ msgid ""
153163
"instance of a subtype."
154164
msgstr ""
155165

156-
#: ../../c-api/set.rst:133
166+
#: ../../c-api/set.rst:142 ../../c-api/set.rst:157 ../../c-api/set.rst:177
167+
msgid ""
168+
"The operation is atomic on :term:`free threading <free-threaded build>` when "
169+
"*key* is :class:`str`, :class:`int`, :class:`float`, :class:`bool` or :class:"
170+
"`bytes`."
171+
msgstr ""
172+
173+
#: ../../c-api/set.rst:147
157174
msgid ""
158175
"Add *key* to a :class:`set` instance. Also works with :class:`frozenset` "
159176
"instances (like :c:func:`PyTuple_SetItem` it can be used to fill in the "
@@ -164,13 +181,13 @@ msgid ""
164181
"`set` or its subtype."
165182
msgstr ""
166183

167-
#: ../../c-api/set.rst:142
184+
#: ../../c-api/set.rst:162
168185
msgid ""
169186
"The following functions are available for instances of :class:`set` or its "
170187
"subtypes but not for instances of :class:`frozenset` or its subtypes."
171188
msgstr ""
172189

173-
#: ../../c-api/set.rst:148
190+
#: ../../c-api/set.rst:168
174191
msgid ""
175192
"Return ``1`` if found and removed, ``0`` if not found (no action taken), and "
176193
"``-1`` if an error is encountered. Does not raise :exc:`KeyError` for "
@@ -180,45 +197,52 @@ msgid ""
180197
"if *set* is not an instance of :class:`set` or its subtype."
181198
msgstr ""
182199

183-
#: ../../c-api/set.rst:158
200+
#: ../../c-api/set.rst:183
184201
msgid ""
185202
"Return a new reference to an arbitrary object in the *set*, and removes the "
186203
"object from the *set*. Return ``NULL`` on failure. Raise :exc:`KeyError` "
187204
"if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance "
188205
"of :class:`set` or its subtype."
189206
msgstr ""
190207

191-
#: ../../c-api/set.rst:166
208+
#: ../../c-api/set.rst:191
192209
msgid ""
193210
"Empty an existing set of all elements. Return ``0`` on success. Return "
194211
"``-1`` and raise :exc:`SystemError` if *set* is not an instance of :class:"
195212
"`set` or its subtype."
196213
msgstr ""
197214

198-
#: ../../c-api/set.rst:172
215+
#: ../../c-api/set.rst:197
216+
msgid ""
217+
"In the :term:`free-threaded build`, the set is emptied before its entries "
218+
"are cleared, so other threads will observe an empty set rather than "
219+
"intermediate states."
220+
msgstr ""
221+
222+
#: ../../c-api/set.rst:203
199223
msgid "Deprecated API"
200224
msgstr "已棄用的 API"
201225

202-
#: ../../c-api/set.rst:176
226+
#: ../../c-api/set.rst:207
203227
msgid ""
204228
"A :term:`soft deprecated` constant representing the size of an internal "
205229
"preallocated table inside :c:type:`PySetObject` instances."
206230
msgstr ""
207-
"一個被\\ :term:`軟性棄用 <soft deprecated>`\\ 的常數,代表 :c:type:`PySetObject` "
208-
"實例內部預分配表格的大小。"
231+
"一個被\\ :term:`軟性棄用 <soft deprecated>`\\ 的常數,代表 :c:type:"
232+
"`PySetObject` 實例內部預分配表格的大小。"
209233

210-
#: ../../c-api/set.rst:179
234+
#: ../../c-api/set.rst:210
211235
msgid ""
212236
"This is documented solely for completeness, as there are no guarantees that "
213237
"a given version of CPython uses preallocated tables with a fixed size. In "
214238
"code that does not deal with unstable set internals, :c:macro:`!"
215239
"PySet_MINSIZE` can be replaced with a small constant like ``8``."
216240
msgstr ""
217-
"這僅為完整性而記錄於文件,且因為無法保證特定版本的 CPython 會使用具有固定大小的預分配表格。"
218-
"在不處理不穩定集合內部結構的程式碼中,:c:macro:`!PySet_MINSIZE` 可以替換為像 ``8`` "
219-
"這樣的小常數。"
241+
"這僅為完整性而記錄於文件,且因為無法保證特定版本的 CPython 會使用具有固定大小"
242+
"的預分配表格。在不處理不穩定集合內部結構的程式碼中,:c:macro:`!"
243+
"PySet_MINSIZE` 可以替換為像 ``8`` 這樣的小常數。"
220244

221-
#: ../../c-api/set.rst:185
245+
#: ../../c-api/set.rst:216
222246
msgid "If looking for the size of a set, use :c:func:`PySet_Size` instead."
223247
msgstr "如果要查詢集合的大小,請使用 :c:func:`PySet_Size`。"
224248

@@ -234,10 +258,10 @@ msgstr "set(集合)"
234258
msgid "frozenset"
235259
msgstr "frozenset(凍結集合)"
236260

237-
#: ../../c-api/set.rst:110
261+
#: ../../c-api/set.rst:120
238262
msgid "built-in function"
239263
msgstr "built-in function(內建函式)"
240264

241-
#: ../../c-api/set.rst:110
265+
#: ../../c-api/set.rst:120
242266
msgid "len"
243267
msgstr "len"

0 commit comments

Comments
 (0)