# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2019, 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.7\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2019-05-06 11:59-0400\n"

"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

"Language-Team: LANGUAGE <LL@li.org>\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

#: ../Doc/library/codecs.rst:2

msgid ":mod:`codecs` --- Codec registry and base classes"

msgstr ""

#: ../Doc/library/codecs.rst:11

msgid "**Source code:** :source:`Lib/codecs.py`"

msgstr ""

#: ../Doc/library/codecs.rst:23

msgid ""

"This module defines base classes for standard Python codecs (encoders and "

"decoders) and provides access to the internal Python codec registry, which "

"manages the codec and error handling lookup process. Most standard codecs "

"are :term:`text encodings <text encoding>`, which encode text to bytes, but "

"there are also codecs provided that encode text to text, and bytes to bytes. "

"Custom codecs may encode and decode between arbitrary types, but some module "

"features are restricted to use specifically with :term:`text encodings <text "

"encoding>`, or with codecs that encode to :class:`bytes`."

msgstr ""

#: ../Doc/library/codecs.rst:33

msgid ""

"The module defines the following functions for encoding and decoding with "

"any codec:"

msgstr ""

#: ../Doc/library/codecs.rst:38

msgid "Encodes *obj* using the codec registered for *encoding*."

msgstr ""

#: ../Doc/library/codecs.rst:40

msgid ""

"*Errors* may be given to set the desired error handling scheme. The default "

"error handler is ``'strict'`` meaning that encoding errors raise :exc:"

"`ValueError` (or a more codec specific subclass, such as :exc:"

"`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more "

"information on codec error handling."

msgstr ""

#: ../Doc/library/codecs.rst:48

msgid "Decodes *obj* using the codec registered for *encoding*."

msgstr ""

#: ../Doc/library/codecs.rst:50

msgid ""

"*Errors* may be given to set the desired error handling scheme. The default "

"error handler is ``'strict'`` meaning that decoding errors raise :exc:"

"`ValueError` (or a more codec specific subclass, such as :exc:"

"`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more "

"information on codec error handling."

msgstr ""

#: ../Doc/library/codecs.rst:56

msgid "The full details for each codec can also be looked up directly:"

msgstr ""

#: ../Doc/library/codecs.rst:60

msgid ""

"Looks up the codec info in the Python codec registry and returns a :class:"

"`CodecInfo` object as defined below."

msgstr ""

#: ../Doc/library/codecs.rst:63

msgid ""

"Encodings are first looked up in the registry's cache. If not found, the "

"list of registered search functions is scanned. If no :class:`CodecInfo` "

"object is found, a :exc:`LookupError` is raised. Otherwise, the :class:"

"`CodecInfo` object is stored in the cache and returned to the caller."

msgstr ""

#: ../Doc/library/codecs.rst:70

msgid ""

"Codec details when looking up the codec registry. The constructor arguments "

"are stored in attributes of the same name:"

msgstr ""

#: ../Doc/library/codecs.rst:76

msgid "The name of the encoding."

msgstr ""

#: ../Doc/library/codecs.rst:82

msgid ""

"The stateless encoding and decoding functions. These must be functions or "

"methods which have the same interface as the :meth:`~Codec.encode` and :meth:"

"`~Codec.decode` methods of Codec instances (see :ref:`Codec Interface <codec-"

"objects>`). The functions or methods are expected to work in a stateless "

"mode."

msgstr ""

#: ../Doc/library/codecs.rst:92

msgid ""

"Incremental encoder and decoder classes or factory functions. These have to "

"provide the interface defined by the base classes :class:"

"`IncrementalEncoder` and :class:`IncrementalDecoder`, respectively. "

"Incremental codecs can maintain state."

msgstr ""

#: ../Doc/library/codecs.rst:101

msgid ""

"Stream writer and reader classes or factory functions. These have to provide "

"the interface defined by the base classes :class:`StreamWriter` and :class:"

"`StreamReader`, respectively. Stream codecs can maintain state."

msgstr ""

#: ../Doc/library/codecs.rst:106

msgid ""

"To simplify access to the various codec components, the module provides "

"these additional functions which use :func:`lookup` for the codec lookup:"

msgstr ""

#: ../Doc/library/codecs.rst:111

msgid ""

"Look up the codec for the given encoding and return its encoder function."

msgstr ""

#: ../Doc/library/codecs.rst:113 ../Doc/library/codecs.rst:120

#: ../Doc/library/codecs.rst:146 ../Doc/library/codecs.rst:154

msgid "Raises a :exc:`LookupError` in case the encoding cannot be found."

msgstr ""

#: ../Doc/library/codecs.rst:118

msgid ""

"Look up the codec for the given encoding and return its decoder function."

msgstr ""

#: ../Doc/library/codecs.rst:125

msgid ""

"Look up the codec for the given encoding and return its incremental encoder "

"class or factory function."

msgstr ""

#: ../Doc/library/codecs.rst:128

msgid ""

"Raises a :exc:`LookupError` in case the encoding cannot be found or the "

"codec doesn't support an incremental encoder."

msgstr ""

#: ../Doc/library/codecs.rst:134

msgid ""

"Look up the codec for the given encoding and return its incremental decoder "

"class or factory function."

msgstr ""

#: ../Doc/library/codecs.rst:137

msgid ""

"Raises a :exc:`LookupError` in case the encoding cannot be found or the "

"codec doesn't support an incremental decoder."

msgstr ""

#: ../Doc/library/codecs.rst:143

msgid ""

"Look up the codec for the given encoding and return its :class:"

"`StreamReader` class or factory function."

msgstr ""

#: ../Doc/library/codecs.rst:151

msgid ""

"Look up the codec for the given encoding and return its :class:"

"`StreamWriter` class or factory function."

msgstr ""

#: ../Doc/library/codecs.rst:156

msgid ""

"Custom codecs are made available by registering a suitable codec search "

"function:"

msgstr ""

#: ../Doc/library/codecs.rst:161

msgid ""

"Register a codec search function. Search functions are expected to take one "

"argument, being the encoding name in all lower case letters, and return a :"

"class:`CodecInfo` object. In case a search function cannot find a given "

"encoding, it should return ``None``."

msgstr ""

#: ../Doc/library/codecs.rst:168

msgid ""

"Search function registration is not currently reversible, which may cause "

"problems in some cases, such as unit testing or module reloading."

msgstr ""

#: ../Doc/library/codecs.rst:172

msgid ""

"While the builtin :func:`open` and the associated :mod:`io` module are the "

"recommended approach for working with encoded text files, this module "

"provides additional utility functions and classes that allow the use of a "

"wider range of codecs when working with binary files:"

msgstr ""

#: ../Doc/library/codecs.rst:179

msgid ""

"Open an encoded file using the given *mode* and return an instance of :class:"

"`StreamReaderWriter`, providing transparent encoding/decoding. The default "

"file mode is ``'r'``, meaning to open the file in read mode."

msgstr ""

#: ../Doc/library/codecs.rst:185

msgid ""

"Underlying encoded files are always opened in binary mode. No automatic "

"conversion of ``'\\n'`` is done on reading and writing. The *mode* argument "

"may be any binary mode acceptable to the built-in :func:`open` function; the "

"``'b'`` is automatically added."

msgstr ""

#: ../Doc/library/codecs.rst:190

msgid ""

"*encoding* specifies the encoding which is to be used for the file. Any "

"encoding that encodes to and decodes from bytes is allowed, and the data "

"types supported by the file methods depend on the codec used."

msgstr ""

#: ../Doc/library/codecs.rst:194

msgid ""

"*errors* may be given to define the error handling. It defaults to "

"``'strict'`` which causes a :exc:`ValueError` to be raised in case an "

"encoding error occurs."

msgstr ""

#: ../Doc/library/codecs.rst:197

msgid ""

"*buffering* has the same meaning as for the built-in :func:`open` function. "

"It defaults to line buffered."

msgstr ""

#: ../Doc/library/codecs.rst:203

msgid ""

"Return a :class:`StreamRecoder` instance, a wrapped version of *file* which "

"provides transparent transcoding. The original file is closed when the "

"wrapped version is closed."

msgstr ""

#: ../Doc/library/codecs.rst:207

msgid ""

"Data written to the wrapped file is decoded according to the given "

"*data_encoding* and then written to the original file as bytes using "

"*file_encoding*. Bytes read from the original file are decoded according to "

"*file_encoding*, and the result is encoded using *data_encoding*."

msgstr ""

#: ../Doc/library/codecs.rst:213

msgid "If *file_encoding* is not given, it defaults to *data_encoding*."

msgstr ""

#: ../Doc/library/codecs.rst:215

msgid ""

"*errors* may be given to define the error handling. It defaults to "

"``'strict'``, which causes :exc:`ValueError` to be raised in case an "

"encoding error occurs."

msgstr ""

#: ../Doc/library/codecs.rst:222

msgid ""

"Uses an incremental encoder to iteratively encode the input provided by "

"*iterator*. This function is a :term:`generator`. The *errors* argument (as "

"well as any other keyword argument) is passed through to the incremental "

"encoder."

msgstr ""

#: ../Doc/library/codecs.rst:227

msgid ""

"This function requires that the codec accept text :class:`str` objects to "

"encode. Therefore it does not support bytes-to-bytes encoders such as "

"``base64_codec``."

msgstr ""

#: ../Doc/library/codecs.rst:234

msgid ""

"Uses an incremental decoder to iteratively decode the input provided by "

"*iterator*. This function is a :term:`generator`. The *errors* argument (as "

"well as any other keyword argument) is passed through to the incremental "

"decoder."

msgstr ""

#: ../Doc/library/codecs.rst:239

msgid ""

"This function requires that the codec accept :class:`bytes` objects to "

"decode. Therefore it does not support text-to-text encoders such as "

"``rot_13``, although ``rot_13`` may be used equivalently with :func:"

"`iterencode`."

msgstr ""

#: ../Doc/library/codecs.rst:245

msgid ""

"The module also provides the following constants which are useful for "

"reading and writing to platform dependent files:"

msgstr ""

#: ../Doc/library/codecs.rst:260

msgid ""

"These constants define various byte sequences, being Unicode byte order "

"marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data "

"streams to indicate the byte order used, and in UTF-8 as a Unicode "

"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` or :const:"

"`BOM_UTF16_LE` depending on the platform's native byte order, :const:`BOM` "

"is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` for :const:"

"`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The others "

"represent the BOM in UTF-8 and UTF-32 encodings."

msgstr ""

#: ../Doc/library/codecs.rst:274

msgid "Codec Base Classes"

msgstr ""

#: ../Doc/library/codecs.rst:276

msgid ""

"The :mod:`codecs` module defines a set of base classes which define the "

"interfaces for working with codec objects, and can also be used as the basis "

"for custom codec implementations."

msgstr ""

#: ../Doc/library/codecs.rst:280

msgid ""

"Each codec has to define four interfaces to make it usable as codec in "

"Python: stateless encoder, stateless decoder, stream reader and stream "

"writer. The stream reader and writers typically reuse the stateless encoder/"

"decoder to implement the file protocols. Codec authors also need to define "

"how the codec will handle encoding and decoding errors."

msgstr ""

#: ../Doc/library/codecs.rst:291

msgid "Error Handlers"

msgstr ""

#: ../Doc/library/codecs.rst:293

msgid ""

"To simplify and standardize error handling, codecs may implement different "

"error handling schemes by accepting the *errors* string argument. The "

"following string values are defined and implemented by all standard Python "

"codecs:"

msgstr ""

#: ../Doc/library/codecs.rst:301 ../Doc/library/codecs.rst:324

#: ../Doc/library/codecs.rst:357

msgid "Value"

msgstr ""

#: ../Doc/library/codecs.rst:301 ../Doc/library/codecs.rst:324

#: ../Doc/library/codecs.rst:357

msgid "Meaning"

msgstr ""

#: ../Doc/library/codecs.rst:303

msgid "``'strict'``"

msgstr ""

#: ../Doc/library/codecs.rst:303

msgid ""

"Raise :exc:`UnicodeError` (or a subclass); this is the default. Implemented "

"in :func:`strict_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:307

msgid "``'ignore'``"

msgstr ""

#: ../Doc/library/codecs.rst:307

msgid ""

"Ignore the malformed data and continue without further notice. Implemented "

"in :func:`ignore_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:312

msgid ""

"The following error handlers are only applicable to :term:`text encodings "

"<text encoding>`:"

msgstr ""

#: ../Doc/library/codecs.rst:326

msgid "``'replace'``"

msgstr ""

#: ../Doc/library/codecs.rst:326

msgid ""

"Replace with a suitable replacement marker; Python will use the official ``U"

"+FFFD`` REPLACEMENT CHARACTER for the built-in codecs on decoding, and '?' "

"on encoding. Implemented in :func:`replace_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:333

msgid "``'xmlcharrefreplace'``"

msgstr ""

#: ../Doc/library/codecs.rst:333

msgid ""

"Replace with the appropriate XML character reference (only for encoding). "

"Implemented in :func:`xmlcharrefreplace_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:337

msgid "``'backslashreplace'``"

msgstr ""

#: ../Doc/library/codecs.rst:337

msgid ""

"Replace with backslashed escape sequences. Implemented in :func:"

"`backslashreplace_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:341

msgid "``'namereplace'``"

msgstr ""

#: ../Doc/library/codecs.rst:341

msgid ""

"Replace with ``\\N{...}`` escape sequences (only for encoding). Implemented "

"in :func:`namereplace_errors`."

msgstr ""

#: ../Doc/library/codecs.rst:345

msgid "``'surrogateescape'``"

msgstr ""

#: ../Doc/library/codecs.rst:345

msgid ""

"On decoding, replace byte with individual surrogate code ranging from ``U"

"+DC80`` to ``U+DCFF``. This code will then be turned back into the same "

"byte when the ``'surrogateescape'`` error handler is used when encoding the "

"data. (See :pep:`383` for more.)"

msgstr ""

#: ../Doc/library/codecs.rst:354

msgid ""

"In addition, the following error handler is specific to the given codecs:"

msgstr ""

#: ../Doc/library/codecs.rst:357

msgid "Codecs"

msgstr ""

#: ../Doc/library/codecs.rst:359

msgid "``'surrogatepass'``"

msgstr ""

#: ../Doc/library/codecs.rst:359

msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le"

msgstr ""

#: ../Doc/library/codecs.rst:359

msgid ""

"Allow encoding and decoding of surrogate codes. These codecs normally treat "

"the presence of surrogates as an error."

msgstr ""

#: ../Doc/library/codecs.rst:364

msgid "The ``'surrogateescape'`` and ``'surrogatepass'`` error handlers."

msgstr ""

#: ../Doc/library/codecs.rst:367

msgid ""

"The ``'surrogatepass'`` error handlers now works with utf-16\\* and "

"utf-32\\* codecs."

msgstr ""

#: ../Doc/library/codecs.rst:370

msgid "The ``'namereplace'`` error handler."

msgstr ""

#: ../Doc/library/codecs.rst:373

msgid ""

"The ``'backslashreplace'`` error handlers now works with decoding and "

"translating."

msgstr ""

#: ../Doc/library/codecs.rst:377

msgid ""

"The set of allowed values can be extended by registering a new named error "

"handler:"

msgstr ""

#: ../Doc/library/codecs.rst:382

msgid ""

"Register the error handling function *error_handler* under the name *name*. "

"The *error_handler* argument will be called during encoding and decoding in "

"case of an error, when *name* is specified as the errors parameter."

msgstr ""

#: ../Doc/library/codecs.rst:386

msgid ""

"For encoding, *error_handler* will be called with a :exc:"

"`UnicodeEncodeError` instance, which contains information about the location "

"of the error. The error handler must either raise this or a different "

"exception, or return a tuple with a replacement for the unencodable part of "

"the input and a position where encoding should continue. The replacement may "

"be either :class:`str` or :class:`bytes`. If the replacement is bytes, the "

"encoder will simply copy them into the output buffer. If the replacement is "

"a string, the encoder will encode the replacement. Encoding continues on "

"original input at the specified position. Negative position values will be "

"treated as being relative to the end of the input string. If the resulting "

"position is out of bound an :exc:`IndexError` will be raised."

msgstr ""

#: ../Doc/library/codecs.rst:398

msgid ""

"Decoding and translating works similarly, except :exc:`UnicodeDecodeError` "

"or :exc:`UnicodeTranslateError` will be passed to the handler and that the "

"replacement from the error handler will be put into the output directly."

msgstr ""

#: ../Doc/library/codecs.rst:403

msgid ""

"Previously registered error handlers (including the standard error handlers) "

"can be looked up by name:"

msgstr ""

#: ../Doc/library/codecs.rst:408

msgid "Return the error handler previously registered under the name *name*."

msgstr ""

#: ../Doc/library/codecs.rst:410

msgid "Raises a :exc:`LookupError` in case the handler cannot be found."

msgstr ""

#: ../Doc/library/codecs.rst:412

msgid ""

"The following standard error handlers are also made available as module "

"level functions:"

msgstr ""

#: ../Doc/library/codecs.rst:417

msgid ""

"Implements the ``'strict'`` error handling: each encoding or decoding error "

"raises a :exc:`UnicodeError`."

msgstr ""

#: ../Doc/library/codecs.rst:423

msgid ""

"Implements the ``'replace'`` error handling (for :term:`text encodings <text "

"encoding>` only): substitutes ``'?'`` for encoding errors (to be encoded by "

"the codec), and ``'\\ufffd'`` (the Unicode replacement character) for "

"decoding errors."

msgstr ""

#: ../Doc/library/codecs.rst:431

msgid ""

"Implements the ``'ignore'`` error handling: malformed data is ignored and "

"encoding or decoding is continued without further notice."

msgstr ""

#: ../Doc/library/codecs.rst:437

msgid ""

"Implements the ``'xmlcharrefreplace'`` error handling (for encoding with :"

"term:`text encodings <text encoding>` only): the unencodable character is "

"replaced by an appropriate XML character reference."

msgstr ""

#: ../Doc/library/codecs.rst:444

msgid ""

"Implements the ``'backslashreplace'`` error handling (for :term:`text "

"encodings <text encoding>` only): malformed data is replaced by a "

"backslashed escape sequence."

msgstr ""

#: ../Doc/library/codecs.rst:450

msgid ""

"Implements the ``'namereplace'`` error handling (for encoding with :term:"

"`text encodings <text encoding>` only): the unencodable character is "

"replaced by a ``\\N{...}`` escape sequence."

msgstr ""

#: ../Doc/library/codecs.rst:460

msgid "Stateless Encoding and Decoding"

msgstr ""

#: ../Doc/library/codecs.rst:462

msgid ""

"The base :class:`Codec` class defines these methods which also define the "

"function interfaces of the stateless encoder and decoder:"

msgstr ""

#: ../Doc/library/codecs.rst:468

msgid ""

"Encodes the object *input* and returns a tuple (output object, length "

"consumed). For instance, :term:`text encoding` converts a string object to a "

"bytes object using a particular character set encoding (e.g., ``cp1252`` or "

"``iso-8859-1``)."

msgstr ""

#: ../Doc/library/codecs.rst:473 ../Doc/library/codecs.rst:495

msgid ""

"The *errors* argument defines the error handling to apply. It defaults to "

"``'strict'`` handling."

msgstr ""

#: ../Doc/library/codecs.rst:476

msgid ""

"The method may not store state in the :class:`Codec` instance. Use :class:"

"`StreamWriter` for codecs which have to keep state in order to make encoding "

"efficient."

msgstr ""

#: ../Doc/library/codecs.rst:480

msgid ""

"The encoder must be able to handle zero length input and return an empty "

"object of the output object type in this situation."

msgstr ""

#: ../Doc/library/codecs.rst:486

msgid ""

"Decodes the object *input* and returns a tuple (output object, length "

"consumed). For instance, for a :term:`text encoding`, decoding converts a "

"bytes object encoded using a particular character set encoding to a string "

"object."

msgstr ""

#: ../Doc/library/codecs.rst:491

msgid ""

"For text encodings and bytes-to-bytes codecs, *input* must be a bytes object "

"or one which provides the read-only buffer interface -- for example, buffer "

"objects and memory mapped files."

msgstr ""

#: ../Doc/library/codecs.rst:498

msgid ""

"The method may not store state in the :class:`Codec` instance. Use :class:"

"`StreamReader` for codecs which have to keep state in order to make decoding "

"efficient."

msgstr ""

#: ../Doc/library/codecs.rst:502

msgid ""

"The decoder must be able to handle zero length input and return an empty "

"object of the output object type in this situation."

msgstr ""

#: ../Doc/library/codecs.rst:507

msgid "Incremental Encoding and Decoding"

msgstr ""

#: ../Doc/library/codecs.rst:509

msgid ""

"The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes "

"provide the basic interface for incremental encoding and decoding. Encoding/"

"decoding the input isn't done with one call to the stateless encoder/decoder "

"function, but with multiple calls to the :meth:`~IncrementalEncoder.encode`/:"

"meth:`~IncrementalDecoder.decode` method of the incremental encoder/decoder. "

"The incremental encoder/decoder keeps track of the encoding/decoding process "

"during method calls."

msgstr ""

#: ../Doc/library/codecs.rst:517

msgid ""

"The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:"

"`~IncrementalDecoder.decode` method is the same as if all the single inputs "

"were joined into one, and this input was encoded/decoded with the stateless "

"encoder/decoder."

msgstr ""

#: ../Doc/library/codecs.rst:526

msgid "IncrementalEncoder Objects"

msgstr ""

#: ../Doc/library/codecs.rst:528

msgid ""

"The :class:`IncrementalEncoder` class is used for encoding an input in "

"multiple steps. It defines the following methods which every incremental "

"encoder must define in order to be compatible with the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:535

msgid "Constructor for an :class:`IncrementalEncoder` instance."

msgstr ""

#: ../Doc/library/codecs.rst:537

msgid ""

"All incremental encoders must provide this constructor interface. They are "

"free to add additional keyword arguments, but only the ones defined here are "

"used by the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:541

msgid ""

"The :class:`IncrementalEncoder` may implement different error handling "

"schemes by providing the *errors* keyword argument. See :ref:`error-"

"handlers` for possible values."

msgstr ""

#: ../Doc/library/codecs.rst:545

msgid ""

"The *errors* argument will be assigned to an attribute of the same name. "

"Assigning to this attribute makes it possible to switch between different "

"error handling strategies during the lifetime of the :class:"

"`IncrementalEncoder` object."

msgstr ""

#: ../Doc/library/codecs.rst:553

msgid ""

"Encodes *object* (taking the current state of the encoder into account) and "

"returns the resulting encoded object. If this is the last call to :meth:"

"`encode` *final* must be true (the default is false)."

msgstr ""

#: ../Doc/library/codecs.rst:560

msgid ""

"Reset the encoder to the initial state. The output is discarded: call ``."

"encode(object, final=True)``, passing an empty byte or text string if "

"necessary, to reset the encoder and to get the output."

msgstr ""

#: ../Doc/library/codecs.rst:567

msgid ""

"Return the current state of the encoder which must be an integer. The "

"implementation should make sure that ``0`` is the most common state. (States "

"that are more complicated than integers can be converted into an integer by "

"marshaling/pickling the state and encoding the bytes of the resulting string "

"into an integer)."

msgstr ""

#: ../Doc/library/codecs.rst:576

msgid ""

"Set the state of the encoder to *state*. *state* must be an encoder state "

"returned by :meth:`getstate`."

msgstr ""

#: ../Doc/library/codecs.rst:583

msgid "IncrementalDecoder Objects"

msgstr ""

#: ../Doc/library/codecs.rst:585

msgid ""

"The :class:`IncrementalDecoder` class is used for decoding an input in "

"multiple steps. It defines the following methods which every incremental "

"decoder must define in order to be compatible with the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:592

msgid "Constructor for an :class:`IncrementalDecoder` instance."

msgstr ""

#: ../Doc/library/codecs.rst:594

msgid ""

"All incremental decoders must provide this constructor interface. They are "

"free to add additional keyword arguments, but only the ones defined here are "

"used by the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:598

msgid ""

"The :class:`IncrementalDecoder` may implement different error handling "

"schemes by providing the *errors* keyword argument. See :ref:`error-"

"handlers` for possible values."

msgstr ""

#: ../Doc/library/codecs.rst:602

msgid ""

"The *errors* argument will be assigned to an attribute of the same name. "

"Assigning to this attribute makes it possible to switch between different "

"error handling strategies during the lifetime of the :class:"

"`IncrementalDecoder` object."

msgstr ""

#: ../Doc/library/codecs.rst:610

msgid ""

"Decodes *object* (taking the current state of the decoder into account) and "

"returns the resulting decoded object. If this is the last call to :meth:"

"`decode` *final* must be true (the default is false). If *final* is true the "

"decoder must decode the input completely and must flush all buffers. If this "

"isn't possible (e.g. because of incomplete byte sequences at the end of the "

"input) it must initiate error handling just like in the stateless case "

"(which might raise an exception)."

msgstr ""

#: ../Doc/library/codecs.rst:621

msgid "Reset the decoder to the initial state."

msgstr ""

#: ../Doc/library/codecs.rst:626

msgid ""

"Return the current state of the decoder. This must be a tuple with two "

"items, the first must be the buffer containing the still undecoded input. "

"The second must be an integer and can be additional state info. (The "

"implementation should make sure that ``0`` is the most common additional "

"state info.) If this additional state info is ``0`` it must be possible to "

"set the decoder to the state which has no input buffered and ``0`` as the "

"additional state info, so that feeding the previously buffered input to the "

"decoder returns it to the previous state without producing any output. "

"(Additional state info that is more complicated than integers can be "

"converted into an integer by marshaling/pickling the info and encoding the "

"bytes of the resulting string into an integer.)"

msgstr ""

#: ../Doc/library/codecs.rst:641

msgid ""

"Set the state of the decoder to *state*. *state* must be a decoder state "

"returned by :meth:`getstate`."

msgstr ""

#: ../Doc/library/codecs.rst:646

msgid "Stream Encoding and Decoding"

msgstr ""

#: ../Doc/library/codecs.rst:649

msgid ""

"The :class:`StreamWriter` and :class:`StreamReader` classes provide generic "

"working interfaces which can be used to implement new encoding submodules "

"very easily. See :mod:`encodings.utf_8` for an example of how this is done."

msgstr ""

#: ../Doc/library/codecs.rst:657

msgid "StreamWriter Objects"

msgstr ""

#: ../Doc/library/codecs.rst:659

msgid ""

"The :class:`StreamWriter` class is a subclass of :class:`Codec` and defines "

"the following methods which every stream writer must define in order to be "

"compatible with the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:666

msgid "Constructor for a :class:`StreamWriter` instance."

msgstr ""

#: ../Doc/library/codecs.rst:668

msgid ""

"All stream writers must provide this constructor interface. They are free to "

"add additional keyword arguments, but only the ones defined here are used by "

"the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:672

msgid ""

"The *stream* argument must be a file-like object open for writing text or "

"binary data, as appropriate for the specific codec."

msgstr ""

#: ../Doc/library/codecs.rst:675

msgid ""

"The :class:`StreamWriter` may implement different error handling schemes by "

"providing the *errors* keyword argument. See :ref:`error-handlers` for the "

"standard error handlers the underlying stream codec may support."

msgstr ""

#: ../Doc/library/codecs.rst:679

msgid ""

"The *errors* argument will be assigned to an attribute of the same name. "

"Assigning to this attribute makes it possible to switch between different "

"error handling strategies during the lifetime of the :class:`StreamWriter` "

"object."

msgstr ""

#: ../Doc/library/codecs.rst:685

msgid "Writes the object's contents encoded to the stream."

msgstr ""

#: ../Doc/library/codecs.rst:690

msgid ""

"Writes the concatenated list of strings to the stream (possibly by reusing "

"the :meth:`write` method). The standard bytes-to-bytes codecs do not support "

"this method."

msgstr ""

#: ../Doc/library/codecs.rst:697

msgid "Flushes and resets the codec buffers used for keeping state."

msgstr ""

#: ../Doc/library/codecs.rst:699

msgid ""

"Calling this method should ensure that the data on the output is put into a "

"clean state that allows appending of new fresh data without having to rescan "

"the whole stream to recover state."

msgstr ""

#: ../Doc/library/codecs.rst:704

msgid ""

"In addition to the above methods, the :class:`StreamWriter` must also "

"inherit all other methods and attributes from the underlying stream."

msgstr ""

#: ../Doc/library/codecs.rst:711

msgid "StreamReader Objects"

msgstr ""

#: ../Doc/library/codecs.rst:713

msgid ""

"The :class:`StreamReader` class is a subclass of :class:`Codec` and defines "

"the following methods which every stream reader must define in order to be "

"compatible with the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:720

msgid "Constructor for a :class:`StreamReader` instance."

msgstr ""

#: ../Doc/library/codecs.rst:722

msgid ""

"All stream readers must provide this constructor interface. They are free to "

"add additional keyword arguments, but only the ones defined here are used by "

"the Python codec registry."

msgstr ""

#: ../Doc/library/codecs.rst:726

msgid ""

"The *stream* argument must be a file-like object open for reading text or "

"binary data, as appropriate for the specific codec."

msgstr ""

#: ../Doc/library/codecs.rst:729

msgid ""

"The :class:`StreamReader` may implement different error handling schemes by "

"providing the *errors* keyword argument. See :ref:`error-handlers` for the "

"standard error handlers the underlying stream codec may support."

msgstr ""

#: ../Doc/library/codecs.rst:733

msgid ""

"The *errors* argument will be assigned to an attribute of the same name. "

"Assigning to this attribute makes it possible to switch between different "

"error handling strategies during the lifetime of the :class:`StreamReader` "

"object."

msgstr ""

#: ../Doc/library/codecs.rst:737

msgid ""

"The set of allowed values for the *errors* argument can be extended with :"

"func:`register_error`."

msgstr ""

#: ../Doc/library/codecs.rst:743

msgid "Decodes data from the stream and returns the resulting object."

msgstr ""

#: ../Doc/library/codecs.rst:745

msgid ""

"The *chars* argument indicates the number of decoded code points or bytes to "

"return. The :func:`read` method will never return more data than requested, "

"but it might return less, if there is not enough available."

msgstr ""

#: ../Doc/library/codecs.rst:750

msgid ""

"The *size* argument indicates the approximate maximum number of encoded "

"bytes or code points to read for decoding. The decoder can modify this "

"setting as appropriate. The default value -1 indicates to read and decode as "

"much as possible. This parameter is intended to prevent having to decode "

"huge files in one step."

msgstr ""

#: ../Doc/library/codecs.rst:757

msgid ""

"The *firstline* flag indicates that it would be sufficient to only return "

"the first line, if there are decoding errors on later lines."

msgstr ""

#: ../Doc/library/codecs.rst:761

msgid ""

"The method should use a greedy read strategy meaning that it should read as "

"much data as is allowed within the definition of the encoding and the given "

"size, e.g. if optional encoding endings or state markers are available on "

"the stream, these should be read too."

msgstr ""

#: ../Doc/library/codecs.rst:769

msgid "Read one line from the input stream and return the decoded data."

msgstr ""

#: ../Doc/library/codecs.rst:771

msgid ""

"*size*, if given, is passed as size argument to the stream's :meth:`read` "

"method."

msgstr ""

#: ../Doc/library/codecs.rst:774

msgid ""

"If *keepends* is false line-endings will be stripped from the lines returned."

msgstr ""

#: ../Doc/library/codecs.rst:780

msgid ""

"Read all lines available on the input stream and return them as a list of "

"lines."

msgstr ""

#: ../Doc/library/codecs.rst:783

msgid ""

"Line-endings are implemented using the codec's decoder method and are "

"included in the list entries if *keepends* is true."

msgstr ""

#: ../Doc/library/codecs.rst:786

msgid ""

"*sizehint*, if given, is passed as the *size* argument to the stream's :meth:"

"`read` method."