Update of /cvsroot/python/python/dist/src/Doc/api In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv25751/Doc/api Modified Files: utilities.tex Log Message: Patch #923098: Share interned strings in marshal. Index: utilities.tex =================================================================== RCS file: /cvsroot/python/python/dist/src/Doc/api/utilities.tex,v retrieving revision 1.13 retrieving revision 1.14 diff -C2 -d -r1.13 -r1.14 *** utilities.tex 3 Jun 2004 09:55:28 -0000 1.13 --- utilities.tex 27 Jun 2004 16:51:45 -0000 1.14 *************** *** 284,301 **** Numeric values are stored with the least significant byte first. ! \begin{cfuncdesc}{void}{PyMarshal_WriteLongToFile}{long value, FILE *file} Marshal a \ctype{long} integer, \var{value}, to \var{file}. This will only write the least-significant 32 bits of \var{value}; regardless of the size of the native \ctype{long} type. \end{cfuncdesc} \begin{cfuncdesc}{void}{PyMarshal_WriteObjectToFile}{PyObject *value, ! FILE *file} Marshal a Python object, \var{value}, to \var{file}. \end{cfuncdesc} ! \begin{cfuncdesc}{PyObject*}{PyMarshal_WriteObjectToString}{PyObject *value} Return a string object containing the marshalled representation of \var{value}. \end{cfuncdesc} --- 284,312 ---- Numeric values are stored with the least significant byte first. ! The module supports two versions of the data format: version 0 is the ! historical version, version 1 (new in Python 2.4) shares interned ! strings in the file, and upon unmarshalling. \var{Py_MARSHAL_VERSION} ! indicates the current file format (currently 1). ! ! \begin{cfuncdesc}{void}{PyMarshal_WriteLongToFile}{long value, FILE *file, int version} Marshal a \ctype{long} integer, \var{value}, to \var{file}. This will only write the least-significant 32 bits of \var{value}; regardless of the size of the native \ctype{long} type. + + \versionchanged[\var{version} indicates the file format]{2.4} \end{cfuncdesc} \begin{cfuncdesc}{void}{PyMarshal_WriteObjectToFile}{PyObject *value, ! FILE *file, int version} Marshal a Python object, \var{value}, to \var{file}. + + \versionchanged[\var{version} indicates the file format]{2.4} \end{cfuncdesc} ! \begin{cfuncdesc}{PyObject*}{PyMarshal_WriteObjectToString}{PyObject *value, int version} Return a string object containing the marshalled representation of \var{value}. + + \versionchanged[\var{version} indicates the file format]{2.4} \end{cfuncdesc}