From 6033d26118cec11eca0c06af215b5876d72e24c6 Mon Sep 17 00:00:00 2001 From: Ezio Melotti Date: Fri, 15 Apr 2011 07:37:00 +0300 Subject: [PATCH] #4783: document that is not possible to use json.dump twice on the same stream. --- Doc/library/json.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/library/json.rst b/Doc/library/json.rst index 6c84f94241a..546a09d69bd 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -156,6 +156,11 @@ Basic Usage :meth:`default` method to serialize additional types), specify it with the *cls* kwarg; otherwise :class:`JSONEncoder` is used. + .. note:: + + Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol so + trying to serialize more objects with repeated calls to :func:`dump` and + the same *fp* will result in an invalid JSON file. .. function:: dumps(obj[, skipkeys[, ensure_ascii[, check_circular[, allow_nan[, cls[, indent[, separators[, encoding[, default[, **kw]]]]]]]]]])