docs(library/pickle.po): editing, up to line 1178

SkyLull · SkyLull · commit 148a7546bfa4 · 2024-09-06T17:34:01.000+08:00
diff --git a/library/pickle.po b/library/pickle.po
@@ -96,7 +96,7 @@ msgid ""
 "pyc` files."
 msgstr ""
 "Python 有另一個比較原始的序列化模組叫 :mod:`marshal`，不過其設計目的是為了支"
-"援 Python 的預編譯功能 :file:`.pyc` 運作。總地來說，沒事不要用 :mod:"
+"援 Python 的預編譯功能 :file:`.pyc` 的運作。總地來說，沒事不要用 :mod:"
 "`marshal`。"
 
 #: ../../library/pickle.rst:57
@@ -194,7 +194,7 @@ msgstr ""
 "JSON 具有高互通性（interoperability）且在 Python 以外的環境也被大量利用，但 "
 "pickle 只能在 Python 內使用。"
 
-# Skylull: [t]
+# Skylull: [T]
 # introspection -> 自省
 # introspection facilities -> 自省措施
 # https://zh.wikipedia.org/wiki/%E5%86%85%E7%9C%81_(%E8%AE%A1%E7%AE%97%E6%9C%BA%E7%A7%91%E5%AD%A6)
@@ -323,7 +323,7 @@ msgstr ""
 "版本 5 的協定在 Python 3.8 被新增。現在能支援帶外資料（Out-of-band data）並加"
 "速帶內資料的處理速度。請參閱 :pep:`574` 以了解第 5 版協定改進的細節。"
 
-# SkyLull: [t]
+# SkyLull: [T]
 # persistent -> 持久
 # data persistent -> 資料持久化
 # https://zh.wikipedia.org/zh-
@@ -637,7 +637,7 @@ msgstr ""
 msgid "See :ref:`pickle-persistent` for details and examples of uses."
 msgstr "關於細節與用法範例請見 :ref:`pickle-persistent`。"
 
-# SkyLull: [t]
+# SkyLull: [T]
 # dispatch table -> 調度表
 # https://zh.wiktionary.org/zh-hant/dispatch_table
 # reduce -> 縮減
@@ -857,8 +857,9 @@ msgstr ""
 ":class:`PickleBuffer` 物件僅能由 5 版或以上的 pickle 協定進行封裝。該物件亦能"
 "被作為帶外資料來進行:ref:`帶外資料序列化 <pickle-oob>`"
 
-# SkyLull: [T] oh boy... 好多術語...
-# format B: https://learn.microsoft.com/zh-tw/dotnet/standard/base-types/standard-numeric-format-strings#BFormatString
+# SkyLull: oh boy... 好多術語...
+# format B: https://learn.microsoft.com/zh-tw/dotnet/standard/base-
+# types/standard-numeric-format-strings#BFormatString
 # C-contiguous, Fortran-contiguous: https://stackoverflow.com/a/26999092
 #: ../../library/pickle.rst:480
 msgid ""
@@ -994,13 +995,15 @@ msgstr ""
 
 #: ../../library/pickle.rst:553
 msgid "Pickling Class Instances"
-msgstr ""
+msgstr "Pickling 類別實例"
 
 #: ../../library/pickle.rst:557
 msgid ""
 "In this section, we describe the general mechanisms available to you to "
 "define, customize, and control how class instances are pickled and unpickled."
 msgstr ""
+"在這一個章節，我們會講述如何封裝或拆封一個物件實例的相關機制，以方便你進行自"
+"訂。"
 
 #: ../../library/pickle.rst:560
 msgid ""
@@ -1011,12 +1014,17 @@ msgid ""
 "creates an uninitialized instance and then restores the saved attributes.  "
 "The following code shows an implementation of this behaviour::"
 msgstr ""
+"大部分的實例不需要額外的程式碼就已經是可封裝的了。在這樣的預設狀況中，pickle "
+"模組透過自省機制來取得類別及其實例的屬性。當類別實例被拆封時，其 :meth:"
+"`~object.__init__` 方法通常*不會*被呼叫。預設行為首先會建立一個未初始化的實"
+"例，然後還原紀錄中的屬性。以下程式碼的實作展示了前述行為::"
 
 #: ../../library/pickle.rst:575
 msgid ""
 "Classes can alter the default behaviour by providing one or several special "
 "methods:"
 msgstr ""
+"被封裝的目標類別可以提供一個或數個下列特殊方法來改變 pickle 的預設行為："
 
 #: ../../library/pickle.rst:580
 msgid ""
@@ -1027,36 +1035,48 @@ msgid ""
 "dictionary of named arguments for constructing the object.  Those will be "
 "passed to the :meth:`__new__` method upon unpickling."
 msgstr ""
+"在第 2 版協定或更新的版本中，有實作 :meth:`__getnewargs_ex__` 方法的類別，可"
+"以決定在拆封時要傳遞給 :meth:`__new__` 方法的值。該方法必須回傳一個 ``(args, "
+"kwargs)`` 的組合，其中 *args* 是一個位置引數的元組（tuple），*kwargs* 是一個"
+"用於建構物件的命名引數字典。這些資訊將在拆封時傳遞給 :meth:`__new__` 方法。"
 
 #: ../../library/pickle.rst:588
 msgid ""
 "You should implement this method if the :meth:`__new__` method of your class "
 "requires keyword-only arguments.  Otherwise, it is recommended for "
 "compatibility to implement :meth:`__getnewargs__`."
 msgstr ""
+"如果目標類別的方法 :meth:`__new__` 需要僅限關鍵字的參數時，你應該實作此方法。"
+"否則，為了提高相容性，建議你改為實作 :meth:`__getnewargs__`。"
 
 #: ../../library/pickle.rst:592
 msgid ":meth:`__getnewargs_ex__` is now used in protocols 2 and 3."
-msgstr ""
+msgstr "在第 2、3 版的協定中現在改為使用 :meth:`__getnewargs_ex__`。"
 
 #: ../../library/pickle.rst:598
 msgid ""
 "This method serves a similar purpose as :meth:`__getnewargs_ex__`, but "
 "supports only positional arguments.  It must return a tuple of arguments "
 "``args`` which will be passed to the :meth:`__new__` method upon unpickling."
 msgstr ""
+"此方法與 :meth:`__getnewargs_ex__` 的目的一樣，但僅支援位置參數。它必須回傳一"
+"個由傳入引數所組成的元組（tuple）``args``，這些引數會在拆封時傳遞給 :meth:"
+"`__new__` 方法。"
 
 #: ../../library/pickle.rst:602
 msgid ""
 ":meth:`__getnewargs__` will not be called if :meth:`__getnewargs_ex__` is "
 "defined."
 msgstr ""
+"當有定義 :meth:`__getnewargs_ex__` 的時候便不會呼叫 :meth:`__getnewargs__`。"
 
 #: ../../library/pickle.rst:605
 msgid ""
 "Before Python 3.6, :meth:`__getnewargs__` was called instead of :meth:"
 "`__getnewargs_ex__` in protocols 2 and 3."
 msgstr ""
+"在 Python 3.6 之前、版本 2 和版本 3 的協定中，會呼叫 :meth:`__getnewargs__` "
+"而非 :meth:`__getnewargs_ex__`。"
 
 #: ../../library/pickle.rst:612
 msgid ""
@@ -1065,18 +1085,25 @@ msgid ""
 "pickled as the contents for the instance, instead of a default state. There "
 "are several cases:"
 msgstr ""
+"目標類別可以透過覆寫方法 :meth:`__getstate__` 進一步影響其實例被封裝的方式。"
+"封裝時，呼叫該方法所返回的物件將作為該實例的內容被封裝、而非一個預設狀態。以"
+"下列出幾種預設狀態："
 
 #: ../../library/pickle.rst:617
 msgid ""
 "For a class that has no instance :attr:`~object.__dict__` and no :attr:"
 "`~object.__slots__`, the default state is ``None``."
 msgstr ""
+"沒有 :attr:`~object.__dict__` 和 :attr:`~object.__slots__` 實例的類別，其預設"
+"狀態為 ``None``。"
 
 #: ../../library/pickle.rst:620
 msgid ""
 "For a class that has an instance :attr:`~object.__dict__` and no :attr:"
 "`~object.__slots__`, the default state is ``self.__dict__``."
 msgstr ""
+"有 :attr:`~object.__dict__` 實例、但沒有 :attr:`~object.__slots__` 實例的類"
+"別，其預設狀態為 ``self.__dict__``。"
 
 #: ../../library/pickle.rst:623
 msgid ""
@@ -1085,6 +1112,10 @@ msgid ""
 "``self.__dict__``, and a dictionary mapping slot names to slot values.  Only "
 "slots that have a value are included in the latter."
 msgstr ""
+"有 :attr:`~object.__dict__` 和 :attr:`~object.__slots__` 實例的類別，其預設狀"
+"態是一個含有兩個字典的元組（tuple），該二字典分別為 ``self.__dict__`` 本身，"
+"和紀錄欄位（slot）名稱和值對應關係的字典（只有含有值的欄位（slot）會被紀錄其"
+"中）。"
 
 #: ../../library/pickle.rst:629
 msgid ""
@@ -1093,12 +1124,15 @@ msgid ""
 "``None`` and whose second item is a dictionary mapping slot names to slot "
 "values described in the previous bullet."
 msgstr ""
+"沒有 :attr:`~object.__dict__` 但有 :attr:`~object.__slots__` 實例的類別，其預"
+"設狀態是一個二元組（tuple），元組中的第一個值是 ``None``，第二個值則是紀錄欄"
+"位（slot）名稱和值對應關係的字典（與前一項提到的字典是同一個）。"
 
 #: ../../library/pickle.rst:634
 msgid ""
 "Added the default implementation of the ``__getstate__()`` method in the :"
 "class:`object` class."
-msgstr ""
+msgstr "在 :class:`object` 類別中增加預設的 ``__getstate__()`` 實作。"
 
 #: ../../library/pickle.rst:641
 msgid ""
@@ -1107,19 +1141,26 @@ msgid ""
 "state object to be a dictionary.  Otherwise, the pickled state must be a "
 "dictionary and its items are assigned to the new instance's dictionary."
 msgstr ""
+"在拆封時，如果類別定義了 :meth:`__setstate__`，則會使用拆封後的狀態呼叫它。在"
+"這種情況下，紀錄狀態的物件不需要是字典（dictionary）。否則，封裝時的狀態紀錄"
+"必須是一個字典，其紀錄的項目將被賦值給新實例的字典。"
 
 #: ../../library/pickle.rst:648
 msgid ""
 "If :meth:`__reduce__` returns a state with value ``None`` at pickling, the :"
 "meth:`__setstate__` method will not be called upon unpickling."
 msgstr ""
+"如果 :meth:`__reduce__` 在封裝時返回了 ``None`` 狀態，則拆封時就不會去呼叫 :"
+"meth:`__setstate__`。"
 
 #: ../../library/pickle.rst:652
 msgid ""
 "Refer to the section :ref:`pickle-state` for more information about how to "
 "use the methods :meth:`~object.__getstate__` and :meth:`~object."
 "__setstate__`."
 msgstr ""
+"參閱 :ref:`pickle-state` 以了解 :meth:`~object.__getstate__` 和 :meth:"
+"`~object.__setstate__` 的使用方法。"
 
 #: ../../library/pickle.rst:657
 msgid ""
@@ -1130,6 +1171,10 @@ msgid ""
 "such an invariant, as :meth:`~object.__init__` is not called when unpickling "
 "an instance."
 msgstr ""
+"在拆封時，某些方法如 :meth:`~object.__getattr__`、:meth:`~object."
+"__getattribute__` 或 :meth:`~object.__setattr__` 可能會在建立實例時被呼叫。如"
+"果這些方法依賴了某些實例內部的不變性，則應實作 :meth:`~object.__new__` 以建立"
+"此不變性，因為在拆封實例時不會呼叫 :meth:`~object.__init__`。"
 
 #: ../../library/pickle.rst:666
 msgid ""
