Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Add some notes about HIGHEST_PROTOCOL.

This commit is contained in:
Neal Norwitz 2003-02-21 00:26:33 +00:00
parent 850566b644
commit d08baa9504
1 changed files with 15 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
Doc/lib/libpickle.tex
View File

@ -144,8 +144,9 @@ much more efficient pickling of new-style classes.
Refer to PEP 307 for more information. Refer to PEP 307 for more information.
If a \var{protocol} is not specified, protocol 0 is used. If a \var{protocol} is not specified, protocol 0 is used.
If \var{protocol} is specified as a negative value, If \var{protocol} is specified as a negative value
the highest protocol version will be used. or \constant{HIGHEST_PROTOCOL},
the highest protocol version available will be used.
\versionchanged[The \var{bin} parameter is deprecated and only provided \versionchanged[The \var{bin} parameter is deprecated and only provided
for backwards compatibility. You should use the \var{protocol} for backwards compatibility. You should use the \var{protocol}
@ -162,6 +163,14 @@ To serialize an object hierarchy, you first create a pickler, then you
call the pickler's \method{dump()} method. To de-serialize a data call the pickler's \method{dump()} method. To de-serialize a data
stream, you first create an unpickler, then you call the unpickler's stream, you first create an unpickler, then you call the unpickler's
\method{load()} method. The \module{pickle} module provides the \method{load()} method. The \module{pickle} module provides the
following constant:
\begin{datadesc}{HIGHEST_PROTOCOL}
The highest protocol version available. This value can be passed
as a \var{protocol} value.
\end{datadesc}
The \module{pickle} module provides the
following functions to make this process more convenient: following functions to make this process more convenient:
\begin{funcdesc}{dump}{object, file\optional{, protocol\optional{, bin}}} \begin{funcdesc}{dump}{object, file\optional{, protocol\optional{, bin}}}
@ -170,7 +179,8 @@ Write a pickled representation of \var{object} to the open file object
\code{Pickler(\var{file}, \var{protocol}, \var{bin}).dump(\var{object})}. \code{Pickler(\var{file}, \var{protocol}, \var{bin}).dump(\var{object})}.
If the \var{protocol} parameter is ommitted, protocol 0 is used. If the \var{protocol} parameter is ommitted, protocol 0 is used.
If \var{protocol} is specified as a negative value, If \var{protocol} is specified as a negative value
or \constant{HIGHEST_PROTOCOL},
the highest protocol version will be used. the highest protocol version will be used.
\versionchanged[The \var{protocol} parameter was added. \versionchanged[The \var{protocol} parameter was added.
@ -209,7 +219,8 @@ Return the pickled representation of the object as a string, instead
of writing it to a file. of writing it to a file.
If the \var{protocol} parameter is ommitted, protocol 0 is used. If the \var{protocol} parameter is ommitted, protocol 0 is used.
If \var{protocol} is specified as a negative value, If \var{protocol} is specified as a negative value
or \constant{HIGHEST_PROTOCOL},
the highest protocol version will be used. the highest protocol version will be used.
\versionchanged[The \var{protocol} parameter was added. \versionchanged[The \var{protocol} parameter was added.