feat: translate c-api/refcounting.po

mattwang44 · mattwang44 · commit 043e7d1a1114 · 2023-07-01T04:57:04.000+08:00
diff --git a/c-api/refcounting.po b/c-api/refcounting.po
@@ -27,52 +27,54 @@ msgstr "參照計數"
 msgid ""
 "The macros in this section are used for managing reference counts of Python "
 "objects."
-msgstr ""
+msgstr "本節中的巨集用於管理 Python 物件的參照計數。"
 
 #: ../../c-api/refcounting.rst:16
 msgid "Increment the reference count for object *o*."
-msgstr ""
+msgstr "增加物件 *o* 的參照計數。"
 
 #: ../../c-api/refcounting.rst:18
 msgid ""
 "This function is usually used to convert a :term:`borrowed reference` to a :"
 "term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be "
 "used to create a new :term:`strong reference`."
-msgstr ""
+msgstr "此函式通常用於將\\ :term:`借用參照 <borrowed reference>`\\ 原地 (in-place) 轉換為\\ :term:`強參照 <strong reference>`。:c:func:`Py_NewRef` "
+"函式可用於建立新的\\ :term:`強參照 <strong reference>`。"
 
 #: ../../c-api/refcounting.rst:22
 msgid ""
 "The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
 "use :c:func:`Py_XINCREF`."
-msgstr ""
+msgstr "該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請使用 :c:func:`Py_XINCREF`。"
 
 #: ../../c-api/refcounting.rst:28
 msgid ""
 "Increment the reference count for object *o*.  The object may be ``NULL``, "
 "in which case the macro has no effect."
-msgstr ""
+msgstr "增加物件 *o* 的參照計數。該物件可能是 ``NULL``，在這種情況下巨集不起作用。"
 
 #: ../../c-api/refcounting.rst:31
 msgid "See also :c:func:`Py_XNewRef`."
-msgstr "另請見 :c:func:`Py_XNewRef`\\ 。"
+msgstr "另請見 :c:func:`Py_XNewRef`。"
 
 #: ../../c-api/refcounting.rst:36
 msgid ""
 "Create a new :term:`strong reference` to an object: increment the reference "
 "count of the object *o* and return the object *o*."
-msgstr ""
+msgstr "建立對物件的新\\ :term:`強參照 <strong reference>`：增加物件 *o* 的參照計數並回傳物件 *o*。"
 
 #: ../../c-api/refcounting.rst:39
 msgid ""
 "When the :term:`strong reference` is no longer needed, :c:func:`Py_DECREF` "
 "should be called on it to decrement the object reference count."
-msgstr ""
+msgstr "當不再需要\\ :term:`強參照 <strong reference>`\\ 時，應對其呼叫 :c:func:`Py_DECREF` 以減少物件參照計數。"
 
 #: ../../c-api/refcounting.rst:42
 msgid ""
 "The object *o* must not be ``NULL``; use :c:func:`Py_XNewRef` if *o* can be "
 "``NULL``."
-msgstr ""
+msgstr "物件 *o* 不能為 ``NULL``；如果 *o* 可以為 "
+"``NULL``，則使用 :c:func:`Py_XNewRef`。"
 
 #: ../../c-api/refcounting.rst:45
 msgid "For example::"
@@ -94,33 +96,33 @@ msgstr "另請參閱 :c:func:`Py_INCREF`\\ 。"
 
 #: ../../c-api/refcounting.rst:61
 msgid "Similar to :c:func:`Py_NewRef`, but the object *o* can be NULL."
-msgstr ""
+msgstr "與 :c:func:`Py_NewRef` 類似，但物件 *o* 可以為 NULL。"
 
 #: ../../c-api/refcounting.rst:63
 msgid "If the object *o* is ``NULL``, the function just returns ``NULL``."
-msgstr ""
+msgstr "如果物件 *o* 為 ``NULL``，則該函式僅回傳 ``NULL``。"
 
 #: ../../c-api/refcounting.rst:70
 msgid "Decrement the reference count for object *o*."
-msgstr ""
+msgstr "減少物件 *o* 的參照計數。"
 
 #: ../../c-api/refcounting.rst:72
 msgid ""
 "If the reference count reaches zero, the object's type's deallocation "
 "function (which must not be ``NULL``) is invoked."
-msgstr ""
+msgstr "如果參照計數達到零，則調用物件之型別的釋放函式 (deallocation function)（不得為 ``NULL``）。"
 
 #: ../../c-api/refcounting.rst:75
 msgid ""
 "This function is usually used to delete a :term:`strong reference` before "
 "exiting its scope."
-msgstr ""
+msgstr "此函式通常用於在退出作用域之前刪除\\ :term:`強參照 <strong reference>`。"
 
 #: ../../c-api/refcounting.rst:78
 msgid ""
 "The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, "
 "use :c:func:`Py_XDECREF`."
-msgstr ""
+msgstr "該物件不能為 ``NULL``；如果你不確定它不是 ``NULL``，請改用 :c:func:`Py_XDECREF`。"
 
 #: ../../c-api/refcounting.rst:83
 msgid ""
@@ -134,13 +136,21 @@ msgid ""
 "update the list data structure, and then call :c:func:`Py_DECREF` for the "
 "temporary variable."
 msgstr ""
+"釋放函式可以導致任意 Python 程式碼被調用（例如，當釋放具有 :meth:`__del__` "
+"方法的類別實例時）。雖然此類程式碼中的例外不會被傳遞出來，但​​"
+"執行的程式碼可以自由存取所有 Python 全域變數。這意味著在調用 :c:"
+"func:`Py_DECREF` 之前，"
+"可從全域變數存取的任何物件都應處於一致狀態。例如，從 list 中刪除物件的程式碼應"
+"將已刪除物件的參照複製到臨時變數中，更新 list 資料結構，然後為臨時變數呼叫 "
+":c:func:`Py_DECREF`。"
 
 #: ../../c-api/refcounting.rst:95
 msgid ""
 "Decrement the reference count for object *o*.  The object may be ``NULL``, "
 "in which case the macro has no effect; otherwise the effect is the same as "
 "for :c:func:`Py_DECREF`, and the same warning applies."
-msgstr ""
+msgstr "減少物件 *o* 的參照計數。該物件可能是 ``NULL``，在這種情況下巨集不起作用；"
+"否則效果與 :c:func:`Py_DECREF` 相同，且使得應用了相同的警告。"
 
 #: ../../c-api/refcounting.rst:102
 msgid ""
@@ -151,28 +161,39 @@ msgid ""
 "object passed because the macro carefully uses a temporary variable and sets "
 "the argument to ``NULL`` before decrementing its reference count."
 msgstr ""
+"減少物件 *o* 的參照計數。該物件可能是 ``NULL``，在這種情況下巨集不起作用；否則，"
+"效果與 :c:func:`Py_DECREF` 相同，只是引數也設定為 ``NULL``。:c:func:`Py_DECREF "
+"的警告不適用於傳遞的物件，"
+"因為巨集在遞減其參照計數之前小心地使用臨時變數並將參數設定為 ``NULL``。"
 
 #: ../../c-api/refcounting.rst:109
 msgid ""
 "It is a good idea to use this macro whenever decrementing the reference "
 "count of an object that might be traversed during garbage collection."
-msgstr ""
+msgstr "每當要減少垃圾收集期間可能被遍歷到之物件的參照計數時，使用此巨集是個好主意。"
 
 #: ../../c-api/refcounting.rst:114
 msgid ""
 "Increment the reference count for object *o*. A function version of :c:func:"
 "`Py_XINCREF`. It can be used for runtime dynamic embedding of Python."
-msgstr ""
+msgstr "增加物件 *o* 的參照計數。:c:func:"
+"`Py_XINCREF` "
+"的函式版本。它可用於 Python 的執行環境動態嵌入。"
 
 #: ../../c-api/refcounting.rst:120
 msgid ""
 "Decrement the reference count for object *o*. A function version of :c:func:"
 "`Py_XDECREF`. It can be used for runtime dynamic embedding of Python."
-msgstr ""
+msgstr "減少物件 *o* 的參照計數。:c:func:"
+"`Py_XDECREF` "
+"的函式版本。它可用於 Python 的執行環境動態嵌入。"
 
 #: ../../c-api/refcounting.rst:124
 msgid ""
 "The following functions or macros are only for use within the interpreter "
 "core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:"
 "`_Py_NewReference`, as well as the global variable :c:data:`_Py_RefTotal`."
 msgstr ""
+"以下函式或巨集僅在直譯器核心內使用：:c:func:`_Py_Dealloc`、:c:func:`_Py_Forge"
+"tReference`、:c:func:`_Py_NewReference` 以及全域變數 "
+":c:data:`_Py_RefTotal`。"
