python
diff --git a/‎c-api/dict.po
Lines changed: 70 additions & 62 deletions b/‎c-api/dict.po
Lines changed: 70 additions & 62 deletions
@@ -34,8 +34,8 @@ msgid ""
 "This instance of :c:type:`PyTypeObject` represents the Python dictionary "
 "type.  This is the same object as :class:`dict` in the Python layer."
 msgstr ""
-":c:type:`PyTypeObject` 實例代表一個 Python 字典型態。此與 Python 層中的 :"
-"class:`dict` 為同一個物件。"
+":c:type:`PyTypeObject` 實例代表一個 Python 字典型態。此與 Python 層中"
+"的 :class:`dict` 為同一個物件。"
 
 #: ../../c-api/dict.rst:24
 msgid ""
@@ -77,9 +77,9 @@ msgstr ""
 
 #: ../../c-api/dict.rst:60
 msgid ""
-"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as a :"
-"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
-"`PyObject*`."
+"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as "
+"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
+"a :c:expr:`PyObject*`."
 msgstr ""
 
 #: ../../c-api/dict.rst:69
@@ -88,32 +88,32 @@ msgstr ""
 
 #: ../../c-api/dict.rst:74
 msgid ""
-"Insert *val* into the dictionary *p* with a key of *key*.  *key* must be :"
-"term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` "
-"on success or ``-1`` on failure.  This function *does not* steal a reference "
-"to *val*."
+"Insert *val* into the dictionary *p* with a key of *key*.  *key* must "
+"be :term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return "
+"``0`` on success or ``-1`` on failure.  This function *does not* steal a "
+"reference to *val*."
 msgstr ""
 
 #: ../../c-api/dict.rst:82
 msgid ""
-"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as a :c:"
-"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
-"`PyObject*`."
+"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as "
+"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
+"a :c:expr:`PyObject*`."
 msgstr ""
 
 #: ../../c-api/dict.rst:89
 msgid ""
-"Remove the entry in dictionary *p* with key *key*. *key* must be :term:"
-"`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is not in the "
-"dictionary, :exc:`KeyError` is raised. Return ``0`` on success or ``-1`` on "
-"failure."
+"Remove the entry in dictionary *p* with key *key*. *key* must "
+"be :term:`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is "
+"not in the dictionary, :exc:`KeyError` is raised. Return ``0`` on success or "
+"``-1`` on failure."
 msgstr ""
 
 #: ../../c-api/dict.rst:97
 msgid ""
-"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as a :c:"
-"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
-"`PyObject*`."
+"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as "
+"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
+"a :c:expr:`PyObject*`."
 msgstr ""
 
 #: ../../c-api/dict.rst:104
@@ -134,11 +134,11 @@ msgstr ""
 
 #: ../../c-api/dict.rst:110 ../../c-api/dict.rst:207
 msgid "On error, raise an exception and return ``-1``."
-msgstr ""
+msgstr "錯誤發生時，引發一個例外並回傳 ``-1``。"
 
 #: ../../c-api/dict.rst:114
 msgid "See also the :c:func:`PyObject_GetItem` function."
-msgstr ""
+msgstr "另見 :c:func:`PyObject_GetItem` 函式。"
 
 #: ../../c-api/dict.rst:119
 msgid ""
@@ -149,9 +149,9 @@ msgstr ""
 
 #: ../../c-api/dict.rst:125
 msgid ""
-"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
-"`~object.__eq__` methods are silently ignored. Prefer the :c:func:"
-"`PyDict_GetItemWithError` function instead."
+"Exceptions that occur while this calls :meth:`~object.__hash__` "
+"and :meth:`~object.__eq__` methods are silently ignored. Prefer "
+"the :c:func:`PyDict_GetItemWithError` function instead."
 msgstr ""
 
 #: ../../c-api/dict.rst:129
@@ -169,23 +169,25 @@ msgstr ""
 
 #: ../../c-api/dict.rst:144
 msgid ""
-"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
-"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:"
-"`PyObject*`."
+"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as "
+"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
+"a :c:expr:`PyObject*`."
 msgstr ""
 
 #: ../../c-api/dict.rst:150
 msgid ""
-"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:"
-"`~object.__eq__` methods or while creating the temporary :class:`str` object "
-"are silently ignored. Prefer using the :c:func:`PyDict_GetItemWithError` "
-"function with your own :c:func:`PyUnicode_FromString` *key* instead."
+"Exceptions that occur while this calls :meth:`~object.__hash__` "
+"and :meth:`~object.__eq__` methods or while creating the "
+"temporary :class:`str` object are silently ignored. Prefer using "
+"the :c:func:`PyDict_GetItemWithError` function with your "
+"own :c:func:`PyUnicode_FromString` *key* instead."
 msgstr ""
 
 #: ../../c-api/dict.rst:159
 msgid ""
-"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as a :c:expr:"
-"`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`."
+"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as "
+"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than "
+"a :c:expr:`PyObject*`."
 msgstr ""
 
 #: ../../c-api/dict.rst:168
@@ -238,8 +240,8 @@ msgstr ""
 
 #: ../../c-api/dict.rst:209
 msgid ""
-"Similar to :meth:`dict.pop`, but without the default value and not raising :"
-"exc:`KeyError` if the key missing."
+"Similar to :meth:`dict.pop`, but without the default value and not "
+"raising :exc:`KeyError` if the key missing."
 msgstr ""
 
 #: ../../c-api/dict.rst:217
@@ -251,37 +253,37 @@ msgstr ""
 #: ../../c-api/dict.rst:226
 msgid ""
 "Return a :c:type:`PyListObject` containing all the items from the dictionary."
-msgstr ""
+msgstr "回傳一個包含字典中所有項目的 :c:type:`PyListObject`。"
 
 #: ../../c-api/dict.rst:231
 msgid ""
 "Return a :c:type:`PyListObject` containing all the keys from the dictionary."
-msgstr ""
+msgstr "回傳一個包含字典中所有鍵的 :c:type:`PyListObject`。"
 
 #: ../../c-api/dict.rst:236
 msgid ""
 "Return a :c:type:`PyListObject` containing all the values from the "
 "dictionary *p*."
-msgstr ""
+msgstr "回傳一個包含字典 *p* 中所有值的 :c:type:`PyListObject`。"
 
 #: ../../c-api/dict.rst:244
 msgid ""
 "Return the number of items in the dictionary.  This is equivalent to "
 "``len(p)`` on a dictionary."
-msgstr ""
+msgstr "回傳字典中項目的數量。此與於字典呼叫 ``len(p)`` 等效。"
 
 #: ../../c-api/dict.rst:250
 msgid ""
-"Iterate over all key-value pairs in the dictionary *p*.  The :c:type:"
-"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
-"first call to this function to start the iteration; the function returns "
-"true for each pair in the dictionary, and false once all pairs have been "
-"reported.  The parameters *pkey* and *pvalue* should either point to :c:expr:"
-"`PyObject*` variables that will be filled in with each key and value, "
-"respectively, or may be ``NULL``.  Any references returned through them are "
-"borrowed.  *ppos* should not be altered during iteration. Its value "
-"represents offsets within the internal dictionary structure, and since the "
-"structure is sparse, the offsets are not consecutive."
+"Iterate over all key-value pairs in the dictionary *p*.  "
+"The :c:type:`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` "
+"prior to the first call to this function to start the iteration; the "
+"function returns true for each pair in the dictionary, and false once all "
+"pairs have been reported.  The parameters *pkey* and *pvalue* should either "
+"point to :c:expr:`PyObject*` variables that will be filled in with each key "
+"and value, respectively, or may be ``NULL``.  Any references returned "
+"through them are borrowed.  *ppos* should not be altered during iteration. "
+"Its value represents offsets within the internal dictionary structure, and "
+"since the structure is sparse, the offsets are not consecutive."
 msgstr ""
 
 #: ../../c-api/dict.rst:261
@@ -347,8 +349,9 @@ msgstr ""
 #: ../../c-api/dict.rst:293
 msgid ""
 "The function is not thread-safe in the :term:`free-threaded <free "
-"threading>` build without external synchronization.  You can use :c:macro:"
-"`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while iterating over it::"
+"threading>` build without external synchronization.  You can "
+"use :c:macro:`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while "
+"iterating over it::"
 msgstr ""
 
 #: ../../c-api/dict.rst:298
@@ -359,6 +362,11 @@ msgid ""
 "}\n"
 "Py_END_CRITICAL_SECTION();"
 msgstr ""
+"Py_BEGIN_CRITICAL_SECTION(self->dict);\n"
+"while (PyDict_Next(self->dict, &pos, &key, &value)) {\n"
+"    ...\n"
+"}\n"
+"Py_END_CRITICAL_SECTION();"
 
 #: ../../c-api/dict.rst:307
 msgid ""
@@ -372,10 +380,10 @@ msgstr ""
 
 #: ../../c-api/dict.rst:317
 msgid ""
-"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a."
-"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back "
-"to the iterating over a sequence of key value pairs if the second argument "
-"has no \"keys\" attribute.  Return ``0`` on success or ``-1`` if an "
+"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to "
+"``a.update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall "
+"back to the iterating over a sequence of key value pairs if the second "
+"argument has no \"keys\" attribute.  Return ``0`` on success or ``-1`` if an "
 "exception was raised."
 msgstr ""
 
@@ -410,15 +418,15 @@ msgstr ""
 
 #: ../../c-api/dict.rst:349
 msgid ""
-"Clear watcher identified by *watcher_id* previously returned from :c:func:"
-"`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error (e.g. if the "
-"given *watcher_id* was never registered.)"
+"Clear watcher identified by *watcher_id* previously returned "
+"from :c:func:`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error "
+"(e.g. if the given *watcher_id* was never registered.)"
 msgstr ""
 
 #: ../../c-api/dict.rst:357
 msgid ""
-"Mark dictionary *dict* as watched. The callback granted *watcher_id* by :c:"
-"func:`PyDict_AddWatcher` will be called when *dict* is modified or "
+"Mark dictionary *dict* as watched. The callback granted *watcher_id* "
+"by :c:func:`PyDict_AddWatcher` will be called when *dict* is modified or "
 "deallocated. Return ``0`` on success or ``-1`` on error."
 msgstr ""
 
@@ -484,8 +492,8 @@ msgstr ""
 #: ../../c-api/dict.rst:409
 msgid ""
 "If the callback sets an exception, it must return ``-1``; this exception "
-"will be printed as an unraisable exception using :c:func:"
-"`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
+"will be printed as an unraisable exception "
+"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``."
 msgstr ""
 
 #: ../../c-api/dict.rst:413