Mercurial > cpython-lru_cache-weakref
diff Lib/json/decoder.py @ 65374:6f4cf73032fc
#4785: document strict argument of JSONDecoder, plus add object_pairs_hook in the docstrings.
| author | Georg Brandl <georg@python.org> |
|---|---|
| date | Fri, 15 Oct 2010 17:03:02 +0000 |
| parents | c3ad883b940b |
| children | 3c9232a684ae |
line wrap: on
line diff
--- a/Lib/json/decoder.py Fri Oct 15 17:01:15 2010 +0000 +++ b/Lib/json/decoder.py Fri Oct 15 17:03:02 2010 +0000 @@ -294,6 +294,15 @@ place of the given ``dict``. This can be used to provide custom deserializations (e.g. to support JSON-RPC class hinting). + ``object_pairs_hook``, if specified will be called with the result of + every JSON object decoded with an ordered list of pairs. The return + value of ``object_pairs_hook`` will be used instead of the ``dict``. + This feature can be used to implement custom decoders that rely on the + order that the key and value pairs are decoded (for example, + collections.OrderedDict will remember the order of insertion). If + ``object_hook`` is also defined, the ``object_pairs_hook`` takes + priority. + ``parse_float``, if specified, will be called with the string of every JSON float to be decoded. By default this is equivalent to float(num_str). This can be used to use another datatype or parser @@ -309,6 +318,11 @@ This can be used to raise an exception if invalid JSON numbers are encountered. + If ``strict`` is false (true is the default), then control + characters will be allowed inside strings. Control characters in + this context are those with character codes in the 0-31 range, + including ``'\\t'`` (tab), ``'\\n'``, ``'\\r'`` and ``'\\0'``. + """ self.object_hook = object_hook self.parse_float = parse_float or float
