Kaydet (Commit) bcd1e3a4 authored tarafından Alexandre Vassalotti's avatar Alexandre Vassalotti

Clean up pickle usage examples.

üst f7d08c7d
...@@ -560,10 +560,8 @@ referenced object. ...@@ -560,10 +560,8 @@ referenced object.
Here is a comprehensive example presenting how persistent ID can be used to Here is a comprehensive example presenting how persistent ID can be used to
pickle external objects by reference. pickle external objects by reference.
.. XXX Work around for some bug in sphinx/pygments.
.. highlightlang:: python
.. literalinclude:: ../includes/dbpickle.py .. literalinclude:: ../includes/dbpickle.py
.. highlightlang:: python3
.. _pickle-state: .. _pickle-state:
...@@ -715,46 +713,35 @@ solutions. ...@@ -715,46 +713,35 @@ solutions.
.. _pickle-example: .. _pickle-example:
Example Usage Examples
------- --------------
For the simplest code, use the :func:`dump` and :func:`load` functions. Note For the simplest code, use the :func:`dump` and :func:`load` functions. Note
that a self-referencing list is pickled and restored correctly. :: that a self-referencing list is pickled and restored correctly. ::
import pickle import pickle
data1 = {'a': [1, 2.0, 3, 4+6j], # An arbitrary collection of objects supported by pickle.
'b': ("string", "string using Unicode features \u0394"), data = {
'c': None} 'a': [1, 2.0, 3, 4+6j],
'b': ("character string", b"byte string"),
selfref_list = [1, 2, 3] 'c': set([None, True, False])
selfref_list.append(selfref_list) }
output = open('data.pkl', 'wb')
# Pickle dictionary using protocol 2.
pickle.dump(data1, output, 2)
# Pickle the list using the highest protocol available.
pickle.dump(selfref_list, output, -1)
output.close()
The following example reads the resulting pickled data. When reading a with open('data.pickle', 'wb') as f:
pickle-containing file, you should open the file in binary mode because you # Pickle the 'data' dictionary using the highest protocol available.
can't be sure if the ASCII or binary format was used. :: pickle.dump(data, f, pickle.HIGHEST_PROTOCOL)
import pprint, pickle
pkl_file = open('data.pkl', 'rb') The following example reads the resulting pickled data. ::
data1 = pickle.load(pkl_file) import pickle
pprint.pprint(data1)
data2 = pickle.load(pkl_file) with open('data.pickle', 'rb') as f:
pprint.pprint(data2) # The protocol version used is detected automatically, so we do not
# have to specify it.
data = pickle.load(f)
pkl_file.close()
.. seealso:: .. seealso::
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment