python-docs-fr/library/json.po

796 lines
25 KiB
Plaintext
Raw Normal View History

2016-10-30 09:46:26 +00:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
2017-04-02 20:14:06 +00:00
"POT-Creation-Date: 2017-04-02 22:11+0200\n"
2016-10-30 09:46:26 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
2017-04-02 20:14:06 +00:00
"Language: \n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/json.rst:2
msgid ":mod:`json` --- JSON encoder and decoder"
msgstr ""
#: ../Doc/library/json.rst:10
msgid "**Source code:** :source:`Lib/json/__init__.py`"
msgstr ""
#: ../Doc/library/json.rst:14
msgid ""
"`JSON (JavaScript Object Notation) <http://json.org>`_, specified by :rfc:"
"`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 <http://www.ecma-"
"international.org/publications/standards/Ecma-404.htm>`_, is a lightweight "
"data interchange format inspired by `JavaScript <https://en.wikipedia.org/"
"wiki/JavaScript>`_ object literal syntax (although it is not a strict subset "
"of JavaScript [#rfc-errata]_ )."
msgstr ""
#: ../Doc/library/json.rst:21
msgid ""
":mod:`json` exposes an API familiar to users of the standard library :mod:"
"`marshal` and :mod:`pickle` modules."
msgstr ""
#: ../Doc/library/json.rst:24
msgid "Encoding basic Python object hierarchies::"
msgstr ""
#: ../Doc/library/json.rst:43
msgid "Compact encoding::"
msgstr ""
#: ../Doc/library/json.rst:49
msgid "Pretty printing::"
msgstr ""
#: ../Doc/library/json.rst:58
msgid "Decoding JSON::"
msgstr ""
#: ../Doc/library/json.rst:70
msgid "Specializing JSON object decoding::"
msgstr ""
#: ../Doc/library/json.rst:85
msgid "Extending :class:`JSONEncoder`::"
msgstr ""
#: ../Doc/library/json.rst:105
msgid "Using :mod:`json.tool` from the shell to validate and pretty-print::"
msgstr ""
#: ../Doc/library/json.rst:114
msgid "See :ref:`json-commandline` for detailed documentation."
msgstr ""
#: ../Doc/library/json.rst:120
msgid ""
"JSON is a subset of `YAML <http://yaml.org/>`_ 1.2. The JSON produced by "
"this module's default settings (in particular, the default *separators* "
"value) is also a subset of YAML 1.0 and 1.1. This module can thus also be "
"used as a YAML serializer."
msgstr ""
#: ../Doc/library/json.rst:127
msgid "Basic Usage"
msgstr "Utilisation basique"
#: ../Doc/library/json.rst:134
msgid ""
"Serialize *obj* as a JSON formatted stream to *fp* (a ``.write()``-"
"supporting :term:`file-like object`) using this :ref:`conversion table <py-"
"to-json-table>`."
msgstr ""
#: ../Doc/library/json.rst:138
msgid ""
"If *skipkeys* is true (default: ``False``), then dict keys that are not of a "
"basic type (:class:`str`, :class:`int`, :class:`float`, :class:`bool`, "
"``None``) will be skipped instead of raising a :exc:`TypeError`."
msgstr ""
#: ../Doc/library/json.rst:142
msgid ""
"The :mod:`json` module always produces :class:`str` objects, not :class:"
"`bytes` objects. Therefore, ``fp.write()`` must support :class:`str` input."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:146 ../Doc/library/json.rst:419
2016-10-30 09:46:26 +00:00
msgid ""
"If *ensure_ascii* is true (the default), the output is guaranteed to have "
"all incoming non-ASCII characters escaped. If *ensure_ascii* is false, "
"these characters will be output as-is."
msgstr ""
#: ../Doc/library/json.rst:150
msgid ""
"If *check_circular* is false (default: ``True``), then the circular "
"reference check for container types will be skipped and a circular reference "
"will result in an :exc:`OverflowError` (or worse)."
msgstr ""
#: ../Doc/library/json.rst:154
msgid ""
"If *allow_nan* is false (default: ``True``), then it will be a :exc:"
"`ValueError` to serialize out of range :class:`float` values (``nan``, "
"``inf``, ``-inf``) in strict compliance of the JSON specification. If "
"*allow_nan* is true, their JavaScript equivalents (``NaN``, ``Infinity``, ``-"
"Infinity``) will be used."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:160 ../Doc/library/json.rst:438
2016-10-30 09:46:26 +00:00
msgid ""
"If *indent* is a non-negative integer or string, then JSON array elements "
"and object members will be pretty-printed with that indent level. An indent "
"level of 0, negative, or ``\"\"`` will only insert newlines. ``None`` (the "
"default) selects the most compact representation. Using a positive integer "
"indent indents that many spaces per level. If *indent* is a string (such as "
"``\"\\t\"``), that string is used to indent each level."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:167 ../Doc/library/json.rst:445
2016-10-30 09:46:26 +00:00
msgid "Allow strings for *indent* in addition to integers."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:170 ../Doc/library/json.rst:448
2016-10-30 09:46:26 +00:00
msgid ""
"If specified, *separators* should be an ``(item_separator, key_separator)`` "
"tuple. The default is ``(', ', ': ')`` if *indent* is ``None`` and ``(',', "
"': ')`` otherwise. To get the most compact JSON representation, you should "
"specify ``(',', ':')`` to eliminate whitespace."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:175 ../Doc/library/json.rst:453
2016-10-30 09:46:26 +00:00
msgid "Use ``(',', ': ')`` as default if *indent* is not ``None``."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:178 ../Doc/library/json.rst:456
2016-10-30 09:46:26 +00:00
msgid ""
"If specified, *default* should be a function that gets called for objects "
"that can't otherwise be serialized. It should return a JSON encodable "
"version of the object or raise a :exc:`TypeError`. If not specified, :exc:"
"`TypeError` is raised."
msgstr ""
#: ../Doc/library/json.rst:183
msgid ""
"If *sort_keys* is true (default: ``False``), then the output of dictionaries "
"will be sorted by key."
msgstr ""
#: ../Doc/library/json.rst:186
msgid ""
"To use a custom :class:`JSONEncoder` subclass (e.g. one that overrides the :"
"meth:`default` method to serialize additional types), specify it with the "
"*cls* kwarg; otherwise :class:`JSONEncoder` is used."
msgstr ""
#: ../Doc/library/json.rst:190 ../Doc/library/json.rst:266
msgid ""
"All optional parameters are now :ref:`keyword-only <keyword-only_parameter>`."
msgstr ""
#: ../Doc/library/json.rst:199
msgid ""
"Serialize *obj* to a JSON formatted :class:`str` using this :ref:`conversion "
"table <py-to-json-table>`. The arguments have the same meaning as in :func:"
"`dump`."
msgstr ""
#: ../Doc/library/json.rst:205
msgid ""
"Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, so "
"trying to serialize multiple objects with repeated calls to :func:`dump` "
"using the same *fp* will result in an invalid JSON file."
msgstr ""
#: ../Doc/library/json.rst:211
msgid ""
"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 converted 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."
msgstr ""
#: ../Doc/library/json.rst:220
msgid ""
"Deserialize *fp* (a ``.read()``-supporting :term:`file-like object` "
"containing a JSON document) to a Python object using this :ref:`conversion "
"table <json-to-py-table>`."
msgstr ""
#: ../Doc/library/json.rst:224
msgid ""
"*object_hook* is an optional function that will be called with the result of "
"any object literal decoded (a :class:`dict`). The return value of "
"*object_hook* will be used instead of the :class:`dict`. This feature can "
"be used to implement custom decoders (e.g. `JSON-RPC <http://www.jsonrpc."
"org>`_ class hinting)."
msgstr ""
#: ../Doc/library/json.rst:230
msgid ""
"*object_pairs_hook* is an optional function that will be called with the "
"result of any object literal decoded with an ordered list of pairs. The "
"return value of *object_pairs_hook* will be used instead of the :class:"
"`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, :func:"
"`collections.OrderedDict` will remember the order of insertion). If "
"*object_hook* is also defined, the *object_pairs_hook* takes priority."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:238 ../Doc/library/json.rst:333
2016-10-30 09:46:26 +00:00
msgid "Added support for *object_pairs_hook*."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:241 ../Doc/library/json.rst:336
2016-10-30 09:46:26 +00:00
msgid ""
"*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 for JSON floats (e.g. :"
"class:`decimal.Decimal`)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:246 ../Doc/library/json.rst:341
2016-10-30 09:46:26 +00:00
msgid ""
"*parse_int*, if specified, will be called with the string of every JSON int "
"to be decoded. By default, this is equivalent to ``int(num_str)``. This "
"can be used to use another datatype or parser for JSON integers (e.g. :class:"
"`float`)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:251 ../Doc/library/json.rst:346
2016-10-30 09:46:26 +00:00
msgid ""
"*parse_constant*, if specified, will be called with one of the following "
"strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``. This can be used to "
"raise an exception if invalid JSON numbers are encountered."
msgstr ""
#: ../Doc/library/json.rst:256
msgid "*parse_constant* doesn't get called on 'null', 'true', 'false' anymore."
msgstr ""
#: ../Doc/library/json.rst:259
msgid ""
"To use a custom :class:`JSONDecoder` subclass, specify it with the ``cls`` "
"kwarg; otherwise :class:`JSONDecoder` is used. Additional keyword arguments "
"will be passed to the constructor of the class."
msgstr ""
#: ../Doc/library/json.rst:263 ../Doc/library/json.rst:278
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:356
2016-10-30 09:46:26 +00:00
msgid ""
"If the data being deserialized is not a valid JSON document, a :exc:"
"`JSONDecodeError` will be raised."
msgstr ""
#: ../Doc/library/json.rst:271
msgid ""
"Deserialize *s* (a :class:`str`, :class:`bytes` or :class:`bytearray` "
"instance containing a JSON document) to a Python object using this :ref:"
"`conversion table <json-to-py-table>`."
msgstr ""
#: ../Doc/library/json.rst:275
msgid ""
"The other arguments have the same meaning as in :func:`load`, except "
"*encoding* which is ignored and deprecated."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:281
msgid ""
"*s* can now be of type :class:`bytes` or :class:`bytearray`. The input "
"encoding should be UTF-8, UTF-16 or UTF-32."
msgstr ""
#: ../Doc/library/json.rst:287
2016-10-30 09:46:26 +00:00
msgid "Encoders and Decoders"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:291
2016-10-30 09:46:26 +00:00
msgid "Simple JSON decoder."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:293
2016-10-30 09:46:26 +00:00
msgid "Performs the following translations in decoding by default:"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:298 ../Doc/library/json.rst:389
2016-10-30 09:46:26 +00:00
msgid "JSON"
msgstr "JSON"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:298 ../Doc/library/json.rst:389
2016-10-30 09:46:26 +00:00
msgid "Python"
msgstr "Python"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:300 ../Doc/library/json.rst:391
2016-10-30 09:46:26 +00:00
msgid "object"
msgstr "objet"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:300 ../Doc/library/json.rst:391
2016-10-30 09:46:26 +00:00
msgid "dict"
msgstr "dict"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:302 ../Doc/library/json.rst:393
2016-10-30 09:46:26 +00:00
msgid "array"
msgstr "array"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:302
2016-10-30 09:46:26 +00:00
msgid "list"
msgstr "list"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:304 ../Doc/library/json.rst:395
2016-10-30 09:46:26 +00:00
msgid "string"
msgstr "string"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:304 ../Doc/library/json.rst:395
2016-10-30 09:46:26 +00:00
msgid "str"
msgstr "str"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:306
2016-10-30 09:46:26 +00:00
msgid "number (int)"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:306
2016-10-30 09:46:26 +00:00
msgid "int"
msgstr "int"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:308
2016-10-30 09:46:26 +00:00
msgid "number (real)"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:308
2016-10-30 09:46:26 +00:00
msgid "float"
msgstr "float"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:310 ../Doc/library/json.rst:399
2016-10-30 09:46:26 +00:00
msgid "true"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:310 ../Doc/library/json.rst:399
2016-10-30 09:46:26 +00:00
msgid "True"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:312 ../Doc/library/json.rst:401
2016-10-30 09:46:26 +00:00
msgid "false"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:312 ../Doc/library/json.rst:401
2016-10-30 09:46:26 +00:00
msgid "False"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:314 ../Doc/library/json.rst:403
2016-10-30 09:46:26 +00:00
msgid "null"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:314 ../Doc/library/json.rst:403
2016-10-30 09:46:26 +00:00
msgid "None"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:317
2016-10-30 09:46:26 +00:00
msgid ""
"It also understands ``NaN``, ``Infinity``, and ``-Infinity`` as their "
"corresponding ``float`` values, which is outside the JSON spec."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:320
2016-10-30 09:46:26 +00:00
msgid ""
"*object_hook*, if specified, will be called with the result of every JSON "
"object decoded and its return value will be used in place of the given :"
"class:`dict`. This can be used to provide custom deserializations (e.g. to "
"support JSON-RPC class hinting)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:325
2016-10-30 09:46:26 +00:00
msgid ""
"*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 :class:`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, :func:`collections.OrderedDict` "
"will remember the order of insertion). If *object_hook* is also defined, the "
"*object_pairs_hook* takes priority."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:351
2016-10-30 09:46:26 +00:00
msgid ""
"If *strict* is false (``True`` is the default), then control characters will "
"be allowed inside strings. Control characters in this context are those "
2017-04-02 20:14:06 +00:00
"with character codes in the 0--31 range, including ``'\\t'`` (tab), "
2016-10-30 09:46:26 +00:00
"``'\\n'``, ``'\\r'`` and ``'\\0'``."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:359 ../Doc/library/json.rst:461
2016-10-30 09:46:26 +00:00
msgid "All parameters are now :ref:`keyword-only <keyword-only_parameter>`."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:364
2016-10-30 09:46:26 +00:00
msgid ""
"Return the Python representation of *s* (a :class:`str` instance containing "
"a JSON document)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:367
2016-10-30 09:46:26 +00:00
msgid ""
":exc:`JSONDecodeError` will be raised if the given JSON document is not "
"valid."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:372
2016-10-30 09:46:26 +00:00
msgid ""
"Decode a JSON document from *s* (a :class:`str` beginning with a JSON "
"document) and return a 2-tuple of the Python representation and the index in "
"*s* where the document ended."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:376
2016-10-30 09:46:26 +00:00
msgid ""
"This can be used to decode a JSON document from a string that may have "
"extraneous data at the end."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:382
2016-10-30 09:46:26 +00:00
msgid "Extensible JSON encoder for Python data structures."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:384
2016-10-30 09:46:26 +00:00
msgid "Supports the following objects and types by default:"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:393
2016-10-30 09:46:26 +00:00
msgid "list, tuple"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:397
2016-10-30 09:46:26 +00:00
msgid "int, float, int- & float-derived Enums"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:397
2016-10-30 09:46:26 +00:00
msgid "number"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:406
2016-10-30 09:46:26 +00:00
msgid "Added support for int- and float-derived Enum classes."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:409
2016-10-30 09:46:26 +00:00
msgid ""
"To extend this to recognize other objects, subclass and implement a :meth:"
"`default` method with another method that returns a serializable object for "
"``o`` if possible, otherwise it should call the superclass implementation "
"(to raise :exc:`TypeError`)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:414
2016-10-30 09:46:26 +00:00
msgid ""
"If *skipkeys* is false (the default), then it is a :exc:`TypeError` to "
"attempt encoding of keys that are not :class:`str`, :class:`int`, :class:"
"`float` or ``None``. If *skipkeys* is true, such items are simply skipped."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:423
2016-10-30 09:46:26 +00:00
msgid ""
"If *check_circular* is true (the default), then lists, dicts, and custom "
"encoded objects will be checked for circular references during encoding to "
"prevent an infinite recursion (which would cause an :exc:`OverflowError`). "
"Otherwise, no such check takes place."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:428
2016-10-30 09:46:26 +00:00
msgid ""
"If *allow_nan* is true (the default), then ``NaN``, ``Infinity``, and ``-"
"Infinity`` will be encoded as such. This behavior is not JSON specification "
"compliant, but is consistent with most JavaScript based encoders and "
"decoders. Otherwise, it will be a :exc:`ValueError` to encode such floats."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:434
2016-10-30 09:46:26 +00:00
msgid ""
"If *sort_keys* is true (default: ``False``), then the output of dictionaries "
"will be sorted by key; this is useful for regression tests to ensure that "
"JSON serializations can be compared on a day-to-day basis."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:467
2016-10-30 09:46:26 +00:00
msgid ""
"Implement this method in a subclass such that it returns a serializable "
"object for *o*, or calls the base implementation (to raise a :exc:"
"`TypeError`)."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:471
2016-10-30 09:46:26 +00:00
msgid ""
"For example, to support arbitrary iterators, you could implement default "
"like this::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:487
2016-10-30 09:46:26 +00:00
msgid ""
"Return a JSON string representation of a Python data structure, *o*. For "
"example::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:496
2016-10-30 09:46:26 +00:00
msgid ""
"Encode the given object, *o*, and yield each string representation as "
"available. For example::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:504
2016-10-30 09:46:26 +00:00
msgid "Exceptions"
msgstr "Les exceptions"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:508
2016-10-30 09:46:26 +00:00
msgid "Subclass of :exc:`ValueError` with the following additional attributes:"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:512
2016-10-30 09:46:26 +00:00
msgid "The unformatted error message."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:516
2016-10-30 09:46:26 +00:00
msgid "The JSON document being parsed."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:520
2016-10-30 09:46:26 +00:00
msgid "The start index of *doc* where parsing failed."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:524
2016-10-30 09:46:26 +00:00
msgid "The line corresponding to *pos*."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:528
2016-10-30 09:46:26 +00:00
msgid "The column corresponding to *pos*."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:534
2016-10-30 09:46:26 +00:00
msgid "Standard Compliance and Interoperability"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:536
2016-10-30 09:46:26 +00:00
msgid ""
"The JSON format is specified by :rfc:`7159` and by `ECMA-404 <http://www."
"ecma-international.org/publications/standards/Ecma-404.htm>`_. This section "
"details this module's level of compliance with the RFC. For simplicity, :"
"class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and parameters "
"other than those explicitly mentioned, are not considered."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:542
2016-10-30 09:46:26 +00:00
msgid ""
"This module does not comply with the RFC in a strict fashion, implementing "
"some extensions that are valid JavaScript but not valid JSON. In particular:"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:545
2016-10-30 09:46:26 +00:00
msgid "Infinite and NaN number values are accepted and output;"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:546
2016-10-30 09:46:26 +00:00
msgid ""
"Repeated names within an object are accepted, and only the value of the last "
"name-value pair is used."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:549
2016-10-30 09:46:26 +00:00
msgid ""
"Since the RFC permits RFC-compliant parsers to accept input texts that are "
"not RFC-compliant, this module's deserializer is technically RFC-compliant "
"under default settings."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:554
2016-10-30 09:46:26 +00:00
msgid "Character Encodings"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:556
2016-10-30 09:46:26 +00:00
msgid ""
"The RFC requires that JSON be represented using either UTF-8, UTF-16, or "
"UTF-32, with UTF-8 being the recommended default for maximum "
"interoperability."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:559
2016-10-30 09:46:26 +00:00
msgid ""
"As permitted, though not required, by the RFC, this module's serializer sets "
"*ensure_ascii=True* by default, thus escaping the output so that the "
"resulting strings only contain ASCII characters."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:563
2016-10-30 09:46:26 +00:00
msgid ""
"Other than the *ensure_ascii* parameter, this module is defined strictly in "
"terms of conversion between Python objects and :class:`Unicode strings "
"<str>`, and thus does not otherwise directly address the issue of character "
"encodings."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:568
2016-10-30 09:46:26 +00:00
msgid ""
"The RFC prohibits adding a byte order mark (BOM) to the start of a JSON "
"text, and this module's serializer does not add a BOM to its output. The RFC "
"permits, but does not require, JSON deserializers to ignore an initial BOM "
"in their input. This module's deserializer raises a :exc:`ValueError` when "
"an initial BOM is present."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:574
2016-10-30 09:46:26 +00:00
msgid ""
"The RFC does not explicitly forbid JSON strings which contain byte sequences "
"that don't correspond to valid Unicode characters (e.g. unpaired UTF-16 "
"surrogates), but it does note that they may cause interoperability problems. "
"By default, this module accepts and outputs (when present in the original :"
"class:`str`) code points for such sequences."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:582
2016-10-30 09:46:26 +00:00
msgid "Infinite and NaN Number Values"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:584
2016-10-30 09:46:26 +00:00
msgid ""
"The RFC does not permit the representation of infinite or NaN number values. "
"Despite that, by default, this module accepts and outputs ``Infinity``, ``-"
"Infinity``, and ``NaN`` as if they were valid JSON number literal values::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:599
2016-10-30 09:46:26 +00:00
msgid ""
"In the serializer, the *allow_nan* parameter can be used to alter this "
"behavior. In the deserializer, the *parse_constant* parameter can be used "
"to alter this behavior."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:605
2016-10-30 09:46:26 +00:00
msgid "Repeated Names Within an Object"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:607
2016-10-30 09:46:26 +00:00
msgid ""
"The RFC specifies that the names within a JSON object should be unique, but "
"does not mandate how repeated names in JSON objects should be handled. By "
"default, this module does not raise an exception; instead, it ignores all "
"but the last name-value pair for a given name::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:616
2016-10-30 09:46:26 +00:00
msgid "The *object_pairs_hook* parameter can be used to alter this behavior."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:620
2016-10-30 09:46:26 +00:00
msgid "Top-level Non-Object, Non-Array Values"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:622
2016-10-30 09:46:26 +00:00
msgid ""
"The old version of JSON specified by the obsolete :rfc:`4627` required that "
"the top-level value of a JSON text must be either a JSON object or array "
"(Python :class:`dict` or :class:`list`), and could not be a JSON null, "
"boolean, number, or string value. :rfc:`7159` removed that restriction, and "
"this module does not and has never implemented that restriction in either "
"its serializer or its deserializer."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:629
2016-10-30 09:46:26 +00:00
msgid ""
"Regardless, for maximum interoperability, you may wish to voluntarily adhere "
"to the restriction yourself."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:634
2016-10-30 09:46:26 +00:00
msgid "Implementation Limitations"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:636
2016-10-30 09:46:26 +00:00
msgid "Some JSON deserializer implementations may set limits on:"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:638
2016-10-30 09:46:26 +00:00
msgid "the size of accepted JSON texts"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:639
2016-10-30 09:46:26 +00:00
msgid "the maximum level of nesting of JSON objects and arrays"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:640
2016-10-30 09:46:26 +00:00
msgid "the range and precision of JSON numbers"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:641
2016-10-30 09:46:26 +00:00
msgid "the content and maximum length of JSON strings"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:643
2016-10-30 09:46:26 +00:00
msgid ""
"This module does not impose any such limits beyond those of the relevant "
"Python datatypes themselves or the Python interpreter itself."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:646
2016-10-30 09:46:26 +00:00
msgid ""
"When serializing to JSON, beware any such limitations in applications that "
"may consume your JSON. In particular, it is common for JSON numbers to be "
"deserialized into IEEE 754 double precision numbers and thus subject to that "
"representation's range and precision limitations. This is especially "
"relevant when serializing Python :class:`int` values of extremely large "
"magnitude, or when serializing instances of \"exotic\" numerical types such "
"as :class:`decimal.Decimal`."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:659
2016-10-30 09:46:26 +00:00
msgid "Command Line Interface"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:664
2016-10-30 09:46:26 +00:00
msgid "**Source code:** :source:`Lib/json/tool.py`"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:668
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`json.tool` module provides a simple command line interface to "
"validate and pretty-print JSON objects."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:671
2016-10-30 09:46:26 +00:00
msgid ""
"If the optional ``infile`` and ``outfile`` arguments are not specified, :"
"attr:`sys.stdin` and :attr:`sys.stdout` will be used respectively::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:681
2016-10-30 09:46:26 +00:00
msgid ""
"The output is now in the same order as the input. Use the :option:`--sort-"
"keys` option to sort the output of dictionaries alphabetically by key."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:687
2016-10-30 09:46:26 +00:00
msgid "Command line options"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:691
2016-10-30 09:46:26 +00:00
msgid "The JSON file to be validated or pretty-printed::"
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:705
2016-10-30 09:46:26 +00:00
msgid "If *infile* is not specified, read from :attr:`sys.stdin`."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:709
2016-10-30 09:46:26 +00:00
msgid ""
"Write the output of the *infile* to the given *outfile*. Otherwise, write it "
"to :attr:`sys.stdout`."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:714
2016-10-30 09:46:26 +00:00
msgid "Sort the output of dictionaries alphabetically by key."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:720
2016-10-30 09:46:26 +00:00
msgid "Show the help message."
msgstr ""
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:724
2016-10-30 09:46:26 +00:00
msgid "Footnotes"
msgstr "Notes"
2017-04-02 20:14:06 +00:00
#: ../Doc/library/json.rst:725
2016-10-30 09:46:26 +00:00
msgid ""
"As noted in `the errata for RFC 7159 <https://www.rfc-editor.org/"
"errata_search.php?rfc=7159>`_, JSON permits literal U+2028 (LINE SEPARATOR) "
"and U+2029 (PARAGRAPH SEPARATOR) characters in strings, whereas JavaScript "
"(as of ECMAScript Edition 5.1) does not."
msgstr ""