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

SkyLull · SkyLull · commit 853b0957f517 · 2024-08-30T06:37:31.000+08:00
diff --git a/library/pickle.po b/library/pickle.po
@@ -782,17 +782,21 @@ msgid ""
 "in the constructor, and return the reconstituted object hierarchy specified "
 "therein.  Bytes past the pickled representation of the object are ignored."
 msgstr ""
+"開啟先前被傳入建構子的檔案，從中讀取一個被 pickle 封裝的物件，並回傳重建完成"
+"的物件階層。超過 pickle 表示範圍的位元組會被忽略。"
 
 #: ../../library/pickle.rst:441
 msgid "Raise an :exc:`UnpicklingError` by default."
-msgstr ""
+msgstr "預設會拋出 :exc:`UnpicklingError` 例外。"
 
 #: ../../library/pickle.rst:443
 msgid ""
 "If defined, :meth:`persistent_load` should return the object specified by "
 "the persistent ID *pid*.  If an invalid persistent ID is encountered, an :"
 "exc:`UnpicklingError` should be raised."
 msgstr ""
+"若有定義 :meth:`persistent_load`，則其將回傳符合持久化識別碼 `pid` 的物件。如"
+"果遭遇了無效的持久化識別碼，則會引發 :exc:`UnpicklingError`。"
 
 #: ../../library/pickle.rst:451
 msgid ""
@@ -801,13 +805,18 @@ msgid ""
 "unlike its name suggests, :meth:`find_class` is also used for finding "
 "functions."
 msgstr ""
+"如有需要將引入 *module* ，並從中返回名為 *name* 的物件，這裡的 *module* 和 "
+"*name* 引數接受的輸入是 :class:`str` 物件。注意，雖然名稱上看起來不像，但 :"
+"meth:`find_class` 亦可被用於尋找其他函式。"
 
 #: ../../library/pickle.rst:456
 msgid ""
 "Subclasses may override this to gain control over what type of objects and "
 "how they can be loaded, potentially reducing security risks. Refer to :ref:"
 "`pickle-restrict` for details."
 msgstr ""
+"子類別可以覆寫此方法以控制可以載入哪些類型的物件、以及如何載入它們，從而潛在"
+"地降低安全性風險。詳情請參考 :ref:`pickle-restrict`。"
 
 #: ../../library/pickle.rst:460
 msgid ""
@@ -817,81 +826,104 @@ msgstr ""
 "引發一個附帶引數 ``module``、``name`` 的\\ :ref:`稽核事件 <auditing>` "
 "``pickle.find_class``。"
 
+# SkyLull: [T]
+# 參見 ＃729
+# wrapper -> 包裝器
 #: ../../library/pickle.rst:464
 msgid ""
 "A wrapper for a buffer representing picklable data.  *buffer* must be a :ref:"
 "`buffer-providing <bufferobjects>` object, such as a :term:`bytes-like "
 "object` or a N-dimensional array."
 msgstr ""
+"一個表示了含有可封裝數據緩衝區的包裝函數（wrapper function）。*buffer* 必須是"
+"一個 :ref:`提供緩衝區 <bufferobjects>` 的物件，例如一個 :term:`類位元組物件"
+"（bytes-like object）` 或 N 維陣列。"
 
 #: ../../library/pickle.rst:468
 msgid ""
 ":class:`PickleBuffer` is itself a buffer provider, therefore it is possible "
 "to pass it to other APIs expecting a buffer-providing object, such as :class:"
 "`memoryview`."
 msgstr ""
+":class:`PickleBuffer` 本身就是一個提供緩衝區的物件，所以是能夠將其提供給其它"
+"「預期收到含有緩衝物件的 API」的，比如 :class:`memoryview`。"
 
 #: ../../library/pickle.rst:472
 msgid ""
 ":class:`PickleBuffer` objects can only be serialized using pickle protocol 5 "
 "or higher.  They are eligible for :ref:`out-of-band serialization <pickle-"
 "oob>`."
 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
+# C-contiguous, Fortran-contiguous: https://stackoverflow.com/a/26999092
 #: ../../library/pickle.rst:480
 msgid ""
 "Return a :class:`memoryview` of the memory area underlying this buffer. The "
 "returned object is a one-dimensional, C-contiguous memoryview with format "
 "``B`` (unsigned bytes).  :exc:`BufferError` is raised if the buffer is "
 "neither C- nor Fortran-contiguous."
 msgstr ""
+"返回此緩衝區底層記憶體區域的 :class:`memoryview`。被返回的物件是一個（在 C 語"
+"言的 formatter 格式中）以 ``B`` (unsigned bytes) 二進位格式儲存、一維且列連續"
+"（C-contiguous）的 memoryview。如果緩衝區既不是列連續（C-contiguous）也不是行"
+"連續（Fortran-contiguous）的，則會引發 :exc:`BufferError`。"
 
 #: ../../library/pickle.rst:487
 msgid "Release the underlying buffer exposed by the PickleBuffer object."
-msgstr ""
+msgstr "釋放 PickleBuffer 物件現正曝光中的緩衝區。"
 
 #: ../../library/pickle.rst:493
 msgid "What can be pickled and unpickled?"
-msgstr ""
+msgstr "哪些物件能或不能被封裝、拆封？"
 
 #: ../../library/pickle.rst:495
 msgid "The following types can be pickled:"
-msgstr ""
+msgstr "下列型別可以被封裝："
 
 #: ../../library/pickle.rst:497
 msgid ""
 "built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, and :data:"
 "`NotImplemented`);"
 msgstr ""
+"內建常數（``None``、``True``、``False``、``Ellipsis`` 和 :data:"
+"`NotImplemented`）；"
 
 #: ../../library/pickle.rst:500
 msgid "integers, floating-point numbers, complex numbers;"
-msgstr ""
+msgstr "整數、浮點數和複數；"
 
 #: ../../library/pickle.rst:502
 msgid "strings, bytes, bytearrays;"
-msgstr ""
+msgstr "字串、位元組物件、位元組陣列；"
 
 #: ../../library/pickle.rst:504
 msgid ""
 "tuples, lists, sets, and dictionaries containing only picklable objects;"
-msgstr ""
+msgstr "元組（tuple）、串列（list）、集合（set）和僅含有可封裝物件的字典；"
 
 #: ../../library/pickle.rst:506
 msgid ""
 "functions (built-in and user-defined) accessible from the top level of a "
 "module (using :keyword:`def`, not :keyword:`lambda`);"
 msgstr ""
+"在模組最表面的層級就能被存取的函式（內建或自訂的皆可，不過僅限使用 :keyword:"
+"`def` 定義的函式，:keyword:`lambda` 函式不適用）；"
 
 #: ../../library/pickle.rst:509
 msgid "classes accessible from the top level of a module;"
-msgstr ""
+msgstr "在模組最表面的層級就能被存取的類別；"
 
 #: ../../library/pickle.rst:511
 msgid ""
 "instances of such classes whose the result of calling :meth:`~object."
 "__getstate__` is picklable  (see section :ref:`pickle-inst` for details)."
 msgstr ""
+"實例，只要在呼叫了 :meth:`~object.__getstate__` 後其回傳值全都是可封裝物件。"
+"（詳情請參閱 :ref:`pickle-inst`）。"
 
 #: ../../library/pickle.rst:514
 msgid ""
@@ -902,7 +934,14 @@ msgid ""
 "`RecursionError` will be raised in this case.  You can carefully raise this "
 "limit with :func:`sys.setrecursionlimit`."
 msgstr ""
+"嘗試封裝無法封裝的物件會引發 :exc:`PicklingError` 例外；注意當這種情況發生"
+"時，可能已經有未知數量的位元組已被寫入到檔案。嘗試封裝深度遞迴的資料結構可能"
+"會導致其超出最大遞迴深度，在這種情況下會引發 :exc:`RecursionError` 例外。你可"
+"以（小心地）使用 :func:`sys.setrecursionlimit` 來提高此上限。"
 
+# SkyLull: [T]
+# 請見官方術語表
+# qualified name -> 限定名稱
 #: ../../library/pickle.rst:521
 msgid ""
 "Note that functions (built-in and user-defined) are pickled by fully :term:"
@@ -913,6 +952,11 @@ msgid ""
 "environment, and the module must contain the named object, otherwise an "
 "exception will be raised. [#]_"
 msgstr ""
+"請注意，函式（內建及自訂兩者皆是）是依據完整的 :term:`限定名稱 <qualified "
+"name>` 來封裝，而非依其值。[#]_ 這意味著封裝時只有函式名稱、所屬的模組和所屬"
+"的類別名稱會被封裝。函式本身的程式碼及其附帶的任何屬性均不會被封裝。因此，在"
+"拆封該物件的環境中，定義此函式的模組必須可被引入，且該模組必須包含具此命名之"
+"物件，否則將引發例外。 [#]_"
 
 #: ../../library/pickle.rst:528
 msgid ""
@@ -921,12 +965,15 @@ msgid ""
 "class's code or data is pickled, so in the following example the class "
 "attribute ``attr`` is not restored in the unpickling environment::"
 msgstr ""
+"同樣情況，類別是依照其完整限定名稱來進行封裝，因此在進行拆封的環境中會具有同"
+"上的限制。類別中的程式碼或資料皆不會被封裝，因此在以下範例中，注意到類別屬性 "
+"``attr`` 在拆封的環境中不會被還原::"
 
 #: ../../library/pickle.rst:538
 msgid ""
 "These restrictions are why picklable functions and classes must be defined "
 "at the top level of a module."
-msgstr ""
+msgstr "這些限制就是可封裝的函式和類別必須被定義在模組頂層的原因。"
 
 #: ../../library/pickle.rst:541
 msgid ""
@@ -939,6 +986,11 @@ msgid ""
 "that suitable conversions can be made by the class's :meth:`~object."
 "__setstate__` method."
 msgstr ""
+"同樣地，當類別實例被封裝時，它所屬類別具有的程式碼和資料不會被一起封裝。只有"
+"實例資料本身會被封裝。這是有意而為的，因為如此你才可以在類別中修正錯誤或新增"
+"其他方法，且於此同時仍能夠載入使用較早期版本的類別所建立的物件實例。如果您預"
+"計將有長期存在的物件、且該物件將經歷許多版本的更替，你可以在物件中存放一個版"
+"本號，以便未來能透過 :meth:`~object.__setstate__` 方法來進行適當的版本轉換。"
 
 #: ../../library/pickle.rst:553
 msgid "Pickling Class Instances"
