copyreg — 註冊 pickle 支援函式

原始碼： Lib/copyreg.py

---

copyreg 模組提供了一種方法，可用於定義在序列化特定物件時使用的函式。pickle 和 copy 模組在序列化/複製這些物件時會使用這些函式。該模組提供了關於非類的物件構造器的配置資訊。這種構造器可以是工廠函式或類例項。

copyreg.constructor(object)

宣告 object 是一個有效的構造器。如果 object 不可呼叫（因此不是有效的構造器），則會引發 TypeError。

copyreg.pickle(type, function, constructor_ob=None)

宣告 function 應當被用作 type 型別物件的“縮減”函式。function 必須返回一個字串或一個包含兩到六個元素的元組。有關 function 介面的更多詳細資訊，請參閱 dispatch_table。

constructor_ob 引數是一項遺留特性，現已被忽略，但如果傳入，則必須是可呼叫物件。

請注意，pickle 化工具物件的 dispatch_table 屬性或 pickle.Pickler 的子類也可用於宣告縮減函式。

示例

以下示例將演示如何註冊一個 pickle 函式以及如何使用它。

>>> import copyreg, copy, pickle
>>> class C:
...     def __init__(self, a):
...         self.a = a
...
>>> def pickle_c(c):
...     print("pickling a C instance...")
...     return C, (c.a,)
...
>>> copyreg.pickle(C, pickle_c)
>>> c = C(1)
>>> d = copy.copy(c)
pickling a C instance...
>>> p = pickle.dumps(c)
pickling a C instance...