mirror of
https://github.com/python/cpython.git
synced 2026-01-07 16:02:55 +00:00
[3.12] Docs: amend json.dump() post gh-128482 (GH-128489) (#128494)
(cherry picked from commit 87ee76062a)
Co-authored-by: Erlend E. Aasland <erlend@python.org>
This commit is contained in:
parent
98d3f2bc6e
commit
e3e4852fe0
1 changed files with 8 additions and 5 deletions
|
|
@ -143,10 +143,6 @@ Basic Usage
|
|||
:term:`file-like object`) using this :ref:`Python-to-JSON conversion table
|
||||
<py-to-json-table>`.
|
||||
|
||||
To use a custom :class:`JSONEncoder` subclass (for example, one that overrides the
|
||||
:meth:`~JSONEncoder.default` method to serialize additional types), specify it with the
|
||||
*cls* keyword argument; otherwise :class:`JSONEncoder` is used.
|
||||
|
||||
.. note::
|
||||
|
||||
Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol,
|
||||
|
|
@ -186,6 +182,13 @@ Basic Usage
|
|||
If ``True`` (the default), their JavaScript equivalents
|
||||
(``NaN``, ``Infinity``, ``-Infinity``) are used.
|
||||
|
||||
:param cls:
|
||||
If set, a custom JSON encoder with the
|
||||
:meth:`~JSONEncoder.default` method overridden,
|
||||
for serializing into custom datatypes.
|
||||
If ``None`` (the default), :class:`!JSONEncoder` is used.
|
||||
:type cls: a :class:`JSONEncoder` subclass
|
||||
|
||||
:param indent:
|
||||
If a positive integer or string, JSON array elements and
|
||||
object members will be pretty-printed with that indent level.
|
||||
|
|
@ -212,7 +215,7 @@ Basic Usage
|
|||
If ``None`` (the default), :exc:`!TypeError` is raised.
|
||||
:type default: :term:`callable` | None
|
||||
|
||||
:param sort_keys:
|
||||
:param bool sort_keys:
|
||||
If ``True``, dictionaries will be outputted sorted by key.
|
||||
Default ``False``.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue