99msgstr ""
1010"Project-Id-Version :Python 3.12\n "
1111"Report-Msgid-Bugs-To :\n "
12- "POT-Creation-Date :2023-08-26 00:03+0000\n "
12+ "POT-Creation-Date :2023-09-03 00:03+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- "
@@ -87,71 +87,70 @@ msgid ""
8787"to *val*."
8888msgstr ""
8989
90- #: ../../c-api/dict.rst:75
90+ #: ../../c-api/dict.rst:73
9191msgid ""
92- "Insert *val* into the dictionary *p* using *key* as a key. *key* should be "
93- "a :c:expr:`const char*` UTF-8 encoded bytes string. The key object is "
94- "created using ``PyUnicode_FromString(key)``. Return ``0`` on success or "
95- "``-1`` on failure. This function *does not* steal a reference to *val*."
92+ "This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as a :c:"
93+ "expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
94+ "`PyObject*`."
9695msgstr ""
9796
98- #: ../../c-api/dict.rst:83
97+ #: ../../c-api/dict.rst:80
9998msgid ""
10099"Remove the entry in dictionary *p* with key *key*. *key* must be :term:"
101100"`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is not in the "
102101"dictionary, :exc:`KeyError` is raised. Return ``0`` on success or ``-1`` on "
103102"failure."
104103msgstr ""
105104
106- #: ../../c-api/dict.rst:91
105+ #: ../../c-api/dict.rst:88
107106msgid ""
108- "Remove theentry in dictionary *p* which has a key specifiedby the UTF-8 "
109- "encoded bytes string *key*. If *key* is not in the dictionary, :exc :"
110- "`KeyError` is raised. Return ``0`` on success or ``-1`` on failure ."
107+ "This is thesame as :c:func:`PyDict_DelItem`, but *key* is specifiedas a :c: "
108+ "expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr :"
109+ "`PyObject*` ."
111110msgstr ""
112111
113- #: ../../c-api/dict.rst:99
112+ #: ../../c-api/dict.rst:95
114113msgid ""
115114"Return the object from dictionary *p* which has a key *key*. Return "
116115"``NULL`` if the key *key* is not present, but *without* setting an exception."
117116msgstr ""
118117
119- #: ../../c-api/dict.rst:104
118+ #: ../../c-api/dict.rst:100
120119msgid ""
121120"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
122121"`~object.__eq__` methods are silently ignored. Prefer the :c:func:"
123122"`PyDict_GetItemWithError` function instead."
124123msgstr ""
125124
126- #: ../../c-api/dict.rst:108
125+ #: ../../c-api/dict.rst:104
127126msgid ""
128127"Calling this API without :term:`GIL` held had been allowed for historical "
129128"reason. It is no longer allowed."
130129msgstr ""
131130
132- #: ../../c-api/dict.rst:115
131+ #: ../../c-api/dict.rst:111
133132msgid ""
134133"Variant of :c:func:`PyDict_GetItem` that does not suppress exceptions. "
135134"Return ``NULL`` **with** an exception set if an exception occurred. Return "
136135"``NULL`` **without** an exception set if the key wasn't present."
137136msgstr ""
138137
139- #: ../../c-api/dict.rst:123
138+ #: ../../c-api/dict.rst:119
140139msgid ""
141140"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
142141"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
143142"`PyObject*`."
144143msgstr ""
145144
146- #: ../../c-api/dict.rst:129
145+ #: ../../c-api/dict.rst:125
147146msgid ""
148147"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
149148"`~object.__eq__` methods or while creating the temporary :class:`str` object "
150149"are silently ignored. Prefer using the :c:func:`PyDict_GetItemWithError` "
151150"function with your own :c:func:`PyUnicode_FromString` *key* instead."
152151msgstr ""
153152
154- #: ../../c-api/dict.rst:138
153+ #: ../../c-api/dict.rst:134
155154msgid ""
156155"This is the same as the Python-level :meth:`dict.setdefault`. If present, "
157156"it returns the value corresponding to *key* from the dictionary *p*. If the "
@@ -161,29 +160,29 @@ msgid ""
161160"the insertion."
162161msgstr ""
163162
164- #: ../../c-api/dict.rst:148
163+ #: ../../c-api/dict.rst:144
165164msgid ""
166165"Return a :c:type:`PyListObject` containing all the items from the dictionary."
167166msgstr ""
168167
169- #: ../../c-api/dict.rst:153
168+ #: ../../c-api/dict.rst:149
170169msgid ""
171170"Return a :c:type:`PyListObject` containing all the keys from the dictionary."
172171msgstr ""
173172
174- #: ../../c-api/dict.rst:158
173+ #: ../../c-api/dict.rst:154
175174msgid ""
176175"Return a :c:type:`PyListObject` containing all the values from the "
177176"dictionary *p*."
178177msgstr ""
179178
180- #: ../../c-api/dict.rst:166
179+ #: ../../c-api/dict.rst:162
181180msgid ""
182181"Return the number of items in the dictionary. This is equivalent to "
183182"``len(p)`` on a dictionary."
184183msgstr ""
185184
186- #: ../../c-api/dict.rst:172
185+ #: ../../c-api/dict.rst:168
187186msgid ""
188187"Iterate over all key-value pairs in the dictionary *p*. The :c:type:"
189188"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
@@ -197,21 +196,21 @@ msgid ""
197196"structure is sparse, the offsets are not consecutive."
198197msgstr ""
199198
200- #: ../../c-api/dict.rst:183
199+ #: ../../c-api/dict.rst:179
201200msgid "For example::"
202201msgstr ""
203202"舉例來說：\n"
204203"\n"
205204"::"
206205
207- #: ../../c-api/dict.rst:193
206+ #: ../../c-api/dict.rst:189
208207msgid ""
209208"The dictionary *p* should not be mutated during iteration. It is safe to "
210209"modify the values of the keys as you iterate over the dictionary, but only "
211210"so long as the set of keys does not change. For example::"
212211msgstr ""
213212
214- #: ../../c-api/dict.rst:218
213+ #: ../../c-api/dict.rst:214
215214msgid ""
216215"Iterate over mapping object *b* adding key-value pairs to dictionary *a*. "
217216"*b* may be a dictionary, or any object supporting :c:func:`PyMapping_Keys` "
@@ -221,7 +220,7 @@ msgid ""
221220"or ``-1`` if an exception was raised."
222221msgstr ""
223222
224- #: ../../c-api/dict.rst:228
223+ #: ../../c-api/dict.rst:224
225224msgid ""
226225"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a."
227226"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back "
@@ -230,7 +229,7 @@ msgid ""
230229"exception was raised."
231230msgstr ""
232231
233- #: ../../c-api/dict.rst:237
232+ #: ../../c-api/dict.rst:233
234233msgid ""
235234"Update or merge into dictionary *a*, from the key-value pairs in *seq2*. "
236235"*seq2* must be an iterable object producing iterable objects of length 2, "
@@ -239,49 +238,49 @@ msgid ""
239238"if an exception was raised. Equivalent Python (except for the return value)::"
240239msgstr ""
241240
242- #: ../../c-api/dict.rst:251
241+ #: ../../c-api/dict.rst:247
243242msgid ""
244243"Register *callback* as a dictionary watcher. Return a non-negative integer "
245244"id which must be passed to future calls to :c:func:`PyDict_Watch`. In case "
246245"of error (e.g. no more watcher IDs available), return ``-1`` and set an "
247246"exception."
248247msgstr ""
249248
250- #: ../../c-api/dict.rst:260
249+ #: ../../c-api/dict.rst:256
251250msgid ""
252251"Clear watcher identified by *watcher_id* previously returned from :c:func:"
253252"`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error (e.g. if the "
254253"given *watcher_id* was never registered.)"
255254msgstr ""
256255
257- #: ../../c-api/dict.rst:268
256+ #: ../../c-api/dict.rst:264
258257msgid ""
259258"Mark dictionary *dict* as watched. The callback granted *watcher_id* by :c:"
260259"func:`PyDict_AddWatcher` will be called when *dict* is modified or "
261260"deallocated. Return ``0`` on success or ``-1`` on error."
262261msgstr ""
263262
264- #: ../../c-api/dict.rst:276
263+ #: ../../c-api/dict.rst:272
265264msgid ""
266265"Mark dictionary *dict* as no longer watched. The callback granted "
267266"*watcher_id* by :c:func:`PyDict_AddWatcher` will no longer be called when "
268267"*dict* is modified or deallocated. The dict must previously have been "
269268"watched by this watcher. Return ``0`` on success or ``-1`` on error."
270269msgstr ""
271270
272- #: ../../c-api/dict.rst:285
271+ #: ../../c-api/dict.rst:281
273272msgid ""
274273"Enumeration of possible dictionary watcher events: ``PyDict_EVENT_ADDED``, "
275274"``PyDict_EVENT_MODIFIED``, ``PyDict_EVENT_DELETED``, "
276275"``PyDict_EVENT_CLONED``, ``PyDict_EVENT_CLEARED``, or "
277276"``PyDict_EVENT_DEALLOCATED``."
278277msgstr ""
279278
280- #: ../../c-api/dict.rst:293
279+ #: ../../c-api/dict.rst:289
281280msgid "Type of a dict watcher callback function."
282281msgstr ""
283282
284- #: ../../c-api/dict.rst:295
283+ #: ../../c-api/dict.rst:291
285284msgid ""
286285"If *event* is ``PyDict_EVENT_CLEARED`` or ``PyDict_EVENT_DEALLOCATED``, both "
287286"*key* and *new_value* will be ``NULL``. If *event* is ``PyDict_EVENT_ADDED`` "
@@ -290,22 +289,22 @@ msgid ""
290289"dictionary and *new_value* will be ``NULL``."
291290msgstr ""
292291
293- #: ../../c-api/dict.rst:301
292+ #: ../../c-api/dict.rst:297
294293msgid ""
295294"``PyDict_EVENT_CLONED`` occurs when *dict* was previously empty and another "
296295"dict is merged into it. To maintain efficiency of this operation, per-key "
297296"``PyDict_EVENT_ADDED`` events are not issued in this case; instead a single "
298297"``PyDict_EVENT_CLONED`` is issued, and *key* will be the source dictionary."
299298msgstr ""
300299
301- #: ../../c-api/dict.rst:307
300+ #: ../../c-api/dict.rst:303
302301msgid ""
303302"The callback may inspect but must not modify *dict*; doing so could have "
304303"unpredictable effects, including infinite recursion. Do not trigger Python "
305304"code execution in the callback, as it could modify the dict as a side effect."
306305msgstr ""
307306
308- #: ../../c-api/dict.rst:311
307+ #: ../../c-api/dict.rst:307
309308msgid ""
310309"If *event* is ``PyDict_EVENT_DEALLOCATED``, taking a new reference in the "
311310"callback to the about-to-be-destroyed dictionary will resurrect it and "
@@ -314,20 +313,20 @@ msgid ""
314313"again."
315314msgstr ""
316315
317- #: ../../c-api/dict.rst:317
316+ #: ../../c-api/dict.rst:313
318317msgid ""
319318"Callbacks occur before the notified modification to *dict* takes place, so "
320319"the prior state of *dict* can be inspected."
321320msgstr ""
322321
323- #: ../../c-api/dict.rst:320
322+ #: ../../c-api/dict.rst:316
324323msgid ""
325324"If the callback sets an exception, it must return ``-1``; this exception "
326325"will be printed as an unraisable exception using :c:func:"
327326"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
328327msgstr ""
329328
330- #: ../../c-api/dict.rst:324
329+ #: ../../c-api/dict.rst:320
331330msgid ""
332331"There may already be a pending exception set on entry to the callback. In "
333332"this case, the callback should return ``0`` with the same exception still "
@@ -344,14 +343,13 @@ msgstr "object（物件）"
344343msgid "dictionary"
345344msgstr "dictionary（字典）"
346345
347- #: ../../c-api/dict.rst:73
348- msgid "PyUnicode_FromString()"
349- msgstr "PyUnicode_FromString()"
350-
351- #: ../../c-api/dict.rst:164
346+ #: ../../c-api/dict.rst:160
352347msgid "built-in function"
353348msgstr "built-in function（內建函式）"
354349
355- #: ../../c-api/dict.rst:164
350+ #: ../../c-api/dict.rst:160
356351msgid "len"
357352msgstr "len"
353+
354+ #~ msgid "PyUnicode_FromString()"
355+ #~ msgstr "PyUnicode_FromString()"