summaryrefslogtreecommitdiffstats
path: root/Doc/library/json.rst
diff options
context:
space:
mode:
authorSenthil Kumaran <senthil@uthcode.com>2012-03-17 07:40:34 (GMT)
committerSenthil Kumaran <senthil@uthcode.com>2012-03-17 07:40:34 (GMT)
commitf2123d2db54d661a016f02c5a1a02484d6d79e0d (patch)
treebfb6d77fb2fc803f94226cac1171e01768ca7b69 /Doc/library/json.rst
parenteebe1112ffce4e014317cdfad74580ea600602b5 (diff)
downloadcpython-f2123d2db54d661a016f02c5a1a02484d6d79e0d.zip
cpython-f2123d2db54d661a016f02c5a1a02484d6d79e0d.tar.gz
cpython-f2123d2db54d661a016f02c5a1a02484d6d79e0d.tar.bz2
3.2 explain json.dumps for non-string keys in dicts. closes issue6566. Patch contributed Kirubakaran Athmanathan
Diffstat (limited to 'Doc/library/json.rst')
-rw-r--r--Doc/library/json.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index a791259..f656700 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -168,6 +168,14 @@ Basic Usage
so trying to serialize multiple objects with repeated calls to
:func:`dump` using the same *fp* will result in an invalid JSON file.
+ .. note::
+
+ Keys in key/value pairs of JSON are always of the type :class:`str`. When
+ a dictionary is converted into JSON, all the keys of the dictionary are
+ coerced to strings. As a result of this, if a dictionary is convered
+ into JSON and then back into a dictionary, the dictionary may not equal
+ the original one. That is, ``loads(dumps(x)) != x`` if x has non-string
+ keys.
.. function:: load(fp, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)