diff options
| author | Senthil Kumaran <senthil@uthcode.com> | 2012-03-17 00:40:34 -0700 |
|---|---|---|
| committer | Senthil Kumaran <senthil@uthcode.com> | 2012-03-17 00:40:34 -0700 |
| commit | 517622e74b7c5aac900fa9e29b9b77aa41fea60f (patch) | |
| tree | 73cff92d82095b3893644160493905040418fadb | |
| parent | 58f18ec387f8d17399d2880bd09b903b743ff067 (diff) | |
| download | cpython-517622e74b7c5aac900fa9e29b9b77aa41fea60f.tar.gz | |
3.2 explain json.dumps for non-string keys in dicts. closes issue6566. Patch contributed Kirubakaran Athmanathan
| -rw-r--r-- | Doc/library/json.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Doc/library/json.rst b/Doc/library/json.rst index a791259831..f656700887 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) |