# Copyright (C) 2001-2018, Python Software Foundation

# For licence information, see README file.

#

msgid ""

msgstr ""

"Project-Id-Version: Python 3\n"

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

"POT-Creation-Date: 2025-10-17 09:58+0200\n"

"PO-Revision-Date: 2023-07-21 12:43+0200\n"

"Last-Translator: \n"

"Language-Team: FRENCH <traductions@lists.afpy.org>\n"

"Language: fr\n"

"MIME-Version: 1.0\n"

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

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

"X-Generator: Poedit 2.2.3\n"

#: library/codecs.rst:2

#, fuzzy

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

msgstr ":mod:`codecs` — Registre des codecs et classes de base associées"

#: library/codecs.rst:11

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

msgstr "**Code source :** :source:`Lib/codecs.py`"

#: library/codecs.rst:23

#, fuzzy

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 (and "

"decode bytes to text), 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 be used "

"specifically with :term:`text encodings <text encoding>` or with codecs that "

"encode to :class:`bytes`."

msgstr ""

"Ce module définit les classes de base pour les codecs (encodeurs et "

"décodeurs) standards Python et fournit l'interface avec le registre des "

"codecs internes à Python, qui gère le processus de recherche de codecs et de "

"gestion des erreurs. La plupart des codecs sont des :term:`encodeurs de "

"texte <text encoding>`, qui encode du texte vers des séquences d'octets "

"(type *bytes* de Python) mais il existe aussi des codecs qui encodent du "

"texte vers du texte et des *bytes* vers des *bytes*. Les codecs "

"personnalisés peuvent encoder et décoder des types arbitraires, mais "

"l'utilisation de certaines fonctionnalités du module est restreinte "

"aux :term:`encodeurs de texte <text encoding>` ou aux codecs qui encodent "

"vers :class:`bytes`."

#: library/codecs.rst:33

msgid ""

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

"any codec:"

msgstr ""

"Le module définit les fonctions suivantes pour encoder et décoder à l'aide "

"de n'importe quel codec :"

#: library/codecs.rst:38

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

msgstr "Encode *obj* en utilisant le codec enregistré pour *encoding*."

#: 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 ""

"Vous pouvez spécifier *errors* pour définir la façon de gérer les erreurs. "

"Le gestionnaire d'erreurs par défaut est ``'strict'``, ce qui veut dire "

"qu'une erreur lors de l'encodage lève :exc:`ValueError` (ou une sous-classe "

"spécifique du codec, telle que :exc:`UnicodeEncodeError`). Référez-vous "

"aux :ref:`classes de base des codecs <codec-base-classes>` pour plus "

"d'informations sur la gestion des erreurs par les codecs."

#: library/codecs.rst:48

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

msgstr "Décode *obj* en utilisant le codec enregistré pour *encoding*."

#: 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 ""

"Vous pouvez spécifier *errors* pour définir la façon de gérer les erreurs. "

"Le gestionnaire d'erreurs par défaut est ``'strict'``, ce qui veut dire "

"qu'une erreur lors du décodage lève :exc:`ValueError` (ou une sous-classe "

"spécifique du codec, telle que :exc:`UnicodeDecodeError`). Référez-vous "

"aux :ref:`classes de base des codecs <codec-base-classes>` pour plus "

"d'informations sur la gestion des erreurs par les codecs."

#: library/codecs.rst:58

msgid ""

"Return a mapping suitable for encoding with a custom single-byte encoding. "

"Given a :class:`str` *string* of up to 256 characters representing a "

"decoding table, returns either a compact internal mapping object "

"``EncodingMap`` or a :class:`dictionary <dict>` mapping character ordinals "

"to byte values. Raises a :exc:`TypeError` on invalid input."

msgstr ""

#: library/codecs.rst:64

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

msgstr ""

"Les détails complets de chaque codec peuvent être examinés directement :"

#: library/codecs.rst:68

msgid ""

"Looks up the codec info in the Python codec registry and returns "

"a :class:`CodecInfo` object as defined below."

msgstr ""

"Recherche les informations relatives au codec dans le registre des codecs de "

"Python et renvoie l'objet :class:`CodecInfo` tel que défini ci-dessous."

#: library/codecs.rst:71

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 ""

"Les encodeurs sont recherchés en priorité dans le cache du registre. S'ils "

"n'y sont pas, la liste des fonctions de recherche enregistrées est passée en "

"revue. Si aucun objet :class:`CodecInfo` n'est trouvé, "

"une :exc:`LookupError` est levée. Sinon, l'objet :class:`CodecInfo` est mis "

"en cache et renvoyé vers l'appelant."

#: library/codecs.rst:78

msgid ""

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

"are stored in attributes of the same name:"

msgstr ""

"Les détails d'un codec trouvé dans le registre des codecs. Les arguments du "

"constructeur sont stockés dans les attributs éponymes :"

#: library/codecs.rst:84

msgid "The name of the encoding."

msgstr "Le nom de l'encodeur."

#: library/codecs.rst:90

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 ""

"Les fonctions d'encodage et de décodage. Ces fonctions ou méthodes doivent "

"avoir la même interface que les méthodes :meth:`~Codec.encode` "

"et :meth:`~Codec.decode` des instances de Codec (voir :ref:`Interface des "

"codecs <codec-objects>`). Les fonctions et méthodes sont censées fonctionner "

"sans état interne."

#: library/codecs.rst:100

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 ""

"Classes d'encodeurs et de décodeurs incrémentaux ou fonctions usines. Elles "

"doivent avoir respectivement les mêmes interfaces que celles définies par "

"les classes de base :class:`IncrementalEncoder` "

"et :class:`IncrementalDecoder`. Les codecs incrémentaux peuvent conserver "

"des états internes."

#: library/codecs.rst:109

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 ""

"Classes d'écriture et de lecture de flux ou fonctions usines. Elles doivent "

"avoir les mêmes interfaces que celles définies par les classes de "

"base :class:`StreamWriter` et :class:`StreamReader`, respectivement. Les "

"codecs de flux peuvent conserver un état interne."

#: library/codecs.rst:114

msgid ""

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

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

msgstr ""

"Pour simplifier l'accès aux différents composants du codec, le module "

"fournit les fonctions supplémentaires suivantes qui utilisent :func:`lookup` "

"pour la recherche du codec :"

#: library/codecs.rst:119

msgid ""

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

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa fonction "

"d'encodage."

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

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

msgstr "Lève une :exc:`LookupError` si l'encodage *encoding* n'est pas trouvé."

#: library/codecs.rst:126

msgid ""

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

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa fonction de "

"décodage."

#: library/codecs.rst:133

msgid ""

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

"class or factory function."

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa classe "

"d'encodage incrémental ou la fonction usine."

#: library/codecs.rst:136

msgid ""

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

"codec doesn't support an incremental encoder."

msgstr ""

"Lève une :exc:`LookupError` si l'encodage *encoding* n'est pas trouvé ou si "

"le codec ne gère pas l'encodage incrémental."

#: library/codecs.rst:142

msgid ""

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

"class or factory function."

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa classe de "

"décodage incrémental ou la fonction usine."

#: library/codecs.rst:145

msgid ""

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

"codec doesn't support an incremental decoder."

msgstr ""

"Lève une :exc:`LookupError` si l'encodage *encoding* n'est pas trouvé ou si "

"le codec ne gère pas le décodage incrémental."

#: library/codecs.rst:151

msgid ""

"Look up the codec for the given encoding and return "

"its :class:`StreamReader` class or factory function."

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa "

"classe :class:`StreamReader` ou la fonction usine."

#: library/codecs.rst:159

msgid ""

"Look up the codec for the given encoding and return "

"its :class:`StreamWriter` class or factory function."

msgstr ""

"Recherche le codec pour l'encodage *encoding* et renvoie sa "

"classe :class:`StreamWriter` ou la fonction usine."

#: library/codecs.rst:164

msgid ""

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

"function:"

msgstr ""

"Les codecs personnalisés sont mis à disposition en enregistrant une fonction "

"de recherche de codecs adaptée :"

#: library/codecs.rst:169

#, fuzzy

msgid ""

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

"argument, being the encoding name in all lower case letters with hyphens and "

"spaces converted to underscores, and return a :class:`CodecInfo` object. In "

"case a search function cannot find a given encoding, it should return "

"``None``."

msgstr ""

"Enregistre une fonction de recherche de codec. Il convient qu'une fonction "

"de recherche prenne un argument, le nom de l'encodage écrit en lettres "

"minuscules, et renvoie un objet :class:`CodecInfo`. Si la fonction de "

"recherche ne trouve pas un encodage donné, il convient qu'elle renvoie `` "

"None``."

#: library/codecs.rst:175

msgid "Hyphens and spaces are converted to underscore."

msgstr ""

#: library/codecs.rst:181

msgid ""

"Unregister a codec search function and clear the registry's cache. If the "

"search function is not registered, do nothing."

msgstr ""

#: library/codecs.rst:187

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 ""

"Alors qu'il est recommandé d'utiliser la fonction native :func:`open` et le "

"module associé :mod:`io` pour travailler avec des fichiers texte encodés, le "

"présent module fournit des fonctions et classes utilitaires supplémentaires "

"qui permettent l'utilisation d'une plus large gamme de codecs si vous "

"travaillez avec des fichiers binaires :"

#: library/codecs.rst:194

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 ""

"Ouvre un fichier encodé en utilisant le *mode* donné et renvoie une instance "

"de :class:`StreamReaderWriter`, permettant un encodage-décodage transparent. "

"Le mode de fichier par défaut est ``'r'``, ce qui signifie que le fichier "

"est ouvert en lecture."

# Pas de majuscule en début car suit un deux-points.

#: library/codecs.rst:200

#, fuzzy

msgid ""

"If *encoding* is not ``None``, then the 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 ""

"les fichiers encodés sous-jacents sont toujours ouverts en mode binaire. "

"Aucune conversion automatique de ``'\\n'`` n'est effectuée à la lecture ou à "

"l'écriture. L'argument *mode* peut être n'importe quel mode binaire "

"acceptable pour la fonction native :func:`open` ; le ``'b'`` est "

"automatiquement ajouté."

#: library/codecs.rst:206

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 ""

"*encoding* spécifie l'encodage à utiliser pour le fichier. Tout encodage qui "

"encode et décode des octets (type *bytes*) est autorisé et les types de "

"données pris en charge par les méthodes relatives aux fichiers dépendent du "

"codec utilisé."

#: library/codecs.rst:210

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 ""

"*errors* peut être spécifié pour définir la gestion des erreurs. La valeur "

"par défaut est ``'strict'``, ce qui lève une :exc:`ValueError` en cas "

"d'erreur lors du codage."

#: library/codecs.rst:213

msgid ""

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

"It defaults to -1 which means that the default buffer size will be used."

msgstr ""

"*buffering* a la même signification que pour la fonction "

"native :func:`open`. Il vaut ``-1`` par défaut, ce qui signifie que la "

"taille par défaut du tampon est utilisée."

#: library/codecs.rst:216

msgid "The ``'U'`` mode has been removed."

msgstr "le mode ``'U``` a été enlevé."

#: library/codecs.rst:221

msgid ":func:`codecs.open` has been superseded by :func:`open`."

msgstr ""

#: library/codecs.rst:226

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 ""

"Renvoie une instance de :class:`StreamRecoder`, version encapsulée de *file* "

"qui fournit un transcodage transparent. Le fichier original est fermé quand "

"la version encapsulée est fermée."

#: library/codecs.rst:230

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 ""

"Les données écrites dans un fichier encapsulant sont décodées en fonction du "

"*data_encoding* spécifié puis écrites vers le fichier original en tant que "

"*bytes* en utilisant *file_encoding*. Les octets lus dans le fichier "

"original sont décodés conformément à *file_encoding* et le résultat est "

"encodé en utilisant *data_encoding*."

#: library/codecs.rst:236

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

msgstr ""

"Si *file_encoding* n'est pas spécifié, la valeur par défaut est "

"*data_encoding*."

#: library/codecs.rst:238

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 ""

"*errors* peut être spécifié pour définir la gestion des erreurs. La valeur "

"par défaut est ``'strict'``, ce qui lève une :exc:`ValueError` en cas "

"d'erreur lors du codage."

#: library/codecs.rst:245

#, fuzzy

msgid ""

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

"*iterator*. *iterator* must yield :class:`str` objects. This function is "

"a :term:`generator`. The *errors* argument (as well as any other keyword "

"argument) is passed through to the incremental encoder."

msgstr ""

"Utilise un encodeur incrémental pour encoder de manière itérative l'entrée "

"fournie par *iterator*. Cette fonction est un :term:`générateur "

"<generator>`. L'argument *errors* (ainsi que tout autre argument passé par "

"son nom) est transmis à l'encodeur incrémental."

#: library/codecs.rst:250

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 ""

"Cette fonction nécessite que le codec accepte les objets texte "

"(classe :class:`str`) en entrée. Par conséquent, il ne prend pas en charge "

"les encodeurs *bytes* vers *bytes* tels que ``base64_codec``."

#: library/codecs.rst:257

#, fuzzy

msgid ""

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

"*iterator*. *iterator* must yield :class:`bytes` objects. This function is "

"a :term:`generator`. The *errors* argument (as well as any other keyword "

"argument) is passed through to the incremental decoder."

msgstr ""

"Utilise un décodeur incrémental pour décoder de manière itérative l'entrée "

"fournie par *iterator*. Cette fonction est un :term:`générateur`. L'argument "

"*errors* (ainsi que tout autre argument passé par son nom) est transmis au "

"décodeur incrémental."

#: library/codecs.rst:262

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 ""

"Cette fonction requiert que le codec accepte les objets :class:`bytes` en "

"entrée. Par conséquent, elle ne prend pas en charge les encodeurs de texte "

"vers texte tels que ``rot_13``, bien que ``rot_13`` puisse être utilisé de "

"manière équivalente avec :func:`iterencode`."

#: library/codecs.rst:270

msgid ""

"Return a :class:`tuple` containing the raw bytes of *buffer*, a :ref:`buffer-"

"compatible object <bufferobjects>` or :class:`str` (encoded to UTF-8 before "

"processing), and their length in bytes."

msgstr ""

#: library/codecs.rst:274

msgid "The *errors* argument is ignored."

msgstr ""

#: library/codecs.rst:282

msgid ""

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

"reading and writing to platform dependent files:"

msgstr ""

"Le module fournit également les constantes suivantes qui sont utiles pour "

"lire et écrire les fichiers dépendants de la plateforme :"

#: library/codecs.rst:297

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 ""

"Ces constantes définissent diverses séquences d'octets, les marques d'ordre "

"d'octets (BOM pour *byte order mark* en anglais) Unicode pour plusieurs "

"encodages. Elles sont utilisées dans les flux de données UTF-16 et UTF-32 "

"pour indiquer l'ordre des octets utilisé, et dans UTF-8 comme signature "

"Unicode. :const:`BOM_UTF16` vaut soit :const:`BOM_UTF16_BE`, "

"soit :const:`BOM_UTF16_LE` selon le boutisme natif de la "

"plateforme, :const:`BOM` est un alias "

"pour :const:`BOM_UTF16`, :const:`BOM_LE` pour :const:`BOM_UTF16_LE` "

"et :const:`BOM_BE` pour :const:`BOM_UTF16_BE`. Les autres sont les marques "

"BOM dans les encodages UTF-8 et UTF-32."

#: library/codecs.rst:311

msgid "Codec Base Classes"

msgstr "Classes de base de codecs"

#: library/codecs.rst:313

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 ""

"Le module :mod:`codecs` définit un ensemble de classes de base qui "

"spécifient les interfaces pour travailler avec des objets codecs et qui "

"peuvent également être utilisées comme base pour des implémentations de "

"codecs personnalisés."

#: library/codecs.rst:317

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 ""

"Chaque codec doit définir quatre interfaces pour être utilisable comme codec "

"en Python : codeur sans état, décodeur sans état, lecteur de flux et "

"écrivain de flux. Le lecteur et l'écrivain de flux réutilisent généralement "

"l'encodeur-décodeur sans état pour implémenter les protocoles de fichiers. "

"Les auteurs de codecs doivent également définir comment le codec gère les "

"erreurs d'encodage et de décodage."

#: library/codecs.rst:328

msgid "Error Handlers"

msgstr "Gestionnaires d'erreurs"

#: library/codecs.rst:330

#, fuzzy

msgid ""

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

"error handling schemes by accepting the *errors* string argument:"

msgstr ""

"Pour simplifier et standardiser la gestion des erreurs, les codecs peuvent "

"implémenter différents schémas de gestion des erreurs en acceptant "

"l'argument *errors* de type chaîne. Les chaînes suivantes sont définies et "

"les gestionnaires correspondants implémentés par tous les codecs Python "

"standards :"

#: library/codecs.rst:350

#, fuzzy

msgid ""

"The following error handlers can be used with all Python :ref:`standard-"

"encodings` codecs:"

msgstr ""

"Les gestionnaires d'erreurs suivants ne s'appliquent que pour "

"les :term:`encodeurs de texte <text encoding>` :"

#: library/codecs.rst:399 library/codecs.rst:419

msgid "Value"

msgstr "Valeur"

#: library/codecs.rst:399 library/codecs.rst:1371 library/codecs.rst:1528

msgid "Meaning"

msgstr "Signification"

#: library/codecs.rst:358

msgid "``'strict'``"

msgstr "``'strict'``"

#: library/codecs.rst:358

#, fuzzy

msgid ""

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

"in :func:`strict_errors`."

msgstr ""

"Lève :exc:`UnicodeError` (ou une sous-classe) ; c'est la valeur par défaut. "

"Implémenté dans :func:`strict_errors`."

#: library/codecs.rst:362

msgid "``'ignore'``"

msgstr "``'ignore'``"

#: library/codecs.rst:362

msgid ""

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

"in :func:`ignore_errors`."

msgstr ""

"Ignore les données incorrectement formatées et continue sans rien signaler. "

"Implémenté dans :func:`ignore_errors`."

#: library/codecs.rst:366

msgid "``'replace'``"

msgstr "``'replace'``"

#: library/codecs.rst:366

#, fuzzy

msgid ""

"Replace with a replacement marker. On encoding, use ``?`` (ASCII character). "

"On decoding, use ``�`` (U+FFFD, the official REPLACEMENT CHARACTER). "

"Implemented in :func:`replace_errors`."

msgstr ""

"Remplace avec une marque de substitution adaptée ; Python utilise le "

"caractère de substitution officiel ``U+FFFD`` pour les codecs natifs lors du "

"décodage et ``?`` lors de l'encodage. Implémenté dans :func:`replace_errors`."

#: library/codecs.rst:372

msgid "``'backslashreplace'``"

msgstr "``'backslashreplace'``"

#: library/codecs.rst:372

msgid ""

"Replace with backslashed escape sequences. On encoding, use hexadecimal form "

"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}"

"` :samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value "

"with format :samp:`\\\\x{hh}`. Implemented "

"in :func:`backslashreplace_errors`."

msgstr ""

#: library/codecs.rst:381

msgid "``'surrogateescape'``"

msgstr "``'surrogateescape'``"

#: library/codecs.rst:381

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 ""

"Lors du décodage, remplace un octet par un code de substitution individuel "

"allant de ``U+DC80`` à ``U+DCFF``. Ce code est reconverti vers l'octet de "

"départ quand le gestionnaire d'erreurs ``'surrogateescape'`` est utilisé "

"pour l'encodage des données (voir la :pep:`383` pour plus de détails)."

#: library/codecs.rst:395

#, fuzzy

msgid ""

"The following error handlers are only applicable to encoding "

"(within :term:`text encodings <text encoding>`):"

msgstr ""

"Les gestionnaires d'erreurs suivants ne s'appliquent que pour "

"les :term:`encodeurs de texte <text encoding>` :"

#: library/codecs.rst:401

msgid "``'xmlcharrefreplace'``"

msgstr "``'xmlcharrefreplace'``"

#: library/codecs.rst:401

#, fuzzy

msgid ""

"Replace with XML/HTML numeric character reference, which is a decimal form "

"of Unicode code point with format :samp:`&#{num};`. Implemented "

"in :func:`xmlcharrefreplace_errors`."

msgstr ""

"Remplace avec la référence de caractère XML adaptée (uniquement pour "

"l'encodage). Implémenté dans :func:`xmlcharrefreplace_errors`."

#: library/codecs.rst:407

msgid "``'namereplace'``"

msgstr "``'namereplace'``"

#: library/codecs.rst:407

#, fuzzy

msgid ""

"Replace with ``\\N{...}`` escape sequences, what appears in the braces is "

"the Name property from Unicode Character Database. Implemented "

"in :func:`namereplace_errors`."

msgstr ""

"Remplace avec des séquences échappées par ``\\N{...}`` (uniquement pour "

"l'encodage). Implémenté dans :func:`namereplace_errors`."

#: library/codecs.rst:416

msgid ""

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

msgstr ""

"En plus, le gestionnaire d'erreurs suivant est spécifique aux codecs "

"suivants :"

#: library/codecs.rst:419

msgid "Codecs"

msgstr "Codecs"

#: library/codecs.rst:421

msgid "``'surrogatepass'``"

msgstr "``'surrogatepass'``"

#: library/codecs.rst:421

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

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

#: library/codecs.rst:421

#, fuzzy

msgid ""

"Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) "

"as normal code point. Otherwise these codecs treat the presence of surrogate "

"code point in :class:`str` as an error."

msgstr ""

"Autorise l'encodage et le décodage de codes de substitution. Ces codecs "

"traitent normalement la présence d'un code de substitution comme une erreur."

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:428

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

msgstr ""

"les gestionnaires d'erreurs ``'surrogateescape'`` et ``'surrogatepass'``."

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:431

#, fuzzy

msgid ""

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

"codecs."

msgstr ""

"le gestionnaire d'erreurs ``'surrogatepass'`` fonctionne maintenant avec les "

"codecs utf-16\\* et utf-32\\*."

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:435

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

msgstr "le gestionnaire d'erreurs ``'namereplace'``."

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:438

#, fuzzy

msgid ""

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

"translating."

msgstr ""

"le gestionnaire d'erreurs ``'backslashreplace'`` fonctionne maintenant pour "

"le décodage et la traduction."

#: library/codecs.rst:442

msgid ""

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

"handler:"

msgstr ""

"L'ensemble des valeurs autorisées peut être étendu en enregistrant un "

"nouveau gestionnaire d'erreurs nommé :"

#: library/codecs.rst:447

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 ""

#: library/codecs.rst:451

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 ""

#: library/codecs.rst:463

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 ""

#: library/codecs.rst:468

msgid ""

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

"can be looked up by name:"

msgstr ""

#: library/codecs.rst:473

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

msgstr ""

#: library/codecs.rst:475

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

msgstr ""

#: library/codecs.rst:477

msgid ""

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

"level functions:"

msgstr ""

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:482

#, fuzzy

msgid "Implements the ``'strict'`` error handling."

msgstr "le gestionnaire d'erreurs ``'namereplace'``."

#: library/codecs.rst:484

msgid "Each encoding or decoding error raises a :exc:`UnicodeError`."

msgstr ""

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:489

#, fuzzy

msgid "Implements the ``'ignore'`` error handling."

msgstr "le gestionnaire d'erreurs ``'namereplace'``."

#: library/codecs.rst:491

msgid ""

"Malformed data is ignored; encoding or decoding is continued without further "

"notice."

msgstr ""

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:497

#, fuzzy

msgid "Implements the ``'replace'`` error handling."

msgstr "le gestionnaire d'erreurs ``'namereplace'``."

#: library/codecs.rst:499

msgid ""

"Substitutes ``?`` (ASCII character) for encoding errors or ``�`` (U+FFFD, "

"the official REPLACEMENT CHARACTER) for decoding errors."

msgstr ""

# pas de majuscule en début de phrase car suit un deux-points.

#: library/codecs.rst:505

#, fuzzy

msgid "Implements the ``'backslashreplace'`` error handling."

msgstr "le gestionnaire d'erreurs ``'namereplace'``."

#: library/codecs.rst:507

msgid ""

"Malformed data is replaced by a backslashed escape sequence. On encoding, "

"use the hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}"

"` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}`. On decoding, use the "

"hexadecimal form of byte value with format :samp:`\\\\x{hh}`."

msgstr ""

#: library/codecs.rst:513

msgid "Works with decoding and translating."

msgstr ""

#: library/codecs.rst:519

msgid ""

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

"within :term:`text encoding` only)."

msgstr ""

#: library/codecs.rst:522

#, fuzzy

msgid ""

"The unencodable character is replaced by an appropriate XML/HTML numeric "

"character reference, which is a decimal form of Unicode code point with "

"format :samp:`&#{num};` ."

msgstr ""

"Remplace avec la référence de caractère XML adaptée (uniquement pour "

"l'encodage). Implémenté dans :func:`xmlcharrefreplace_errors`."

#: library/codecs.rst:529

msgid ""

"Implements the ``'namereplace'`` error handling (for encoding "

"within :term:`text encoding` only)."

msgstr ""

#: library/codecs.rst:532

msgid ""

"The unencodable character is replaced by a ``\\N{...}`` escape sequence. The "

"set of characters that appear in the braces is the Name property from "

"Unicode Character Database. For example, the German lowercase letter ``'ß'`` "

"will be converted to byte sequence ``\\N{LATIN SMALL LETTER SHARP S}`` ."

msgstr ""

#: library/codecs.rst:543

msgid "Stateless Encoding and Decoding"

msgstr ""

#: library/codecs.rst:545

msgid ""

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

"function interfaces of the stateless encoder and decoder:"

msgstr ""

#: library/codecs.rst:553

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 ""

#: library/codecs.rst:580

msgid ""

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

"``'strict'`` handling."

msgstr ""

#: library/codecs.rst:561

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 ""

#: library/codecs.rst:565

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 ""

#: library/codecs.rst:571

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 ""

#: library/codecs.rst:576

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 ""

#: library/codecs.rst:583

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 ""

#: library/codecs.rst:587

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 ""

#: library/codecs.rst:592

msgid "Incremental Encoding and Decoding"

msgstr ""

#: library/codecs.rst:594

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 ""

#: library/codecs.rst:602

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 ""

#: library/codecs.rst:611

msgid "IncrementalEncoder Objects"

msgstr ""

#: library/codecs.rst:613

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 ""

#: library/codecs.rst:620

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

msgstr ""

#: library/codecs.rst:622

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 ""

#: library/codecs.rst:626

msgid ""

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

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

"handlers` for possible values."

msgstr ""

#: library/codecs.rst:630

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 ""

#: library/codecs.rst:638

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 ""

#: library/codecs.rst:645

msgid ""

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