feat: to rst:130

Author: ken71301

library/weakref.po

@@ -8,7 +8,7 @@ msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2023-10-11 17:13+0000\n"
-"PO-Revision-Date: 2024-03-22 22:11+0800\n"
+"PO-Revision-Date: 2024-03-25 21:54+0800\n"
 "Last-Translator: Adrian Liaw <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
@@ -97,6 +97,10 @@ msgid ""
 "class:`set` interface, but keeps weak references to its elements, just like "
 "a :class:`WeakKeyDictionary` does."
 msgstr ""
+":class:`WeakKeyDictionary` 和 :class:`WeakValueDictionary` 在其實作中使用弱參"
+"照，在弱參照上設定回呼函式，此弱參照在垃圾回收取回鍵或值時通知弱字典。:class:"
+"`WeakSet` 實作了 :class:`set` 介面，但保留對其元素的弱參照，就像 :class:"
+"`WeakKeyDictionary` 一樣。"
 
 #: ../../library/weakref.rst:57
 msgid ""
@@ -106,6 +110,9 @@ msgid ""
 "the module automatically ensures that the finalizer remains alive until the "
 "object is collected."
 msgstr ""
+":class:`finalize` 提供了一種直接的方法來註冊在物件被垃圾回收時呼叫的清理函"
+"式。這比在原始弱參照上設定回呼函式更容易使用，因為模組在物件被收集前會自動確"
+"保終結函式 (finalizer) 保持存活。"
 
 #: ../../library/weakref.rst:63
 msgid ""
@@ -114,6 +121,9 @@ msgid ""
 "your own weak references directly.  The low-level machinery is exposed by "
 "the :mod:`weakref` module for the benefit of advanced uses."
 msgstr ""
+"大多數程式應該發現使用這些弱容器種類之一或 :class:`finalize` 就足夠了—通常不"
+"需要直接建立自己的弱參照。低層級的機制由 :mod:`weakref` 模組公開，以利於進階"
+"用途。"
 
 #: ../../library/weakref.rst:68
 msgid ""
@@ -123,28 +133,38 @@ msgid ""
 "object>`, :term:`generators <generator>`, type objects, sockets, arrays, "
 "deques, regular expression pattern objects, and code objects."
 msgstr ""
+"並非所有物件都可以被弱參照。支援弱參照的物件包括類別實例、用 Python （但不是"
+"C）編寫的函式、實例方法、集合、凍結集合 (frozenset)、一些\\ :term:`檔案物件 "
+"<file object>`、:term:`產生器 <generator>`、類型物件、插座 (socket)、陣列、雙"
+"向佇列、正規表示式模式物件和程式碼物件。"
 
 #: ../../library/weakref.rst:74
 msgid "Added support for thread.lock, threading.Lock, and code objects."
-msgstr ""
+msgstr "新增了對 thread.lock、threading.Lock 和程式碼物件的支援。"
 
 #: ../../library/weakref.rst:77
 msgid ""
 "Several built-in types such as :class:`list` and :class:`dict` do not "
 "directly support weak references but can add support through subclassing::"
 msgstr ""
+"一些內建型別，例如 :class:`list` 和 :class:`dict` 不直接支援弱參照，但可以透"
+"過子類別化來支援： ::"
 
 #: ../../library/weakref.rst:87
 msgid ""
 "Other built-in types such as :class:`tuple` and :class:`int` do not support "
 "weak references even when subclassed."
 msgstr ""
+"其他內建型別，例如 :class:`tuple` 和 :class:`int` 即使在子類別化時也不支援弱"
+"參照。"
 
 #: ../../library/weakref.rst:90
 msgid ""
 "Extension types can easily be made to support weak references; see :ref:"
 "`weakref-support`."
 msgstr ""
+"擴充型別 (extension type) 可以輕易地支援弱參照；請參閱 :ref:`weakref-"
+"support`。"
 
 #: ../../library/weakref.rst:93
 msgid ""
@@ -153,6 +173,9 @@ msgid ""
 "of strings in the ``__slots__`` declaration. See :ref:`__slots__ "
 "documentation <slots>` for details."
 msgstr ""
+"當為給定的型別定義 ``__slots__`` 時，弱參照支援將被停用，除非 "
+"``'__weakref__'`` 字串也存在於 ``__slots__`` 宣告的字串序列中。詳情請參閱 :"
+"ref:`__slots__ 文件<slots>`。"
 
 #: ../../library/weakref.rst:100
 msgid ""
@@ -165,20 +188,29 @@ msgid ""
 "passed as the only parameter to the callback; the referent will no longer be "
 "available."
 msgstr ""
+"傳回對 *object* 的弱參照。如果參照目標仍存活，則可以透過呼叫參照物件來取回原"
+"始物件；如果參照目標已不存活，呼叫參照物件將導致 :const:`None` 被回傳。如果 "
+"*callback* 被提供而非 :const:`None`，且回傳的弱參照物件仍存活，那麼當物件即將"
+"被終結 (finalize) 時，回呼將被呼叫；弱參照物件將作為唯一的參數傳遞給回呼；參"
+"照物件將不再可用。"
 
 #: ../../library/weakref.rst:108
 msgid ""
 "It is allowable for many weak references to be constructed for the same "
 "object. Callbacks registered for each weak reference will be called from the "
 "most recently registered callback to the oldest registered callback."
 msgstr ""
+"為同一個物件建構多個弱參照是可行的。為每個弱參照註冊的回呼將按照最新到最舊註"
+"冊的回呼順序來被呼叫。"
 
 #: ../../library/weakref.rst:112
 msgid ""
 "Exceptions raised by the callback will be noted on the standard error "
 "output, but cannot be propagated; they are handled in exactly the same way "
 "as exceptions raised from an object's :meth:`~object.__del__` method."
 msgstr ""
+"回呼引發的例外將在標準錯誤輸出中被註明，但無法被傳播；它們的處理方式與物件"
+"的 :meth:`~object.__del__` 方法引發的例外完全相同。"
 
 #: ../../library/weakref.rst:116
 msgid ""
@@ -187,6 +219,9 @@ msgid ""
 "`hash` is called the first time only after the *object* was deleted, the "
 "call will raise :exc:`TypeError`."
 msgstr ""
+"如果 *object* 是可雜湊的，那麼弱參照就是 :term:`hashable`。即使在 *object* 被"
+"刪除後，它們仍將保留其雜湊值。如果僅在 *object* 刪除後 :func:`hash` 才第一次"
+"被呼叫，則該呼叫將引發 :exc:`TypeError`。"
 
 #: ../../library/weakref.rst:121
 msgid ""
@@ -196,17 +231,22 @@ msgid ""
 "referent has been deleted, the references are equal only if the reference "
 "objects are the same object."
 msgstr ""
+"弱參照支援相等性的測試，但不支援排序。如果參照目標仍存活，則兩個參照與其參照"
+"目標具有相同的相等關係（無論 *callback* 如何）。如果任一參照目標已被刪除，則"
+"僅當參照物件是同一物件時，參照才相等。"
 
 #: ../../library/weakref.rst:126
 msgid "This is a subclassable type rather than a factory function."
-msgstr ""
+msgstr "這是一個可子類別化的型別，而不是一個工廠函式。"
 
 #: ../../library/weakref.rst:130
 msgid ""
 "This read-only attribute returns the callback currently associated to the "
 "weakref.  If there is no callback or if the referent of the weakref is no "
 "longer alive then this attribute will have value ``None``."
 msgstr ""
+"此唯讀屬性回傳目前與弱參照關聯的回呼。如果沒有回呼或弱參照的參照目標已不存"
+"活，那麼該屬性的值為 ``None``。"
 
 #: ../../library/weakref.rst:134
 msgid "Added the :attr:`__callback__` attribute."