9.1.3 模块接口
pickle.HIGHEST_PROTOCOL
一个整数，表示支持协议的最高版本。
例子：
#python 3.4
import pickle
r = pickle.HIGHEST_PROTOCOL
print('version:', r)
结果输出如下：
version: 4
pickle.DEFAULT_PROTOCOL
一个整数，表示默认使用的协议版本。
例子：
#python 3.4
import pickle
r = pickle.DEFAULT_PROTOCOL
print('version:', r)
结果输出如下：
version: 3
pickle.dump(obj, file, protocol=None, *, fix_imports=True)
把一个对象obj打包，并写入文件file。参数protocol是想使用打包协议的版本；参数fix_imports设置为True，如果协议版本小于3，则会尽量按Python2版本来打包。
例子：
#python 3.4
import pickle
with open(r'F:\temp\py\pk', 'wb') as f:
l = [2, 3, 4, 5]
r = pickle.dump(l, f)
print(r)
结果输出如下：
None
在这个例子里，把列表对象l进行序列化，再把数据流写入文件对象f，这样就保存到磁盘上了。
pickle.dumps(obj, protocol=None, *, fix_imports=True)
把对象obj打包成一个bytes对象返回。参数与上面函数dump()一样。
例子：
#python 3.4
import pickle
l = [2, 3, 4, 5]
r = pickle.dumps(l)
print(r)
结果输出如下：
b'\x80\x03]q\x00(K\x02K\x03K\x04K\x05e.'
pickle.load(file, *, fix_imports=True, encoding="ASCII", errors="strict")
从打开的文件里读取一个打包的对象，并解包返回此对象。参数encoding和errors是怎么样解析8位表示的字符串。其它参数与上面的函数是一样的。
例子：
#python 3.4
import pickle
with open(r'F:\temp\py\pk', 'rb') as f:
r = pickle.load(f)
print(r)
结果输出如下：
[2, 3, 4, 5]
pickle.loads(bytes_object, *, fix_imports=True, encoding="ASCII", errors="strict")
从bytes字节对象里解包出来Python内部表示的对象。参数bytes_object是bytes表示的对象。其它参数与上面函数一样。
例子：
#python 3.4
import pickle
l = [2, 3, 4, 5]
r = pickle.dumps(l)
print(r)
r = pickle.loads(r)
print(r)
结果输出如下：
b'\x80\x03]q\x00(K\x02K\x03K\x04K\x05e.'
[2, 3, 4, 5]
exception pickle.PickleError
模块pickle异常基类。
exception pickle.PicklingError
当打包一个对象不能打包时，就抛出本异常。
exception pickle.UnpicklingError
当在解包时出错，就会抛出此异常。
在pickle模块里，主要定义了两个类供外面访问：Pickler和Unpickler。
class pickle.Pickler(file, protocol=None, *, fix_imports=True)
创建一个二进制文件，可以写入打包的数据流到文件。参数file是保存数据的文件名称；参数protocol是可选的协议版本号，值可以设置从0到HIGHEST_PROTOCOL，如果没有设置默读值是DEFAULT_PROTOCOL；参数fix_imports设置为True时，当版本号小于3，打包时就会转换Python3版本的名称为Python2版本的名称，以便在Python2版本里可以读取到打包的数据。
dump(obj)
本函数是写一个打包的数据对象到已经打开的文件对象里。
persistent_id(obj)
本函数默认时，什么也没有做，主要为了给派生类进行继承使用。如果本函数返回None，表示对象obj按普通方式打包；如果返回任何其它值，就会当作储存ID来保存，读取时可以根据这个储存ID来读取出来，比如调用Unpickler.persistent_load()函数来加载。
dispatch_table
主要用来为方法__reduce__()保存一个分配表。默认情况下，不会保存一个这样的分配表，使用全局的分配表。如果需要保存一个私有的分配表时需要自己创建一个。
fast
本属性已经不再使用。如果设置为True值，表示使用快速模式。
class pickle.Unpickler(file, *, fix_imports=True, encoding="ASCII", errors="strict")
从一个二进制文件里读取打包的数据对象。参数file是保存数据的文件名称；参数protocol是可选的协议版本号，值可以设置从0到HIGHEST_PROTOCOL，如果没有设置默读值是DEFAULT_PROTOCOL；参数fix_imports设置为True时，当版本号小于3，打包时就会转换Python3版本的名称为Python2版本的名称，以便在Python2版本里可以读取到打包的数据。参数encoding是用来指明采用什么方式来读取8位的字符串对象；参数errors是用来表示读取对象时的错误处理方式。
load()
本函数从二进制文件里加载所有认识对象返回。
persistent_load(pid)
本函数默认弹出异常错误UnpicklingError。
find_class(module, name)
本函数从模块module里找到name对象返回，也可以使用于查找函数的返回。
蔡军生 QQ:9073204 深圳