summaryrefslogtreecommitdiffstats
path: root/Doc/library/marshal.rst
diff options
context:
space:
mode:
authorKristján Valur Jónsson <sweskman@gmail.com>2013-03-20 01:02:10 (GMT)
committerKristján Valur Jónsson <sweskman@gmail.com>2013-03-20 01:02:10 (GMT)
commitd7009c69136a3809282804f460902ab42e9972f6 (patch)
tree4d63e0482a090ede2c41c6a8f347418665e93072 /Doc/library/marshal.rst
parentc7c42efb16612f66af266073937cffa99ad49a33 (diff)
downloadcpython-d7009c69136a3809282804f460902ab42e9972f6.zip
cpython-d7009c69136a3809282804f460902ab42e9972f6.tar.gz
cpython-d7009c69136a3809282804f460902ab42e9972f6.tar.bz2
Issue #16475: Support object instancing, recursion and interned strings
in marshal
Diffstat (limited to 'Doc/library/marshal.rst')
-rw-r--r--Doc/library/marshal.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/library/marshal.rst b/Doc/library/marshal.rst
index 3b9e3d2..124eb61 100644
--- a/Doc/library/marshal.rst
+++ b/Doc/library/marshal.rst
@@ -40,10 +40,11 @@ this module. The following types are supported: booleans, integers, floating
point numbers, complex numbers, strings, bytes, bytearrays, tuples, lists, sets,
frozensets, dictionaries, and code objects, where it should be understood that
tuples, lists, sets, frozensets and dictionaries are only supported as long as
-the values contained therein are themselves supported; and recursive lists, sets
-and dictionaries should not be written (they will cause infinite loops). The
+the values contained therein are themselves supported.
singletons :const:`None`, :const:`Ellipsis` and :exc:`StopIteration` can also be
marshalled and unmarshalled.
+For format *version* lower than 3, recursive lists, sets and dictionaries cannot
+be written (see below).
There are functions that read/write files as well as functions operating on
strings.
@@ -103,7 +104,9 @@ In addition, the following constants are defined:
Indicates the format that the module uses. Version 0 is the historical
format, version 1 shares interned strings and version 2 uses a binary format
- for floating point numbers. The current version is 2.
+ for floating point numbers.
+ Version 3 adds support for object instancing and recursion.
+ The current version is 3.
.. rubric:: Footnotes