# 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: 2023-02-12 11:56+0100\n" "PO-Revision-Date: 2023-04-10 12:41+0200\n" "Last-Translator: Loc Cosnier \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" "X-Generator: Poedit 3.2.1\n" #: library/stdtypes.rst:8 msgid "Built-in Types" msgstr "Types natifs" #: library/stdtypes.rst:10 msgid "" "The following sections describe the standard types that are built into the " "interpreter." msgstr "" "Les sections suivantes décrivent les types standards intégrés à " "l'interpréteur." #: library/stdtypes.rst:15 msgid "" "The principal built-in types are numerics, sequences, mappings, classes, " "instances and exceptions." msgstr "" "Les principaux types natifs sont les numériques, les séquences, les " "dictionnaires, les classes, les instances et les exceptions." #: library/stdtypes.rst:18 msgid "" "Some collection classes are mutable. The methods that add, subtract, or " "rearrange their members in place, and don't return a specific item, never " "return the collection instance itself but ``None``." msgstr "" "Certaines classes de collection sont muables. Les méthodes qui ajoutent, " "retirent, ou réorganisent leurs éléments sur place, et qui ne renvoient pas " "un élément spécifique, ne renvoient jamais l'instance de la collection elle-" "même, mais ``None``." #: library/stdtypes.rst:22 msgid "" "Some operations are supported by several object types; in particular, " "practically all objects can be compared for equality, tested for truth " "value, and converted to a string (with the :func:`repr` function or the " "slightly different :func:`str` function). The latter function is implicitly " "used when an object is written by the :func:`print` function." msgstr "" "Certaines opérations sont prises en charge par plusieurs types d'objets ; en " "particulier, pratiquement tous les objets peuvent être comparés en égalité, " "testés en véridicité (valeur booléenne) et convertis en une chaîne de " "caractères (avec la fonction :func:`repr` ou la fonction légèrement " "différente :func:`str`). Cette dernière est implicitement utilisée quand un " "objet est affiché par la fonction :func:`print`." #: library/stdtypes.rst:32 msgid "Truth Value Testing" msgstr "Valeurs booléennes" #: library/stdtypes.rst:41 msgid "" "Any object can be tested for truth value, for use in an :keyword:`if` or :" "keyword:`while` condition or as operand of the Boolean operations below." msgstr "" "Tout objet peut être comparé à une valeur booléenne, typiquement dans une " "condition :keyword:`if` ou :keyword:`while` ou comme opérande des opérations " "booléennes ci-dessous." #: library/stdtypes.rst:46 msgid "" "By default, an object is considered true unless its class defines either a :" "meth:`__bool__` method that returns ``False`` or a :meth:`__len__` method " "that returns zero, when called with the object. [1]_ Here are most of the " "built-in objects considered false:" msgstr "" "Par défaut, tout objet est considéré vrai à moins que sa classe définisse " "soit une méthode :meth:`__bool__` renvoyant ``False`` soit une méthode :meth:" "`__len__` renvoyant zéro lorsqu'elle est appelée avec l'objet [1]_. Voici la " "majorité des objets natifs considérés comme étant faux :" # énumération #: library/stdtypes.rst:55 msgid "constants defined to be false: ``None`` and ``False``." msgstr "les constantes définies comme étant fausses : ``None`` et ``False`` ;" # énumération #: library/stdtypes.rst:57 msgid "" "zero of any numeric type: ``0``, ``0.0``, ``0j``, ``Decimal(0)``, " "``Fraction(0, 1)``" msgstr "" "zéro de tout type numérique : ``0``, ``0.0``, ``0j``, ``Decimal(0)``, " "``Fraction(0, 1)`` ;" # fin d'énumération #: library/stdtypes.rst:60 msgid "" "empty sequences and collections: ``''``, ``()``, ``[]``, ``{}``, ``set()``, " "``range(0)``" msgstr "" "les chaînes et collections vides : ``''``, ``()``, ``[]``, ``{}``, " "``set()``, ``range(0)``." #: library/stdtypes.rst:69 msgid "" "Operations and built-in functions that have a Boolean result always return " "``0`` or ``False`` for false and ``1`` or ``True`` for true, unless " "otherwise stated. (Important exception: the Boolean operations ``or`` and " "``and`` always return one of their operands.)" msgstr "" "Les opérations et fonctions natives dont le résultat est booléen renvoient " "toujours ``0`` ou ``False`` pour faux et ``1`` ou ``True`` pour vrai, sauf " "indication contraire (exception importante : les opérations booléennes " "``or`` et ``and`` renvoient toujours l'une de leurs opérandes)." #: library/stdtypes.rst:78 msgid "Boolean Operations --- :keyword:`!and`, :keyword:`!or`, :keyword:`!not`" msgstr "" "Opérations booléennes — :keyword:`!and`, :keyword:`!or`, :keyword:`!not`" #: library/stdtypes.rst:82 msgid "These are the Boolean operations, ordered by ascending priority:" msgstr "Ce sont les opérations booléennes, classées par priorité ascendante :" #: library/stdtypes.rst:143 library/stdtypes.rst:364 library/stdtypes.rst:921 #: library/stdtypes.rst:1126 msgid "Operation" msgstr "Opération" #: library/stdtypes.rst:275 library/stdtypes.rst:414 library/stdtypes.rst:1126 msgid "Result" msgstr "Résultat" #: library/stdtypes.rst:275 library/stdtypes.rst:921 library/stdtypes.rst:2371 #: library/stdtypes.rst:3589 msgid "Notes" msgstr "Notes" #: library/stdtypes.rst:87 msgid "``x or y``" msgstr "``x or y``" #: library/stdtypes.rst:87 msgid "if *x* is false, then *y*, else *x*" msgstr "si *x* est faux, alors *y*, sinon *x*" #: library/stdtypes.rst:285 library/stdtypes.rst:926 library/stdtypes.rst:2377 #: library/stdtypes.rst:3595 msgid "\\(1)" msgstr "\\(1)" #: library/stdtypes.rst:90 msgid "``x and y``" msgstr "``x and y``" #: library/stdtypes.rst:90 msgid "if *x* is false, then *x*, else *y*" msgstr "si *x* est faux, alors *x*, sinon *y*" #: library/stdtypes.rst:288 library/stdtypes.rst:1165 library/stdtypes.rst:2383 #: library/stdtypes.rst:3601 msgid "\\(2)" msgstr "\\(2)" #: library/stdtypes.rst:93 msgid "``not x``" msgstr "``not x``" #: library/stdtypes.rst:93 msgid "if *x* is false, then ``True``, else ``False``" msgstr "si *x* est faux, alors ``True``, sinon ``False``" #: library/stdtypes.rst:935 library/stdtypes.rst:2385 library/stdtypes.rst:2389 #: library/stdtypes.rst:3603 library/stdtypes.rst:3607 #: library/stdtypes.rst:3609 msgid "\\(3)" msgstr "\\(3)" #: library/stdtypes.rst:319 library/stdtypes.rst:972 library/stdtypes.rst:2417 #: library/stdtypes.rst:3639 msgid "Notes:" msgstr "Notes :" #: library/stdtypes.rst:105 msgid "" "This is a short-circuit operator, so it only evaluates the second argument " "if the first one is false." msgstr "" "C'est un opérateur court-circuit : il n'évalue le deuxième argument que si " "le premier est faux." #: library/stdtypes.rst:109 msgid "" "This is a short-circuit operator, so it only evaluates the second argument " "if the first one is true." msgstr "" "C'est un opérateur court-circuit, il n'évalue le deuxième argument que si le " "premier est vrai." #: library/stdtypes.rst:113 msgid "" "``not`` has a lower priority than non-Boolean operators, so ``not a == b`` " "is interpreted as ``not (a == b)``, and ``a == not b`` is a syntax error." msgstr "" "``not`` a une priorité inférieure à celle des opérateurs non-booléens, donc " "``not a == b`` est interprété comme ``not (a == b)`` et ``a == not b`` est " "une erreur de syntaxe." #: library/stdtypes.rst:120 msgid "Comparisons" msgstr "Comparaisons" #: library/stdtypes.rst:134 msgid "" "There are eight comparison operations in Python. They all have the same " "priority (which is higher than that of the Boolean operations). Comparisons " "can be chained arbitrarily; for example, ``x < y <= z`` is equivalent to ``x " "< y and y <= z``, except that *y* is evaluated only once (but in both cases " "*z* is not evaluated at all when ``x < y`` is found to be false)." msgstr "" "Il y a huit opérations de comparaison en Python. Elles ont toutes la même " "priorité (qui est supérieure à celle des opérations booléennes). Les " "comparaisons peuvent être enchaînées arbitrairement ; par exemple, ``x < y " "<= z`` est équivalent à ``x < y and y <= z``, sauf que *y* n'est évalué " "qu'une seule fois (mais dans les deux cas *z* n'est pas évalué du tout quand " "``x < y`` est faux)." #: library/stdtypes.rst:140 msgid "This table summarizes the comparison operations:" msgstr "Ce tableau résume les opérations de comparaison :" #: library/stdtypes.rst:2348 library/stdtypes.rst:3566 #: library/stdtypes.rst:3589 msgid "Meaning" msgstr "Signification" #: library/stdtypes.rst:145 msgid "``<``" msgstr "``<``" #: library/stdtypes.rst:145 msgid "strictly less than" msgstr "strictement inférieur" #: library/stdtypes.rst:147 msgid "``<=``" msgstr "``<=``" #: library/stdtypes.rst:147 msgid "less than or equal" msgstr "inférieur ou égal" #: library/stdtypes.rst:149 msgid "``>``" msgstr "``>``" #: library/stdtypes.rst:149 msgid "strictly greater than" msgstr "strictement supérieur" #: library/stdtypes.rst:151 msgid "``>=``" msgstr "``>=``" #: library/stdtypes.rst:151 msgid "greater than or equal" msgstr "supérieur ou égal" #: library/stdtypes.rst:153 msgid "``==``" msgstr "``==``" #: library/stdtypes.rst:153 msgid "equal" msgstr "égal" #: library/stdtypes.rst:155 msgid "``!=``" msgstr "``!=``" #: library/stdtypes.rst:155 msgid "not equal" msgstr "différent" #: library/stdtypes.rst:157 msgid "``is``" msgstr "``is``" #: library/stdtypes.rst:157 msgid "object identity" msgstr "identité d'objet" #: library/stdtypes.rst:159 msgid "``is not``" msgstr "``is not``" #: library/stdtypes.rst:159 msgid "negated object identity" msgstr "contraire de l'identité d'objet" #: library/stdtypes.rst:166 msgid "" "Objects of different types, except different numeric types, never compare " "equal. The ``==`` operator is always defined but for some object types (for " "example, class objects) is equivalent to :keyword:`is`. The ``<``, ``<=``, " "``>`` and ``>=`` operators are only defined where they make sense; for " "example, they raise a :exc:`TypeError` exception when one of the arguments " "is a complex number." msgstr "" "Vous ne pouvez pas tester l'égalité d'objets de types différents, à " "l'exception des types numériques entre eux. L'opérateur ``==`` est toujours " "défini mais pour certains types d'objets (par exemple, les objets de type " "classe), il est équivalent à :keyword:`is`. Les opérateurs ``<``, ``<=``, " "``>`` et ``>=`` sont définis seulement quand ils ont un sens. Par exemple, " "ils lèvent une exception :exc:`TypeError` lorsque l'un des arguments est un " "nombre complexe." #: library/stdtypes.rst:180 msgid "" "Non-identical instances of a class normally compare as non-equal unless the " "class defines the :meth:`~object.__eq__` method." msgstr "" "Des instances différentes d'une classe sont normalement considérées " "différentes à moins que la classe ne définisse la méthode :meth:`~object." "__eq__`." #: library/stdtypes.rst:183 msgid "" "Instances of a class cannot be ordered with respect to other instances of " "the same class, or other types of object, unless the class defines enough of " "the methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object." "__gt__`, and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` and :" "meth:`~object.__eq__` are sufficient, if you want the conventional meanings " "of the comparison operators)." msgstr "" "Les instances d'une classe ne peuvent pas être ordonnées par rapport à " "d'autres instances de la même classe, ou d'autres types d'objets, à moins " "que la classe ne définisse suffisamment de méthodes parmi :meth:`~object." "__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__` et :meth:`~object." "__ge__` (en général, :meth:`__lt__` et :meth:`__eq__` sont suffisantes, si " "vous voulez les significations classiques des opérateurs de comparaison)." #: library/stdtypes.rst:190 msgid "" "The behavior of the :keyword:`is` and :keyword:`is not` operators cannot be " "customized; also they can be applied to any two objects and never raise an " "exception." msgstr "" "Le comportement des opérateurs :keyword:`is` et :keyword:`is not` ne peut " "pas être personnalisé ; aussi ils peuvent être appliqués à deux objets " "quelconques et ne lèvent jamais d'exception." #: library/stdtypes.rst:198 msgid "" "Two more operations with the same syntactic priority, :keyword:`in` and :" "keyword:`not in`, are supported by types that are :term:`iterable` or " "implement the :meth:`__contains__` method." msgstr "" "Deux autres opérations avec la même priorité syntaxique, :keyword:`in` et :" "keyword:`not in`, sont pris en charge par les types :term:`itérables " "` ou qui implémentent la méthode :meth:`__contains__`." #: library/stdtypes.rst:205 msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" msgstr "Types numériques — :class:`int`, :class:`float`, :class:`complex`" #: library/stdtypes.rst:215 msgid "" "There are three distinct numeric types: :dfn:`integers`, :dfn:`floating " "point numbers`, and :dfn:`complex numbers`. In addition, Booleans are a " "subtype of integers. Integers have unlimited precision. Floating point " "numbers are usually implemented using :c:expr:`double` in C; information " "about the precision and internal representation of floating point numbers " "for the machine on which your program is running is available in :data:`sys." "float_info`. Complex numbers have a real and imaginary part, which are each " "a floating point number. To extract these parts from a complex number *z*, " "use ``z.real`` and ``z.imag``. (The standard library includes the additional " "numeric types :mod:`fractions.Fraction`, for rationals, and :mod:`decimal." "Decimal`, for floating-point numbers with user-definable precision.)" msgstr "" "Il existe trois types numériques distincts : les entiers (:dfn:`integers`), " "les nombres flottants (:dfn:`floating point numbers`) et les nombres " "complexes (:dfn:`complex numbers`). En outre, les booléens sont un sous-type " "des entiers. Les entiers ont une précision illimitée. Les nombres à virgule " "flottante sont généralement implémentés en utilisant des :c:expr:`double` en " "C ; des informations sur la précision et la représentation interne des " "nombres à virgule flottante pour la machine sur laquelle le programme est en " "cours d'exécution sont disponibles dans :data:`sys.float_info`. Les nombres " "complexes ont une partie réelle et une partie imaginaire, qui sont chacune " "des nombres à virgule flottante. Pour extraire ces parties d'un nombre " "complexe *z*, utilisez ``z.real`` et ``z.imag``. (La bibliothèque standard " "comprend les types numériques additionnels :mod:`fractions.Fraction` pour " "les rationnels et :mod:`decimal.Decimal` pour les nombres à virgule " "flottante avec une précision définissable par l'utilisateur.)" #: library/stdtypes.rst:237 msgid "" "Numbers are created by numeric literals or as the result of built-in " "functions and operators. Unadorned integer literals (including hex, octal " "and binary numbers) yield integers. Numeric literals containing a decimal " "point or an exponent sign yield floating point numbers. Appending ``'j'`` " "or ``'J'`` to a numeric literal yields an imaginary number (a complex number " "with a zero real part) which you can add to an integer or float to get a " "complex number with real and imaginary parts." msgstr "" "Les nombres sont créés par des littéraux numériques ou sont le résultat de " "fonctions natives ou d'opérateurs. Les entiers littéraux basiques (y compris " "leur forme hexadécimale, octale et binaire) donnent des entiers. Les nombres " "littéraux contenant un point décimal (NdT : notation anglo-saxonne de la " "virgule) ou un exposant donnent des nombres à virgule flottante. Suffixer " "``'j'`` ou ``'J'`` à un nombre littéral donne un nombre imaginaire (un " "nombre complexe avec une partie réelle nulle) que vous pouvez ajouter à un " "nombre (entier ou à virgule flottante) pour obtenir un nombre complexe avec " "une partie réelle et une partie imaginaire." #: library/stdtypes.rst:262 msgid "" "Python fully supports mixed arithmetic: when a binary arithmetic operator " "has operands of different numeric types, the operand with the \"narrower\" " "type is widened to that of the other, where integer is narrower than " "floating point, which is narrower than complex. A comparison between numbers " "of different types behaves as though the exact values of those numbers were " "being compared. [2]_" msgstr "" "Python gère pleinement l'arithmétique de types numériques mixtes : lorsqu'un " "opérateur arithmétique binaire possède des opérandes de types numériques " "différents, l'opérande de type le plus « étroit » est élargi à celui de " "l'autre. Dans ce système, l'entier est plus « étroit » que la virgule " "flottante, qui est plus « étroite » que le complexe. Une comparaison entre " "des nombres de types différents se comporte comme si les valeurs exactes de " "ces nombres étaient comparées [2]_." #: library/stdtypes.rst:268 msgid "" "The constructors :func:`int`, :func:`float`, and :func:`complex` can be used " "to produce numbers of a specific type." msgstr "" "Les constructeurs :func:`int`, :func:`float` et :func:`complex` peuvent être " "utilisés pour produire des nombres d'un type numérique spécifique." #: library/stdtypes.rst:271 msgid "" "All numeric types (except complex) support the following operations (for " "priorities of the operations, see :ref:`operator-summary`):" msgstr "" "Tous les types numériques (sauf complexe) gèrent les opérations suivantes " "(pour les priorités des opérations, voir :ref:`operator-summary`) :" #: library/stdtypes.rst:275 msgid "Full documentation" msgstr "Documentation complète" #: library/stdtypes.rst:277 msgid "``x + y``" msgstr "``x + y``" #: library/stdtypes.rst:277 msgid "sum of *x* and *y*" msgstr "somme de *x* et *y*" #: library/stdtypes.rst:279 msgid "``x - y``" msgstr "``x - y``" #: library/stdtypes.rst:279 msgid "difference of *x* and *y*" msgstr "différence de *x* et *y*" #: library/stdtypes.rst:281 msgid "``x * y``" msgstr "``x * y``" #: library/stdtypes.rst:281 msgid "product of *x* and *y*" msgstr "produit de *x* et *y*" #: library/stdtypes.rst:283 msgid "``x / y``" msgstr "``x / y``" #: library/stdtypes.rst:283 msgid "quotient of *x* and *y*" msgstr "quotient de *x* et *y*" #: library/stdtypes.rst:285 msgid "``x // y``" msgstr "``x // y``" #: library/stdtypes.rst:285 msgid "floored quotient of *x* and *y*" msgstr "quotient entier de *x* et *y*" #: library/stdtypes.rst:288 msgid "``x % y``" msgstr "``x % y``" #: library/stdtypes.rst:288 msgid "remainder of ``x / y``" msgstr "reste de ``x / y``" #: library/stdtypes.rst:290 msgid "``-x``" msgstr "``-x``" #: library/stdtypes.rst:290 msgid "*x* negated" msgstr "négatif de *x*" #: library/stdtypes.rst:292 msgid "``+x``" msgstr "``+x``" #: library/stdtypes.rst:292 msgid "*x* unchanged" msgstr "*x* inchangé" #: library/stdtypes.rst:294 msgid "``abs(x)``" msgstr "``abs(x)``" #: library/stdtypes.rst:294 msgid "absolute value or magnitude of *x*" msgstr "valeur absolue de *x*" #: library/stdtypes.rst:294 msgid ":func:`abs`" msgstr ":func:`abs`" #: library/stdtypes.rst:297 msgid "``int(x)``" msgstr "``int(x)``" #: library/stdtypes.rst:297 msgid "*x* converted to integer" msgstr "*x* converti en nombre entier" #: library/stdtypes.rst:297 msgid "\\(3)\\(6)" msgstr "\\(3)\\(6)" #: library/stdtypes.rst:297 msgid ":func:`int`" msgstr ":func:`int`" #: library/stdtypes.rst:299 msgid "``float(x)``" msgstr "``float(x)``" #: library/stdtypes.rst:299 msgid "*x* converted to floating point" msgstr "*x* converti en nombre à virgule flottante" #: library/stdtypes.rst:299 msgid "\\(4)\\(6)" msgstr "\\(4)\\(6)" #: library/stdtypes.rst:299 msgid ":func:`float`" msgstr ":func:`float`" #: library/stdtypes.rst:301 msgid "``complex(re, im)``" msgstr "``complex(re, im)``" #: library/stdtypes.rst:301 msgid "" "a complex number with real part *re*, imaginary part *im*. *im* defaults to " "zero." msgstr "" "un nombre complexe avec *re* pour partie réelle et *im* pour partie " "imaginaire. *im* vaut zéro par défaut." #: library/stdtypes.rst:1158 library/stdtypes.rst:3626 msgid "\\(6)" msgstr "\\(6)" #: library/stdtypes.rst:301 msgid ":func:`complex`" msgstr ":func:`complex`" #: library/stdtypes.rst:305 msgid "``c.conjugate()``" msgstr "``c.conjugate()``" #: library/stdtypes.rst:305 msgid "conjugate of the complex number *c*" msgstr "conjugué du nombre complexe *c*" #: library/stdtypes.rst:308 msgid "``divmod(x, y)``" msgstr "``divmod(x, y)``" #: library/stdtypes.rst:308 msgid "the pair ``(x // y, x % y)``" msgstr "la paire ``(x // y, x % y)``" #: library/stdtypes.rst:308 msgid ":func:`divmod`" msgstr ":func:`divmod`" #: library/stdtypes.rst:310 msgid "``pow(x, y)``" msgstr "``pow(x, y)``" #: library/stdtypes.rst:312 msgid "*x* to the power *y*" msgstr "*x* à la puissance *y*" #: library/stdtypes.rst:312 library/stdtypes.rst:1150 library/stdtypes.rst:2407 #: library/stdtypes.rst:3622 library/stdtypes.rst:3629 msgid "\\(5)" msgstr "\\(5)" #: library/stdtypes.rst:310 msgid ":func:`pow`" msgstr ":func:`pow`" #: library/stdtypes.rst:312 msgid "``x ** y``" msgstr "``x ** y``" #: library/stdtypes.rst:322 msgid "" "Also referred to as integer division. The resultant value is a whole " "integer, though the result's type is not necessarily int. The result is " "always rounded towards minus infinity: ``1//2`` is ``0``, ``(-1)//2`` is " "``-1``, ``1//(-2)`` is ``-1``, and ``(-1)//(-2)`` is ``0``." msgstr "" "Également appelé division entière. La valeur résultante est un nombre " "entier, bien que le type du résultat ne soit pas nécessairement *int*. Le " "résultat est toujours arrondi vers moins l'infini : ``1//2`` vaut ``0``, " "``(-1)//2`` vaut ``-1``, ``1//(-2)`` vaut ``-1``, et ``(-1)//(-2)`` vaut " "``0``." #: library/stdtypes.rst:328 msgid "" "Not for complex numbers. Instead convert to floats using :func:`abs` if " "appropriate." msgstr "" "Pas pour les nombres complexes. Convertissez-les plutôt en nombres flottants " "à l'aide de :func:`abs` si c'est approprié." #: library/stdtypes.rst:340 msgid "" "Conversion from floating point to integer may round or truncate as in C; see " "functions :func:`math.floor` and :func:`math.ceil` for well-defined " "conversions." msgstr "" "La conversion de virgule flottante en entier peut arrondir ou tronquer comme " "en C ; voir les fonctions :func:`math.floor` et :func:`math.ceil` pour des " "conversions bien définies." #: library/stdtypes.rst:345 msgid "" "float also accepts the strings \"nan\" and \"inf\" with an optional prefix " "\"+\" or \"-\" for Not a Number (NaN) and positive or negative infinity." msgstr "" "*float* accepte aussi les chaînes *nan* et *inf* avec un préfixe optionnel ``" "+`` ou ``-`` pour *Not a Number* (*NaN*) et les infinis positif ou négatif." #: library/stdtypes.rst:349 msgid "" "Python defines ``pow(0, 0)`` and ``0 ** 0`` to be ``1``, as is common for " "programming languages." msgstr "" "Python définit ``pow(0, 0)`` et ``0 ** 0`` valant ``1``, puisque c'est " "courant pour les langages de programmation, et logique." #: library/stdtypes.rst:353 msgid "" "The numeric literals accepted include the digits ``0`` to ``9`` or any " "Unicode equivalent (code points with the ``Nd`` property)." msgstr "" "Les littéraux numériques acceptés comprennent les chiffres ``0`` à ``9`` ou " "tout équivalent Unicode (caractères avec la propriété ``Nd``)." #: library/stdtypes.rst:356 msgid "" "See https://www.unicode.org/Public/14.0.0/ucd/extracted/DerivedNumericType." "txt for a complete list of code points with the ``Nd`` property." msgstr "" "Voir https://www.unicode.org/Public/14.0.0/ucd/extracted/DerivedNumericType." "txt pour une liste complète des caractères avec la propriété ``Nd``." #: library/stdtypes.rst:360 msgid "" "All :class:`numbers.Real` types (:class:`int` and :class:`float`) also " "include the following operations:" msgstr "" "Tous types :class:`numbers.Real` (:class:`int` et :class:`float`) " "comprennent également les opérations suivantes :" #: library/stdtypes.rst:366 msgid ":func:`math.trunc(\\ x) `" msgstr ":func:`math.trunc(\\ x) `" #: library/stdtypes.rst:366 msgid "*x* truncated to :class:`~numbers.Integral`" msgstr "*x* tronqué à l':class:`~numbers.Integral`" #: library/stdtypes.rst:369 msgid ":func:`round(x[, n]) `" msgstr ":func:`round(x[, n]) `" #: library/stdtypes.rst:369 msgid "" "*x* rounded to *n* digits, rounding half to even. If *n* is omitted, it " "defaults to 0." msgstr "" "*x* arrondi à *n* chiffres, arrondissant la moitié au pair. Si *n* est omis, " "la valeur par défaut est 0." #: library/stdtypes.rst:373 msgid ":func:`math.floor(\\ x) `" msgstr ":func:`math.floor(\\ x) `" #: library/stdtypes.rst:373 msgid "the greatest :class:`~numbers.Integral` <= *x*" msgstr "le plus grand :class:`~numbers.Integral` ≤ *x*" #: library/stdtypes.rst:376 msgid ":func:`math.ceil(x) `" msgstr ":func:`math.ceil(x) `" #: library/stdtypes.rst:376 msgid "the least :class:`~numbers.Integral` >= *x*" msgstr "le plus petit :class:`~numbers.Integral` ≥ *x*" #: library/stdtypes.rst:380 msgid "" "For additional numeric operations see the :mod:`math` and :mod:`cmath` " "modules." msgstr "" "Pour d'autres opérations numériques voir les modules :mod:`math` et :mod:" "`cmath`." #: library/stdtypes.rst:389 msgid "Bitwise Operations on Integer Types" msgstr "Opérations sur les bits des nombres entiers" #: library/stdtypes.rst:403 msgid "" "Bitwise operations only make sense for integers. The result of bitwise " "operations is calculated as though carried out in two's complement with an " "infinite number of sign bits." msgstr "" "Les opérations bit à bit n'ont de sens que pour les entiers relatifs. Le " "résultat d'une opération bit à bit est calculé comme si elle était effectuée " "en complément à deux avec un nombre infini de bits de signe." #: library/stdtypes.rst:407 msgid "" "The priorities of the binary bitwise operations are all lower than the " "numeric operations and higher than the comparisons; the unary operation " "``~`` has the same priority as the other unary numeric operations (``+`` and " "``-``)." msgstr "" "Les priorités de toutes les opérations bit à bit à deux opérandes sont " "inférieures à celles des opérations numériques et plus élevées que les " "comparaisons ; l'opération unaire ``~`` a la même priorité que les autres " "opérations numériques unaires (``+`` et ``-``)." #: library/stdtypes.rst:411 msgid "This table lists the bitwise operations sorted in ascending priority:" msgstr "" "Ce tableau répertorie les opérations binaires triées par priorité " "ascendante :" #: library/stdtypes.rst:416 msgid "``x | y``" msgstr "``x | y``" #: library/stdtypes.rst:416 msgid "bitwise :dfn:`or` of *x* and *y*" msgstr ":dfn:`OU` bit à bit de *x* et *y*" #: library/stdtypes.rst:419 library/stdtypes.rst:1171 library/stdtypes.rst:2397 #: library/stdtypes.rst:3615 msgid "\\(4)" msgstr "\\(4)" #: library/stdtypes.rst:419 msgid "``x ^ y``" msgstr "``x ^ y``" #: library/stdtypes.rst:419 msgid "bitwise :dfn:`exclusive or` of *x* and *y*" msgstr ":dfn:`OU exclusif` bit à bit de *x* et *y*" #: library/stdtypes.rst:422 msgid "``x & y``" msgstr "``x & y``" #: library/stdtypes.rst:422 msgid "bitwise :dfn:`and` of *x* and *y*" msgstr ":dfn:`ET` bit à bit de *x* et *y*" #: library/stdtypes.rst:425 msgid "``x << n``" msgstr "``x << n``" #: library/stdtypes.rst:425 msgid "*x* shifted left by *n* bits" msgstr "*x* décalé vers la gauche de *n* bits" #: library/stdtypes.rst:425 msgid "(1)(2)" msgstr "(1)(2)" #: library/stdtypes.rst:427 msgid "``x >> n``" msgstr "``x >> n``" #: library/stdtypes.rst:427 msgid "*x* shifted right by *n* bits" msgstr "*x* décalé vers la droite de *n* bits" #: library/stdtypes.rst:427 msgid "(1)(3)" msgstr "(1)(3)" #: library/stdtypes.rst:429 msgid "``~x``" msgstr "``~x``" #: library/stdtypes.rst:429 msgid "the bits of *x* inverted" msgstr "les bits de *x*, inversés" #: library/stdtypes.rst:435 msgid "" "Negative shift counts are illegal and cause a :exc:`ValueError` to be raised." msgstr "" "Des valeurs de décalage négatives sont illégales et provoquent une " "exception :exc:`ValueError`." #: library/stdtypes.rst:438 msgid "" "A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``." msgstr "" "Un décalage à gauche de *n* bits est équivalent à la multiplication par " "``pow(2, n)``." #: library/stdtypes.rst:441 msgid "" "A right shift by *n* bits is equivalent to floor division by ``pow(2, n)``." msgstr "" "Un décalage à droite de *n* les bits est équivalent à la division par " "``pow(2, n)``." #: library/stdtypes.rst:444 msgid "" "Performing these calculations with at least one extra sign extension bit in " "a finite two's complement representation (a working bit-width of ``1 + max(x." "bit_length(), y.bit_length())`` or more) is sufficient to get the same " "result as if there were an infinite number of sign bits." msgstr "" "Effectuer ces calculs avec au moins un bit d'extension de signe " "supplémentaire dans une représentation finie du complément à deux éléments " "(une largeur de bit fonctionnelle de ``1 + max(x.bit_length(), y." "bit_length()`` ou plus) est suffisante pour obtenir le même résultat que " "s'il y avait un nombre infini de bits de signe." #: library/stdtypes.rst:451 msgid "Additional Methods on Integer Types" msgstr "Méthodes supplémentaires sur les entiers" #: library/stdtypes.rst:453 msgid "" "The int type implements the :class:`numbers.Integral` :term:`abstract base " "class`. In addition, it provides a few more methods:" msgstr "" "Le type *int* implémente la :term:`classe mère abstraite ` :class:`numbers.Integral`. Il fournit aussi quelques autres " "méthodes :" #: library/stdtypes.rst:458 msgid "" "Return the number of bits necessary to represent an integer in binary, " "excluding the sign and leading zeros::" msgstr "" "Renvoie le nombre de bits nécessaires pour représenter un nombre entier en " "binaire, à l'exclusion du signe et des zéros non significatifs ::" #: library/stdtypes.rst:467 msgid "" "More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " "positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " "Equivalently, when ``abs(x)`` is small enough to have a correctly rounded " "logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then ``x." "bit_length()`` returns ``0``." msgstr "" "Plus précisément, si ``x`` est différent de zéro, ``x.bit_length()`` est le " "nombre entier positif unique, ``k`` tel que ``2**(k-1) <= abs(x) < 2**k``. " "Équivalemment, quand ``abs(x)`` est assez petit pour avoir un logarithme " "correctement arrondi, ``k = 1 + int(log(abs(x), 2))``. Si ``x`` est nul, " "alors ``x.bit_length()`` donne ``0``." #: library/stdtypes.rst:496 library/stdtypes.rst:583 msgid "Equivalent to::" msgstr "Équivalent à ::" #: library/stdtypes.rst:484 msgid "" "Return the number of ones in the binary representation of the absolute value " "of the integer. This is also known as the population count. Example::" msgstr "" "Renvoie le nombre de 1 dans la représentation binaire de la valeur absolue " "de l'entier. On la connait également sous le nom de dénombrement de la " "population. Par exemple ::" #: library/stdtypes.rst:505 msgid "Return an array of bytes representing an integer." msgstr "Renvoie un tableau d'octets représentant un nombre entier." #: library/stdtypes.rst:517 msgid "" "The integer is represented using *length* bytes, and defaults to 1. An :exc:" "`OverflowError` is raised if the integer is not representable with the given " "number of bytes." msgstr "" "L'entier est représenté en utilisant *length* octets, dont la valeur par " "défaut est 1. Une exception :exc:`OverflowError` est levée s'il n'est pas " "possible de représenter l'entier avec le nombre donné d'octets." #: library/stdtypes.rst:521 msgid "" "The *byteorder* argument determines the byte order used to represent the " "integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " "most significant byte is at the beginning of the byte array. If *byteorder* " "is ``\"little\"``, the most significant byte is at the end of the byte array." msgstr "" "L'argument *byteorder* détermine l'ordre des octets utilisé pour représenter " "le nombre entier, la valeur par défaut étant ``\"big\"``. Si *byteorder* est " "``\"big\"``, l'octet le plus significatif est au début du tableau d'octets. " "Si *byteorder* est ``\"little\"``, l'octet le plus significatif est à la fin " "du tableau d'octets." #: library/stdtypes.rst:527 msgid "" "The *signed* argument determines whether two's complement is used to " "represent the integer. If *signed* is ``False`` and a negative integer is " "given, an :exc:`OverflowError` is raised. The default value for *signed* is " "``False``." msgstr "" "L'argument *signed* détermine si le complément à deux est utilisé pour " "représenter le nombre entier. Si *signed* est ``False`` et qu'un entier " "négatif est donné, une exception :exc:`OverflowError` est levée. La valeur " "par défaut pour *signed* est ``False``." #: library/stdtypes.rst:532 msgid "" "The default values can be used to conveniently turn an integer into a single " "byte object. However, when using the default arguments, don't try to " "convert a value greater than 255 or you'll get an :exc:`OverflowError`::" msgstr "" "Les valeurs par défaut peuvent être utilisées pour transformer facilement un " "entier en un objet à un seul octet. Cependant, lorsque vous utilisez les " "arguments par défaut, n'essayez pas de convertir une valeur supérieure à 255 " "ou vous lèverez une :exc:`OverflowError` ::" # suit un : #: library/stdtypes.rst:552 msgid "Added default argument values for ``length`` and ``byteorder``." msgstr "" "ajout de valeurs par défaut pour les arguments ``length`` et ``byteorder``." #: library/stdtypes.rst:557 msgid "Return the integer represented by the given array of bytes." msgstr "Renvoie le nombre entier représenté par le tableau d'octets fourni." #: library/stdtypes.rst:570 msgid "" "The argument *bytes* must either be a :term:`bytes-like object` or an " "iterable producing bytes." msgstr "" "L'argument *bytes* doit être soit un :term:`objet octet-compatible `, soit un itérable produisant des *bytes*." #: library/stdtypes.rst:573 msgid "" "The *byteorder* argument determines the byte order used to represent the " "integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " "most significant byte is at the beginning of the byte array. If *byteorder* " "is ``\"little\"``, the most significant byte is at the end of the byte " "array. To request the native byte order of the host system, use :data:`sys." "byteorder` as the byte order value." msgstr "" "L'argument *byteorder* détermine l'ordre des octets utilisé pour représenter " "le nombre entier, la valeur par défaut étant ``\"big\"``. Si *byteorder* est " "``\"big\"``, l'octet le plus significatif est au début du tableau d'octets. " "Si *byteorder* est ``\"little\"``, l'octet le plus significatif est à la fin " "du tableau d'octets. Pour demander l'ordre natif des octets du système hôte, " "donnez :data:`sys.byteorder` comme *byteorder*." #: library/stdtypes.rst:580 msgid "" "The *signed* argument indicates whether two's complement is used to " "represent the integer." msgstr "" "L'argument *signed* indique si le complément à deux est utilisé pour " "représenter le nombre entier." # suit un : #: library/stdtypes.rst:600 msgid "Added default argument value for ``byteorder``." msgstr "ajout de la valeur par défaut pour l'argument ``byteorder``." #: library/stdtypes.rst:605 msgid "" "Return a pair of integers whose ratio is exactly equal to the original " "integer and with a positive denominator. The integer ratio of integers " "(whole numbers) is always the integer as the numerator and ``1`` as the " "denominator." msgstr "" "Renvoie une paire de nombres entiers dont le rapport est exactement égal au " "nombre d'origine et avec un dénominateur positif. L'\\ *integer_ratio* d'un " "entier (tous les nombres entiers) est cet entier au numérateur et ``1`` " "comme dénominateur." #: library/stdtypes.rst:613 msgid "Additional Methods on Float" msgstr "Méthodes supplémentaires sur les nombres à virgule flottante" #: library/stdtypes.rst:615 msgid "" "The float type implements the :class:`numbers.Real` :term:`abstract base " "class`. float also has the following additional methods." msgstr "" "Le type *float* implémente la :term:`classe mère abstraite ` :class:`numbers.Real` et a également les méthodes suivantes." #: library/stdtypes.rst:620 msgid "" "Return a pair of integers whose ratio is exactly equal to the original float " "and with a positive denominator. Raises :exc:`OverflowError` on infinities " "and a :exc:`ValueError` on NaNs." msgstr "" "Renvoie une paire de nombres entiers dont le rapport est exactement égal au " "nombre d'origine et avec un dénominateur positif. Lève :exc:`OverflowError` " "avec un infini et :exc:`ValueError` avec un NaN." #: library/stdtypes.rst:627 msgid "" "Return ``True`` if the float instance is finite with integral value, and " "``False`` otherwise::" msgstr "" "Renvoie ``True`` si l'instance de *float* est finie avec une valeur entière, " "et ``False`` autrement ::" #: library/stdtypes.rst:635 msgid "" "Two methods support conversion to and from hexadecimal strings. Since " "Python's floats are stored internally as binary numbers, converting a float " "to or from a *decimal* string usually involves a small rounding error. In " "contrast, hexadecimal strings allow exact representation and specification " "of floating-point numbers. This can be useful when debugging, and in " "numerical work." msgstr "" "Deux méthodes prennent en charge la conversion vers et à partir de chaînes " "hexadécimales. Étant donné que les *float* de Python sont stockés en interne " "sous forme de nombres binaires, la conversion d'un *float* depuis ou vers " "une chaine décimale implique généralement une petite erreur d'arrondi. En " "revanche, les chaînes hexadécimales permettent de représenter exactement les " "nombres à virgule flottante. Cela peut être utile lors du débogage, et dans " "un travail numérique." #: library/stdtypes.rst:646 msgid "" "Return a representation of a floating-point number as a hexadecimal string. " "For finite floating-point numbers, this representation will always include a " "leading ``0x`` and a trailing ``p`` and exponent." msgstr "" "Renvoie une représentation d'un nombre à virgule flottante sous forme de " "chaîne hexadécimale. Pour les nombres à virgule flottante finis, cette " "représentation comprendra toujours un préfixe ``0x``, un suffixe ``p`` et un " "exposant." #: library/stdtypes.rst:654 msgid "" "Class method to return the float represented by a hexadecimal string *s*. " "The string *s* may have leading and trailing whitespace." msgstr "" "Méthode de classe pour obtenir le *float* représenté par une chaîne de " "caractères hexadécimale *s*. La chaîne *s* peut contenir des espaces avant " "et après le nombre." #: library/stdtypes.rst:659 msgid "" "Note that :meth:`float.hex` is an instance method, while :meth:`float." "fromhex` is a class method." msgstr "" "Notez que :meth:`float.hex` est une méthode d'instance, alors que :meth:" "`float.fromhex` est une méthode de classe." #: library/stdtypes.rst:662 msgid "A hexadecimal string takes the form::" msgstr "Une chaîne hexadécimale prend la forme ::" #: library/stdtypes.rst:666 msgid "" "where the optional ``sign`` may by either ``+`` or ``-``, ``integer`` and " "``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " "decimal integer with an optional leading sign. Case is not significant, and " "there must be at least one hexadecimal digit in either the integer or the " "fraction. This syntax is similar to the syntax specified in section 6.4.4.2 " "of the C99 standard, and also to the syntax used in Java 1.5 onwards. In " "particular, the output of :meth:`float.hex` is usable as a hexadecimal " "floating-point literal in C or Java code, and hexadecimal strings produced " "by C's ``%a`` format character or Java's ``Double.toHexString`` are accepted " "by :meth:`float.fromhex`." msgstr "" "où ``sign`` peut être soit ``+`` soit ``-``, ``integer`` et ``fraction`` " "sont des chaînes de chiffres hexadécimaux, et ``exponent`` est un entier " "décimal facultativement signé. La casse n'est pas significative, et il doit " "y avoir au moins un chiffre hexadécimal soit dans le nombre entier soit dans " "la fraction. Cette syntaxe est similaire à la syntaxe spécifiée dans la " "section 6.4.4.2 de la norme C99, et est aussi la syntaxe utilisée à partir " "de Java 1.5. En particulier, la sortie de :meth:`float.hex` est utilisable " "comme valeur hexadécimale à virgule flottante littérale en C ou Java, et des " "chaînes hexadécimales produites en C via un format ``%a`` ou Java via " "``Double.toHexString`` sont acceptées par :meth:`float.fromhex`." #: library/stdtypes.rst:679 msgid "" "Note that the exponent is written in decimal rather than hexadecimal, and " "that it gives the power of 2 by which to multiply the coefficient. For " "example, the hexadecimal string ``0x3.a7p10`` represents the floating-point " "number ``(3 + 10./16 + 7./16**2) * 2.0**10``, or ``3740.0``::" msgstr "" "Notez que l'exposant est écrit en décimal plutôt qu'en hexadécimal, et qu'il " "donne la puissance de 2 par lequel multiplier le coefficient. Par exemple, " "la chaîne hexadécimale ``0x3.a7p10`` représente le nombre à virgule " "flottante ``(3 + 10./16 + 7./16**2) *2.0**10``, ou ``3740.0`` ::" #: library/stdtypes.rst:689 msgid "" "Applying the reverse conversion to ``3740.0`` gives a different hexadecimal " "string representing the same number::" msgstr "" "L'application de la conversion inverse à ``3740.0`` donne une chaîne " "hexadécimale différente représentant le même nombre ::" #: library/stdtypes.rst:699 msgid "Hashing of numeric types" msgstr "Hachage des types numériques" #: library/stdtypes.rst:701 msgid "" "For numbers ``x`` and ``y``, possibly of different types, it's a requirement " "that ``hash(x) == hash(y)`` whenever ``x == y`` (see the :meth:`~object." "__hash__` method documentation for more details). For ease of " "implementation and efficiency across a variety of numeric types (including :" "class:`int`, :class:`float`, :class:`decimal.Decimal` and :class:`fractions." "Fraction`) Python's hash for numeric types is based on a single mathematical " "function that's defined for any rational number, and hence applies to all " "instances of :class:`int` and :class:`fractions.Fraction`, and all finite " "instances of :class:`float` and :class:`decimal.Decimal`. Essentially, this " "function is given by reduction modulo ``P`` for a fixed prime ``P``. The " "value of ``P`` is made available to Python as the :attr:`modulus` attribute " "of :data:`sys.hash_info`." msgstr "" "Pour deux nombres égaux ``x`` et ``y`` (c.-à-d. ``x == y``), pouvant être de " "différents types, il est requis que ``hash(x) == hash(y)`` (voir la " "documentation de :meth:`~object.__hash__`). Pour faciliter la mise en œuvre " "et l'efficacité à travers une variété de types numériques (y compris :class:" "`int`, :class:`float`, :class:`decimal.Decimal` et :class:`fractions." "Fraction`) le hachage en Python pour les types numérique est basé sur une " "fonction mathématique unique qui est définie pour tout nombre rationnel, et " "donc s'applique à toutes les instances de :class:`int` et :class:`fractions." "Fraction`, et toutes les instances finies de :class:`float` et :class:" "`decimal.Decimal`. Essentiellement, cette fonction est donnée par la " "réduction modulo ``P`` pour un nombre ``P`` premier fixe. La valeur de ``P`` " "est disponible comme attribut :attr:`modulus` de :data:`sys.hash_info`." # suit un : #: library/stdtypes.rst:716 msgid "" "Currently, the prime used is ``P = 2**31 - 1`` on machines with 32-bit C " "longs and ``P = 2**61 - 1`` on machines with 64-bit C longs." msgstr "" "actuellement, le premier utilisé est ``P = 2 ** 31 - 1`` sur des machines " "dont les *longs* en C sont de 32 bits ``P = 2 ** 61 - 1`` sur des machines " "dont les *longs* en C font 64 bits." #: library/stdtypes.rst:719 msgid "Here are the rules in detail:" msgstr "Voici les règles en détail :" #: library/stdtypes.rst:721 msgid "" "If ``x = m / n`` is a nonnegative rational number and ``n`` is not divisible " "by ``P``, define ``hash(x)`` as ``m * invmod(n, P) % P``, where ``invmod(n, " "P)`` gives the inverse of ``n`` modulo ``P``." msgstr "" "Si ``x = m / n`` est un nombre rationnel non négatif et ``n`` n'est pas " "divisible par ``P``, définir ``hash(x)`` comme ``m * invmod(n, P) % P``, où " "``invmod(n, P)`` donne l'inverse de ``n`` modulo ``P``." #: library/stdtypes.rst:725 msgid "" "If ``x = m / n`` is a nonnegative rational number and ``n`` is divisible by " "``P`` (but ``m`` is not) then ``n`` has no inverse modulo ``P`` and the rule " "above doesn't apply; in this case define ``hash(x)`` to be the constant " "value ``sys.hash_info.inf``." msgstr "" "Si ``x = m / n`` est un nombre rationnel non négatif et ``n`` est divisible " "par ``P`` (mais ``m`` ne l'est pas), alors ``n`` n'a pas de modulo inverse " "``P`` et la règle ci-dessus n'est pas applicable ; dans ce cas définir " "``hash(x)`` comme étant la valeur de la constante ``sys.hash_info.inf``." #: library/stdtypes.rst:730 msgid "" "If ``x = m / n`` is a negative rational number define ``hash(x)`` as ``-" "hash(-x)``. If the resulting hash is ``-1``, replace it with ``-2``." msgstr "" "Si ``x = m / n`` est un nombre rationnel négatif définir ``hash(x)`` comme " "``-hash(-x)``. Si le résultat est ``-1``, le remplacer par ``-2``." #: library/stdtypes.rst:734 msgid "" "The particular values ``sys.hash_info.inf`` and ``-sys.hash_info.inf`` are " "used as hash values for positive infinity or negative infinity " "(respectively)." msgstr "" "Les valeurs particulières ``sys.hash_info.inf`` et ``-sys.hash_info.inf`` " "sont utilisées comme valeurs de hachage pour l'infini positif et l'infini " "négatif (respectivement)." #: library/stdtypes.rst:738 msgid "" "For a :class:`complex` number ``z``, the hash values of the real and " "imaginary parts are combined by computing ``hash(z.real) + sys.hash_info." "imag * hash(z.imag)``, reduced modulo ``2**sys.hash_info.width`` so that it " "lies in ``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - " "1))``. Again, if the result is ``-1``, it's replaced with ``-2``." msgstr "" "Pour un nombre :class:`complexe ` ``z``, les valeurs de hachage des " "parties réelles et imaginaires sont combinées en calculant ``hash(z.real) + " "sys.hash_info.imag * hash(z.imag)``, réduit au modulo ``2**sys.hash_info." "width`` de sorte qu'il se trouve dans ``range(-2**(sys.hash_info.width - 1), " "2**(sys.hash_info.width - 1))``. Encore une fois, si le résultat est ``-1``, " "il est remplacé par ``-2``." #: library/stdtypes.rst:746 msgid "" "To clarify the above rules, here's some example Python code, equivalent to " "the built-in hash, for computing the hash of a rational number, :class:" "`float`, or :class:`complex`::" msgstr "" "Afin de clarifier les règles ci-dessus, voici quelques exemples de code " "Python, équivalent à la fonction de hachage native, pour calculer le hachage " "d'un nombre rationnel, d'un :class:`float`, ou d'un :class:`complex` ::" #: library/stdtypes.rst:801 msgid "Iterator Types" msgstr "Les types itérateurs" #: library/stdtypes.rst:809 msgid "" "Python supports a concept of iteration over containers. This is implemented " "using two distinct methods; these are used to allow user-defined classes to " "support iteration. Sequences, described below in more detail, always " "support the iteration methods." msgstr "" "Python gère un concept d'itération sur les conteneurs. Il l'implémente en " "utilisant deux méthodes distinctes qui permettent aux classes définies par " "l'utilisateur de devenir itérables. Les séquences, décrites plus bas en " "détail, savent toujours gérer les méthodes d'itération." #: library/stdtypes.rst:814 msgid "" "One method needs to be defined for container objects to provide :term:" "`iterable` support:" msgstr "" "Une méthode doit être définie afin que les objets conteneurs prennent en " "charge :term:`l’itération ` :" #: library/stdtypes.rst:821 msgid "" "Return an :term:`iterator` object. The object is required to support the " "iterator protocol described below. If a container supports different types " "of iteration, additional methods can be provided to specifically request " "iterators for those iteration types. (An example of an object supporting " "multiple forms of iteration would be a tree structure which supports both " "breadth-first and depth-first traversal.) This method corresponds to the :c:" "member:`~PyTypeObject.tp_iter` slot of the type structure for Python objects " "in the Python/C API." msgstr "" "Renvoie un objet :term:`itérateur `. L'objet doit implémenter le " "protocole d'itération décrit ci-dessous. Si un conteneur prend en charge " "différents types d'itération, d'autres méthodes peuvent être fournies pour " "obtenir spécifiquement les itérateurs pour ces types d'itération. (Exemple " "d'un objet gérant plusieurs formes d'itération : une structure d'arbre " "pouvant être parcourue en largeur ou en profondeur.) Cette méthode " "correspond à l'attribut :c:member:`~PyTypeObject.tp_iter` de la structure du " "type des objets Python dans l'API Python/C." #: library/stdtypes.rst:830 msgid "" "The iterator objects themselves are required to support the following two " "methods, which together form the :dfn:`iterator protocol`:" msgstr "" "Les itérateurs eux-mêmes doivent implémenter les deux méthodes suivantes, " "qui forment ensemble le :dfn:`protocole d'itération` :" #: library/stdtypes.rst:836 msgid "" "Return the :term:`iterator` object itself. This is required to allow both " "containers and iterators to be used with the :keyword:`for` and :keyword:" "`in` statements. This method corresponds to the :c:member:`~PyTypeObject." "tp_iter` slot of the type structure for Python objects in the Python/C API." msgstr "" "Renvoie :term:`l’objet itérateur` lui-même. C'est nécessaire pour " "permettre à la fois à des conteneurs et des itérateurs d'être utilisés avec " "les instructions :keyword:`for` et :keyword:`in`. Cette méthode correspond à " "l'attribut :c:member:`~PyTypeObject.tp_iter` de la structure des types des " "objets Python dans l'API Python/C." #: library/stdtypes.rst:845 msgid "" "Return the next item from the :term:`iterator`. If there are no further " "items, raise the :exc:`StopIteration` exception. This method corresponds to " "the :c:member:`~PyTypeObject.tp_iternext` slot of the type structure for " "Python objects in the Python/C API." msgstr "" "Renvoie l'élément suivant de l’:term:`itérateur`. S'il n'y a pas " "d'autres éléments, une exception :exc:`StopIteration` est levée. Cette " "méthode correspond à l'attribut :c:member:`~PyTypeObject.tp_iternext` de la " "structure du type des objets Python dans l'API Python/C." #: library/stdtypes.rst:850 msgid "" "Python defines several iterator objects to support iteration over general " "and specific sequence types, dictionaries, and other more specialized " "forms. The specific types are not important beyond their implementation of " "the iterator protocol." msgstr "" "Python définit plusieurs objets itérateurs pour itérer sur les types " "standards ou spécifiques de séquence, de dictionnaires et d'autres formes " "plus spécialisées. Les types spécifiques ne sont pas importants au-delà de " "leur implémentation du protocole d'itération." #: library/stdtypes.rst:855 msgid "" "Once an iterator's :meth:`~iterator.__next__` method raises :exc:" "`StopIteration`, it must continue to do so on subsequent calls. " "Implementations that do not obey this property are deemed broken." msgstr "" "Dès que la méthode :meth:`~iterator.__next__` lève une exception :exc:" "`StopIteration`, elle doit continuer à le faire lors des appels ultérieurs. " "Les implémentations qui ne respectent pas cette propriété sont considérées " "cassées." #: library/stdtypes.rst:863 msgid "Generator Types" msgstr "Types générateurs" #: library/stdtypes.rst:865 msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " "iterator protocol. If a container object's :meth:`__iter__` method is " "implemented as a generator, it will automatically return an iterator object " "(technically, a generator object) supplying the :meth:`__iter__` and :meth:" "`~generator.__next__` methods. More information about generators can be " "found in :ref:`the documentation for the yield expression `." msgstr "" "Les :term:`générateurs ` offrent un moyen pratique d'implémenter " "le protocole d'itération. Si la méthode :meth:`__iter__` d'un objet " "conteneur est implémentée comme un générateur, elle renverra automatiquement " "un objet *iterator* (techniquement, un objet générateur) fournissant les " "méthodes :meth:`__iter__` et :meth:`~generator.__next__`. Plus " "d'informations sur les générateurs peuvent être trouvées dans :ref:`la " "documentation de l'expression yield `." #: library/stdtypes.rst:877 msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" msgstr "Types séquentiels — :class:`list`, :class:`tuple`, :class:`range`" #: library/stdtypes.rst:879 msgid "" "There are three basic sequence types: lists, tuples, and range objects. " "Additional sequence types tailored for processing of :ref:`binary data " "` and :ref:`text strings ` are described in dedicated " "sections." msgstr "" "Il existe trois types séquentiels élémentaires : les listes (objets *list*), " "*n*-uplets (objets *tuple*) et les intervalles (objets *range*). D'autres " "types séquentiels spécifiques au traitement de :ref:`données binaires " "` et :ref:`chaînes de caractères ` sont décrits dans des " "sections dédiées." #: library/stdtypes.rst:888 msgid "Common Sequence Operations" msgstr "Opérations communes sur les séquences" #: library/stdtypes.rst:892 msgid "" "The operations in the following table are supported by most sequence types, " "both mutable and immutable. The :class:`collections.abc.Sequence` ABC is " "provided to make it easier to correctly implement these operations on custom " "sequence types." msgstr "" "Les opérations dans le tableau ci-dessous sont prises en charge par la " "plupart des types séquentiels, variables et immuables. La classe mère " "abstraite :class:`collections.abc.Sequence` est fournie pour aider à " "implémenter correctement ces opérations sur les types séquentiels " "personnalisés." #: library/stdtypes.rst:897 msgid "" "This table lists the sequence operations sorted in ascending priority. In " "the table, *s* and *t* are sequences of the same type, *n*, *i*, *j* and *k* " "are integers and *x* is an arbitrary object that meets any type and value " "restrictions imposed by *s*." msgstr "" "Ce tableau répertorie les opérations sur les séquences triées par priorité " "ascendante. Dans le tableau, *s* et *t* sont des séquences du même type, " "*n*, *i*, *j* et *k* sont des nombres entiers et *x* est un objet arbitraire " "qui répond à toutes les restrictions de type et de valeur imposée par *s*." #: library/stdtypes.rst:902 msgid "" "The ``in`` and ``not in`` operations have the same priorities as the " "comparison operations. The ``+`` (concatenation) and ``*`` (repetition) " "operations have the same priority as the corresponding numeric operations. " "[3]_" msgstr "" "Les opérations ``in`` et ``not in`` ont les mêmes priorités que les " "opérations de comparaison. Les opérations ``+`` (concaténation) et ``*`` " "(répétition) ont la même priorité que les opérations numériques " "correspondantes [3]_." #: library/stdtypes.rst:923 msgid "``x in s``" msgstr "``x in s``" #: library/stdtypes.rst:923 msgid "``True`` if an item of *s* is equal to *x*, else ``False``" msgstr "``True`` si un élément de *s* est égal à *x*, sinon ``False``" #: library/stdtypes.rst:926 msgid "``x not in s``" msgstr "``x not in s``" #: library/stdtypes.rst:926 msgid "``False`` if an item of *s* is equal to *x*, else ``True``" msgstr "``False`` si un élément de *s* est égal à *x*, sinon ``True``" #: library/stdtypes.rst:929 msgid "``s + t``" msgstr "``s + t``" #: library/stdtypes.rst:929 msgid "the concatenation of *s* and *t*" msgstr "la concaténation de *s* et *t*" #: library/stdtypes.rst:929 msgid "(6)(7)" msgstr "(6)(7)" #: library/stdtypes.rst:932 msgid "``s * n`` or ``n * s``" msgstr "``s * n`` ou ``n * s``" #: library/stdtypes.rst:932 msgid "equivalent to adding *s* to itself *n* times" msgstr "équivalent à ajouter *s* *n* fois à lui même" #: library/stdtypes.rst:932 msgid "(2)(7)" msgstr "(2)(7)" #: library/stdtypes.rst:935 msgid "``s[i]``" msgstr "``s[i]``" #: library/stdtypes.rst:935 msgid "*i*\\ th item of *s*, origin 0" msgstr "*i*\\ :sup:`e` élément de *s* en commençant par 0" #: library/stdtypes.rst:937 msgid "``s[i:j]``" msgstr "``s[i:j]``" #: library/stdtypes.rst:937 msgid "slice of *s* from *i* to *j*" msgstr "tranche (*slice*) de *s* de *i* à *j*" #: library/stdtypes.rst:937 msgid "(3)(4)" msgstr "(3)(4)" #: library/stdtypes.rst:939 msgid "``s[i:j:k]``" msgstr "``s[i:j:k]``" #: library/stdtypes.rst:939 msgid "slice of *s* from *i* to *j* with step *k*" msgstr "tranche (*slice*) de *s* de *i* à *j* avec un pas de *k*" #: library/stdtypes.rst:939 msgid "(3)(5)" msgstr "(3)(5)" #: library/stdtypes.rst:942 msgid "``len(s)``" msgstr "``len(s)``" #: library/stdtypes.rst:942 msgid "length of *s*" msgstr "longueur de *s*" #: library/stdtypes.rst:944 msgid "``min(s)``" msgstr "``min(s)``" #: library/stdtypes.rst:944 msgid "smallest item of *s*" msgstr "plus petit élément de *s*" #: library/stdtypes.rst:946 msgid "``max(s)``" msgstr "``max(s)``" #: library/stdtypes.rst:946 msgid "largest item of *s*" msgstr "plus grand élément de *s*" #: library/stdtypes.rst:948 msgid "``s.index(x[, i[, j]])``" msgstr "``s.index(x[, i[, j]])``" #: library/stdtypes.rst:948 msgid "" "index of the first occurrence of *x* in *s* (at or after index *i* and " "before index *j*)" msgstr "" "indice de la première occurrence de *x* dans *s* (à ou après l'indice *i* et " "avant l'indice *j*)" #: library/stdtypes.rst:3597 msgid "\\(8)" msgstr "\\(8)" #: library/stdtypes.rst:952 msgid "``s.count(x)``" msgstr "``s.count(x)``" #: library/stdtypes.rst:952 msgid "total number of occurrences of *x* in *s*" msgstr "nombre total d'occurrences de *x* dans *s*" #: library/stdtypes.rst:956 msgid "" "Sequences of the same type also support comparisons. In particular, tuples " "and lists are compared lexicographically by comparing corresponding " "elements. This means that to compare equal, every element must compare equal " "and the two sequences must be of the same type and have the same length. " "(For full details see :ref:`comparisons` in the language reference.)" msgstr "" "Les séquences du même type gèrent également la comparaison. En particulier, " "les *n*-uplets et les listes sont comparés lexicographiquement en comparant " "les éléments correspondants. Cela signifie que, pour que deux séquences soit " "égales, les éléments les constituant doivent être égaux deux à deux et les " "deux séquences doivent être du même type et de la même longueur. (Pour plus " "de détails voir :ref:`comparisons` dans la référence du langage.)" #: library/stdtypes.rst:966 msgid "" "Forward and reversed iterators over mutable sequences access values using an " "index. That index will continue to march forward (or backward) even if the " "underlying sequence is mutated. The iterator terminates only when an :exc:" "`IndexError` or a :exc:`StopIteration` is encountered (or when the index " "drops below zero)." msgstr "" "Les itérateurs avant et arrière sur des séquences modifiables accèdent aux " "valeurs à l'aide d'un indice. Cet indice continue à avancer (ou à reculer) " "même si la séquence sous-jacente est modifiée. L'itérateur ne se termine que " "lorsqu'une :exc:`IndexError` ou une :exc:`StopIteration` est rencontrée (ou " "lorsque l'indice tombe en dessous de zéro)." #: library/stdtypes.rst:975 msgid "" "While the ``in`` and ``not in`` operations are used only for simple " "containment testing in the general case, some specialised sequences (such " "as :class:`str`, :class:`bytes` and :class:`bytearray`) also use them for " "subsequence testing::" msgstr "" "Bien que les opérations ``in`` et ``not in`` ne soient généralement " "utilisées que pour les tests d'appartenance simple, certaines séquences " "spécialisées (telles que :class:`str`, :class:`bytes` et :class:`bytearray`) " "les utilisent aussi pour tester l'existence de sous-séquences ::" #: library/stdtypes.rst:984 msgid "" "Values of *n* less than ``0`` are treated as ``0`` (which yields an empty " "sequence of the same type as *s*). Note that items in the sequence *s* are " "not copied; they are referenced multiple times. This often haunts new " "Python programmers; consider::" msgstr "" "Les valeurs de *n* plus petites que ``0`` sont traitées comme ``0`` (ce qui " "donne une séquence vide du même type que *s*). Notez que les éléments de *s* " "ne sont pas copiés ; ils sont référencés plusieurs fois. Cela hante souvent " "de nouveaux développeurs Python, typiquement ::" #: library/stdtypes.rst:996 msgid "" "What has happened is that ``[[]]`` is a one-element list containing an empty " "list, so all three elements of ``[[]] * 3`` are references to this single " "empty list. Modifying any of the elements of ``lists`` modifies this single " "list. You can create a list of different lists this way::" msgstr "" "Ce qui est arrivé est que ``[[]]`` est une liste à un élément contenant une " "liste vide, de sorte que les trois éléments de ``[[]] * 3`` sont des " "références à cette seule liste vide. Modifier l'un des éléments de ``lists`` " "modifie cette liste unique. Vous pouvez créer une liste des différentes " "listes de cette façon ::" #: library/stdtypes.rst:1008 msgid "" "Further explanation is available in the FAQ entry :ref:`faq-multidimensional-" "list`." msgstr "" "De plus amples explications sont disponibles dans la FAQ à la question :ref:" "`faq-multidimensional-list`." #: library/stdtypes.rst:1012 msgid "" "If *i* or *j* is negative, the index is relative to the end of sequence *s*: " "``len(s) + i`` or ``len(s) + j`` is substituted. But note that ``-0`` is " "still ``0``." msgstr "" "Si *i* ou *j* sont négatifs, l'indice est relatif à la fin de la séquence " "*s* : ``len(s) + i`` ou ``len(s) + j`` est substitué. Mais notez que ``-0`` " "est toujours ``0``." #: library/stdtypes.rst:1017 msgid "" "The slice of *s* from *i* to *j* is defined as the sequence of items with " "index *k* such that ``i <= k < j``. If *i* or *j* is greater than " "``len(s)``, use ``len(s)``. If *i* is omitted or ``None``, use ``0``. If " "*j* is omitted or ``None``, use ``len(s)``. If *i* is greater than or equal " "to *j*, the slice is empty." msgstr "" "La tranche de *s* de *i* à *j* est définie comme la séquence d'éléments " "d'indices *k* tels que ``i <= k < j``. Si *i* ou *j* est supérieur à " "``len(s)``, ``len(s)`` est utilisé. Si *i* est omis ou ``None``, ``0`` est " "utilisé. Si *j* est omis ou ``None``, ``len(s)`` est utilisé. Si *i* est " "supérieur ou égal à *j*, la tranche est vide." #: library/stdtypes.rst:1024 msgid "" "The slice of *s* from *i* to *j* with step *k* is defined as the sequence of " "items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other " "words, the indices are ``i``, ``i+k``, ``i+2*k``, ``i+3*k`` and so on, " "stopping when *j* is reached (but never including *j*). When *k* is " "positive, *i* and *j* are reduced to ``len(s)`` if they are greater. When " "*k* is negative, *i* and *j* are reduced to ``len(s) - 1`` if they are " "greater. If *i* or *j* are omitted or ``None``, they become \"end\" values " "(which end depends on the sign of *k*). Note, *k* cannot be zero. If *k* is " "``None``, it is treated like ``1``." msgstr "" "La tranche de *s* de *i* à *j* avec un pas de *k* est définie comme la " "séquence d'éléments d'indices ``x = i + n*k`` tels que ``0 <= n < (j-i)/k``. " "En d'autres termes, les indices sont ``i``, ``i+k``, ``i+2*k``, ``i+3*k`` et " "ainsi de suite, en arrêtant lorsque *j* est atteint (mais jamais inclus). Si " "*k* est positif, *i* et *j* sont réduits, s'ils sont plus grands, à " "``len(s)``. Si *k* est négatif, *i* et *j* sont réduits à ``len(s) - 1`` " "s'ils sont plus grands. Si *i* ou *j* sont omis ou sont ``None``, ils " "deviennent des valeurs « limites » (la limite haute ou basse dépend du signe " "de *k*). Notez que *k* ne peut pas valoir zéro. Si *k* est ``None``, il est " "traité comme ``1``." #: library/stdtypes.rst:1035 msgid "" "Concatenating immutable sequences always results in a new object. This " "means that building up a sequence by repeated concatenation will have a " "quadratic runtime cost in the total sequence length. To get a linear " "runtime cost, you must switch to one of the alternatives below:" msgstr "" "Concaténer des séquences immuables donne toujours un nouvel objet. Cela " "signifie que la construction d'une séquence par concaténations répétées aura " "une durée d'exécution quadratique par rapport à la longueur de la séquence " "totale. Pour obtenir un temps d'exécution linéaire, vous devez utiliser " "l'une des alternatives suivantes :" # énumération #: library/stdtypes.rst:1040 msgid "" "if concatenating :class:`str` objects, you can build a list and use :meth:" "`str.join` at the end or else write to an :class:`io.StringIO` instance and " "retrieve its value when complete" msgstr "" "si vous concaténez des :class:`str`, vous pouvez construire une liste puis " "utiliser :meth:`str.join` à la fin, ou bien écrire dans une instance de :" "class:`io.StringIO` et récupérer sa valeur lorsque vous avez terminé ;" # énumération #: library/stdtypes.rst:1044 msgid "" "if concatenating :class:`bytes` objects, you can similarly use :meth:`bytes." "join` or :class:`io.BytesIO`, or you can do in-place concatenation with a :" "class:`bytearray` object. :class:`bytearray` objects are mutable and have " "an efficient overallocation mechanism" msgstr "" "si vous concaténez des :class:`bytes`, vous pouvez aussi utiliser :meth:" "`bytes.join` ou :class:`io.BytesIO`, ou vous pouvez faire les concaténations " "sur place avec un objet :class:`bytearray`. Les objets :class:`bytearray` " "sont muables et ont un mécanisme de sur-allocation efficace ;" # énumération #: library/stdtypes.rst:1049 msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" msgstr "" "si vous concaténez des :class:`n-uplets`, utilisez plutôt *extend* " "sur une :class:`list` ;" # fin d'énumération #: library/stdtypes.rst:1051 msgid "for other types, investigate the relevant class documentation" msgstr "" "pour les autres types, cherchez dans la documentation de la classe concernée." #: library/stdtypes.rst:1055 msgid "" "Some sequence types (such as :class:`range`) only support item sequences " "that follow specific patterns, and hence don't support sequence " "concatenation or repetition." msgstr "" "Certains types séquentiels (tels que :class:`range`) ne gèrent que des " "séquences qui suivent des modèles spécifiques, et donc ne prennent pas en " "charge la concaténation ou la répétition." #: library/stdtypes.rst:1060 msgid "" "``index`` raises :exc:`ValueError` when *x* is not found in *s*. Not all " "implementations support passing the additional arguments *i* and *j*. These " "arguments allow efficient searching of subsections of the sequence. Passing " "the extra arguments is roughly equivalent to using ``s[i:j].index(x)``, only " "without copying any data and with the returned index being relative to the " "start of the sequence rather than the start of the slice." msgstr "" "``index`` lève une exception :exc:`ValueError` quand *x* ne se trouve pas " "dans *s*. Toutes les implémentations ne gèrent pas les deux paramètres " "supplémentaires *i* et *j*. Ces deux arguments permettent de chercher " "efficacement dans une sous-séquence de la séquence. Donner ces arguments est " "plus ou moins équivalent à ``s[i:j].index(x)``, sans copier les données ; " "l'indice renvoyé est relatif au début de la séquence et non au début de la " "tranche." #: library/stdtypes.rst:1071 msgid "Immutable Sequence Types" msgstr "Types de séquences immuables" #: library/stdtypes.rst:1078 msgid "" "The only operation that immutable sequence types generally implement that is " "not also implemented by mutable sequence types is support for the :func:" "`hash` built-in." msgstr "" "La seule opération que les types de séquences immuables implémentent et qui " "n'est pas implémentée par les types de séquences muables est la fonction " "native :func:`hash`." #: library/stdtypes.rst:1082 msgid "" "This support allows immutable sequences, such as :class:`tuple` instances, " "to be used as :class:`dict` keys and stored in :class:`set` and :class:" "`frozenset` instances." msgstr "" "Cette implémentation permet d'utiliser des séquences immuables, comme les " "instances de :class:`n-uplets `, en tant que clés de :class:`dict` et " "stockées dans les instances de :class:`set` et :class:`frozenset`." #: library/stdtypes.rst:1086 msgid "" "Attempting to hash an immutable sequence that contains unhashable values " "will result in :exc:`TypeError`." msgstr "" "Essayer de hacher une séquence immuable qui contient des valeurs non " "hachables lève une :exc:`TypeError`." #: library/stdtypes.rst:1093 msgid "Mutable Sequence Types" msgstr "Types de séquences muables" #: library/stdtypes.rst:1100 msgid "" "The operations in the following table are defined on mutable sequence types. " "The :class:`collections.abc.MutableSequence` ABC is provided to make it " "easier to correctly implement these operations on custom sequence types." msgstr "" "Les opérations dans le tableau ci-dessous sont définies sur les types de " "séquences muables. La classe mère abstraite :class:`collections.abc." "MutableSequence` est prévue pour faciliter l'implémentation correcte de ces " "opérations sur les types de séquences personnalisées." #: library/stdtypes.rst:1104 msgid "" "In the table *s* is an instance of a mutable sequence type, *t* is any " "iterable object and *x* is an arbitrary object that meets any type and value " "restrictions imposed by *s* (for example, :class:`bytearray` only accepts " "integers that meet the value restriction ``0 <= x <= 255``)." msgstr "" "Dans le tableau ci-dessosus, *s* est une instance d'un type de séquence " "muable, *t* est un objet itérable et *x* est un objet arbitraire qui répond " "à toutes les restrictions de type et de valeur imposées par *s* (par " "exemple, :class:`bytearray` accepte uniquement des nombres entiers qui " "répondent à la restriction de la valeur ``0 <= x <= 255``)." #: library/stdtypes.rst:1128 msgid "``s[i] = x``" msgstr "``s[i] = x``" #: library/stdtypes.rst:1128 msgid "item *i* of *s* is replaced by *x*" msgstr "l'élément *i* de *s* est remplacé par *x*" #: library/stdtypes.rst:1131 msgid "``s[i:j] = t``" msgstr "``s[i:j] = t``" #: library/stdtypes.rst:1131 msgid "" "slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" msgstr "" "la tranche de *s* de *i* à *j* est remplacée par le contenu de l'itérable *t*" #: library/stdtypes.rst:1135 msgid "``del s[i:j]``" msgstr "``del s[i:j]``" #: library/stdtypes.rst:1135 msgid "same as ``s[i:j] = []``" msgstr "identique à ``s[i:j] = []``" #: library/stdtypes.rst:1137 msgid "``s[i:j:k] = t``" msgstr "``s[i:j:k] = t``" #: library/stdtypes.rst:1137 msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" msgstr "les éléments de ``s[i:j:k]`` sont remplacés par ceux de *t*" #: library/stdtypes.rst:1140 msgid "``del s[i:j:k]``" msgstr "``del s[i:j:k]``" #: library/stdtypes.rst:1140 msgid "removes the elements of ``s[i:j:k]`` from the list" msgstr "supprime les éléments de ``s[i:j:k]`` de la liste" #: library/stdtypes.rst:1143 msgid "``s.append(x)``" msgstr "``s.append(x)``" #: library/stdtypes.rst:1143 msgid "" "appends *x* to the end of the sequence (same as ``s[len(s):len(s)] = [x]``)" msgstr "" "ajoute *x* à la fin de la séquence (identique à ``s[len(s):len(s)] = [x]``)" #: library/stdtypes.rst:1147 msgid "``s.clear()``" msgstr "``s.clear()``" #: library/stdtypes.rst:1147 msgid "removes all items from *s* (same as ``del s[:]``)" msgstr "supprime tous les éléments de *s* (identique à ``del s[:]``)" #: library/stdtypes.rst:1150 msgid "``s.copy()``" msgstr "``s.copy()``" #: library/stdtypes.rst:1150 msgid "creates a shallow copy of *s* (same as ``s[:]``)" msgstr "crée une copie superficielle de *s* (identique à ``s[:]``)" #: library/stdtypes.rst:1153 msgid "``s.extend(t)`` or ``s += t``" msgstr "``s.extend(t)`` ou ``s += t``" #: library/stdtypes.rst:1153 msgid "" "extends *s* with the contents of *t* (for the most part the same as " "``s[len(s):len(s)] = t``)" msgstr "étend *s* avec le contenu de *t* (proche de ``s[len(s):len(s)] = t``)" #: library/stdtypes.rst:1158 msgid "``s *= n``" msgstr "``s *= n``" #: library/stdtypes.rst:1158 msgid "updates *s* with its contents repeated *n* times" msgstr "met à jour *s* avec son contenu répété *n* fois" #: library/stdtypes.rst:1161 msgid "``s.insert(i, x)``" msgstr "``s.insert(i, x)``" #: library/stdtypes.rst:1161 msgid "" "inserts *x* into *s* at the index given by *i* (same as ``s[i:i] = [x]``)" msgstr "" "insère *x* dans *s* à l'indice donné par *i* (identique à ``s[i:i] = [x]``)" #: library/stdtypes.rst:1165 msgid "``s.pop()`` or ``s.pop(i)``" msgstr "``s.pop()`` ou ``s.pop(i)``" #: library/stdtypes.rst:1165 msgid "retrieves the item at *i* and also removes it from *s*" msgstr "récupère l'élément à la position *i* et le supprime de *s*" #: library/stdtypes.rst:1168 msgid "``s.remove(x)``" msgstr "``s.remove(x)``" #: library/stdtypes.rst:1168 msgid "remove the first item from *s* where ``s[i]`` is equal to *x*" msgstr "supprime le premier élément de *s* pour lequel ``s[i]`` est égal à *x*" #: library/stdtypes.rst:1171 msgid "``s.reverse()``" msgstr "``s.reverse()``" #: library/stdtypes.rst:1171 msgid "reverses the items of *s* in place" msgstr "inverse sur place les éléments de *s*" #: library/stdtypes.rst:1179 msgid "*t* must have the same length as the slice it is replacing." msgstr "*t* doit avoir la même longueur que la tranche qu'il remplace." #: library/stdtypes.rst:1182 msgid "" "The optional argument *i* defaults to ``-1``, so that by default the last " "item is removed and returned." msgstr "" "L'argument optionnel *i* vaut ``-1`` par défaut, afin que, par défaut, le " "dernier élément soit retiré et renvoyé." #: library/stdtypes.rst:1186 msgid ":meth:`remove` raises :exc:`ValueError` when *x* is not found in *s*." msgstr "" ":meth:`remove` lève une exception :exc:`ValueError` si *x* ne se trouve pas " "dans *s*." #: library/stdtypes.rst:1189 msgid "" "The :meth:`reverse` method modifies the sequence in place for economy of " "space when reversing a large sequence. To remind users that it operates by " "side effect, it does not return the reversed sequence." msgstr "" "La méthode :meth:`reverse` modifie la séquence sur place pour économiser de " "l'espace lors du traitement de grandes séquences. Pour rappeler aux " "utilisateurs qu'elle a un effet de bord, elle ne renvoie pas la séquence " "inversée." #: library/stdtypes.rst:1194 msgid "" ":meth:`clear` and :meth:`!copy` are included for consistency with the " "interfaces of mutable containers that don't support slicing operations (such " "as :class:`dict` and :class:`set`). :meth:`!copy` is not part of the :class:" "`collections.abc.MutableSequence` ABC, but most concrete mutable sequence " "classes provide it." msgstr "" ":meth:`clear` et :meth:`!copy` sont incluses pour la compatibilité avec les " "interfaces des conteneurs muables qui ne gèrent pas les opérations de " "découpage (comme :class:`dict` et :class:`set`). :meth:`!copy` ne fait pas " "partie des classes mères abstraites (*ABC*) de :class:`collections.abc." "MutableSequence`, mais la plupart des classes implémentées gérant des " "séquences la proposent." #: library/stdtypes.rst:1200 msgid ":meth:`clear` and :meth:`!copy` methods." msgstr "méthodes :meth:`clear` et :meth:`!copy`." #: library/stdtypes.rst:1204 msgid "" "The value *n* is an integer, or an object implementing :meth:`~object." "__index__`. Zero and negative values of *n* clear the sequence. Items in " "the sequence are not copied; they are referenced multiple times, as " "explained for ``s * n`` under :ref:`typesseq-common`." msgstr "" "La valeur *n* est un entier, ou un objet implémentant :meth:`~object." "__index__`. Zéro et les valeurs négatives de *n* permettent d'effacer la " "séquence. Les éléments dans la séquence ne sont pas copiés ; ils sont " "référencés plusieurs fois, comme expliqué pour ``s * n`` dans :ref:`typesseq-" "common`." #: library/stdtypes.rst:1213 msgid "Lists" msgstr "Listes" #: library/stdtypes.rst:1217 msgid "" "Lists are mutable sequences, typically used to store collections of " "homogeneous items (where the precise degree of similarity will vary by " "application)." msgstr "" "Les listes sont des séquences muables, généralement utilisées pour stocker " "des collections d'éléments homogènes (le degré de similitude varie selon " "l'usage)." #: library/stdtypes.rst:1223 msgid "Lists may be constructed in several ways:" msgstr "Les listes peuvent être construites de différentes manières :" # énumération #: library/stdtypes.rst:1225 msgid "Using a pair of square brackets to denote the empty list: ``[]``" msgstr "" "en utilisant une paire de crochets pour indiquer une liste vide : ``[]`` ;" # énumération #: library/stdtypes.rst:1226 msgid "" "Using square brackets, separating items with commas: ``[a]``, ``[a, b, c]``" msgstr "" "au moyen de crochets, en séparant les éléments par des virgules : ``[a]``, " "``[a, b, c]`` ;" # énumération #: library/stdtypes.rst:1227 msgid "Using a list comprehension: ``[x for x in iterable]``" msgstr "en utilisant une liste en compréhension : ``[x for x in iterable]`` ;" # fin d'énumération #: library/stdtypes.rst:1228 msgid "Using the type constructor: ``list()`` or ``list(iterable)``" msgstr "" "en utilisant le constructeur du type : ``list()`` ou ``list(iterable)``." #: library/stdtypes.rst:1230 msgid "" "The constructor builds a list whose items are the same and in the same order " "as *iterable*'s items. *iterable* may be either a sequence, a container " "that supports iteration, or an iterator object. If *iterable* is already a " "list, a copy is made and returned, similar to ``iterable[:]``. For example, " "``list('abc')`` returns ``['a', 'b', 'c']`` and ``list( (1, 2, 3) )`` " "returns ``[1, 2, 3]``. If no argument is given, the constructor creates a " "new empty list, ``[]``." msgstr "" "Le constructeur crée une liste dont les éléments sont les mêmes et dans le " "même ordre que les éléments d'*iterable*. *iterable* peut être une séquence, " "un conteneur qui prend en charge l'itération, ou un itérateur. Si *iterable* " "est déjà une liste, une copie est faite et renvoyée, comme avec " "``iterable[:]``. Par exemple, ``list('abc')`` renvoie ``['a', 'b', 'c']`` et " "``list( (1, 2, 3) )`` renvoie ``[1, 2, 3]``. Si aucun argument est donné, le " "constructeur crée une nouvelle liste vide, ``[]``." #: library/stdtypes.rst:1239 msgid "" "Many other operations also produce lists, including the :func:`sorted` built-" "in." msgstr "" "De nombreuses autres opérations produisent des listes, comme la fonction " "native :func:`sorted`." #: library/stdtypes.rst:1242 msgid "" "Lists implement all of the :ref:`common ` and :ref:`mutable " "` sequence operations. Lists also provide the following " "additional method:" msgstr "" "Les listes gèrent toutes les opérations des séquences :ref:`communes " "` et :ref:`muables `. Les listes " "fournissent également la méthode supplémentaire suivante :" #: library/stdtypes.rst:1248 msgid "" "This method sorts the list in place, using only ``<`` comparisons between " "items. Exceptions are not suppressed - if any comparison operations fail, " "the entire sort operation will fail (and the list will likely be left in a " "partially modified state)." msgstr "" "Cette méthode trie la liste sur place, en utilisant uniquement des " "comparaisons ``<`` entre les éléments. Les exceptions ne sont pas " "supprimées : si n'importe quelle opération de comparaison échoue, le tri " "échoue (et la liste sera probablement laissée dans un état partiellement " "modifié)." #: library/stdtypes.rst:1253 msgid "" ":meth:`sort` accepts two arguments that can only be passed by keyword (:ref:" "`keyword-only arguments `):" msgstr "" ":meth:`sort` accepte deux arguments qui ne peuvent être fournis que nommés " "(voir :ref:`arguments nommés `) :" #: library/stdtypes.rst:1256 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element (for example, ``key=str.lower``). The " "key corresponding to each item in the list is calculated once and then used " "for the entire sorting process. The default value of ``None`` means that " "list items are sorted directly without calculating a separate key value." msgstr "" "*key* spécifie une fonction d'un argument utilisée pour extraire une clé de " "comparaison de chaque élément de la liste (par exemple, ``key=str.lower``). " "La clé correspondant à chaque élément de la liste n'est calculée qu'une " "seule fois, puis utilisée durant tout le processus. La valeur par défaut, " "``None``, signifie que les éléments sont triés directement sans calculer de " "« valeur clé » séparée." #: library/stdtypes.rst:1263 msgid "" "The :func:`functools.cmp_to_key` utility is available to convert a 2.x style " "*cmp* function to a *key* function." msgstr "" "La fonction utilitaire :func:`functools.cmp_to_key` est disponible pour " "convertir une fonction *cmp* du style 2.x à une fonction *key*." #: library/stdtypes.rst:1266 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." msgstr "" "*reverse*, une valeur booléenne. Si elle est ``True``, la liste d'éléments " "est triée comme si toutes les comparaisons étaient inversées." #: library/stdtypes.rst:1269 msgid "" "This method modifies the sequence in place for economy of space when sorting " "a large sequence. To remind users that it operates by side effect, it does " "not return the sorted sequence (use :func:`sorted` to explicitly request a " "new sorted list instance)." msgstr "" "Cette méthode modifie la séquence sur place pour économiser de l'espace lors " "du tri de grandes séquences. Pour rappeler aux utilisateurs cet effet de " "bord, elle ne renvoie pas la séquence triée (utilisez :func:`sorted` pour " "demander explicitement une nouvelle instance de liste triée)." #: library/stdtypes.rst:1274 msgid "" "The :meth:`sort` method is guaranteed to be stable. A sort is stable if it " "guarantees not to change the relative order of elements that compare equal " "--- this is helpful for sorting in multiple passes (for example, sort by " "department, then by salary grade)." msgstr "" "La méthode :meth:`sort` est garantie stable. Un tri est stable s'il garantit " "de ne pas changer l'ordre relatif des éléments égaux — cela est utile pour " "trier en plusieurs passes (par exemple, trier par service, puis par niveau " "de salaire)." #: library/stdtypes.rst:1279 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" "Pour des exemples de tris et un bref tutoriel, consultez :ref:`sortinghowto`." # suit un : #: library/stdtypes.rst:1283 msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " "inspect, the list is undefined. The C implementation of Python makes the " "list appear empty for the duration, and raises :exc:`ValueError` if it can " "detect that the list has been mutated during a sort." msgstr "" "l'effet de tenter de modifier, ou même inspecter la liste pendant qu'on la " "trie est indéfini. L'implémentation C de Python fait apparaître la liste " "comme vide pour la durée du traitement, et lève :exc:`ValueError` si elle " "détecte que la liste a été modifiée au cours du tri." #: library/stdtypes.rst:1292 msgid "Tuples" msgstr "*N*-uplets" #: library/stdtypes.rst:1296 msgid "" "Tuples are immutable sequences, typically used to store collections of " "heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " "built-in). Tuples are also used for cases where an immutable sequence of " "homogeneous data is needed (such as allowing storage in a :class:`set` or :" "class:`dict` instance)." msgstr "" "Les *n*-uplets (*tuples* en anglais) sont des séquences immuables, " "généralement utilisées pour stocker des collections de données hétérogènes " "(telles que les paires produites par la fonction native :func:`enumerate`). " "Les *n*-uplets sont également utilisés dans des cas où une séquence homogène " "et immuable de données est nécessaire (pour, par exemple, les stocker dans " "un :class:`ensemble ` ou un :class:`dictionnaire `)." #: library/stdtypes.rst:1304 msgid "Tuples may be constructed in a number of ways:" msgstr "Les *n*-uplets peuvent être construits de différentes façons :" # énumération #: library/stdtypes.rst:1306 msgid "Using a pair of parentheses to denote the empty tuple: ``()``" msgstr "" "en utilisant une paire de parenthèses pour désigner le *n*-uplet vide : " "``()`` ;" # énumération #: library/stdtypes.rst:1307 msgid "Using a trailing comma for a singleton tuple: ``a,`` or ``(a,)``" msgstr "" "en utilisant une virgule, pour créer un *n*-uplet d'un élément : ``a,`` ou " "``(a,)`` ;" # énumération #: library/stdtypes.rst:1308 msgid "Separating items with commas: ``a, b, c`` or ``(a, b, c)``" msgstr "" "en séparant les éléments avec des virgules : ``a, b, c`` ou ``(a, b, c)`` ;" # fin d'énumération #: library/stdtypes.rst:1309 msgid "Using the :func:`tuple` built-in: ``tuple()`` or ``tuple(iterable)``" msgstr "" "en utilisant la fonction native :func:`tuple` : ``tuple()`` ou " "``tuple(iterable)``." #: library/stdtypes.rst:1311 msgid "" "The constructor builds a tuple whose items are the same and in the same " "order as *iterable*'s items. *iterable* may be either a sequence, a " "container that supports iteration, or an iterator object. If *iterable* is " "already a tuple, it is returned unchanged. For example, ``tuple('abc')`` " "returns ``('a', 'b', 'c')`` and ``tuple( [1, 2, 3] )`` returns ``(1, 2, " "3)``. If no argument is given, the constructor creates a new empty tuple, " "``()``." msgstr "" "Le constructeur construit un *n*-uplet dont les éléments sont les mêmes et " "dans le même ordre que les éléments de *iterable*. *iterable* peut être une " "séquence, un conteneur qui prend en charge l'itération ou un itérateur. Si " "*iterable* est déjà un *n*-uplet, il est renvoyé inchangé. Par exemple, " "``tuple('abc')`` renvoie ``('a', 'b', 'c')`` et ``tuple( [1, 2, 3] )`` " "renvoie ``(1, 2, 3)``. Si aucun argument n'est donné, le constructeur crée " "un nouveau *n*-uplet vide, ``()``." #: library/stdtypes.rst:1319 msgid "" "Note that it is actually the comma which makes a tuple, not the parentheses. " "The parentheses are optional, except in the empty tuple case, or when they " "are needed to avoid syntactic ambiguity. For example, ``f(a, b, c)`` is a " "function call with three arguments, while ``f((a, b, c))`` is a function " "call with a 3-tuple as the sole argument." msgstr "" "Notez que c'est en fait la virgule qui fait un *n*-uplet et non les " "parenthèses. Les parenthèses sont facultatives, sauf dans le cas du *n*-" "uplet vide, ou lorsqu'elles sont nécessaires pour éviter l'ambiguïté " "syntaxique. Par exemple, ``f(a, b, c)`` est un appel de fonction avec trois " "arguments, alors que ``f((a, b, c))`` est un appel de fonction avec un " "triplet comme unique argument." #: library/stdtypes.rst:1325 msgid "" "Tuples implement all of the :ref:`common ` sequence " "operations." msgstr "" "Les *n*-uplets implémentent toutes les opérations :ref:`communes ` des séquences." #: library/stdtypes.rst:1328 msgid "" "For heterogeneous collections of data where access by name is clearer than " "access by index, :func:`collections.namedtuple` may be a more appropriate " "choice than a simple tuple object." msgstr "" "Pour les collections hétérogènes de données où l'accès par nom est plus " "clair que l'accès par indice, :func:`collections.namedtuple` peut être un " "choix plus approprié qu'un simple *n*-uplet." #: library/stdtypes.rst:1336 msgid "Ranges" msgstr "*Ranges*" #: library/stdtypes.rst:1340 msgid "" "The :class:`range` type represents an immutable sequence of numbers and is " "commonly used for looping a specific number of times in :keyword:`for` loops." msgstr "" "Le type :class:`range` représente une séquence immuable de nombres et est " "couramment utilisé pour itérer un certain nombre de fois dans les boucles :" "keyword:`for`." #: library/stdtypes.rst:1347 msgid "" "The arguments to the range constructor must be integers (either built-in :" "class:`int` or any object that implements the :meth:`~object.__index__` " "special method). If the *step* argument is omitted, it defaults to ``1``. " "If the *start* argument is omitted, it defaults to ``0``. If *step* is " "zero, :exc:`ValueError` is raised." msgstr "" "Les arguments du constructeur de *range* doivent être des entiers (des :" "class:`int` ou tout autre objet qui implémente la méthode spéciale :meth:" "`~object.__index__`). La valeur par défaut de l'argument *step* est ``1``. " "La valeur par défaut de l'argument *start* est ``0``. Si *step* est égal à " "zéro, une exception :exc:`ValueError` est levée." #: library/stdtypes.rst:1353 msgid "" "For a positive *step*, the contents of a range ``r`` are determined by the " "formula ``r[i] = start + step*i`` where ``i >= 0`` and ``r[i] < stop``." msgstr "" "Pour un *step* positif, le contenu d'un *range* ``r`` est déterminé par la " "formule ``r[i] = start + step*i`` où ``i >= 0`` et ``r[i] < stop``." #: library/stdtypes.rst:1357 msgid "" "For a negative *step*, the contents of the range are still determined by the " "formula ``r[i] = start + step*i``, but the constraints are ``i >= 0`` and " "``r[i] > stop``." msgstr "" "Pour un *step* négatif, le contenu du *range* est toujours déterminé par la " "formule ``r[i] = start + step*i``, mais les contraintes sont ``i >= 0`` et " "``r[i] > stop``." #: library/stdtypes.rst:1361 msgid "" "A range object will be empty if ``r[0]`` does not meet the value constraint. " "Ranges do support negative indices, but these are interpreted as indexing " "from the end of the sequence determined by the positive indices." msgstr "" "Un objet *range* sera vide si ``r[0]`` ne répond pas à la contrainte de " "valeur. Les *range* prennent en charge les indices négatifs, mais ceux-ci " "sont interprétées comme un indice à partir de la fin de la séquence " "déterminée par les indices positifs." #: library/stdtypes.rst:1366 msgid "" "Ranges containing absolute values larger than :data:`sys.maxsize` are " "permitted but some features (such as :func:`len`) may raise :exc:" "`OverflowError`." msgstr "" "Les *range* contenant des valeurs absolues plus grandes que :data:`sys." "maxsize` sont permises, mais certaines fonctionnalités (comme :func:`len`) " "peuvent lever :exc:`OverflowError`." #: library/stdtypes.rst:1370 msgid "Range examples::" msgstr "Exemples avec *range* ::" #: library/stdtypes.rst:1387 msgid "" "Ranges implement all of the :ref:`common ` sequence " "operations except concatenation and repetition (due to the fact that range " "objects can only represent sequences that follow a strict pattern and " "repetition and concatenation will usually violate that pattern)." msgstr "" "*range* implémente toutes les opérations :ref:`communes ` " "des séquences sauf la concaténation et la répétition (en raison du fait que " "les *range* ne peuvent représenter que des séquences qui respectent un motif " "strict et que la répétition et la concaténation les feraient dévier de ce " "motif)." #: library/stdtypes.rst:1394 msgid "" "The value of the *start* parameter (or ``0`` if the parameter was not " "supplied)" msgstr "" "Valeur du paramètre *start* (ou ``0`` si le paramètre n'a pas été fourni)" #: library/stdtypes.rst:1399 msgid "The value of the *stop* parameter" msgstr "Valeur du paramètre *stop*" #: library/stdtypes.rst:1403 msgid "" "The value of the *step* parameter (or ``1`` if the parameter was not " "supplied)" msgstr "" "Valeur du paramètre *step* (ou ``1`` si le paramètre n'a pas été fourni)" #: library/stdtypes.rst:1406 msgid "" "The advantage of the :class:`range` type over a regular :class:`list` or :" "class:`tuple` is that a :class:`range` object will always take the same " "(small) amount of memory, no matter the size of the range it represents (as " "it only stores the ``start``, ``stop`` and ``step`` values, calculating " "individual items and subranges as needed)." msgstr "" "L'avantage du type :class:`range` sur une :class:`liste ` classique ou " "un :class:`n-uplet ` est qu'un objet :class:`range` occupe toujours " "la même (petite) quantité de mémoire, peu importe la taille de l'intervalle " "qu'il représente (car il ne stocke que les valeurs ``start``, ``stop``, " "``step``, le calcul des éléments individuels et les sous-intervalles au " "besoin)." #: library/stdtypes.rst:1412 msgid "" "Range objects implement the :class:`collections.abc.Sequence` ABC, and " "provide features such as containment tests, element index lookup, slicing " "and support for negative indices (see :ref:`typesseq`):" msgstr "" "Les *range* implémentent la classe mère abstraite :class:`collections.abc." "Sequence` et offrent des fonctionnalités telles que les tests d'appartenance " "(avec *in*), de recherche par indice, les tranches et ils gèrent les indices " "négatifs (voir :ref:`typesseq`) :" #: library/stdtypes.rst:1432 msgid "" "Testing range objects for equality with ``==`` and ``!=`` compares them as " "sequences. That is, two range objects are considered equal if they " "represent the same sequence of values. (Note that two range objects that " "compare equal might have different :attr:`~range.start`, :attr:`~range.stop` " "and :attr:`~range.step` attributes, for example ``range(0) == range(2, 1, " "3)`` or ``range(0, 3, 2) == range(0, 4, 2)``.)" msgstr "" "Comparer des *range* avec ``==`` et ``!=`` les compare comme des séquences. " "C'est-à-dire que deux objets *range* sont considérés comme égaux s'ils " "représentent la même séquence de valeurs. (Notez que deux objets *range* " "dits égaux pourraient avoir leurs attributs :attr:`~range.start`, :attr:" "`~range.stop` et :attr:`~range.step` différents, par exemple ``range(0) == " "range(2, 1, 3)`` ou ``range(0, 3, 2) == range(0, 4, 2)``.)" # suit un : #: library/stdtypes.rst:1439 msgid "" "Implement the Sequence ABC. Support slicing and negative indices. Test :" "class:`int` objects for membership in constant time instead of iterating " "through all items." msgstr "" "implémente la classe mère abstraite *Sequence*. prend en charge les tranches " "(*slicing*) et les indices négatifs. Teste l'appartenance d'un :class:`int` " "en temps constant au lieu d'itérer sur tous les éléments." #: library/stdtypes.rst:1445 msgid "" "Define '==' and '!=' to compare range objects based on the sequence of " "values they define (instead of comparing based on object identity)." msgstr "" "``==`` et ``!=`` comparent des *range* en fonction de la séquence de valeurs " "qu'ils définissent (au lieu d'une comparaison fondée sur l'identité de " "l'objet)." # suit un : #: library/stdtypes.rst:1450 msgid "" "The :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " "attributes." msgstr "" "les attributs :attr:`~range.start`, :attr:`~range.stop` et :attr:`~range." "step`." #: library/stdtypes.rst:1456 msgid "" "The `linspace recipe `_ shows " "how to implement a lazy version of range suitable for floating point " "applications." msgstr "" "La `recette linspace `_ montre " "comment implémenter une version paresseuse de *range* adaptée aux nombres à " "virgule flottante." #: library/stdtypes.rst:1468 msgid "Text Sequence Type --- :class:`str`" msgstr "Type Séquence de Texte — :class:`str`" #: library/stdtypes.rst:1470 msgid "" "Textual data in Python is handled with :class:`str` objects, or :dfn:" "`strings`. Strings are immutable :ref:`sequences ` of Unicode code " "points. String literals are written in a variety of ways:" msgstr "" "Les données textuelles en Python sont manipulées avec des objets :class:" "`str` ou :dfn:`strings`. Les chaînes sont des :ref:`séquences ` " "immuables de points de code Unicode. Les chaînes littérales peuvent être " "écrites de différentes manières :" # énumération #: library/stdtypes.rst:1475 msgid "Single quotes: ``'allows embedded \"double\" quotes'``" msgstr "" "entre guillemets simples : ``'cela autorise les \"guillemets anglais\"'`` ;" # énumération #: library/stdtypes.rst:1476 msgid "Double quotes: ``\"allows embedded 'single' quotes\"``" msgstr "" "entre guillemets (anglais) : ``\"cela autorise les guillemets 'simples'\"`` ;" # fin d'énumération #: library/stdtypes.rst:1477 msgid "" "Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double quotes" "\"\"\"``" msgstr "" "entre guillemets triples : ``'''Trois guillemets simples'''``, ``\"\"\"Trois " "guillemets anglais\"\"\"``." #: library/stdtypes.rst:1479 msgid "" "Triple quoted strings may span multiple lines - all associated whitespace " "will be included in the string literal." msgstr "" "Les chaînes entre guillemets triples peuvent couvrir plusieurs lignes, tous " "les espaces associées sont alors incluses dans la chaîne littérale." #: library/stdtypes.rst:1482 msgid "" "String literals that are part of a single expression and have only " "whitespace between them will be implicitly converted to a single string " "literal. That is, ``(\"spam \" \"eggs\") == \"spam eggs\"``." msgstr "" "Les chaînes littérales qui font partie d'une seule expression et ont " "seulement des espaces entre elles sont implicitement converties en une seule " "chaîne littérale. Autrement dit, ``(\"spam \" \"eggs\") == \"spam eggs\"``." #: library/stdtypes.rst:1486 msgid "" "See :ref:`strings` for more about the various forms of string literal, " "including supported escape sequences, and the ``r`` (\"raw\") prefix that " "disables most escape sequence processing." msgstr "" "Voir :ref:`strings` pour plus d'informations sur les différentes formes de " "chaînes littérales, y compris les séquences d'échappement prises en charge, " "et le préfixe ``r`` (*raw* pour brut) qui désactive la plupart des " "traitements de séquence d'échappement." #: library/stdtypes.rst:1490 msgid "" "Strings may also be created from other objects using the :class:`str` " "constructor." msgstr "" "Les chaînes peuvent également être créées à partir d'autres objets à l'aide " "du constructeur :class:`str`." #: library/stdtypes.rst:1493 msgid "" "Since there is no separate \"character\" type, indexing a string produces " "strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." msgstr "" "Comme il n'y a pas de type « caractère » propre, un indice d'une chaîne " "produit une chaîne de longueur 1. Autrement dit, pour une chaîne non vide " "*s*, ``s[0] == s[0:1]``." #: library/stdtypes.rst:1499 msgid "" "There is also no mutable string type, but :meth:`str.join` or :class:`io." "StringIO` can be used to efficiently construct strings from multiple " "fragments." msgstr "" "Il n'y a aucun type de chaîne muable, mais :meth:`str.join` ou :class:`io." "StringIO` peuvent être utilisées pour construire efficacement des chaînes à " "partir de plusieurs fragments." # suit un : #: library/stdtypes.rst:1503 msgid "" "For backwards compatibility with the Python 2 series, the ``u`` prefix is " "once again permitted on string literals. It has no effect on the meaning of " "string literals and cannot be combined with the ``r`` prefix." msgstr "" "pour une compatibilité ascendante avec la série Python 2, le préfixe ``u`` " "est à nouveau autorisé sur les chaînes littérales. Il n'a aucun effet sur le " "sens des chaînes littérales et ne peut pas être combiné avec le préfixe " "``r``." #: library/stdtypes.rst:1515 msgid "" "Return a :ref:`string ` version of *object*. If *object* is not " "provided, returns the empty string. Otherwise, the behavior of ``str()`` " "depends on whether *encoding* or *errors* is given, as follows." msgstr "" "Renvoie une représentation en :ref:`chaîne de caractères ` de " "*object*. Si *object* n'est pas fourni, renvoie une chaîne vide. Sinon, le " "comportement de ``str()`` dépend des valeurs données pour *encoding* et " "*errors*, comme indiqué ci-dessous." #: library/stdtypes.rst:1519 msgid "" "If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" "`type(object).__str__(object) `, which is the \"informal\" " "or nicely printable string representation of *object*. For string objects, " "this is the string itself. If *object* does not have a :meth:`~object." "__str__` method, then :func:`str` falls back to returning :meth:" "`repr(object) `." msgstr "" "Si ni *encoding* ni *errors* ne sont donnés, ``str(object)`` renvoie :meth:" "`type(object).__str__(object) `, qui est la représentation " "en chaîne de caractères « informelle » ou joliment affichable de *object*. " "Pour les chaînes, c'est la chaîne elle-même. Si *object* n'a pas de méthode :" "meth:`~object.__str__`, :func:`str` utilise :meth:`repr(object) `." #: library/stdtypes.rst:1531 msgid "" "If at least one of *encoding* or *errors* is given, *object* should be a :" "term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " "this case, if *object* is a :class:`bytes` (or :class:`bytearray`) object, " "then ``str(bytes, encoding, errors)`` is equivalent to :meth:`bytes." "decode(encoding, errors) `. Otherwise, the bytes object " "underlying the buffer object is obtained before calling :meth:`bytes." "decode`. See :ref:`binaryseq` and :ref:`bufferobjects` for information on " "buffer objects." msgstr "" "Si au moins un des deux arguments *encoding* ou *errors* est donné, *object* " "doit être un :term:`objet octet-compatible ` (par " "exemple, :class:`bytes` ou :class:`bytearray`). Dans ce cas, si *object* est " "un objet :class:`bytes` (ou :class:`bytearray`), alors ``str(bytes, " "encoding, errors)`` est équivalent à :meth:`bytes.decode(encoding, errors) " "`. Sinon, l'objet *bytes* sous-jacent au tampon est obtenu " "avant d'appeler :meth:`bytes.decode`. Voir :ref:`binaryseq` et :ref:" "`bufferobjects` pour plus d'informations sur les tampons." #: library/stdtypes.rst:1540 msgid "" "Passing a :class:`bytes` object to :func:`str` without the *encoding* or " "*errors* arguments falls under the first case of returning the informal " "string representation (see also the :option:`-b` command-line option to " "Python). For example::" msgstr "" "Donner un objet :class:`bytes` à :func:`str` sans argument *encoding* ni " "argument *errors* relève du premier cas, où la représentation informelle de " "la chaîne est renvoyée (voir aussi l'option :option:`-b` de Python). Par " "exemple ::" #: library/stdtypes.rst:1548 msgid "" "For more information on the ``str`` class and its methods, see :ref:" "`textseq` and the :ref:`string-methods` section below. To output formatted " "strings, see the :ref:`f-strings` and :ref:`formatstrings` sections. In " "addition, see the :ref:`stringservices` section." msgstr "" "Pour plus d'informations sur la classe ``str`` et ses méthodes, voir les " "sections :ref:`textseq` et :ref:`string-methods`. Pour formater des chaînes " "de caractères, voir les sections :ref:`f-strings` et :ref:`formatstrings`. " "La section :ref:`stringservices` contient aussi des informations." #: library/stdtypes.rst:1560 msgid "String Methods" msgstr "Méthodes de chaînes de caractères" #: library/stdtypes.rst:1565 msgid "" "Strings implement all of the :ref:`common ` sequence " "operations, along with the additional methods described below." msgstr "" "Les chaînes implémentent toutes les opérations :ref:`communes des séquences " "`, ainsi que les autres méthodes décrites ci-dessous." #: library/stdtypes.rst:1568 msgid "" "Strings also support two styles of string formatting, one providing a large " "degree of flexibility and customization (see :meth:`str.format`, :ref:" "`formatstrings` and :ref:`string-formatting`) and the other based on C " "``printf`` style formatting that handles a narrower range of types and is " "slightly harder to use correctly, but is often faster for the cases it can " "handle (:ref:`old-string-formatting`)." msgstr "" "Les chaînes gèrent aussi deux styles de mise en forme, l'un fournissant une " "grande flexibilité et de personnalisation (voir :meth:`str.format`, :ref:" "`formatstrings` et :ref:`string-formatting`) et l'autre basée sur le style " "de formatage de ``printf`` du C qui gère une gamme plus étroite de types et " "est légèrement plus difficile à utiliser correctement, mais qui est souvent " "plus rapide pour les cas pris en charge (:ref:`old-string-formatting`)." #: library/stdtypes.rst:1575 msgid "" "The :ref:`textservices` section of the standard library covers a number of " "other modules that provide various text related utilities (including regular " "expression support in the :mod:`re` module)." msgstr "" "La section :ref:`textservices` de la bibliothèque standard couvre un certain " "nombre d'autres modules qui fournissent différents services relatifs au " "texte (y compris les expressions rationnelles dans le module :mod:`re`)." #: library/stdtypes.rst:1581 msgid "" "Return a copy of the string with its first character capitalized and the " "rest lowercased." msgstr "" "Renvoie une copie de la chaîne avec son premier caractère en majuscule et le " "reste en minuscule." # suit un : #: library/stdtypes.rst:1584 msgid "" "The first character is now put into titlecase rather than uppercase. This " "means that characters like digraphs will only have their first letter " "capitalized, instead of the full character." msgstr "" "le premier caractère est maintenant mis en *titlecase* plutôt qu'en " "majuscule. Cela veut dire que les caractères comme les digrammes auront " "seulement leur première lettre en majuscule, au lieu du caractère en entier." #: library/stdtypes.rst:1591 msgid "" "Return a casefolded copy of the string. Casefolded strings may be used for " "caseless matching." msgstr "" "Renvoie une copie *casefolded* de la chaîne. Les chaînes *casefolded* " "peuvent être utilisées dans des comparaisons insensibles à la casse." #: library/stdtypes.rst:1594 msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " "German lowercase letter ``'ß'`` is equivalent to ``\"ss\"``. Since it is " "already lowercase, :meth:`lower` would do nothing to ``'ß'``; :meth:" "`casefold` converts it to ``\"ss\"``." msgstr "" "Le *casefolding* est une technique agressive de mise en minuscule, car il " "vise à éliminer toutes les distinctions de casse dans une chaîne. Par " "exemple, la lettre minuscule ``'ß'`` de l'allemand équivaut à ``\"ss\"``. " "Comme il est déjà minuscule, :meth:`lower` ne fait rien à ``'ß'`` ; :meth:" "`casefold` le convertit en ``\"ss\"``." #: library/stdtypes.rst:1600 msgid "" "The casefolding algorithm is described in section 3.13 of the Unicode " "Standard." msgstr "" "L'algorithme de *casefolding* est décrit dans la section 3.13 de la norme " "Unicode." #: library/stdtypes.rst:1608 msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is an ASCII space). The original string is " "returned if *width* is less than or equal to ``len(s)``." msgstr "" "Renvoie la chaîne au centre d'une chaîne de longueur *width*. Le remplissage " "est fait en utilisant l'argument *fillchar* (qui par défaut est une espace " "ASCII). La chaîne d'origine est renvoyée si *width* est inférieure ou égale " "à ``len(s)``." #: library/stdtypes.rst:1616 msgid "" "Return the number of non-overlapping occurrences of substring *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" "Renvoie le nombre d'occurrences de *sub* ne se chevauchant pas dans " "l'intervalle [*start*, *end*]. Les arguments facultatifs *start* et *end* " "sont interprétés comme dans la notation des tranches (*slices* en anglais)." #: library/stdtypes.rst:1620 msgid "" "If *sub* is empty, returns the number of empty strings between characters " "which is the length of the string plus one." msgstr "" "Si *sub* est vide, renvoie le nombre de chaînes vides entre les caractères " "de début et de fin, ce qui correspond à la longueur de la chaîne plus un." #: library/stdtypes.rst:1626 msgid "Return the string encoded to :class:`bytes`." msgstr "Renvoie la chaine encodée dans une instance de :class:`bytes`." #: library/stdtypes.rst:2763 msgid "" "*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " "possible values." msgstr "" "*encoding* vaut par défaut ``utf-8`` ; pour une liste des encodages " "possibles, voir la section :ref:`standard-encodings`." #: library/stdtypes.rst:1631 msgid "" "*errors* controls how encoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " "are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, " "``'backslashreplace'`` and any other name registered via :func:`codecs." "register_error`. See :ref:`error-handlers` for details." msgstr "" "*errors* détermine la manière dont les erreurs sont traitées. La valeur par " "défaut est ``'strict'``, ce qui signifie que les erreurs d'encodage lèvent " "une :exc:`UnicodeError`. Les autres valeurs possibles sont ``'ignore'``, " "``'replace'``, ``'xmlcharrefreplace'``, ``'backslashreplace'`` et tout autre " "nom enregistré *via* :func:`codecs.register_error`. Voir la section :ref:" "`error-handlers` pour plus de détails." #: library/stdtypes.rst:1638 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless an encoding error actually occurs, :ref:`devmode` is enabled or a :" "ref:`debug build ` is used." msgstr "" "Pour des raisons de performances, la valeur de *errors* n'est pas vérifiée à " "moins qu'une erreur d'encodage ne se produise réellement, que le :ref:`mode " "développeur ` ne soit activé ou que Python ait été compilé en :ref:" "`mode débogage `." # suit un : #: library/stdtypes.rst:2782 msgid "Added support for keyword arguments." msgstr "gère les arguments nommés." # suit un : #: library/stdtypes.rst:2785 msgid "" "The value of the *errors* argument is now checked in :ref:`devmode` and in :" "ref:`debug mode `." msgstr "" "les valeurs de *errors* sont maintenant vérifiées en :ref:`mode de " "développement ` et en :ref:`mode de débogage `." #: library/stdtypes.rst:1653 msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " "With optional *start*, test beginning at that position. With optional " "*end*, stop comparing at that position." msgstr "" "Renvoie ``True`` si la chaîne se termine par *suffix*, sinon ``False``. " "*suffix* peut aussi être un *n*-uplet de suffixes à rechercher. Si " "l'argument optionnel *start* est donné, le test se fait à partir de cette " "position. Si l'argument optionnel *end* est fourni, la comparaison s'arrête " "à cette position." #: library/stdtypes.rst:1661 msgid "" "Return a copy of the string where all tab characters are replaced by one or " "more spaces, depending on the current column and the given tab size. Tab " "positions occur every *tabsize* characters (default is 8, giving tab " "positions at columns 0, 8, 16 and so on). To expand the string, the current " "column is set to zero and the string is examined character by character. If " "the character is a tab (``\\t``), one or more space characters are inserted " "in the result until the current column is equal to the next tab position. " "(The tab character itself is not copied.) If the character is a newline (``" "\\n``) or return (``\\r``), it is copied and the current column is reset to " "zero. Any other character is copied unchanged and the current column is " "incremented by one regardless of how the character is represented when " "printed." msgstr "" "Renvoie une copie de la chaîne où toutes les tabulations sont remplacées par " "une ou plusieurs espaces, en fonction de la colonne courante et de la taille " "de tabulation donnée. Les positions des tabulations se trouvent tous les " "*tabsize* caractères (8 par défaut, ce qui donne les positions de " "tabulations aux colonnes 0, 8, 16 et ainsi de suite). Pour travailler sur la " "chaîne, la colonne en cours est mise à zéro et la chaîne est examinée " "caractère par caractère. Si le caractère est une tabulation (``\\t``), un ou " "plusieurs caractères d'espacement sont insérés dans le résultat jusqu'à ce " "que la colonne courante soit égale à la position de tabulation suivante (le " "caractère tabulation lui-même n'est pas copié). Si le caractère est un saut " "de ligne (``\\n``) ou un retour chariot (``\\r``), il est copié et la " "colonne en cours est remise à zéro. Tout autre caractère est copié inchangé " "et la colonne en cours est incrémentée de un indépendamment de la façon dont " "le caractère est représenté lors de l'affichage." #: library/stdtypes.rst:1682 msgid "" "Return the lowest index in the string where substring *sub* is found within " "the slice ``s[start:end]``. Optional arguments *start* and *end* are " "interpreted as in slice notation. Return ``-1`` if *sub* is not found." msgstr "" "Renvoie l'indice de la première position dans la chaîne où *sub* est trouvé " "dans le découpage ``s[start:end]``. Les arguments facultatifs *start* et " "*end* sont interprétés comme dans la notation des découpages (*slice* en " "anglais). Renvoie ``-1`` si *sub* n'est pas trouvé." # suit un : #: library/stdtypes.rst:1688 msgid "" "The :meth:`~str.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" "la méthode :meth:`~str.find` ne doit être utilisée que si vous avez besoin " "de connaître la position de *sub*. Pour vérifier si *sub* est une sous " "chaine ou non, utilisez l'opérateur :keyword:`in` ::" #: library/stdtypes.rst:1698 msgid "" "Perform a string formatting operation. The string on which this method is " "called can contain literal text or replacement fields delimited by braces " "``{}``. Each replacement field contains either the numeric index of a " "positional argument, or the name of a keyword argument. Returns a copy of " "the string where each replacement field is replaced with the string value of " "the corresponding argument." msgstr "" "Formate une chaîne. La chaîne sur laquelle cette méthode est appelée peut " "contenir du texte littéral ou des emplacements de remplacement délimités par " "des accolades ``{}``. Chaque champ de remplacement contient soit l'indice " "numérique d'un argument positionnel, soit le nom d'un argument nommé. " "Renvoie une copie de la chaîne où chaque champ de remplacement est remplacé " "par la valeur de chaîne de l'argument correspondant." #: library/stdtypes.rst:1708 msgid "" "See :ref:`formatstrings` for a description of the various formatting options " "that can be specified in format strings." msgstr "" "Voir :ref:`formatstrings` pour une description des options de formatage qui " "peuvent être spécifiées dans les chaînes de format." # suit un : #: library/stdtypes.rst:1712 msgid "" "When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" "class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." "format(1234)``), the function temporarily sets the ``LC_CTYPE`` locale to " "the ``LC_NUMERIC`` locale to decode ``decimal_point`` and ``thousands_sep`` " "fields of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, " "and the ``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. " "This temporary change affects other threads." msgstr "" "lors du formatage avec le format ``n`` (comme ``'{:n}'.format(1234)``) d'un " "nombre (:class:`int`, :class:`float`, :class:`complex`, :class:`decimal." "Decimal` et classes dérivées), la fonction met temporairement la variable " "``LC_CTYPE`` à la valeur de ``LC_NUMERIC`` pour décoder correctement les " "attributs ``decimal_point`` et ``thousands_sep`` de :c:func:`localeconv`, " "s'ils ne sont pas en ASCII ou font plus d'un octet et que ``LC_NUMERIC`` est " "différent de ``LC_CTYPE``. Ce changement temporaire affecte les autres fils " "d'exécution." # suit un : #: library/stdtypes.rst:1721 msgid "" "When formatting a number with the ``n`` type, the function sets temporarily " "the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." msgstr "" "lors du formatage d'un nombre avec le format ``n``, la fonction change " "temporairement ``LC_CTYPE`` par la valeur de ``LC_NUMERIC`` dans certains " "cas." #: library/stdtypes.rst:1729 msgid "" "Similar to ``str.format(**mapping)``, except that ``mapping`` is used " "directly and not copied to a :class:`dict`. This is useful if for example " "``mapping`` is a dict subclass:" msgstr "" "Semblable à ``str.format(**mapping)``, sauf que ``mapping`` est utilisé " "directement et non copié dans un :class:`dict`. C'est utile si, par exemple, " "``mapping`` est une sous-classe de ``dict`` :" #: library/stdtypes.rst:1745 msgid "" "Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " "not found." msgstr "" "Comme :meth:`~str.find`, mais lève une :exc:`ValueError` lorsque la chaîne " "est introuvable." #: library/stdtypes.rst:1751 msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " "alphanumeric if one of the following returns ``True``: ``c.isalpha()``, ``c." "isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont alphanumériques et " "qu'il y a au moins un caractère, sinon ``False``. Un caractère ``c`` est " "alphanumérique si l'un des tests suivants renvoie ``True`` : ``c." "isalpha()``, ``c.isdecimal()``, ``c.isdigit()`` ou ``c.isnumeric()``." #: library/stdtypes.rst:1759 msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " "at least one character, ``False`` otherwise. Alphabetic characters are " "those characters defined in the Unicode character database as \"Letter\", i." "e., those with general category property being one of \"Lm\", \"Lt\", \"Lu" "\", \"Ll\", or \"Lo\". Note that this is different from the \"Alphabetic\" " "property defined in the Unicode Standard." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont alphabétiques et " "qu'elle contient au moins un caractère, sinon ``False``. Les caractères " "alphabétiques sont les caractères définis dans la base de données de " "caractères Unicode comme *Letter*, à savoir, ceux qui ont \"Lm\", \"Lt\", " "\"Lu\", \"Ll\" ou \"Lo\" comme catégorie générale. Notez que c'est différent " "de la propriété *Alphabetic* définie dans la norme Unicode." #: library/stdtypes.rst:1768 msgid "" "Return ``True`` if the string is empty or all characters in the string are " "ASCII, ``False`` otherwise. ASCII characters have code points in the range U" "+0000-U+007F." msgstr "" "Renvoie ``True`` si la chaîne est vide ou ne contient que des caractères " "ASCII, ``False`` sinon. Les caractères ASCII ont un code dans l'intervalle ``" "\"U+0000\"``\\ –\\ ``\"U+007F\"``." #: library/stdtypes.rst:1777 msgid "" "Return ``True`` if all characters in the string are decimal characters and " "there is at least one character, ``False`` otherwise. Decimal characters are " "those that can be used to form numbers in base 10, e.g. U+0660, ARABIC-INDIC " "DIGIT ZERO. Formally a decimal character is a character in the Unicode " "General Category \"Nd\"." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont des caractères " "décimaux et qu'elle contient au moins un caractère, sinon ``False``. Les " "caractères décimaux sont ceux pouvant être utilisés pour former des nombres " "en base 10, tels que U+0660, ARABIC-INDIC DIGIT ZERO. Formellement, un " "caractère décimal est un caractère dans la catégorie Unicode générale \"Nd\"." #: library/stdtypes.rst:1787 msgid "" "Return ``True`` if all characters in the string are digits and there is at " "least one character, ``False`` otherwise. Digits include decimal characters " "and digits that need special handling, such as the compatibility superscript " "digits. This covers digits which cannot be used to form numbers in base 10, " "like the Kharosthi numbers. Formally, a digit is a character that has the " "property value Numeric_Type=Digit or Numeric_Type=Decimal." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont des chiffres et " "qu'elle contient au moins un caractère, ``False`` sinon. Les chiffres " "incluent des caractères décimaux et des chiffres qui nécessitent une " "manipulation particulière, tels que les *compatibility superscript digits*. " "Ça couvre les chiffres qui ne peuvent pas être utilisés pour construire des " "nombres en base 10, tels que les nombres de Kharosthi. Formellement, un " "chiffre est un caractère dont la valeur de la propriété *Numeric_Type* est " "*Digit* ou *Decimal*." #: library/stdtypes.rst:1797 msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." msgstr "" "Renvoie ``True`` si la chaîne est un identifiant valide selon la définition " "du langage, section :ref:`identifiers`." #: library/stdtypes.rst:1800 msgid "" "Call :func:`keyword.iskeyword` to test whether string ``s`` is a reserved " "identifier, such as :keyword:`def` and :keyword:`class`." msgstr "" "Utilisez :func:`keyword.iskeyword` pour savoir si la chaîne ``s`` est un " "identifiant réservé, tels que :keyword:`def` et :keyword:`class`." #: library/stdtypes.rst:1803 msgid "Example: ::" msgstr "Par exemple ::" #: library/stdtypes.rst:1816 msgid "" "Return ``True`` if all cased characters [4]_ in the string are lowercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" "Renvoie ``True`` si tous les caractères capitalisables [4]_ de la chaîne " "sont en minuscules et qu'elle contient au moins un caractère capitalisable. " "Renvoie ``False`` dans le cas contraire." #: library/stdtypes.rst:1822 msgid "" "Return ``True`` if all characters in the string are numeric characters, and " "there is at least one character, ``False`` otherwise. Numeric characters " "include digit characters, and all characters that have the Unicode numeric " "value property, e.g. U+2155, VULGAR FRACTION ONE FIFTH. Formally, numeric " "characters are those with the property value Numeric_Type=Digit, " "Numeric_Type=Decimal or Numeric_Type=Numeric." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont des caractères " "numériques et qu'elle contient au moins un caractère, sinon ``False``. Les " "caractères numériques comprennent les chiffres et tous les caractères qui " "ont la propriété Unicode *numeric value*, par exemple U+2155, *VULGAR " "FRACTION OF FIFTH*. Formellement, les caractères numériques sont ceux avec " "les propriétés *Numeric_Type=Digit*, *Numeric_Type=Decimal* ou " "*Numeric_Type=Numeric*." #: library/stdtypes.rst:1832 msgid "" "Return ``True`` if all characters in the string are printable or the string " "is empty, ``False`` otherwise. Nonprintable characters are those characters " "defined in the Unicode character database as \"Other\" or \"Separator\", " "excepting the ASCII space (0x20) which is considered printable. (Note that " "printable characters in this context are those which should not be escaped " "when :func:`repr` is invoked on a string. It has no bearing on the handling " "of strings written to :data:`sys.stdout` or :data:`sys.stderr`.)" msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont affichables ou si " "elle est vide, sinon ``False``. Les caractères non affichables sont les " "caractères définis dans la base de données de caractères Unicode comme " "« *Other* » ou « *Separator* », à l'exception de l'espace ASCII (``0x20``) " "qui est considérée comme affichable. (Notez que les caractères imprimables " "dans ce contexte sont ceux qui ne doivent pas être échappés quand :func:" "`repr` est invoquée sur une chaîne. Ça n'a aucune incidence sur le " "traitement des chaînes écrites sur :data:`sys.stdout` ou :data:`sys.stderr`.)" #: library/stdtypes.rst:1843 msgid "" "Return ``True`` if there are only whitespace characters in the string and " "there is at least one character, ``False`` otherwise." msgstr "" "Renvoie ``True`` s'il n'y a que des caractères d'espacement dans la chaîne " "et qu'elle comporte au moins un caractère. Renvoie ``False`` dans le cas " "contraire." #: library/stdtypes.rst:1846 msgid "" "A character is *whitespace* if in the Unicode character database (see :mod:" "`unicodedata`), either its general category is ``Zs`` (\"Separator, space" "\"), or its bidirectional class is one of ``WS``, ``B``, or ``S``." msgstr "" "Un caractère est considéré comme un caractère d'espacement (*whitespace* en " "anglais) si, dans la base de données caractères Unicode (voir :mod:" "`unicodedata`), sa catégorie générale est ``Zs`` (« séparateur, espace »), " "ou sa classe bidirectionnelle est une de ``WS``, ``B``, ou ``S``." #: library/stdtypes.rst:1854 msgid "" "Return ``True`` if the string is a titlecased string and there is at least " "one character, for example uppercase characters may only follow uncased " "characters and lowercase characters only cased ones. Return ``False`` " "otherwise." msgstr "" "Renvoie ``True`` si la chaîne est une chaîne *titlecased* et qu'elle " "contient au moins un caractère, par exemple les caractères majuscules ne " "peuvent suivre les caractères non capitalisables et les caractères " "minuscules ne peuvent suivre que des caractères capitalisables. Renvoie " "``False`` dans le cas contraire." #: library/stdtypes.rst:1861 msgid "" "Return ``True`` if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" "Renvoie ``True`` si tous les caractères différentiables sur la casse [4]_ de " "la chaîne sont en majuscules et s'il y a au moins un caractère " "différentiable sur la casse, sinon ``False``." #: library/stdtypes.rst:1879 msgid "" "Return a string which is the concatenation of the strings in *iterable*. A :" "exc:`TypeError` will be raised if there are any non-string values in " "*iterable*, including :class:`bytes` objects. The separator between " "elements is the string providing this method." msgstr "" "Renvoie une chaîne qui est la concaténation des chaînes contenues dans " "*iterable*. Une :exc:`TypeError` est levée si une valeur d'*iterable* n'est " "pas une chaîne, y compris pour les objets :class:`bytes`. Le séparateur " "entre les éléments est la chaîne fournissant cette méthode." #: library/stdtypes.rst:1887 msgid "" "Return the string left justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" "Renvoie la chaîne justifiée à gauche dans une chaîne de longueur *width*. Le " "bourrage est fait en utilisant *fillchar* (qui par défaut est une espace " "ASCII). La chaîne d'origine est renvoyée si *width* est inférieure ou égale " "à ``len(s)``." #: library/stdtypes.rst:1894 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "lowercase." msgstr "" "Renvoie une copie de la chaîne avec tous les caractères différentiables sur " "la casse [4]_ convertis en minuscules." #: library/stdtypes.rst:1897 msgid "" "The lowercasing algorithm used is described in section 3.13 of the Unicode " "Standard." msgstr "" "L'algorithme de mise en minuscules utilisé est décrit dans la section 3.13 " "de la norme Unicode." #: library/stdtypes.rst:1903 msgid "" "Return a copy of the string with leading characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " "omitted or ``None``, the *chars* argument defaults to removing whitespace. " "The *chars* argument is not a prefix; rather, all combinations of its values " "are stripped::" msgstr "" "Renvoie une copie de la chaîne avec des caractères supprimés au début. " "L'argument *chars* est une chaîne spécifiant le jeu de caractères à " "supprimer. En cas d'omission ou ``None``, la valeur par défaut de *chars* " "permet de supprimer des caractères d'espacement. L'argument *chars* n'est " "pas un préfixe, toutes les combinaisons de ses valeurs sont supprimées ::" #: library/stdtypes.rst:1913 msgid "" "See :meth:`str.removeprefix` for a method that will remove a single prefix " "string rather than all of a set of characters. For example::" msgstr "" "Voir :meth:`str.removeprefix` pour une méthode qui supprime une seule chaîne " "de préfixe plutôt que la totalité d'un ensemble de caractères. Par exemple ::" #: library/stdtypes.rst:1924 msgid "" "This static method returns a translation table usable for :meth:`str." "translate`." msgstr "" "Cette méthode statique renvoie une table de traduction utilisable pour :meth:" "`str.translate`." #: library/stdtypes.rst:1926 msgid "" "If there is only one argument, it must be a dictionary mapping Unicode " "ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " "strings (of arbitrary lengths) or ``None``. Character keys will then be " "converted to ordinals." msgstr "" "Si un seul argument est fourni, ce soit être un dictionnaire faisant " "correspondre des points de code Unicode (nombres entiers) ou des caractères " "(chaînes de longueur 1) à des points de code Unicode." #: library/stdtypes.rst:1931 msgid "" "If there are two arguments, they must be strings of equal length, and in the " "resulting dictionary, each character in x will be mapped to the character at " "the same position in y. If there is a third argument, it must be a string, " "whose characters will be mapped to ``None`` in the result." msgstr "" "Si deux arguments sont fournis, ce doit être deux chaînes de caractères de " "même longueur. Le dictionnaire renvoyé fera correspondre pour chaque " "caractère de x un caractère de y pris à la même place. Si un troisième " "argument est fourni, ce doit être une chaîne dont chaque caractère " "correspondra à ``None`` dans le résultat." #: library/stdtypes.rst:1939 msgid "" "Split the string at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " "after the separator. If the separator is not found, return a 3-tuple " "containing the string itself, followed by two empty strings." msgstr "" "Divise la chaîne à la première occurrence de *sep*, et renvoie un triplet " "contenant la partie avant le séparateur, le séparateur lui-même, et la " "partie après le séparateur. Si le séparateur n'est pas trouvé, le triplet " "contient la chaîne elle-même, suivie de deux chaînes vides." #: library/stdtypes.rst:1947 msgid "" "If the string starts with the *prefix* string, return " "``string[len(prefix):]``. Otherwise, return a copy of the original string::" msgstr "" "Si la chaîne de caractères commence par la chaîne *prefix*, renvoie " "``string[len(prefix):]``. Sinon, renvoie une copie de la chaîne originale ::" #: library/stdtypes.rst:1961 msgid "" "If the string ends with the *suffix* string and that *suffix* is not empty, " "return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " "string::" msgstr "" "Si la chaîne de caractères se termine par la chaîne *suffix* et que *suffix* " "n'est pas vide, renvoie ``string[:-len(suffix)]``. Sinon, renvoie une copie " "de la chaîne originale ::" #: library/stdtypes.rst:1975 msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If the optional argument *count* is given, only the first *count* " "occurrences are replaced." msgstr "" "Renvoie une copie de la chaîne dont toutes les occurrences de la sous-" "chaîne *old* sont remplacées par *new*. Si l'argument optionnel *count* est " "donné, seules les *count* premières occurrences sont remplacées." #: library/stdtypes.rst:1982 msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " "and *end* are interpreted as in slice notation. Return ``-1`` on failure." msgstr "" "Renvoie l'indice le plus élevé dans la chaîne où la sous-chaîne *sub* se " "trouve, de telle sorte que *sub* soit contenue dans ``s[start:end]``. Les " "arguments facultatifs *start* et *end* sont interprétés comme dans la " "notation des découpages. Renvoie ``-1`` en cas d'échec." #: library/stdtypes.rst:1989 msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " "not found." msgstr "" "Comme :meth:`rfind` mais lève une exception :exc:`ValueError` lorsque la " "sous-chaîne *sub* est introuvable." #: library/stdtypes.rst:1995 msgid "" "Return the string right justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is an ASCII space). The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" "Renvoie la chaîne justifiée à droite dans une chaîne de longueur *width*. Le " "bourrage est fait en utilisant le caractère spécifié par *fillchar* (par " "défaut une espace ASCII). La chaîne d'origine est renvoyée si *width* est " "inférieure ou égale à ``len(s)``." #: library/stdtypes.rst:2002 msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " "after the separator. If the separator is not found, return a 3-tuple " "containing two empty strings, followed by the string itself." msgstr "" "Divise la chaîne à la dernière occurrence de *sep*, et renvoie un triplet " "contenant la partie avant le séparateur, le séparateur lui-même, et la " "partie après le séparateur. Si le séparateur n'est pas trouvé, le triplet " "contient deux chaînes vides, puis la chaîne elle-même." #: library/stdtypes.rst:2010 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " "*rightmost* ones. If *sep* is not specified or ``None``, any whitespace " "string is a separator. Except for splitting from the right, :meth:`rsplit` " "behaves like :meth:`split` which is described in detail below." msgstr "" "Renvoie une liste des mots de la chaîne, en utilisant *sep* comme " "séparateur. Si *maxsplit* est donné, c'est le nombre maximum de divisions " "qui pourront être faites, celles « les plus à droite ». Si *sep* est pas " "spécifié ou est ``None``, tout caractère d'espacement est un séparateur. En " "dehors du fait qu'il découpe par la droite, :meth:`rsplit` se comporte " "comme :meth:`split` qui est décrit en détail ci-dessous." #: library/stdtypes.rst:2019 msgid "" "Return a copy of the string with trailing characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " "omitted or ``None``, the *chars* argument defaults to removing whitespace. " "The *chars* argument is not a suffix; rather, all combinations of its values " "are stripped::" msgstr "" "Renvoie une copie de la chaîne avec des caractères finaux supprimés. " "L'argument *chars* est une chaîne spécifiant le jeu de caractères à " "supprimer. En cas d'omission ou ``None``, les caractères d'espacement sont " "supprimés. L'argument *chars* n'est pas un suffixe : toutes les combinaisons " "de ses valeurs sont retirées ::" #: library/stdtypes.rst:2029 msgid "" "See :meth:`str.removesuffix` for a method that will remove a single suffix " "string rather than all of a set of characters. For example::" msgstr "" "Voir :meth:`str.removesuffix` pour une méthode qui supprime une seule chaîne " "de suffixe plutôt que la totalité d'un ensemble de caractères. Par exemple ::" #: library/stdtypes.rst:2039 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " "the list will have at most ``maxsplit+1`` elements). If *maxsplit* is not " "specified or ``-1``, then there is no limit on the number of splits (all " "possible splits are made)." msgstr "" "Renvoie une liste des mots de la chaîne, en utilisant *sep* comme séparateur " "de mots. Si *maxsplit* est donné, c'est le nombre maximum de divisions qui " "pourront être effectuées (donnant ainsi une liste de longueur ``maxsplit" "+1``). Si *maxsplit* n'est pas fourni, ou vaut ``-1``, le nombre de découpes " "n'est pas limité (toutes les découpes possibles sont faites)." #: library/stdtypes.rst:2045 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " "``['1', '', '2']``). The *sep* argument may consist of multiple characters " "(for example, ``'1<>2<>3'.split('<>')`` returns ``['1', '2', '3']``). " "Splitting an empty string with a specified separator returns ``['']``." msgstr "" "Si *sep* est donné, les délimiteurs consécutifs ne sont pas regroupés et " "ainsi délimitent des chaînes vides (par exemple, ``'1,,2'.split(',')`` " "renvoie ``['1', '', '2']``). L'argument *sep* peut contenir plusieurs " "caractères (par exemple, ``'1<>2<>3'.split('<>')`` renvoie ``['1', '2', " "'3']``). Découper une chaîne vide en spécifiant *sep* renvoie ``['']``." #: library/stdtypes.rst:2067 library/stdtypes.rst:2187 #: library/stdtypes.rst:3101 library/stdtypes.rst:3208 #: library/stdtypes.rst:3249 library/stdtypes.rst:3291 #: library/stdtypes.rst:3323 library/stdtypes.rst:3373 #: library/stdtypes.rst:3442 library/stdtypes.rst:3466 msgid "For example::" msgstr "Par exemple ::" #: library/stdtypes.rst:2060 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " "and the result will contain no empty strings at the start or end if the " "string has leading or trailing whitespace. Consequently, splitting an empty " "string or a string consisting of just whitespace with a ``None`` separator " "returns ``[]``." msgstr "" "Si *sep* n'est pas spécifié ou est ``None``, un autre algorithme de " "découpage est appliqué : les caractères d'espacement consécutifs sont " "considérés comme un seul séparateur, et le résultat ne contient pas les " "chaînes vides de début ou de la fin si la chaîne est préfixée ou suffixé de " "caractères d'espacement. Par conséquent, diviser une chaîne vide ou une " "chaîne composée d'espaces avec un séparateur ``None`` renvoie ``[]``." #: library/stdtypes.rst:2082 msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " "true." msgstr "" "Renvoie les lignes de la chaîne sous forme de liste, la découpe se faisant " "au niveau des limites des lignes. Les sauts de ligne ne sont pas inclus dans " "la liste des résultats, sauf si *keepends* est donné et est vrai." #: library/stdtypes.rst:2086 msgid "" "This method splits on the following line boundaries. In particular, the " "boundaries are a superset of :term:`universal newlines`." msgstr "" "Cette méthode découpe sur les limites de ligne suivantes. Ces limites sont " "un sur-ensemble de :term:`universal newlines`." #: library/stdtypes.rst:2090 msgid "Representation" msgstr "Représentation" #: library/stdtypes.rst:2090 msgid "Description" msgstr "Description" #: library/stdtypes.rst:2092 msgid "``\\n``" msgstr "``\\n``" #: library/stdtypes.rst:2092 msgid "Line Feed" msgstr "Saut de ligne" #: library/stdtypes.rst:2094 msgid "``\\r``" msgstr "``\\r``" #: library/stdtypes.rst:2094 msgid "Carriage Return" msgstr "Retour chariot" #: library/stdtypes.rst:2096 msgid "``\\r\\n``" msgstr "``\\r\\n``" #: library/stdtypes.rst:2096 msgid "Carriage Return + Line Feed" msgstr "Retour chariot + saut de ligne" #: library/stdtypes.rst:2098 msgid "``\\v`` or ``\\x0b``" msgstr "``\\v`` or ``\\x0b``" #: library/stdtypes.rst:2098 msgid "Line Tabulation" msgstr "Tabulation verticale" #: library/stdtypes.rst:2100 msgid "``\\f`` or ``\\x0c``" msgstr "``\\f`` or ``\\x0c``" #: library/stdtypes.rst:2100 msgid "Form Feed" msgstr "Saut de page" #: library/stdtypes.rst:2102 msgid "``\\x1c``" msgstr "``\\x1c``" #: library/stdtypes.rst:2102 msgid "File Separator" msgstr "Séparateur de fichiers" #: library/stdtypes.rst:2104 msgid "``\\x1d``" msgstr "``\\x1d``" #: library/stdtypes.rst:2104 msgid "Group Separator" msgstr "Séparateur de groupes" #: library/stdtypes.rst:2106 msgid "``\\x1e``" msgstr "``\\x1e``" #: library/stdtypes.rst:2106 msgid "Record Separator" msgstr "Séparateur d'enregistrements" #: library/stdtypes.rst:2108 msgid "``\\x85``" msgstr "``\\x85``" #: library/stdtypes.rst:2108 msgid "Next Line (C1 Control Code)" msgstr "Ligne suivante (code de contrôle *C1*)" #: library/stdtypes.rst:2110 msgid "``\\u2028``" msgstr "``\\u2028``" #: library/stdtypes.rst:2110 msgid "Line Separator" msgstr "Séparateur de ligne" #: library/stdtypes.rst:2112 msgid "``\\u2029``" msgstr "``\\u2029``" #: library/stdtypes.rst:2112 msgid "Paragraph Separator" msgstr "Séparateur de paragraphe" #: library/stdtypes.rst:2117 msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "``\\v`` et ``\\f`` ajoutés à la liste des limites de lignes." #: library/stdtypes.rst:2126 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" "Contrairement à :meth:`~str.split` lorsque *sep* est fourni, cette méthode " "renvoie une liste vide pour la chaîne vide, et un saut de ligne à la fin ne " "se traduit pas par une ligne supplémentaire ::" #: library/stdtypes.rst:2135 msgid "For comparison, ``split('\\n')`` gives::" msgstr "À titre de comparaison, ``split('\\n')`` donne ::" #: library/stdtypes.rst:2145 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " "optional *start*, test string beginning at that position. With optional " "*end*, stop comparing string at that position." msgstr "" "Renvoie ``True`` si la chaîne commence par *prefix*, sinon ``False``. " "*prefix* peut aussi être un *n*-uplet de préfixes à rechercher. Lorsque " "*start* est donné, la comparaison commence à cette position et, lorsque " "*end* est donné, la comparaison s'arrête à celle-ci." #: library/stdtypes.rst:2153 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " "to be removed. If omitted or ``None``, the *chars* argument defaults to " "removing whitespace. The *chars* argument is not a prefix or suffix; rather, " "all combinations of its values are stripped::" msgstr "" "Renvoie une copie de la chaîne dont des caractères initiaux et finaux sont " "supprimés. L'argument *chars* est une chaîne spécifiant le jeu de caractères " "à supprimer. En cas d'omission ou ``None``, les caractères d'espacement sont " "supprimés. L'argument *chars* est pas un préfixe ni un suffixe, toutes les " "combinaisons de ses valeurs sont supprimées ::" #: library/stdtypes.rst:2164 msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " "string character that is not contained in the set of characters in *chars*. " "A similar action takes place on the trailing end. For example::" msgstr "" "Les caractères de *char* sont retirés du début et de la fin de la chaîne. " "Les caractères sont retirés de la gauche jusqu'à atteindre un caractère ne " "figurant pas dans le jeu de caractères dans *chars*. La même opération a " "lieu par la droite. Par exemple ::" #: library/stdtypes.rst:2177 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa. Note that it is not necessarily true that ``s.swapcase()." "swapcase() == s``." msgstr "" "Renvoie une copie de la chaîne dont les caractères majuscules sont convertis " "en minuscules et vice versa. Notez qu'il est pas nécessairement vrai que ``s." "swapcase().swapcase() == s``." #: library/stdtypes.rst:2184 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." msgstr "" "Renvoie une version de la chaîne où les mots commencent par une capitale et " "les caractères restants sont en minuscules." #: library/stdtypes.rst:3410 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " "means that apostrophes in contractions and possessives form word boundaries, " "which may not be the desired result::" msgstr "" "Pour l'algorithme, la notion de mot est définie simplement et indépendamment " "de la langue comme un groupe de lettres consécutives. La définition " "fonctionne dans de nombreux contextes, mais cela signifie que les " "apostrophes (typiquement de la forme possessive en Anglais) forment les " "limites de mot, ce qui n'est pas toujours le résultat souhaité ::" #: library/stdtypes.rst:2200 msgid "" "The :func:`string.capwords` function does not have this problem, as it " "splits words on spaces only." msgstr "" "La fonction :func:`string.capwords` n'a pas ce problème, car elle sépare les " "mots uniquement sur les espaces." #: library/stdtypes.rst:2203 msgid "" "Alternatively, a workaround for apostrophes can be constructed using regular " "expressions::" msgstr "" "Sinon, une solution pour contourner le problème des apostrophes est " "d'utiliser des expressions rationnelles ::" #: library/stdtypes.rst:2218 msgid "" "Return a copy of the string in which each character has been mapped through " "the given translation table. The table must be an object that implements " "indexing via :meth:`__getitem__`, typically a :term:`mapping` or :term:" "`sequence`. When indexed by a Unicode ordinal (an integer), the table " "object can do any of the following: return a Unicode ordinal or a string, to " "map the character to one or more other characters; return ``None``, to " "delete the character from the return string; or raise a :exc:`LookupError` " "exception, to map the character to itself." msgstr "" "Renvoie une copie de la chaîne dans laquelle chaque caractère a été changé " "selon la table de traduction donnée. La table doit être un objet qui " "implémente l'indexation via :meth:`__getitem__`, typiquement un :term:" "`tableau de correspondances ` ou une :term:`séquence `. " "Pour un ordinal Unicode (un entier), la table peut donner un ordinal Unicode " "ou une chaîne pour faire correspondre un ou plusieurs caractères au " "caractère donné, ``None`` pour supprimer le caractère de la chaîne renvoyée " "ou lever une exception :exc:`LookupError` pour ne pas changer le caractère." #: library/stdtypes.rst:2227 msgid "" "You can use :meth:`str.maketrans` to create a translation map from character-" "to-character mappings in different formats." msgstr "" "Vous pouvez utiliser :meth:`str.maketrans` pour créer une table de " "correspondances de caractères dans différents formats." #: library/stdtypes.rst:2230 msgid "" "See also the :mod:`codecs` module for a more flexible approach to custom " "character mappings." msgstr "" "Voir aussi le module :mod:`codecs` pour une approche plus souple de " "changements de caractères par correspondance." #: library/stdtypes.rst:2236 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " "contains uncased characters or if the Unicode category of the resulting " "character(s) is not \"Lu\" (Letter, uppercase), but e.g. \"Lt\" (Letter, " "titlecase)." msgstr "" "Renvoie une copie de la chaîne où tous les caractères capitalisables [4]_ " "ont été convertis en capitales. Notez que ``s.upper().isupper()`` peut être " "``False`` si ``s`` contient des caractères non capitalisables ou si la " "catégorie Unicode d'un caractère du résultat n'est pas \"Lu\" (*Letter*, " "*uppercase*), mais par exemple \"Lt\" (*Letter*, *titlecase*)." #: library/stdtypes.rst:2242 msgid "" "The uppercasing algorithm used is described in section 3.13 of the Unicode " "Standard." msgstr "" "L'algorithme de capitalisation utilisé est décrit dans la section 3.13 de la " "norme Unicode." #: library/stdtypes.rst:2248 msgid "" "Return a copy of the string left filled with ASCII ``'0'`` digits to make a " "string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " "by inserting the padding *after* the sign character rather than before. The " "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" "Renvoie une copie de la chaîne remplie par la gauche du chiffre (le " "caractère ASCII) ``'0'`` pour faire une chaîne de longueur *width*. Un " "préfixe (``'+'`` / ``'-'``) est permis par l'insertion du caractère de " "bourrage *après* le caractère désigné plutôt qu'avant. La chaîne d'origine " "est renvoyée si *width* est inférieure ou égale à ``len(s)``." #: library/stdtypes.rst:2266 msgid "``printf``-style String Formatting" msgstr "Formatage de chaines à la ``printf``" # suit un : #: library/stdtypes.rst:2279 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " "dictionaries correctly). Using the newer :ref:`formatted string literals `, the :meth:`str.format` interface, or :ref:`template strings " "` may help avoid these errors. Each of these alternatives " "provides their own trade-offs and benefits of simplicity, flexibility, and/" "or extensibility." msgstr "" "ces opérations de mise en forme contiennent des bizarreries menant à de " "nombreuses erreurs classiques (telles que ne pas réussir à afficher des *n*-" "uplets ou des dictionnaires correctement). Utiliser les :ref:`formatted " "string literals `, la méthode :meth:`str.format` ou les :ref:" "`template strings ` aide à éviter ces erreurs. Chacune de " "ces alternatives apporte son lot d'avantages et inconvénients en matière de " "simplicité, de flexibilité et/ou de généralisation possible." #: library/stdtypes.rst:2287 msgid "" "String objects have one unique built-in operation: the ``%`` operator " "(modulo). This is also known as the string *formatting* or *interpolation* " "operator. Given ``format % values`` (where *format* is a string), ``%`` " "conversion specifications in *format* are replaced with zero or more " "elements of *values*. The effect is similar to using the :c:func:`sprintf` " "in the C language." msgstr "" "Les objets *str* n'exposent qu'une opération : l'opérateur ``%`` (modulo). " "Aussi connu sous le nom d'opérateur de formatage, ou opérateur " "d'interpolation. Étant donné ``format % values`` (où *format* est une " "chaîne), les marqueurs ``%`` de *format* sont remplacés par zéro ou " "plusieurs éléments de *values*. L'effet est similaire à la fonction :c:func:" "`sprintf` du langage C." #: library/stdtypes.rst:2293 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " "items specified by the format string, or a single mapping object (for " "example, a dictionary)." msgstr "" "Si *format* ne nécessite qu'un seul argument, *values* peut être un objet " "unique [5]_. Si *values* est un *n*-uplet, il doit contenir exactement le " "nombre d'éléments spécifiés par la chaîne de format, ou un seul objet " "tableau de correspondances (*mapping object*, par exemple, un dictionnaire)." #: library/stdtypes.rst:3521 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" "Un indicateur de conversion contient deux ou plusieurs caractères et " "comporte les éléments suivants, qui doivent apparaître dans cet ordre :" # énumération #: library/stdtypes.rst:3524 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "le caractère ``'%'``, qui marque le début du marqueur ;" # énumération #: library/stdtypes.rst:3526 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" "la clé de correspondance (facultative), composée d'une suite de caractères " "entre parenthèses (par exemple, ``(somename)``) ;" # énumération #: library/stdtypes.rst:3529 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" "des indications de conversion, facultatives, qui affectent le résultat de " "certains types de conversion ;" # énumération #: library/stdtypes.rst:3532 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" "largeur minimum (facultative). Si elle vaut ``'*'`` (astérisque), la largeur " "est lue de l'élément suivant du *n*-uplet *values*, et l'objet à convertir " "vient après la largeur de champ minimale et la précision facultative ;" # énumération #: library/stdtypes.rst:3536 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual precision is read from the " "next element of the tuple in *values*, and the value to convert comes after " "the precision." msgstr "" "précision (facultatif), donnée sous la forme d'un ``'.'`` (point) suivi de " "la précision. Si la précision est ``'*'`` (un astérisque), la précision est " "lue à partir de l'élément suivant du *n*-uplet *values* et la valeur à " "convertir vient ensuite ;" # énumération #: library/stdtypes.rst:3541 msgid "Length modifier (optional)." msgstr "modificateur de longueur (facultatif) ;" # fin d'énumération #: library/stdtypes.rst:3543 msgid "Conversion type." msgstr "type de conversion." #: library/stdtypes.rst:2327 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " "dictionary inserted immediately after the ``'%'`` character. The mapping key " "selects the value to be formatted from the mapping. For example:" msgstr "" "Lorsque l'argument de droite est un dictionnaire (ou un autre type de " "tableau de correspondances), les marqueurs dans la chaîne *doivent* inclure " "une clé présente dans le dictionnaire, écrite entre parenthèses, " "immédiatement après le caractère ``'%'``. La clé indique quelle valeur du " "dictionnaire doit être formatée. Par exemple :" #: library/stdtypes.rst:3554 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" "Dans ce cas, aucune ``*`` ne peut se trouver dans le format (car ces ``*`` " "nécessitent une liste (accès séquentiel) de paramètres)." #: library/stdtypes.rst:3557 msgid "The conversion flag characters are:" msgstr "Les caractères indicateurs de conversion sont :" #: library/stdtypes.rst:3566 msgid "Flag" msgstr "Option" #: library/stdtypes.rst:3568 msgid "``'#'``" msgstr "``'#'``" #: library/stdtypes.rst:3568 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "La conversion utilise la « forme alternative » (définie ci-dessous)." #: library/stdtypes.rst:3571 msgid "``'0'``" msgstr "``'0'``" #: library/stdtypes.rst:3571 msgid "The conversion will be zero padded for numeric values." msgstr "Les valeurs numériques converties sont complétées de zéros." #: library/stdtypes.rst:3573 msgid "``'-'``" msgstr "``'-'``" #: library/stdtypes.rst:3573 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" "La valeur convertie est ajustée à gauche (remplace la conversion ``'0'`` si " "les deux sont données)." #: library/stdtypes.rst:3576 msgid "``' '``" msgstr "``' '``" #: library/stdtypes.rst:3576 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" "(une espace) Une espace doit être laissée avant un nombre positif (ou chaîne " "vide) produite par la conversion d'une valeur signée." #: library/stdtypes.rst:3579 msgid "``'+'``" msgstr "``'+'``" #: library/stdtypes.rst:3579 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" "Un caractère de signe (``'+'`` ou ``'-'``) précède la valeur convertie " "(remplace le marqueur « espace »)." #: library/stdtypes.rst:3583 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" "Un modificateur de longueur (``h``, ``l`` ou ``L``) peut être présent, mais " "est ignoré car il est pas nécessaire pour Python, donc par exemple ``%ld`` " "est identique à ``%d``." #: library/stdtypes.rst:3586 msgid "The conversion types are:" msgstr "Les types utilisables dans les conversions sont :" #: library/stdtypes.rst:3589 msgid "Conversion" msgstr "Conversion" #: library/stdtypes.rst:3591 msgid "``'d'``" msgstr "``'d'``" #: library/stdtypes.rst:2375 library/stdtypes.rst:3593 msgid "Signed integer decimal." msgstr "Entier décimal signé." #: library/stdtypes.rst:3593 msgid "``'i'``" msgstr "``'i'``" #: library/stdtypes.rst:3595 msgid "``'o'``" msgstr "``'o'``" #: library/stdtypes.rst:3595 msgid "Signed octal value." msgstr "Valeur octale signée." #: library/stdtypes.rst:3597 msgid "``'u'``" msgstr "``'u'``" #: library/stdtypes.rst:3597 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "Type obsolète — identique à ``'d'``." #: library/stdtypes.rst:3599 msgid "``'x'``" msgstr "``'x'``" #: library/stdtypes.rst:3599 msgid "Signed hexadecimal (lowercase)." msgstr "Hexadécimal signé (en minuscules)." #: library/stdtypes.rst:3601 msgid "``'X'``" msgstr "``'X'``" #: library/stdtypes.rst:3601 msgid "Signed hexadecimal (uppercase)." msgstr "Hexadécimal signé (capitales)." #: library/stdtypes.rst:3603 msgid "``'e'``" msgstr "``'e'``" #: library/stdtypes.rst:3603 msgid "Floating point exponential format (lowercase)." msgstr "Format exponentiel pour un *float* (minuscule)." #: library/stdtypes.rst:3605 msgid "``'E'``" msgstr "``'E'``" #: library/stdtypes.rst:3605 msgid "Floating point exponential format (uppercase)." msgstr "Format exponentiel pour un *float* (en capitales)." #: library/stdtypes.rst:3607 msgid "``'f'``" msgstr "``'f'``" #: library/stdtypes.rst:2391 library/stdtypes.rst:3609 msgid "Floating point decimal format." msgstr "Format décimal pour un *float*." #: library/stdtypes.rst:3609 msgid "``'F'``" msgstr "``'F'``" #: library/stdtypes.rst:3611 msgid "``'g'``" msgstr "``'g'``" #: library/stdtypes.rst:3611 msgid "" "Floating point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" "Format *float*. Utilise le format exponentiel minuscules si l'exposant est " "inférieur à ``-4`` ou pas plus petit que la précision, sinon le format " "décimal." #: library/stdtypes.rst:3615 msgid "``'G'``" msgstr "``'G'``" #: library/stdtypes.rst:3615 msgid "" "Floating point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" "Format *float*. Utilise le format exponentiel en capitales si l'exposant est " "inférieur à ``-4`` ou pas plus petit que la précision, sinon le format " "décimal." #: library/stdtypes.rst:3619 msgid "``'c'``" msgstr "``'c'``" #: library/stdtypes.rst:2401 msgid "Single character (accepts integer or single character string)." msgstr "" "Un seul caractère (accepte des entiers ou une chaîne d'un seul caractère)." #: library/stdtypes.rst:3632 msgid "``'r'``" msgstr "``'r'``" #: library/stdtypes.rst:2404 msgid "String (converts any Python object using :func:`repr`)." msgstr "String (convertit n'importe quel objet Python avec :func:`repr`)." #: library/stdtypes.rst:3626 msgid "``'s'``" msgstr "``'s'``" #: library/stdtypes.rst:2407 msgid "String (converts any Python object using :func:`str`)." msgstr "String (convertit n'importe quel objet Python avec :func:`str`)." #: library/stdtypes.rst:3629 msgid "``'a'``" msgstr "``'a'``" #: library/stdtypes.rst:2410 msgid "String (converts any Python object using :func:`ascii`)." msgstr "" "String (convertit n'importe quel objet Python en utilisant :func:`ascii`)." #: library/stdtypes.rst:3635 msgid "``'%'``" msgstr "``'%'``" #: library/stdtypes.rst:3635 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" "Aucun argument n'est converti, donne un caractère de ``'%'`` dans le " "résultat." #: library/stdtypes.rst:3642 msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." msgstr "" "La forme alternative entraîne l'insertion d'un préfixe octal (``'0o'``) " "avant le premier chiffre." #: library/stdtypes.rst:3646 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " "first digit." msgstr "" "La forme alternative entraîne l'insertion d'un préfixe ``'0x'`` ou ``'0X'`` " "(respectivement pour les formats ``'x'`` et ``'X'``) avant le premier " "chiffre." #: library/stdtypes.rst:3650 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" "La forme alternative implique la présence d'un point décimal, même si aucun " "chiffre ne le suit." #: library/stdtypes.rst:3653 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" "La précision détermine le nombre de chiffres après la virgule, 6 par défaut." #: library/stdtypes.rst:3657 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" "La forme alternative implique la présence d'un point décimal et les zéros " "non significatifs sont conservés (ils ne le seraient pas autrement)." #: library/stdtypes.rst:3660 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" "La précision détermine le nombre de chiffres significatifs avant et après la " "virgule. 6 par défaut." #: library/stdtypes.rst:3664 msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "Si la précision est ``N``, la sortie est tronquée à ``N`` caractères." #: library/stdtypes.rst:3673 msgid "See :pep:`237`." msgstr "Voir la :pep:`237`." #: library/stdtypes.rst:2447 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" "Puisque les chaînes Python ont une longueur explicite, les conversions ``" "%s`` ne considèrent pas ``'\\0'`` comme la fin de la chaîne." # suit un : #: library/stdtypes.rst:2452 msgid "" "``%f`` conversions for numbers whose absolute value is over 1e50 are no " "longer replaced by ``%g`` conversions." msgstr "" "les conversions ``%f`` des nombres dont la valeur absolue est supérieure à " "``1e50`` ne sont plus remplacées par des conversions ``%g``." #: library/stdtypes.rst:2463 msgid "" "Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" "`memoryview`" msgstr "" "Séquences Binaires — :class:`bytes`, :class:`bytearray`, :class:`vue mémoire " "`" #: library/stdtypes.rst:2471 msgid "" "The core built-in types for manipulating binary data are :class:`bytes` and :" "class:`bytearray`. They are supported by :class:`memoryview` which uses the :" "ref:`buffer protocol ` to access the memory of other binary " "objects without needing to make a copy." msgstr "" "Les principaux types natifs pour manipuler des données binaires sont :class:" "`bytes` et :class:`bytearray`. Ils sont gérés par les :class:`vues mémoire " "` qui utilisent le :ref:`protocole tampon ` pour " "accéder à la mémoire d'autres objets binaires sans avoir besoin d'en faire " "une copie." #: library/stdtypes.rst:2476 msgid "" "The :mod:`array` module supports efficient storage of basic data types like " "32-bit integers and IEEE754 double-precision floating values." msgstr "" "Le module :mod:`array` permet le stockage efficace de types basiques comme " "les entiers de 32 bits et les *float* double précision IEEE754." #: library/stdtypes.rst:2482 msgid "Bytes Objects" msgstr "Objets *bytes*" #: library/stdtypes.rst:2486 msgid "" "Bytes objects are immutable sequences of single bytes. Since many major " "binary protocols are based on the ASCII text encoding, bytes objects offer " "several methods that are only valid when working with ASCII compatible data " "and are closely related to string objects in a variety of other ways." msgstr "" "Les *bytes* sont des séquences immuables d'octets. Comme beaucoup de " "protocoles binaires utilisent l'ASCII, les objets *bytes* offrent plusieurs " "méthodes qui ne sont valables que lors de la manipulation de données ASCII " "et sont étroitement liés aux objets *str* dans bien d'autres aspects." #: library/stdtypes.rst:2493 msgid "" "Firstly, the syntax for bytes literals is largely the same as that for " "string literals, except that a ``b`` prefix is added:" msgstr "" "Tout d'abord, la syntaxe des *bytes* littéraux est en grande partie la même " "que pour les chaînes littérales, en dehors du préfixe ``b`` :" # énumération #: library/stdtypes.rst:2496 msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" msgstr "" "entre guillemets simples : ``b'cela autorise les guillemets \"doubles\"'`` ;" # énumération #: library/stdtypes.rst:2497 msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" msgstr "" "entre guillemets (anglais) : ``b\"cela permet aussi les guillemets " "'simples'\"`` ;" # fin d'énumération #: library/stdtypes.rst:2498 msgid "" "Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" msgstr "" "entre guillemets triples : ``b'''3 single quotes'''``, ``b\"\"\"3 double " "quotes\"\"\"``." #: library/stdtypes.rst:2500 msgid "" "Only ASCII characters are permitted in bytes literals (regardless of the " "declared source code encoding). Any binary values over 127 must be entered " "into bytes literals using the appropriate escape sequence." msgstr "" "Seuls les caractères ASCII sont autorisés dans les littéraux de *bytes* " "(quel que soit l'encodage du code source déclaré). Toutes les valeurs au " "delà de 127 doivent être écrites en utilisant une séquence d'échappement " "appropriée." #: library/stdtypes.rst:2504 msgid "" "As with string literals, bytes literals may also use a ``r`` prefix to " "disable processing of escape sequences. See :ref:`strings` for more about " "the various forms of bytes literal, including supported escape sequences." msgstr "" "Comme avec les chaînes littérales, les *bytes* littéraux peuvent également " "utiliser un préfixe ``r`` pour désactiver le traitement des séquences " "d'échappement. Voir :ref:`strings` pour plus d'informations sur les " "différentes formes littérales de *bytes*, y compris les séquences " "d'échappement gérées." #: library/stdtypes.rst:2508 msgid "" "While bytes literals and representations are based on ASCII text, bytes " "objects actually behave like immutable sequences of integers, with each " "value in the sequence restricted such that ``0 <= x < 256`` (attempts to " "violate this restriction will trigger :exc:`ValueError`). This is done " "deliberately to emphasise that while many binary formats include ASCII based " "elements and can be usefully manipulated with some text-oriented algorithms, " "this is not generally the case for arbitrary binary data (blindly applying " "text processing algorithms to binary data formats that are not ASCII " "compatible will usually lead to data corruption)." msgstr "" "Bien que les *bytes* littéraux, et leurs représentation, soient basés sur du " "texte ASCII, les *bytes* se comportent en fait comme des séquences immuables " "de nombres entiers, dont les valeurs sont restreintes dans l'intervalle ``0 " "<= x < 256`` (ne pas respecter cette restriction lève une :exc:" "`ValueError`). C'est délibéré afin de souligner que, bien que de nombreux " "encodages binaires soient compatibles avec l'ASCII, et peuvent être " "manipulés avec des algorithmes orientés texte, ce n'est généralement pas le " "cas pour les données binaires arbitraires (appliquer aveuglément des " "algorithmes de texte sur des données binaires qui ne sont pas compatibles " "ASCII conduit généralement à leur corruption)." #: library/stdtypes.rst:2518 msgid "" "In addition to the literal forms, bytes objects can be created in a number " "of other ways:" msgstr "" "En plus des formes littérales, des objets *bytes* peuvent être créés par de " "nombreux moyens :" # énumération #: library/stdtypes.rst:2521 msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" msgstr "" "un objet *bytes* rempli de zéros d'une longueur spécifiée : ``bytes(10)`` ;" # énumération #: library/stdtypes.rst:2522 msgid "From an iterable of integers: ``bytes(range(20))``" msgstr "un itérable d'entiers : ``bytes(range(20))`` ;" # fin d'énumération #: library/stdtypes.rst:2523 msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" msgstr "" "la copie de données binaires existantes via le protocole tampon : " "``bytes(obj)``." #: library/stdtypes.rst:2525 msgid "Also see the :ref:`bytes ` built-in." msgstr "Voir aussi la fonction native :ref:`bytes `." #: library/stdtypes.rst:2527 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " "Accordingly, the bytes type has an additional class method to read data in " "that format:" msgstr "" "Puisque 2 chiffres hexadécimaux correspondent précisément à un seul octet, " "les nombres hexadécimaux sont un format couramment utilisé pour décrire les " "données binaires. Par conséquent, le type *bytes* a une méthode de classe " "pour lire des données dans ce format :" #: library/stdtypes.rst:2533 msgid "" "This :class:`bytes` class method returns a bytes object, decoding the given " "string object. The string must contain two hexadecimal digits per byte, " "with ASCII whitespace being ignored." msgstr "" "Cette méthode de la classe :class:`bytes` renvoie un objet *bytes*, décodant " "la chaîne donnée. La chaîne doit contenir deux chiffres hexadécimaux par " "octet, les espaces ASCII sont ignorés." #: library/stdtypes.rst:2540 msgid "" ":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " "spaces." msgstr "" ":meth:`bytes.fromhex` saute maintenant dans la chaîne tous les caractères " "ASCII d'espacement, pas seulement les espaces." #: library/stdtypes.rst:2544 msgid "" "A reverse conversion function exists to transform a bytes object into its " "hexadecimal representation." msgstr "" "Une fonction de conversion inverse existe pour transformer un objet *bytes* " "en sa représentation hexadécimale." #: library/stdtypes.rst:2634 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the instance." msgstr "" "Renvoie une chaîne contenant deux chiffres hexadécimaux pour chaque octet de " "l'instance." #: library/stdtypes.rst:2555 msgid "" "If you want to make the hex string easier to read, you can specify a single " "character separator *sep* parameter to include in the output. By default, " "this separator will be included between each byte. A second optional " "*bytes_per_sep* parameter controls the spacing. Positive values calculate " "the separator position from the right, negative values from the left." msgstr "" "Si vous voulez obtenir une chaîne hexadécimale plus facile à lire, vous " "pouvez spécifier le paramètre *sep* comme « caractère de séparation », à " "inclure dans la sortie. Par défaut, ce caractère est inséré entre chaque " "octet. Un second paramètre optionnel *bytes_per_sep* contrôle l'espacement. " "Les valeurs positives calculent la position du séparateur en partant de la " "droite, les valeurs négatives de la gauche." #: library/stdtypes.rst:2572 msgid "" ":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " "to insert separators between bytes in the hex output." msgstr "" ":meth:`bytes.hex` prend désormais en charge les paramètres optionnels *sep* " "et *bytes_per_sep* pour insérer des séparateurs entre les octets dans la " "sortie hexadécimale." #: library/stdtypes.rst:2576 msgid "" "Since bytes objects are sequences of integers (akin to a tuple), for a bytes " "object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " "object of length 1. (This contrasts with text strings, where both indexing " "and slicing will produce a string of length 1)" msgstr "" "Comme les objets *bytes* sont des séquences d'entiers (semblables à un *n*-" "uplet), pour une instance de *bytes* *b*, ``b[0]`` est un entier, tandis que " "``b[0:1]`` est un objet *bytes* de longueur 1. (Cela contraste avec les " "chaînes, où un indice et le découpage donnent une chaîne de longueur 1.)" #: library/stdtypes.rst:2581 msgid "" "The representation of bytes objects uses the literal format (``b'...'``) " "since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " "always convert a bytes object into a list of integers using ``list(b)``." msgstr "" "La représentation des *bytes* utilise le format littéral (``b'...'``) car il " "est souvent plus utile que par exemple ``bytes([46, 46, 46])``. Vous pouvez " "toujours convertir un *bytes* en liste d'entiers en utilisant ``list(b)``." #: library/stdtypes.rst:2589 msgid "Bytearray Objects" msgstr "Objets *bytearray*" #: library/stdtypes.rst:2593 msgid "" ":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " "objects." msgstr "" "Les objets :class:`bytearray` sont l'équivalent muable des objets :class:" "`bytes`." #: library/stdtypes.rst:2598 msgid "" "There is no dedicated literal syntax for bytearray objects, instead they are " "always created by calling the constructor:" msgstr "" "Il n'y a pas de syntaxe littérale dédiée aux *bytearray*, ils sont toujours " "créés en appelant le constructeur :" # énumération #: library/stdtypes.rst:2601 msgid "Creating an empty instance: ``bytearray()``" msgstr "créer une instance vide: ``bytearray()`` ;" # énumération #: library/stdtypes.rst:2602 msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" msgstr "" "crée une instance remplie de zéros d'une longueur donnée : " "``bytearray(10)`` ;" # énumération #: library/stdtypes.rst:2603 msgid "From an iterable of integers: ``bytearray(range(20))``" msgstr "à partir d'un itérable d'entiers : ``bytearray(range(20))`` ;" # fin d'énumération #: library/stdtypes.rst:2604 msgid "" "Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" msgstr "" "copie des données binaires existantes via le protocole tampon : " "``bytearray(b'Hi!')``." #: library/stdtypes.rst:2606 msgid "" "As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " "operations described in :ref:`bytes-methods`." msgstr "" "Comme les *bytearray* sont muables, ils prennent en charge les opérations de " "séquences :ref:`muables ` en plus des opérations communes " "de *bytes* et *bytearray* décrites dans :ref:`bytes-methods`." #: library/stdtypes.rst:2610 msgid "Also see the :ref:`bytearray ` built-in." msgstr "Voir aussi la fonction native :ref:`bytearray `." #: library/stdtypes.rst:2612 msgid "" "Since 2 hexadecimal digits correspond precisely to a single byte, " "hexadecimal numbers are a commonly used format for describing binary data. " "Accordingly, the bytearray type has an additional class method to read data " "in that format:" msgstr "" "Puisque 2 chiffres hexadécimaux correspondent précisément à un octet, les " "nombres hexadécimaux sont un format couramment utilisé pour décrire les " "données binaires. Par conséquent, le type *bytearray* a une méthode de " "classe pour lire les données dans ce format :" #: library/stdtypes.rst:2618 msgid "" "This :class:`bytearray` class method returns bytearray object, decoding the " "given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" "Cette méthode de la classe :class:`bytearray` renvoie un objet *bytearray*, " "décodant la chaîne donnée. La chaîne doit contenir deux chiffres " "hexadécimaux par octet, les caractères d'espacement ASCII sont ignorés." #: library/stdtypes.rst:2625 msgid "" ":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " "just spaces." msgstr "" ":meth:`bytearray.fromhex` saute maintenant tous les caractères d'espacement " "ASCII dans la chaîne, pas seulement les espaces." #: library/stdtypes.rst:2629 msgid "" "A reverse conversion function exists to transform a bytearray object into " "its hexadecimal representation." msgstr "" "Une fonction de conversion inverse existe pour transformer un objet " "*bytearray* en sa représentation hexadécimale." # suit un : #: library/stdtypes.rst:2642 msgid "" "Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" "similaire à :meth:`bytes.hex`, :meth:`bytearray.hex` prend désormais en " "charge les paramètres optionnels *sep* et *bytes_per_sep* pour insérer des " "séparateurs entre les octets dans la sortie hexadécimale." #: library/stdtypes.rst:2647 msgid "" "Since bytearray objects are sequences of integers (akin to a list), for a " "bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " "a bytearray object of length 1. (This contrasts with text strings, where " "both indexing and slicing will produce a string of length 1)" msgstr "" "Comme les *bytearray* sont des séquences d'entiers (semblables à une liste), " "pour un objet *bytearray* *b*, ``b[0]`` est un entier, tandis que ``b[0:1]`` " "est un objet *bytearray* de longueur 1. (Ceci contraste avec les chaînes de " "texte, où l'indice et le découpage produisent une chaîne de longueur 1)" #: library/stdtypes.rst:2652 msgid "" "The representation of bytearray objects uses the bytes literal format " "(``bytearray(b'...')``) since it is often more useful than e.g. " "``bytearray([46, 46, 46])``. You can always convert a bytearray object into " "a list of integers using ``list(b)``." msgstr "" "La représentation des objets *bytearray* utilise le format littéral des " "*bytes* (``bytearray(b'...')``) car il est souvent plus utile que par " "exemple ``bytearray([46, 46, 46])``. Vous pouvez toujours convertir un objet " "*bytearray* en une liste de nombres entiers en utilisant ``list(b)``." #: library/stdtypes.rst:2661 msgid "Bytes and Bytearray Operations" msgstr "Opérations sur les *bytes* et *bytearray*" #: library/stdtypes.rst:2666 msgid "" "Both bytes and bytearray objects support the :ref:`common ` " "sequence operations. They interoperate not just with operands of the same " "type, but with any :term:`bytes-like object`. Due to this flexibility, they " "can be freely mixed in operations without causing errors. However, the " "return type of the result may depend on the order of operands." msgstr "" "*bytes* et *bytearray* prennent en charge les opérations :ref:`communes " "` des séquences. Ils interagissent non seulement avec des " "opérandes de même type, mais aussi avec les :term:`objets octet-compatibles " "`. En raison de cette flexibilité, ils peuvent être " "mélangés librement dans des opérations sans provoquer d'erreurs. Cependant, " "le type du résultat peut dépendre de l'ordre des opérandes." # suit un : #: library/stdtypes.rst:2674 msgid "" "The methods on bytes and bytearray objects don't accept strings as their " "arguments, just as the methods on strings don't accept bytes as their " "arguments. For example, you have to write::" msgstr "" "les méthodes sur les *bytes* et les *bytearray* n'acceptent pas les chaînes " "comme arguments, tout comme les méthodes sur les chaînes n'acceptent pas les " "*bytes* comme arguments. Par exemple, vous devez écrire ::" #: library/stdtypes.rst:2681 msgid "and::" msgstr "et ::" #: library/stdtypes.rst:2686 msgid "" "Some bytes and bytearray operations assume the use of ASCII compatible " "binary formats, and hence should be avoided when working with arbitrary " "binary data. These restrictions are covered below." msgstr "" "Quelques opérations de *bytes* et *bytesarray* supposent l'utilisation de " "formats binaires compatibles ASCII, et donc doivent être évités lorsque vous " "travaillez avec des données binaires arbitraires. Ces restrictions sont " "couvertes ci-dessous." # suit un : #: library/stdtypes.rst:2691 msgid "" "Using these ASCII based operations to manipulate binary data that is not " "stored in an ASCII based format may lead to data corruption." msgstr "" "utiliser ces opérations basées sur l'ASCII pour manipuler des données " "binaires qui ne sont pas au format ASCII peut les corrompre." #: library/stdtypes.rst:2694 msgid "" "The following methods on bytes and bytearray objects can be used with " "arbitrary binary data." msgstr "" "Les méthodes suivantes sur les *bytes* et *bytearray* peuvent être utilisées " "avec des données binaires arbitraires." #: library/stdtypes.rst:2700 msgid "" "Return the number of non-overlapping occurrences of subsequence *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " "interpreted as in slice notation." msgstr "" "Renvoie le nombre d'occurrences qui ne se chevauchent pas de la sous-" "séquence *sub* dans l'intervalle [*start*, *end*]. Les arguments facultatifs " "*start* et *end* sont interprétés comme dans la notation des découpages." #: library/stdtypes.rst:2809 library/stdtypes.rst:2897 #: library/stdtypes.rst:2910 msgid "" "The subsequence to search for may be any :term:`bytes-like object` or an " "integer in the range 0 to 255." msgstr "" "La sous-séquence à rechercher peut être un quelconque :term:`objet octet-" "compatible ` ou un nombre entier compris entre 0 et 255." #: library/stdtypes.rst:2707 msgid "" "If *sub* is empty, returns the number of empty slices between characters " "which is the length of the bytes object plus one." msgstr "" "Si *sub* est vide, renvoie le nombre de tranches vides entre les caractères " "de début et de fin, ce qui correspond à la longueur de l'objet bytes plus un." # suit un : #: library/stdtypes.rst:2821 library/stdtypes.rst:2900 #: library/stdtypes.rst:2913 msgid "Also accept an integer in the range 0 to 255 as the subsequence." msgstr "" "accepte aussi un nombre entier compris entre 0 et 255 comme sous-séquence." #: library/stdtypes.rst:2717 msgid "" "If the binary data starts with the *prefix* string, return " "``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " "data::" msgstr "" "Si les données binaires commencent par la chaîne *prefix*, renvoie " "``bytes[len(prefix):]``. Sinon, renvoie une copie des données binaires " "d'origine ::" #: library/stdtypes.rst:2726 msgid "The *prefix* may be any :term:`bytes-like object`." msgstr "" "Le *prefix* peut être n'importe quel :term:`objet octet-compatible `." # suit un : #: library/stdtypes.rst:2752 library/stdtypes.rst:2978 #: library/stdtypes.rst:3023 library/stdtypes.rst:3079 #: library/stdtypes.rst:3167 library/stdtypes.rst:3334 #: library/stdtypes.rst:3432 library/stdtypes.rst:3475 #: library/stdtypes.rst:3677 msgid "" "The bytearray version of this method does *not* operate in place - it always " "produces a new object, even if no changes were made." msgstr "" "la version *bytearray* de cette méthode *ne modifie pas* les octets, elle " "produit toujours un nouvel objet, même si aucune modification n'a été " "effectuée." #: library/stdtypes.rst:2739 msgid "" "If the binary data ends with the *suffix* string and that *suffix* is not " "empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " "original binary data::" msgstr "" "Si les données binaires terminent par la chaîne *suffix*, renvoie ``bytes[:-" "len(suffix)]``. Sinon, renvoie une copie des données binaires d'origine ::" #: library/stdtypes.rst:2748 msgid "The *suffix* may be any :term:`bytes-like object`." msgstr "" "Le *suffix* peut être n'importe quel :term:`objet octet-compatible `." #: library/stdtypes.rst:2761 msgid "Return the bytes decoded to a :class:`str`." msgstr "Renvoie la chaine d'octets décodée en instance de :class:`str`." #: library/stdtypes.rst:2766 msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " "are ``'ignore'``, ``'replace'``, and any other name registered via :func:" "`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" "*errors* détermine la manière dont sont traitées les erreurs. Sa valeur par " "défaut est ``'strict'``, ce qui signifie que les erreurs d'encodage lèvent " "une :exc:`UnicodeError`. Les autres valeurs possibles sont ``'ignore'``, " "``'replace'`` et tout autre nom enregistré *via* :func:`codecs." "register_error`, voir la section :ref:`error-handlers` pour les détails." #: library/stdtypes.rst:2772 msgid "" "For performance reasons, the value of *errors* is not checked for validity " "unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" "`debug build ` is used." msgstr "" "Pour des raisons de performances, la valeur de *errors* n'est pas vérifiée à " "moins qu'une erreur de décodage ne se produise réellement, que le :ref:`mode " "développeur ` ne soit activé ou que Python ait été compilé en :ref:" "`mode débogage `." # suit un : #: library/stdtypes.rst:2778 msgid "" "Passing the *encoding* argument to :class:`str` allows decoding any :term:" "`bytes-like object` directly, without needing to make a temporary :class:`!" "bytes` or :class:`!bytearray` object." msgstr "" "passer l'argument *encoding* à :class:`str` permet de décoder tout :term:" "`objet octet-compatible ` directement, sans avoir besoin " "d'utiliser un :class:`!bytes` ou :class:`!bytearray` temporaire." #: library/stdtypes.rst:2793 msgid "" "Return ``True`` if the binary data ends with the specified *suffix*, " "otherwise return ``False``. *suffix* can also be a tuple of suffixes to " "look for. With optional *start*, test beginning at that position. With " "optional *end*, stop comparing at that position." msgstr "" "Renvoie ``True`` si les octets se terminent par *suffix*, sinon ``False``. " "*suffix* peut aussi être un *n*-uplet de suffixes à rechercher. Avec " "l'argument optionnel *start*, la recherche se fait à partir de cette " "position. Avec l'argument optionnel *end*, la comparaison s'arrête à cette " "position." #: library/stdtypes.rst:2798 msgid "The suffix(es) to search for may be any :term:`bytes-like object`." msgstr "" "Les suffixes à rechercher peuvent être n'importe quel :term:`objet octet-" "compatible `." #: library/stdtypes.rst:2804 msgid "" "Return the lowest index in the data where the subsequence *sub* is found, " "such that *sub* is contained in the slice ``s[start:end]``. Optional " "arguments *start* and *end* are interpreted as in slice notation. Return " "``-1`` if *sub* is not found." msgstr "" "Renvoie la première position où le *sub* se trouve dans les données, de " "telle sorte que *sub* soit contenue dans ``s[start:end]``. Les arguments " "facultatifs *start* et *end* sont interprétés comme dans la notation des " "découpages. Renvoie ``-1`` si *sub* n'est pas trouvé." # suit un : #: library/stdtypes.rst:2814 msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" "la méthode :meth:`~bytes.find` ne doit être utilisée que si vous avez besoin " "de connaître la position de *sub*. Pour vérifier si *sub* est présent ou " "non, utilisez l'opérateur :keyword:`in` ::" #: library/stdtypes.rst:2828 msgid "" "Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " "is not found." msgstr "" "Comme :meth:`~bytes.find`, mais lève une :exc:`ValueError` lorsque la " "séquence est introuvable." #: library/stdtypes.rst:2841 msgid "" "Return a bytes or bytearray object which is the concatenation of the binary " "data sequences in *iterable*. A :exc:`TypeError` will be raised if there " "are any values in *iterable* that are not :term:`bytes-like objects `, including :class:`str` objects. The separator between " "elements is the contents of the bytes or bytearray object providing this " "method." msgstr "" "Renvoie un *bytes* ou *bytearray* qui est la concaténation des séquences de " "données binaires dans *iterable*. Une exception :exc:`TypeError` est levée " "si une valeur d'*iterable* n'est pas un :term:`objet octet-compatible `, y compris pour des :class:`str`. Le séparateur entre les " "éléments est le contenu du *bytes* ou du *bytearray* depuis lequel cette " "méthode est appelée." #: library/stdtypes.rst:2852 msgid "" "This static method returns a translation table usable for :meth:`bytes." "translate` that will map each character in *from* into the character at the " "same position in *to*; *from* and *to* must both be :term:`bytes-like " "objects ` and have the same length." msgstr "" "Cette méthode statique renvoie une table de traduction utilisable par :meth:" "`bytes.translate` qui permettra de changer chaque caractère de *from* par un " "caractère à la même position dans *to* ; *from* et *to* doivent tous deux " "être des :term:`objets octet-compatibles ` et avoir la " "même longueur." #: library/stdtypes.rst:2863 msgid "" "Split the sequence at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " "bytearray copy, and the part after the separator. If the separator is not " "found, return a 3-tuple containing a copy of the original sequence, followed " "by two empty bytes or bytearray objects." msgstr "" "Divise la séquence à la première occurrence de *sep*, et renvoie un triplet " "contenant la partie précédant le séparateur, le séparateur lui même (ou sa " "copie en *byterray*), et la partie suivant le séparateur. Si le séparateur " "n'est pas trouvé, le triplet renvoyé contient une copie de la séquence " "d'origine, suivi de deux *bytes* ou *bytearray* vides." #: library/stdtypes.rst:2927 msgid "The separator to search for may be any :term:`bytes-like object`." msgstr "" "Le séparateur à rechercher peut être tout :term:`objet octet-compatible " "`." #: library/stdtypes.rst:2876 msgid "" "Return a copy of the sequence with all occurrences of subsequence *old* " "replaced by *new*. If the optional argument *count* is given, only the " "first *count* occurrences are replaced." msgstr "" "Renvoie une copie de la séquence dont toutes les occurrences de la sous-" "séquence *old* sont remplacées par *new*. Si l'argument optionnel *count* " "est donné, seules les *count* premières occurrences sont remplacées." #: library/stdtypes.rst:2880 msgid "" "The subsequence to search for and its replacement may be any :term:`bytes-" "like object`." msgstr "" "La sous-séquence à rechercher et son remplacement peuvent être n'importe " "quel :term:`objet octet-compatible `." #: library/stdtypes.rst:2892 msgid "" "Return the highest index in the sequence where the subsequence *sub* is " "found, such that *sub* is contained within ``s[start:end]``. Optional " "arguments *start* and *end* are interpreted as in slice notation. Return " "``-1`` on failure." msgstr "" "Renvoie la plus grande position de *sub* dans la séquence, de telle sorte " "que *sub* soit dans ``s[start:end]``. Les arguments facultatifs *start* et " "*end* sont interprétés comme dans la notation des découpages. Renvoie ``-1`` " "si *sub* n'est pas trouvable." #: library/stdtypes.rst:2907 msgid "" "Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " "*sub* is not found." msgstr "" "Semblable à :meth:`~bytes.rfind` mais lève une :exc:`ValueError` lorsque " "*sub* est introuvable." #: library/stdtypes.rst:2920 msgid "" "Split the sequence at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself or its " "bytearray copy, and the part after the separator. If the separator is not " "found, return a 3-tuple containing two empty bytes or bytearray objects, " "followed by a copy of the original sequence." msgstr "" "Coupe la séquence à la dernière occurrence de *sep*, et renvoie un triplet " "de trois éléments contenant la partie précédent le séparateur, le séparateur " "lui même (ou sa copie, un *bytearray*), et la partie suivant le séparateur. " "Si le séparateur n'est pas trouvé, le triplet contient deux *bytes* ou " "*bytesarray* vides suivi d’une copie de la séquence d'origine." #: library/stdtypes.rst:2933 msgid "" "Return ``True`` if the binary data starts with the specified *prefix*, " "otherwise return ``False``. *prefix* can also be a tuple of prefixes to " "look for. With optional *start*, test beginning at that position. With " "optional *end*, stop comparing at that position." msgstr "" "Renvoie ``True`` si les données binaires commencent par le *prefix* " "spécifié, sinon ``False``. *prefix* peut aussi être un *n*-uplet de préfixes " "à rechercher. Avec l'argument *start* la recherche commence à cette " "position. Avec l'argument *end* option, la recherche s'arrête à cette " "position." #: library/stdtypes.rst:2938 msgid "The prefix(es) to search for may be any :term:`bytes-like object`." msgstr "" "Les préfixes à rechercher peuvent être n'importe quels :term:`objets octet-" "compatibles `." #: library/stdtypes.rst:2944 msgid "" "Return a copy of the bytes or bytearray object where all bytes occurring in " "the optional argument *delete* are removed, and the remaining bytes have " "been mapped through the given translation table, which must be a bytes " "object of length 256." msgstr "" "Renvoie une copie du *bytes* ou *bytearray* dont tous les octets de " "*delete* sont supprimés, et les octets restants changés par la table de " "correspondance donnée, qui doit être un objet *bytes* d'une longueur de 256." #: library/stdtypes.rst:2949 msgid "" "You can use the :func:`bytes.maketrans` method to create a translation table." msgstr "" "Vous pouvez utiliser la méthode :func:`bytes.maketrans` pour créer une table " "de correspondance." #: library/stdtypes.rst:2952 msgid "" "Set the *table* argument to ``None`` for translations that only delete " "characters::" msgstr "" "Donnez ``None`` comme *table* pour seulement supprimer des caractères ::" #: library/stdtypes.rst:2958 msgid "*delete* is now supported as a keyword argument." msgstr "*delete* est maintenant accepté comme argument nommé." #: library/stdtypes.rst:2962 msgid "" "The following methods on bytes and bytearray objects have default behaviours " "that assume the use of ASCII compatible binary formats, but can still be " "used with arbitrary binary data by passing appropriate arguments. Note that " "all of the bytearray methods in this section do *not* operate in place, and " "instead produce new objects." msgstr "" "Les méthodes suivantes sur les *bytes* et *bytearray* supposent par défaut " "que les données traitées sont compatibles ASCII, mais peuvent toujours être " "utilisées avec des données binaires, arbitraires, en passant des arguments " "appropriés. Notez que toutes les méthodes de *bytearray* de cette section ne " "travaillent jamais sur l'objet lui-même, mais renvoient un nouvel objet." #: library/stdtypes.rst:2971 msgid "" "Return a copy of the object centered in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " "For :class:`bytes` objects, the original sequence is returned if *width* is " "less than or equal to ``len(s)``." msgstr "" "Renvoie une copie de l'objet centrée dans une séquence de longueur *width*. " "Le remplissage est fait en utilisant *fillbyte* (qui par défaut est une " "espace ASCII). Pour les objets :class:`bytes`, la séquence initiale est " "renvoyée si *width* est inférieure ou égale à ``len(s)``." #: library/stdtypes.rst:2985 msgid "" "Return a copy of the object left justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " "For :class:`bytes` objects, the original sequence is returned if *width* is " "less than or equal to ``len(s)``." msgstr "" "Renvoie une copie de l'objet aligné à gauche dans une séquence de longueur " "*width*. Le remplissage est fait en utilisant *fillbyte* (par défaut un " "espace ASCII). Pour les objets :class:`bytes`, la séquence initiale est " "renvoyée si *width* est inférieure ou égale à ``len(s)``." #: library/stdtypes.rst:2999 msgid "" "Return a copy of the sequence with specified leading bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " "be removed - the name refers to the fact this method is usually used with " "ASCII characters. If omitted or ``None``, the *chars* argument defaults to " "removing ASCII whitespace. The *chars* argument is not a prefix; rather, " "all combinations of its values are stripped::" msgstr "" "Renvoie une copie de la séquence dont certains préfixes ont été supprimés. " "L’argument *chars* est une séquence binaire spécifiant le jeu d'octets à " "supprimer. Ce nom se réfère au fait de cette méthode est généralement " "utilisée avec des caractères ASCII. En cas d’omission ou ``None``, la valeur " "par défaut de *chars* permet de supprimer des espaces ASCII. L’argument " "*chars* n’est pas un préfixe, toutes les combinaisons de ses valeurs sont " "supprimées ::" #: library/stdtypes.rst:3011 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removeprefix` for a method that will remove a " "single prefix string rather than all of a set of characters. For example::" msgstr "" "Les octets à retirer peuvent être n'importe quel :term:`bytes-like object`. " "Voir :meth:`~bytes.removeprefix` pour une méthode qui supprime, au début de " "la séquence, la chaîne de caractères en tant que telle plutôt que l'ensemble " "des caractères passés en paramètre. Par exemple ::" #: library/stdtypes.rst:3030 msgid "" "Return a copy of the object right justified in a sequence of length *width*. " "Padding is done using the specified *fillbyte* (default is an ASCII space). " "For :class:`bytes` objects, the original sequence is returned if *width* is " "less than or equal to ``len(s)``." msgstr "" "Renvoie une copie de l'objet justifié à droite dans une séquence de longueur " "*width*. Le remplissage est fait en utilisant le caractère *fillbyte* (par " "défaut est un espace ASCII). Pour les objets :class:`bytes`, la séquence " "d'origine est renvoyée si *width* est inférieure ou égale à ``len(s)``." #: library/stdtypes.rst:3044 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " "done, the *rightmost* ones. If *sep* is not specified or ``None``, any " "subsequence consisting solely of ASCII whitespace is a separator. Except for " "splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " "described in detail below." msgstr "" "Divise la séquence d'octets en sous-séquences du même type, en utilisant " "*sep* comme séparateur. Si *maxsplit* est donné, c'est le nombre maximum de " "divisions qui pourront être faites, celles \"à droite\". Si *sep* est pas " "spécifié ou est ``None``, toute sous-séquence composée uniquement d'espaces " "ASCII est un séparateur. En dehors du fait qu'il découpe par la droite, :" "meth:`rsplit` se comporte comme :meth:`split` qui est décrit en détail ci-" "dessous." #: library/stdtypes.rst:3055 msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " "*chars* argument is a binary sequence specifying the set of byte values to " "be removed - the name refers to the fact this method is usually used with " "ASCII characters. If omitted or ``None``, the *chars* argument defaults to " "removing ASCII whitespace. The *chars* argument is not a suffix; rather, " "all combinations of its values are stripped::" msgstr "" "Renvoie une copie de la séquence dont des octets finaux sont supprimés. " "L'argument *chars* est une séquence d'octets spécifiant le jeu de caractères " "à supprimer. En cas d'omission ou ``None``, les espaces ASCII sont " "supprimées. L'argument *chars* n'est pas un suffixe : toutes les " "combinaisons de ses valeurs sont retirées ::" #: library/stdtypes.rst:3067 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`. See :meth:`~bytes.removesuffix` for a method that will remove a " "single suffix string rather than all of a set of characters. For example::" msgstr "" "Les octets à retirer peuvent être n'importe quel :term:`bytes-like object`. " "Voir :meth:`~bytes.removesuffix` pour une méthode qui supprime, à la fin de " "la séquence, la chaîne de caractères en tant que telle plutôt que l'ensemble " "des caractères passés en paramètre. Par exemple ::" #: library/stdtypes.rst:3086 msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given and non-negative, at most " "*maxsplit* splits are done (thus, the list will have at most ``maxsplit+1`` " "elements). If *maxsplit* is not specified or is ``-1``, then there is no " "limit on the number of splits (all possible splits are made)." msgstr "" "Divise la séquence en sous-séquences du même type, en utilisant *sep* comme " "séparateur. Si *maxsplit* est donné, c'est le nombre maximum de divisions " "qui pourront être faites (la liste aura donc au plus ``maxsplit+1`` " "éléments), Si *maxsplit* n'est pas spécifié ou faut ``-1``, il n'y a aucune " "limite au nombre de découpes (elles sont toutes effectuées)." #: library/stdtypes.rst:3092 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " "returns ``[b'1', b'', b'2']``). The *sep* argument may consist of a " "multibyte sequence (for example, ``b'1<>2<>3'.split(b'<>')`` returns " "``[b'1', b'2', b'3']``). Splitting an empty sequence with a specified " "separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on the type of " "object being split. The *sep* argument may be any :term:`bytes-like object`." msgstr "" "Si *sep* est donné, les délimiteurs consécutifs ne sont pas regroupés et " "ainsi délimitent ainsi des chaînes vides (par exemple, ``b'1,,2'." "split(b',')`` renvoie ``[b'1', b'', b'2']``). L'argument *sep* peut contenir " "plusieurs sous-séquences (par exemple, ``b'1<>2<>3'.split(b'<>')`` renvoie " "``[b'1', b'2', b'3']``). Découper une chaîne vide en spécifiant *sep* " "renvoie ``[b'']`` ou ``[bytearray(b'')]`` en fonction du type de l'objet " "découpé. L'argument *sep* peut être n'importe quel :term:`bytes-like object`." #: library/stdtypes.rst:3110 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive ASCII whitespace are regarded as a single " "separator, and the result will contain no empty strings at the start or end " "if the sequence has leading or trailing whitespace. Consequently, splitting " "an empty sequence or a sequence consisting solely of ASCII whitespace " "without a specified separator returns ``[]``." msgstr "" "Si *sep* n'est pas spécifié ou est ``None``, un autre algorithme de découpe " "est appliqué : les espaces ASCII consécutifs sont considérés comme un seul " "séparateur, et le résultat ne contiendra pas les chaînes vides de début ou " "de la fin si la chaîne est préfixée ou suffixé d'espaces. Par conséquent, " "diviser une séquence vide ou une séquence composée d'espaces ASCII avec un " "séparateur ``None`` renvoie ``[]``." #: library/stdtypes.rst:3131 msgid "" "Return a copy of the sequence with specified leading and trailing bytes " "removed. The *chars* argument is a binary sequence specifying the set of " "byte values to be removed - the name refers to the fact this method is " "usually used with ASCII characters. If omitted or ``None``, the *chars* " "argument defaults to removing ASCII whitespace. The *chars* argument is not " "a prefix or suffix; rather, all combinations of its values are stripped::" msgstr "" "Renvoie une copie de la séquence dont des caractères initiaux et finaux sont " "supprimés. L'argument *chars* est une séquence spécifiant le jeu d'octets à " "supprimer, le nom se réfère au fait de cette méthode est généralement " "utilisée avec des caractères ASCII. En cas d'omission ou ``None``, les " "espaces ASCII sont supprimés. L'argument *chars* n'est ni un préfixe ni un " "suffixe, toutes les combinaisons de ses valeurs sont supprimées ::" #: library/stdtypes.rst:3144 msgid "" "The binary sequence of byte values to remove may be any :term:`bytes-like " "object`." msgstr "Les octets à retirer peuvent être tout :term:`bytes-like object`." #: library/stdtypes.rst:3153 msgid "" "The following methods on bytes and bytearray objects assume the use of ASCII " "compatible binary formats and should not be applied to arbitrary binary " "data. Note that all of the bytearray methods in this section do *not* " "operate in place, and instead produce new objects." msgstr "" "Les méthodes suivantes sur les *bytes* et *bytearray* supposent " "l'utilisation d'un format binaire compatible ASCII, et donc doivent être " "évités lorsque vous travaillez avec des données binaires arbitraires. Notez " "que toutes les méthodes de *bytearray* de cette section *ne modifient pas* " "les octets, ils produisent de nouveaux objets." #: library/stdtypes.rst:3161 msgid "" "Return a copy of the sequence with each byte interpreted as an ASCII " "character, and the first byte capitalized and the rest lowercased. Non-ASCII " "byte values are passed through unchanged." msgstr "" "Renvoie une copie de la séquence dont chaque octet est interprété comme un " "caractère ASCII, le premier octet en capitale et le reste en minuscules. Les " "octets non ASCII ne sont pas modifiés." #: library/stdtypes.rst:3174 msgid "" "Return a copy of the sequence where all ASCII tab characters are replaced by " "one or more ASCII spaces, depending on the current column and the given tab " "size. Tab positions occur every *tabsize* bytes (default is 8, giving tab " "positions at columns 0, 8, 16 and so on). To expand the sequence, the " "current column is set to zero and the sequence is examined byte by byte. If " "the byte is an ASCII tab character (``b'\\t'``), one or more space " "characters are inserted in the result until the current column is equal to " "the next tab position. (The tab character itself is not copied.) If the " "current byte is an ASCII newline (``b'\\n'``) or carriage return " "(``b'\\r'``), it is copied and the current column is reset to zero. Any " "other byte value is copied unchanged and the current column is incremented " "by one regardless of how the byte value is represented when printed::" msgstr "" "Renvoie une copie de la séquence où toutes les tabulations ASCII sont " "remplacées par un ou plusieurs espaces ASCII, en fonction de la colonne " "courante et de la taille de tabulation donnée. Les positions des tabulations " "se trouvent tous les *tabsize* caractères (8 par défaut, ce qui donne les " "positions de tabulations aux colonnes 0, 8, 16 et ainsi de suite). Pour " "travailler sur la séquence, la colonne en cours est mise à zéro et la " "séquence est examinée octets par octets. Si l'octet est une tabulation ASCII " "(``b'\\t'``), un ou plusieurs espaces sont insérés au résultat jusqu’à ce " "que la colonne courante soit égale à la position de tabulation suivante. (Le " "caractère tabulation lui-même n’est pas copié.) Si l'octet courant est un " "saut de ligne ASCII (``b'\\n'``) ou un retour chariot (``b'\\r'``), il est " "copié et la colonne en cours est remise à zéro. Tout autre octet est copié " "inchangé et la colonne en cours est incrémentée de un indépendamment de la " "façon dont l'octet est représenté lors de l’affichage ::" #: library/stdtypes.rst:3202 msgid "" "Return ``True`` if all bytes in the sequence are alphabetical ASCII " "characters or ASCII decimal digits and the sequence is not empty, ``False`` " "otherwise. Alphabetic ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``. ASCII decimal " "digits are those byte values in the sequence ``b'0123456789'``." msgstr "" "Renvoie ``True`` si tous les caractères de la chaîne sont des caractères " "ASCII alphabétiques ou chiffres et que la séquence n'est pas vide, sinon " "``False``. Les caractères ASCII alphabétiques sont les suivants dans la " "séquence d'octets " "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'`` et les " "chiffres : ``b'0123456789'``." #: library/stdtypes.rst:3219 msgid "" "Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " "and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " "characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" "Renvoie ``True`` si tous les octets dans la séquence sont des caractères " "alphabétiques ASCII et que la séquence n'est pas vide, sinon ``False``. Les " "caractères ASCII alphabétiques sont : " "``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." #: library/stdtypes.rst:3235 msgid "" "Return ``True`` if the sequence is empty or all bytes in the sequence are " "ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." msgstr "" "Renvoie ``True`` si la séquence est vide, ou si tous ses octets sont des " "octets ASCII, renvoie ``False`` dans le cas contraire. Les octets ASCII dans " "l'intervalle ``0``–``0x7F``." #: library/stdtypes.rst:3245 msgid "" "Return ``True`` if all bytes in the sequence are ASCII decimal digits and " "the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " "those byte values in the sequence ``b'0123456789'``." msgstr "" "Renvoie ``True`` si tous les octets de la séquence sont des chiffres ASCII " "et que la séquence n'est pas vide, sinon ``False``. Les chiffres ASCII sont " "ceux dans la séquence d'octets ``b'0123456789'``." #: library/stdtypes.rst:3260 msgid "" "Return ``True`` if there is at least one lowercase ASCII character in the " "sequence and no uppercase ASCII characters, ``False`` otherwise." msgstr "" "Renvoie ``True`` s'il y a au moins un caractère ASCII minuscule dans la " "séquence et aucune capitale, sinon ``False``." #: library/stdtypes.rst:3312 library/stdtypes.rst:3378 #: library/stdtypes.rst:3447 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." msgstr "" "Les caractères ASCII minuscules sont ``b'abcdefghijklmnopqrstuvwxyz'``. Les " "capitales ASCII sont ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." #: library/stdtypes.rst:3278 msgid "" "Return ``True`` if all bytes in the sequence are ASCII whitespace and the " "sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " "those byte values in the sequence ``b' \\t\\n\\r\\x0b\\f'`` (space, tab, " "newline, carriage return, vertical tab, form feed)." msgstr "" "Renvoie ``True`` si tous les octets de la séquence sont des espaces ASCII et " "que la séquence n'est pas vide, sinon ``False``. Les espèces ASCII sont ``b' " "\\t\\n\\r\\x0b\\f'`` (espace, tabulation, saut de ligne, retour chariot, " "tabulation verticale, saut de page)." #: library/stdtypes.rst:3287 msgid "" "Return ``True`` if the sequence is ASCII titlecase and the sequence is not " "empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " "definition of \"titlecase\"." msgstr "" "Renvoie ``True`` si la séquence ASCII est *titlecased*, et qu'elle n'est pas " "vide, sinon ``False``. Voir :meth:`bytes.title` pour plus de détails sur la " "définition de *titlecase*." #: library/stdtypes.rst:3302 msgid "" "Return ``True`` if there is at least one uppercase alphabetic ASCII " "character in the sequence and no lowercase ASCII characters, ``False`` " "otherwise." msgstr "" "Renvoie ``True`` s'il y a au moins un caractère alphabétique majuscule ASCII " "dans la séquence et aucun caractère ASCII minuscule, sinon ``False``." #: library/stdtypes.rst:3320 msgid "" "Return a copy of the sequence with all the uppercase ASCII characters " "converted to their corresponding lowercase counterpart." msgstr "" "Renvoie une copie de la séquence dont tous les caractères ASCII en " "majuscules sont convertis en leur équivalent en minuscules." #: library/stdtypes.rst:3345 msgid "" "Return a list of the lines in the binary sequence, breaking at ASCII line " "boundaries. This method uses the :term:`universal newlines` approach to " "splitting lines. Line breaks are not included in the resulting list unless " "*keepends* is given and true." msgstr "" "Renvoie une liste des lignes de la séquence d'octets, découpant au niveau " "des fin de lignes ASCII. Cette méthode utilise l'approche :term:`universal " "newlines` pour découper les lignes. Les fins de ligne ne sont pas inclus " "dans la liste des résultats, sauf si *keepends* est donné et vrai." #: library/stdtypes.rst:3357 msgid "" "Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line::" msgstr "" "Contrairement à :meth:`~bytes.split` lorsque le délimiteur *sep* est fourni, " "cette méthode renvoie une liste vide pour la chaîne vide, et un saut de " "ligne à la fin ne se traduit pas par une ligne supplémentaire ::" #: library/stdtypes.rst:3370 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart and vice-versa." msgstr "" "Renvoie une copie de la séquence dont tous les caractères ASCII minuscules " "sont convertis en majuscules et vice-versa." #: library/stdtypes.rst:3382 msgid "" "Unlike :func:`str.swapcase()`, it is always the case that ``bin.swapcase()." "swapcase() == bin`` for the binary versions. Case conversions are " "symmetrical in ASCII, even though that is not generally true for arbitrary " "Unicode code points." msgstr "" "Contrairement à :func:`str.swapcase()`, ``bin.swapcase().swapcase() == " "bin`` est toujours vrai. Les conversions majuscule/minuscule en ASCII étant " "toujours symétrique, ce qui n'est pas toujours vrai avec Unicode." #: library/stdtypes.rst:3396 msgid "" "Return a titlecased version of the binary sequence where words start with an " "uppercase ASCII character and the remaining characters are lowercase. " "Uncased byte values are left unmodified." msgstr "" "Renvoie une version *titlecased* de la séquence d'octets où les mots " "commencent par un caractère ASCII majuscule et les caractères restants sont " "en minuscules. Les octets non capitalisables ne sont pas modifiés." #: library/stdtypes.rst:3405 msgid "" "Lowercase ASCII characters are those byte values in the sequence " "``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " "values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. All other byte " "values are uncased." msgstr "" "Les caractères ASCII minuscules sont ``b'abcdefghijklmnopqrstuvwxyz'``. Les " "caractères ASCII majuscules sont ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. Aucun " "autre octet n'est capitalisable." #: library/stdtypes.rst:3418 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" "Une solution pour contourner le problème des apostrophes peut être obtenue " "en utilisant des expressions rationnelles ::" #: library/stdtypes.rst:3439 msgid "" "Return a copy of the sequence with all the lowercase ASCII characters " "converted to their corresponding uppercase counterpart." msgstr "" "Renvoie une copie de la séquence dont tous les caractères ASCII minuscules " "sont convertis en leur équivalent majuscule." #: library/stdtypes.rst:3460 msgid "" "Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " "a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " "handled by inserting the padding *after* the sign character rather than " "before. For :class:`bytes` objects, the original sequence is returned if " "*width* is less than or equal to ``len(seq)``." msgstr "" "Renvoie une copie de la séquence remplie par la gauche du chiffre ``b'0'`` " "pour en faire une séquence de longueur *width*. Un préfixe (``b'+'`` / " "``b'-'``) est permis par l'insertion du caractère de remplissage *après* le " "caractère de signe plutôt qu'avant. Pour les objets :class:`bytes` la " "séquence d'origine est renvoyée si *width* est inférieur ou égale à " "``len(seq)``." #: library/stdtypes.rst:3482 msgid "``printf``-style Bytes Formatting" msgstr "Formatage de *bytes* a la ``printf``" #: library/stdtypes.rst:3499 msgid "" "The formatting operations described here exhibit a variety of quirks that " "lead to a number of common errors (such as failing to display tuples and " "dictionaries correctly). If the value being printed may be a tuple or " "dictionary, wrap it in a tuple." msgstr "" "Les opérations de formatage décrites ici présentent une variété de " "bizarreries qui conduisent à un certain nombre d’erreurs classiques " "(typiquement, échouer à afficher des *n*-uplets ou des dictionnaires " "correctement). Si la valeur à afficher peut être un *n*-uplet ou un " "dictionnaire, mettez-le à l'intérieur d'un autre *n*-uplet." #: library/stdtypes.rst:3504 msgid "" "Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " "*interpolation* operator. Given ``format % values`` (where *format* is a " "bytes object), ``%`` conversion specifications in *format* are replaced with " "zero or more elements of *values*. The effect is similar to using the :c:" "func:`sprintf` in the C language." msgstr "" "Les objets *bytes* (``bytes`` et ``bytearray``) ont un unique opérateur : " "l'opérateur ``%`` (modulo). Il est aussi connu sous le nom d'opérateur de " "mise en forme. Avec ``format % values`` (où *format* est un objet *bytes*), " "les marqueurs de conversion ``%`` dans *format* sont remplacés par zéro ou " "plus de *values*. L'effet est similaire à la fonction :c:func:`sprintf` du " "langage C." #: library/stdtypes.rst:3511 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " "items specified by the format bytes object, or a single mapping object (for " "example, a dictionary)." msgstr "" "Si *format* ne nécessite qu'un seul argument, *values* peut être un objet " "unique. [5]_ Si *values* est un *n*-uplet, il doit contenir exactement le " "nombre d'éléments spécifiés dans le format en *bytes*, ou un seul objet de " "correspondances ( *mapping object*, par exemple, un dictionnaire)." #: library/stdtypes.rst:3545 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the bytes object *must* include a parenthesised mapping key into " "that dictionary inserted immediately after the ``'%'`` character. The " "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" "Lorsque l'argument de droite est un dictionnaire (ou un autre type de " "*mapping*), les marqueurs dans le *bytes* *doivent* inclure une clé présente " "dans le dictionnaire, écrite entre parenthèses, immédiatement après le " "caractère ``'%'``. La clé indique quelle valeur du dictionnaire doit être " "formatée. Par exemple :" #: library/stdtypes.rst:3619 msgid "Single byte (accepts integer or single byte objects)." msgstr "Octet simple (Accepte un nombre entier ou un seul objet *byte*)." #: library/stdtypes.rst:3622 msgid "``'b'``" msgstr "``'b'``" #: library/stdtypes.rst:3622 msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " "has :meth:`__bytes__`)." msgstr "" "*Bytes* (tout objet respectant le :ref:`buffer protocol ` ou " "ayant la méthode :meth:`__bytes__`)." #: library/stdtypes.rst:3626 msgid "" "``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " "bases." msgstr "" "``'s'`` est un alias de ``'b'`` et ne devrait être utilisé que pour du code " "Python2/3." #: library/stdtypes.rst:3629 msgid "" "Bytes (converts any Python object using ``repr(obj).encode('ascii', " "'backslashreplace')``)." msgstr "" "*Bytes* (convertit n'importe quel objet Python en utilisant ``repr(obj)." "encode('ascii', 'backslashreplace)``)." #: library/stdtypes.rst:3632 msgid "" "``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " "bases." msgstr "" "``'r'`` est un alias de ``'a'`` et ne devrait être utilise que dans du code " "Python2/3." #: library/stdtypes.rst:3632 msgid "\\(7)" msgstr "\\(7)" #: library/stdtypes.rst:3667 msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "``b'%s'`` est obsolète, mais ne sera pas retiré des version 3.x." #: library/stdtypes.rst:3670 msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." msgstr "``b'%r'`` est obsolète mais ne sera pas retiré dans Python 3.x." #: library/stdtypes.rst:3682 msgid ":pep:`461` - Adding % formatting to bytes and bytearray" msgstr ":pep:`461` -- Ajout du formatage via % aux *bytes* et *bytesarray*" #: library/stdtypes.rst:3689 msgid "Memory Views" msgstr "Vues mémoire" #: library/stdtypes.rst:3691 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the :ref:`buffer protocol ` without " "copying." msgstr "" "Les :class:`vues mémoire ` permettent à du code Python d'accéder " "sans copie aux données internes d'un objet prenant en charge le :ref:" "`protocole tampon `." #: library/stdtypes.rst:3697 msgid "" "Create a :class:`memoryview` that references *object*. *object* must " "support the buffer protocol. Built-in objects that support the buffer " "protocol include :class:`bytes` and :class:`bytearray`." msgstr "" "Crée une :class:`vue mémoire ` faisant référence à *object*. " "*object* doit savoir gérer le protocole tampon. :class:`bytes` et :class:" "`bytearray` sont des classes natives prenant en charge le protocole tampon." #: library/stdtypes.rst:3701 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating *object*. For many simple types such " "as :class:`bytes` and :class:`bytearray`, an element is a single byte, but " "other types such as :class:`array.array` may have bigger elements." msgstr "" "Une :class:`vue mémoire ` a la notion d'*élement*, qui est " "l'unité de mémoire atomique gérée par l'objet *object* d'origine. Pour de " "nombreux types simples comme :class:`bytes` et :class:`bytearray`, l'élément " "est l'octet, mais pour d'autres types tels que :class:`array.array` les " "éléments peuvent être plus grands." #: library/stdtypes.rst:3706 msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`. If " "``view.ndim = 0``, the length is 1. If ``view.ndim = 1``, the length is " "equal to the number of elements in the view. For higher dimensions, the " "length is equal to the length of the nested list representation of the view. " "The :class:`~memoryview.itemsize` attribute will give you the number of " "bytes in a single element." msgstr "" "``len(view)`` est égal à la grandeur de :class:`~memoryview.tolist`. Si " "``view.ndim = 0``, la longueur vaut 1. Si ``view.ndim = 1``, la longueur est " "égale au nombre d'éléments de la vue. Pour les dimensions plus grandes, la " "longueur est égale à la longueur de la sous-liste représentée par la vue. " "L'attribut :class:`~memoryview.itemsize` vous renvoie la taille en octets " "d'un élément." #: library/stdtypes.rst:3713 msgid "" "A :class:`memoryview` supports slicing and indexing to expose its data. One-" "dimensional slicing will result in a subview::" msgstr "" "Une :class:`vue mémoire ` autorise le découpage et l'indiçage de " "ses données. Découper sur une dimension donne une sous-vue ::" #: library/stdtypes.rst:3726 msgid "" "If :class:`~memoryview.format` is one of the native format specifiers from " "the :mod:`struct` module, indexing with an integer or a tuple of integers is " "also supported and returns a single *element* with the correct type. One-" "dimensional memoryviews can be indexed with an integer or a one-integer " "tuple. Multi-dimensional memoryviews can be indexed with tuples of exactly " "*ndim* integers where *ndim* is the number of dimensions. Zero-dimensional " "memoryviews can be indexed with the empty tuple." msgstr "" "Si le :class:`~memoryview.format` est un des formats natif du module :mod:" "`struct`, indexer avec un nombre entier ou un *n*-uplet de nombres entiers " "est aussi autorisé et renvoie un seul *element* du bon type. Les " "*memoryview* à une dimension peuvent être indexées avec un nombre entier ou " "un *n*-uplet d'un entier. Les *memoryview* multi-dimensionnelles peuvent " "être indexées avec des *ndim*-uplets où *ndim* est le nombre de dimensions. " "Les *memoryviews* à zéro dimension peuvent être indexées avec un *n*-uplet " "vide." #: library/stdtypes.rst:3735 msgid "Here is an example with a non-byte format::" msgstr "Voici un exemple avec un autre format que *byte* ::" #: library/stdtypes.rst:3747 msgid "" "If the underlying object is writable, the memoryview supports one-" "dimensional slice assignment. Resizing is not allowed::" msgstr "" "Si l'objet sous-jacent est accessible en écriture, la vue mémoire autorise " "les assignations de tranches à une dimension. Redimensionner n'est cependant " "pas autorisé ::" #: library/stdtypes.rst:3768 msgid "" "One-dimensional memoryviews of hashable (read-only) types with formats 'B', " "'b' or 'c' are also hashable. The hash is defined as ``hash(m) == hash(m." "tobytes())``::" msgstr "" "Les vues mémoire à une dimension de types hachables (lecture seule) avec les " "formats 'B', 'b', ou 'c' sont aussi hachables. La fonction de hachage est " "définie telle que ``hash(m) == hash(m.tobytes())`` ::" #: library/stdtypes.rst:3780 msgid "" "One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " "with formats 'B', 'b' or 'c' are now hashable." msgstr "" "les vues mémoire à une dimension peuvent aussi être découpées. Les vues " "mémoire à une dimension avec les formats 'B', 'b', ou 'c' sont maintenant " "hachables." #: library/stdtypes.rst:3784 msgid "" "memoryview is now registered automatically with :class:`collections.abc." "Sequence`" msgstr "" "*memoryview* est maintenant enregistrée automatiquement avec :class:" "`collections.abc.Sequence`" #: library/stdtypes.rst:3788 msgid "memoryviews can now be indexed with tuple of integers." msgstr "" "les vues mémoire peuvent maintenant être indicées par un *n*-uplet d'entiers." #: library/stdtypes.rst:3791 msgid ":class:`memoryview` has several methods:" msgstr "" "La classe :class:`vue mémoire ` dispose de plusieurs méthodes :" #: library/stdtypes.rst:3795 msgid "" "A memoryview and a :pep:`3118` exporter are equal if their shapes are " "equivalent and if all corresponding values are equal when the operands' " "respective format codes are interpreted using :mod:`struct` syntax." msgstr "" "Une vue mémoire et un *exporter* de la :pep:`3118` sont égaux si leurs " "formes sont équivalentes et si toutes les valeurs correspondantes sont " "égales, les formats respectifs des opérandes étant interprétés en utilisant " "la syntaxe de :mod:`struct`." #: library/stdtypes.rst:3799 msgid "" "For the subset of :mod:`struct` format strings currently supported by :meth:" "`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" msgstr "" "Pour le sous-ensemble des formats de :mod:`struct` pris en charge par :meth:" "`tolist`, ``v`` et ``w`` sont égaux si ``v.tolist() ==w.tolist()`` ::" #: library/stdtypes.rst:3818 msgid "" "If either format string is not supported by the :mod:`struct` module, then " "the objects will always compare as unequal (even if the format strings and " "buffer contents are identical)::" msgstr "" "Si l'un des format n'est pas géré par le module de :mod:`struct`, les objets " "sont toujours considérés différents (même si les formats et les valeurs " "contenues sont identiques) ::" #: library/stdtypes.rst:3834 msgid "" "Note that, as with floating point numbers, ``v is w`` does *not* imply ``v " "== w`` for memoryview objects." msgstr "" "Notez que pour les vues mémoire, comme pour les nombres à virgule flottante, " "``v is w`` *n'implique pas* ``v == w``." # suit un : #: library/stdtypes.rst:3837 msgid "" "Previous versions compared the raw memory disregarding the item format and " "the logical array structure." msgstr "" "les versions précédentes comparaient la mémoire brute sans tenir compte du " "format de l'objet ni de sa structure logique." #: library/stdtypes.rst:3843 msgid "" "Return the data in the buffer as a bytestring. This is equivalent to " "calling the :class:`bytes` constructor on the memoryview. ::" msgstr "" "Renvoie les données de la vue mémoire sous forme de *bytes*. Cela équivaut " "à appeler le constructeur :class:`bytes` sur la vue mémoire. ::" #: library/stdtypes.rst:3852 msgid "" "For non-contiguous arrays the result is equal to the flattened list " "representation with all elements converted to bytes. :meth:`tobytes` " "supports all format strings, including those that are not in :mod:`struct` " "module syntax." msgstr "" "Pour les tableaux non contigus le résultat est égal à la représentation en " "liste aplatie dont tous les éléments sont convertis en octets. :meth:" "`tobytes` prend en charge toutes les chaînes de format, y compris celles qui " "ne sont pas connues du module :mod:`struct`." #: library/stdtypes.rst:3857 msgid "" "*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " "original array is converted to C or Fortran order. For contiguous views, 'A' " "returns an exact copy of the physical memory. In particular, in-memory " "Fortran order is preserved. For non-contiguous views, the data is converted " "to C first. *order=None* is the same as *order='C'*." msgstr "" "*order* peut être ``'C'``, ``'F'`` ou ``'A'``. Lorsque *order* est ``'C'`` " "ou ``'F'``, les données du tableau original sont converties en ordre C ou " "Fortran. Pour les vues contiguës, ``'A'`` renvoie une copie exacte de la " "mémoire physique. En particulier, l'ordre Fortran en mémoire est conservé. " "Pour les vues non contiguës, les données sont d'abord converties en C. " "``order=None`` est identique à ``order='C'``." #: library/stdtypes.rst:3866 msgid "" "Return a string object containing two hexadecimal digits for each byte in " "the buffer. ::" msgstr "" "Renvoie une chaîne contenant deux chiffres hexadécimaux pour chaque octet de " "la mémoire. ::" # suit un : #: library/stdtypes.rst:3875 msgid "" "Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " "*sep* and *bytes_per_sep* parameters to insert separators between bytes in " "the hex output." msgstr "" "similaire à :meth:`bytes.hex`, :meth:`memoryview.hex` prend désormais en " "charge les paramètres optionnels *sep* et *bytes_per_sep* pour insérer des " "séparateurs entre les octets dans la sortie hexadécimale." #: library/stdtypes.rst:3882 msgid "Return the data in the buffer as a list of elements. ::" msgstr "" "Renvoie les données de la mémoire sous la forme d'une liste d'éléments. ::" #: library/stdtypes.rst:3892 msgid "" ":meth:`tolist` now supports all single character native formats in :mod:" "`struct` module syntax as well as multi-dimensional representations." msgstr "" ":meth:`tolist` prend désormais en charge tous les formats d'un caractère du " "module :mod:`struct` ainsi que des représentations multidimensionnelles." #: library/stdtypes.rst:3899 msgid "" "Return a readonly version of the memoryview object. The original memoryview " "object is unchanged. ::" msgstr "" "Renvoie une version en lecture seule de l'objet *memoryview*. L'objet " "original *memoryview* est inchangé. ::" #: library/stdtypes.rst:3918 msgid "" "Release the underlying buffer exposed by the memoryview object. Many " "objects take special actions when a view is held on them (for example, a :" "class:`bytearray` would temporarily forbid resizing); therefore, calling " "release() is handy to remove these restrictions (and free any dangling " "resources) as soon as possible." msgstr "" "Libère le tampon sous-jacent exposé par l'objet *memoryview*. Beaucoup " "d'objets ont des comportements spécifiques lorsqu'ils sont liés à une vue " "(par exemple, un :class:`bytearray` refusera temporairement de se faire " "redimensionner). Par conséquent, appeler *release()* peut être pratique pour " "lever ces restrictions (et libérer des ressources liées) aussi tôt que " "possible." #: library/stdtypes.rst:3924 msgid "" "After this method has been called, any further operation on the view raises " "a :class:`ValueError` (except :meth:`release()` itself which can be called " "multiple times)::" msgstr "" "Après le premier appel de cette méthode, toute nouvelle opération sur la " "vue mémoire lève une :class:`ValueError` (sauf :meth:`release()` elle-même " "qui peut être appelée plusieurs fois) ::" #: library/stdtypes.rst:3935 msgid "" "The context management protocol can be used for a similar effect, using the " "``with`` statement::" msgstr "" "Le protocole de gestion de contexte peut être utilisé pour obtenir un effet " "similaire, via l'instruction ``with`` ::" #: library/stdtypes.rst:3951 msgid "" "Cast a memoryview to a new format or shape. *shape* defaults to " "``[byte_length//new_itemsize]``, which means that the result view will be " "one-dimensional. The return value is a new memoryview, but the buffer itself " "is not copied. Supported casts are 1D -> C-:term:`contiguous` and C-" "contiguous -> 1D." msgstr "" "Change le format ou la forme d'une vue mémoire. Par défaut *shape* vaut " "``[byte_length//new_itemsize]``, ce qui signifie que la vue résultante n'a " "qu'une dimension. La valeur renvoyée est une nouvelle vue mémoire, mais le " "tampon sous-jacent lui-même n'est pas copié. Les changements de format pris " "en charge sont « une dimension vers C-:term:`contiguous` » et « *C-" "contiguous* vers une dimension »." #: library/stdtypes.rst:3957 msgid "" "The destination format is restricted to a single element native format in :" "mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " "'c'). The byte length of the result must be the same as the original length." msgstr "" "Le format de destination est limité à un seul élément natif de la syntaxe du " "module :mod:`struct`. L'un des formats doit être un *byte* ('B', 'b', ou " "'c'). La longueur du résultat en octets doit être la même que la longueur " "initiale." #: library/stdtypes.rst:3962 msgid "Cast 1D/long to 1D/unsigned bytes::" msgstr "Transformer un *1D/long* en *1D/unsigned bytes* ::" #: library/stdtypes.rst:3985 msgid "Cast 1D/unsigned bytes to 1D/char::" msgstr "Transformer un *1D/unsigned bytes* en *1D/char* ::" #: library/stdtypes.rst:3998 msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" msgstr "Transformer un *1D/bytes* en *3D/ints* en *1D/signed char* ::" #: library/stdtypes.rst:4024 msgid "Cast 1D/unsigned long to 2D/unsigned long::" msgstr "Transformer un *1D/unsigned char* en *2D/unsigned long* ::" # suit un : #: library/stdtypes.rst:4038 msgid "The source format is no longer restricted when casting to a byte view." msgstr "" "le format de la source n'est plus restreint lors de la transformation vers " "une vue d'octets." #: library/stdtypes.rst:4041 msgid "There are also several readonly attributes available:" msgstr "Plusieurs attributs en lecture seule sont également disponibles :" #: library/stdtypes.rst:4045 msgid "The underlying object of the memoryview::" msgstr "L'objet sous-jacent de la vue mémoire ::" #: library/stdtypes.rst:4056 msgid "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " "amount of space in bytes that the array would use in a contiguous " "representation. It is not necessarily equal to ``len(m)``::" msgstr "" "``nbytes == product(shape) * itemsize == len(m.tobytes())``. C'est l'espace " "que la liste occuperait en octets, dans une représentation contiguë. Ce " "n'est pas nécessairement égal à ``len(m)`` ::" #: library/stdtypes.rst:4075 msgid "Multi-dimensional arrays::" msgstr "Tableaux multidimensionnels ::" #: library/stdtypes.rst:4092 msgid "A bool indicating whether the memory is read only." msgstr "Booléen indiquant si la mémoire est en lecture seule." #: library/stdtypes.rst:4096 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. A memoryview can be created from exporters with " "arbitrary format strings, but some methods (e.g. :meth:`tolist`) are " "restricted to native single element formats." msgstr "" "Chaîne contenant le format (dans le style de :mod:`struct`) pour chaque " "élément de la vue. Une vue mémoire peut être créée depuis des exportateurs " "de formats arbitraires, mais certaines méthodes (comme :meth:`tolist`) sont " "limitées aux formats natifs à un seul élément." #: library/stdtypes.rst:4101 msgid "" "format ``'B'`` is now handled according to the struct module syntax. This " "means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." msgstr "" "le format ``'B'`` est maintenant traité selon la syntaxe du module *struct*. " "Cela signifie que ``memoryview(b'abc')[0] == b'abc'[0] == 97``." #: library/stdtypes.rst:4107 msgid "The size in bytes of each element of the memoryview::" msgstr "Taille en octets de chaque élément de la vue mémoire ::" #: library/stdtypes.rst:4120 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" "Nombre de dimensions du tableau multi-dimensionnel pointé par la vue mémoire." #: library/stdtypes.rst:4125 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as an N-dimensional array." msgstr "" ":attr:`ndim`-uplet d'entiers donnant la forme du tableau à N dimensions " "pointé par la vue mémoire." # suit un : #: library/stdtypes.rst:4136 msgid "An empty tuple instead of ``None`` when ndim = 0." msgstr "le *n*-uplet est vide au lieu de ``None`` lorsque *ndim* = 0." #: library/stdtypes.rst:4133 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" ":attr:`ndim`-uplet d'entiers donnant la taille en octets permettant " "d'accéder à chaque élément pour chaque dimension du tableau." #: library/stdtypes.rst:4141 msgid "Used internally for PIL-style arrays. The value is informational only." msgstr "" "Détail de l'implémentation des *PIL-style arrays*. La valeur n'est donnée " "qu'à titre d'information." #: library/stdtypes.rst:4145 msgid "A bool indicating whether the memory is C-:term:`contiguous`." msgstr "Booléen indiquant si la mémoire est C-:term:`contiguë `." #: library/stdtypes.rst:4151 msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." msgstr "" "Booléen indiquant si la mémoire est Fortran-:term:`contiguë `." #: library/stdtypes.rst:4157 msgid "A bool indicating whether the memory is :term:`contiguous`." msgstr "Booléen indiquant si la mémoire est :term:`contiguë `." #: library/stdtypes.rst:4165 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "Types d'ensembles — :class:`set`, :class:`frozenset`" #: library/stdtypes.rst:4169 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " "sequence, and computing mathematical operations such as intersection, union, " "difference, and symmetric difference. (For other containers see the built-" "in :class:`dict`, :class:`list`, and :class:`tuple` classes, and the :mod:" "`collections` module.)" msgstr "" "Un ensemble (objet :dfn:`set`) est une collection non triée d'objets :term:" "`hachables ` distincts. Les utilisations classiques sont le test " "d'appartenance, la déduplication d'une séquence, ou le calcul d'opérations " "mathématiques telles que l'intersection, l'union, la différence, ou la " "différence symétrique. (Pour les autres conteneurs, voir les classes " "natives :class:`dict`, :class:`liste `, et :class:`n-uplet `, " "ainsi que le module :mod:`collections`.)" #: library/stdtypes.rst:4176 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " "position or order of insertion. Accordingly, sets do not support indexing, " "slicing, or other sequence-like behavior." msgstr "" "Comme pour les autres collections, les ensembles gèrent ``x in set``, " "``len(set)``, et ``for x in set``. En tant que collection non triée, les " "ensembles n'enregistrent pas la position des éléments ou leur ordre " "d'insertion. En conséquence, les ensembles n'autorisent ni l'indexation, ni " "le découpage, ou tout autre comportement de séquence." #: library/stdtypes.rst:4181 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " "changed using methods like :meth:`~set.add` and :meth:`~set.remove`. Since " "it is mutable, it has no hash value and cannot be used as either a " "dictionary key or as an element of another set. The :class:`frozenset` type " "is immutable and :term:`hashable` --- its contents cannot be altered after " "it is created; it can therefore be used as a dictionary key or as an element " "of another set." msgstr "" "Il existe actuellement deux types natifs pour les ensembles, :class:`set` " "et :class:`frozenset`. Le type :class:`set` est muable — son contenu peut " "changer en utilisant des méthodes comme :meth:`~set.add` et :meth:`~set." "remove`. Puisqu'il est muable, il n'a pas de valeur de hachage et ne peut " "donc pas être utilisé ni comme clé de dictionnaire ni comme élément d'un " "autre ensemble. Le type :class:`frozenset` est immuable et :term:`hashable` " "— son contenu ne peut être modifié après sa création, il peut ainsi être " "utilisé comme clé de dictionnaire ou élément d'un autre ensemble." #: library/stdtypes.rst:4189 msgid "" "Non-empty sets (not frozensets) can be created by placing a comma-separated " "list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " "addition to the :class:`set` constructor." msgstr "" "Des *sets* (mais pas des *frozensets*) peuvent être créés par une liste " "d'éléments séparés par des virgules et entre accolades, par exemple " "``{'jack', 'sjoerd'}``, en plus du constructeur de la classe :class:`set`." #: library/stdtypes.rst:4193 msgid "The constructors for both classes work the same:" msgstr "Les constructeurs des deux classes fonctionnent de la même manière :" #: library/stdtypes.rst:4198 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " "sets of sets, the inner sets must be :class:`frozenset` objects. If " "*iterable* is not specified, a new empty set is returned." msgstr "" "Renvoie un nouvel ensemble (*set* ou *frozenset*) dont les éléments viennent " "d'*iterable*. Les éléments d'un *set* doivent être :term:`hachables " "`. Pour représenter des ensembles d'ensembles, les ensembles " "intérieurs doivent être des :class:`frozenset`. Si *iterable* n'est pas " "spécifié, un nouvel ensemble vide est renvoyé." #: library/stdtypes.rst:4204 msgid "Sets can be created by several means:" msgstr "Les ensembles peuvent être construits de différentes manières :" # énumération #: library/stdtypes.rst:4206 msgid "" "Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" msgstr "" "en utilisant une liste d'éléments séparés par des virgules entre accolades : " "``{'jack', 'sjoerd'}`` ;" # énumération #: library/stdtypes.rst:4207 msgid "" "Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" msgstr "" "en utilisant un ensemble en compréhension : ``{c for c in 'abracadabra' if c " "not in 'abc'}`` ;" # énumération #: library/stdtypes.rst:4208 msgid "" "Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " "'foo'])``" msgstr "" "en utilisant le constructeur du type : ``set()``, ``set('foobar')``, " "``set(['a', 'b', 'foo'])``." #: library/stdtypes.rst:4210 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" "Les instances de :class:`set` et :class:`frozenset` fournissent les " "opérations suivantes :" #: library/stdtypes.rst:4215 msgid "Return the number of elements in set *s* (cardinality of *s*)." msgstr "Renvoie le nombre d'éléments dans l'ensemble *s* (cardinalité de *s*)." #: library/stdtypes.rst:4219 msgid "Test *x* for membership in *s*." msgstr "Test d'appartenance de *x* dans *s*." #: library/stdtypes.rst:4223 msgid "Test *x* for non-membership in *s*." msgstr "Test de non-appartenance de *x* dans *s*." #: library/stdtypes.rst:4227 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." msgstr "" "Renvoie ``True`` si l'ensemble n'a aucun élément en commun avec *other*. " "Les ensembles sont disjoints si et seulement si leurs intersection est un " "ensemble vide." #: library/stdtypes.rst:4233 msgid "Test whether every element in the set is in *other*." msgstr "Teste si tous les éléments de l'ensemble sont dans *other*." #: library/stdtypes.rst:4237 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." msgstr "" "Teste si l'ensemble est un sous-ensemble propre de *other*, c'est-à-dire " "``set <= other and set != other``." #: library/stdtypes.rst:4243 msgid "Test whether every element in *other* is in the set." msgstr "Teste si tous les éléments de *other* sont dans l'ensemble." #: library/stdtypes.rst:4247 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." msgstr "" "Teste si l'ensemble est un sur-ensemble propre de *other*, c'est-à-dire, " "``set >= other and set != other``." #: library/stdtypes.rst:4253 msgid "Return a new set with elements from the set and all others." msgstr "" "Renvoie un nouvel ensemble dont les éléments viennent de l'ensemble et de " "tous les autres (*others*)." #: library/stdtypes.rst:4258 msgid "Return a new set with elements common to the set and all others." msgstr "" "Renvoie un nouvel ensemble dont les éléments sont communs à l'ensemble et à " "tous les autres (*others*)." #: library/stdtypes.rst:4263 msgid "Return a new set with elements in the set that are not in the others." msgstr "" "Renvoie un nouvel ensemble dont les éléments sont dans l'ensemble mais ne " "sont dans aucun des autres." #: library/stdtypes.rst:4268 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" "Renvoie un nouvel ensemble dont les éléments sont soit dans l'ensemble, soit " "dans *other*, mais pas dans les deux." #: library/stdtypes.rst:4272 msgid "Return a shallow copy of the set." msgstr "Renvoie une copie superficielle du dictionnaire." #: library/stdtypes.rst:4275 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" "`issuperset` methods will accept any iterable as an argument. In contrast, " "their operator based counterparts require their arguments to be sets. This " "precludes error-prone constructions like ``set('abc') & 'cbs'`` in favor of " "the more readable ``set('abc').intersection('cbs')``." msgstr "" "Remarque : les méthodes :meth:`union`, :meth:`intersection`, :meth:" "`difference`, :meth:`symmetric_difference`, :meth:`issubset` et :meth:" "`issuperset` acceptent n'importe quel itérable comme argument, contrairement " "aux opérateurs équivalents qui n'acceptent que des ensembles. Il est donc " "préférable d'éviter les constructions comme ``set('abc') & 'cbs'``, sources " "typiques d'erreurs, en faveur d'une construction plus lisible : ``set('abc')." "intersection('cbs')``." #: library/stdtypes.rst:4282 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " "other (each is a subset of the other). A set is less than another set if and " "only if the first set is a proper subset of the second set (is a subset, but " "is not equal). A set is greater than another set if and only if the first " "set is a proper superset of the second set (is a superset, but is not equal)." msgstr "" "Les classes :class:`set` et :class:`frozenset` gèrent les comparaisons " "d'ensemble à ensemble. Deux ensembles sont égaux si et seulement si chaque " "élément de chaque ensemble est contenu dans l'autre (autrement dit que " "chaque ensemble est un sous-ensemble de l'autre). Un ensemble est plus petit " "qu'un autre ensemble si et seulement si le premier est un sous-ensemble " "propre du second (un sous-ensemble, mais pas égal). Un ensemble est plus " "grand qu'un autre ensemble si et seulement si le premier est un sur-ensemble " "propre du second (est un sur-ensemble mais n'est pas égal)." #: library/stdtypes.rst:4289 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " "returns ``True`` and so does ``set('abc') in set([frozenset('abc')])``." msgstr "" "Les instances de :class:`set` se comparent aux instances de :class:" "`frozenset` en fonction de leurs membres. Par exemple, ``set('abc') == " "frozenset('abc')`` envoie ``True``, ainsi que ``set('abc') in " "set([frozenset('abc')])``." #: library/stdtypes.rst:4293 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two nonempty disjoint sets are not equal and are " "not subsets of each other, so *all* of the following return ``False``: " "``ab``." msgstr "" "Les tests de sous-ensemble et d'égalité ne se généralisent pas pour former " "une fonction donnant un ordre total. Par exemple, deux ensembles disjoints " "non vides ne sont ni égaux et ni des sous-ensembles l'un de l'autre, donc " "toutes ces comparaisons donnent ``False`` : ``ab``." #: library/stdtypes.rst:4298 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." msgstr "" "Puisque les ensembles ne définissent qu'un ordre partiel (par leurs " "relations de sous-ensembles), la sortie de la méthode :meth:`list.sort` " "n'est pas définie pour des listes d'ensembles." #: library/stdtypes.rst:4301 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "" "Les éléments des ensembles, comme les clés de dictionnaires, doivent être :" "term:`hachables `." #: library/stdtypes.rst:4303 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " "set('bc')`` returns an instance of :class:`frozenset`." msgstr "" "Les opérations binaires mélangeant des instances de :class:`set` et :class:" "`frozenset` renvoient le type de la première opérande. Par exemple, " "``frozenset('ab') | set('bc')`` renvoie une instance de :class:`frozenset`." #: library/stdtypes.rst:4307 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" msgstr "" "La table suivante liste les opérations disponibles pour les :class:`set` " "mais qui ne s'appliquent pas aux instances de :class:`frozenset` :" #: library/stdtypes.rst:4313 msgid "Update the set, adding elements from all others." msgstr "" "Met à jour l'ensemble, ajoutant les éléments de tous les autres (*others*)." #: library/stdtypes.rst:4318 msgid "Update the set, keeping only elements found in it and all others." msgstr "" "Met à jour l'ensemble, ne gardant que les éléments trouvés dans tous les " "autres." #: library/stdtypes.rst:4323 msgid "Update the set, removing elements found in others." msgstr "Met à jour l'ensemble, retirant les éléments trouvés dans les autres." #: library/stdtypes.rst:4328 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" "Met à jour l'ensemble, ne gardant que les éléments trouvés dans un des deux " "ensembles mais pas dans les deux." #: library/stdtypes.rst:4332 msgid "Add element *elem* to the set." msgstr "Ajoute l'élément *elem* à l'ensemble." #: library/stdtypes.rst:4336 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." msgstr "" "Retire l'élément *elem* de l'ensemble. Lève une exception :exc:`KeyError` si " "*elem* n'est pas dans l'ensemble." #: library/stdtypes.rst:4341 msgid "Remove element *elem* from the set if it is present." msgstr "Retire l'élément *elem* de l'ensemble s'il y est." #: library/stdtypes.rst:4345 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." msgstr "" "Retire et renvoie un élément arbitraire de l'ensemble. Lève une exception :" "exc:`KeyError` si l'ensemble est vide." #: library/stdtypes.rst:4350 msgid "Remove all elements from the set." msgstr "Supprime tous les éléments de l'ensemble." #: library/stdtypes.rst:4353 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" "`symmetric_difference_update` methods will accept any iterable as an " "argument." msgstr "" "Notez que les versions n'utilisant pas la syntaxe d'opérateur des méthodes :" "meth:`update`, :meth:`intersection_update`, :meth:`difference_update`, et :" "meth:`symmetric_difference_update` acceptent n'importe quel itérable comme " "argument." #: library/stdtypes.rst:4358 msgid "" "Note, the *elem* argument to the :meth:`__contains__`, :meth:`remove`, and :" "meth:`discard` methods may be a set. To support searching for an equivalent " "frozenset, a temporary one is created from *elem*." msgstr "" "Notez que l'argument *elem* des méthodes :meth:`__contains__`, :meth:" "`remove` et :meth:`discard` peut être un ensemble (*set*). Pour effectuer la " "recherche d'un *frozenset* équivalent, un *frozenset* temporaire est crée " "depuis *elem*." #: library/stdtypes.rst:4366 msgid "Mapping Types --- :class:`dict`" msgstr "Les types de correspondances — :class:`dict`" #: library/stdtypes.rst:4376 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " "type, the :dfn:`dictionary`. (For other containers see the built-in :class:" "`list`, :class:`set`, and :class:`tuple` classes, and the :mod:`collections` " "module.)" msgstr "" "Un objet :term:`tableau de correspondances ` (*mapping*) fait " "correspondre des valeurs :term:`hachables ` à des objets " "arbitraires. Les tableaux de correspondances sont des objets muables. Il " "n'existe pour le moment qu'un type de tableau de correspondances standard, " "le :dfn:`dictionary`. (Pour les autres conteneurs, voir les types natifs :" "class:`liste `, :class:`ensemble ` et :class:`n-uplet `, " "ainsi que le module :mod:`collections`.)" #: library/stdtypes.rst:4382 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " "mutable types (that are compared by value rather than by object identity) " "may not be used as keys. Values that compare equal (such as ``1``, ``1.0``, " "and ``True``) can be used interchangeably to index the same dictionary entry." msgstr "" "Les clés d'un dictionnaire sont *presque* des données arbitraires. Les " "valeurs qui ne sont pas :term:`hachables `, c'est-à-dire les " "valeurs contenant des listes, dictionnaires ou autres types muables (qui " "sont comparés à l'aide de leurs valeurs plutôt que par l'identité de " "l'objet) ne peuvent pas être utilisées comme clés. Des valeurs qui sont " "considérées égales lors d'une comparaison (comme ``1``, ``1.0`` et ``True``) " "peuvent être utilisées pour obtenir la même entrée d'un dictionnaire." #: library/stdtypes.rst:4393 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." msgstr "" "Renvoie un nouveau dictionnaire initialisé à partir d'un argument " "positionnel optionnel, et un ensemble (vide ou non) d'arguments nommés." #: library/stdtypes.rst:4396 msgid "Dictionaries can be created by several means:" msgstr "Les dictionnaires peuvent être construits de différentes manières :" # énumération #: library/stdtypes.rst:4398 msgid "" "Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " "4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" msgstr "" "en utilisant une liste de paires ``clé: valeur`` séparées par des virgules " "entre accolades : ``{'jack': 4098, 'sjoerd': 4127}`` ou ``{4098: 'jack', " "4127: 'sjoerd'}`` ;" # énumération #: library/stdtypes.rst:4400 msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" msgstr "" "en utilisant un dictionnaire en compréhension : ``{}``, ``{x: x ** 2 for x " "in range(10)}`` ;" # fin d'énumération #: library/stdtypes.rst:4401 msgid "" "Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " "200)])``, ``dict(foo=100, bar=200)``" msgstr "" "en utilisant le constructeur du type : ``dict()``, ``dict([('foo', 100), " "('bar', 200)])``, ``dict(foo=100, bar=200)``." #: library/stdtypes.rst:4404 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " "created with the same key-value pairs as the mapping object. Otherwise, the " "positional argument must be an :term:`iterable` object. Each item in the " "iterable must itself be an iterable with exactly two objects. The first " "object of each item becomes a key in the new dictionary, and the second " "object the corresponding value. If a key occurs more than once, the last " "value for that key becomes the corresponding value in the new dictionary." msgstr "" "Si aucun argument positionnel n'est donné, un dictionnaire vide est crée. Si " "un argument positionnel est donné et est un *mapping object*, un " "dictionnaire est crée avec les mêmes paires de clé-valeur que le *mapping* " "donné. Autrement, l'argument positionnel doit être un objet :term:`itérable " "`. Chaque élément de cet itérable doit lui même être un itérable " "contenant exactement deux objets. Le premier objet de chaque élément " "devient une clé du nouveau dictionnaire, et le second devient sa valeur " "correspondante. Si une clé apparaît plus d'une fois, la dernière valeur " "pour cette clé devient la valeur correspondante à cette clé dans le nouveau " "dictionnaire." #: library/stdtypes.rst:4414 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " "being added is already present, the value from the keyword argument replaces " "the value from the positional argument." msgstr "" "Si des arguments nommés sont donnés, ils sont ajoutés au dictionnaire créé " "depuis l'argument positionnel. Si une clé est déjà présente, la valeur de " "l'argument nommé remplace la valeur reçue par l'argument positionnel." #: library/stdtypes.rst:4419 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" "Typiquement, les exemples suivants renvoient tous un dictionnaire valant " "``{\"one\": 1, \"two\": 2, \"three\": 3}`` ::" #: library/stdtypes.rst:4431 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" "Fournir les arguments nommés comme dans le premier exemple ne fonctionne que " "pour des clés qui sont des identifiants valides en Python. Dans les autres " "cas, toutes les clés valides sont utilisables." #: library/stdtypes.rst:4435 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" "Voici les opérations gérées par les dictionnaires (par conséquent, d'autres " "types de tableaux de correspondances devraient les gérer aussi) :" #: library/stdtypes.rst:4440 msgid "Return a list of all the keys used in the dictionary *d*." msgstr "" "Renvoie une liste de toutes les clés utilisées dans le dictionnaire *d*." #: library/stdtypes.rst:4444 msgid "Return the number of items in the dictionary *d*." msgstr "Renvoie le nombre d'éléments dans le dictionnaire *d*." #: library/stdtypes.rst:4448 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" "Renvoie l'élément de *d* dont la clé est *key*. Lève une exception :exc:" "`KeyError` si *key* n'est pas dans le dictionnaire." #: library/stdtypes.rst:4453 msgid "" "If a subclass of dict defines a method :meth:`__missing__` and *key* is not " "present, the ``d[key]`` operation calls that method with the key *key* as " "argument. The ``d[key]`` operation then returns or raises whatever is " "returned or raised by the ``__missing__(key)`` call. No other operations or " "methods invoke :meth:`__missing__`. If :meth:`__missing__` is not defined, :" "exc:`KeyError` is raised. :meth:`__missing__` must be a method; it cannot be " "an instance variable::" msgstr "" "Si une sous-classe de *dict* définit une méthode :meth:`__missing__` et que " "*key* manque, l'opération ``d[key]`` appelle cette méthode avec la clé *key* " "en argument. L'opération ``d[key]`` renvoie la valeur, ou lève l'exception " "renvoyée ou levée par l'appel à ``__missing__(key)``. Aucune autre opération " "ni méthode n'appelle :meth:`__missing__`. Si :meth:`__missing__` n'est pas " "définie, une exception :exc:`KeyError` est levée. :meth:`__missing__` doit " "être une méthode ; ça ne peut pas être une variable d'instance ::" #: library/stdtypes.rst:4471 msgid "" "The example above shows part of the implementation of :class:`collections." "Counter`. A different ``__missing__`` method is used by :class:`collections." "defaultdict`." msgstr "" "L'exemple ci-dessus montre une partie de l'implémentation de :class:" "`collections.Counter`. :class:`collections.defaultdict` implémente aussi " "``__missing__``." #: library/stdtypes.rst:4477 msgid "Set ``d[key]`` to *value*." msgstr "Assigne ``d[key]`` à *value*." #: library/stdtypes.rst:4481 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" "Supprime ``d[key]`` de *d*. Lève une exception :exc:`KeyError` si *key* " "n'est pas dans le dictionnaire." #: library/stdtypes.rst:4486 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "Renvoie ``True`` si *d* a la clé *key*, sinon ``False``." #: library/stdtypes.rst:4490 msgid "Equivalent to ``not key in d``." msgstr "Équivalent à ``not key in d``." #: library/stdtypes.rst:4494 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for " "``iter(d.keys())``." msgstr "" "Renvoie un itérateur sur les clés du dictionnaire. C'est un raccourci pour " "``iter(d.keys())``." #: library/stdtypes.rst:4499 msgid "Remove all items from the dictionary." msgstr "Supprime tous les éléments du dictionnaire." #: library/stdtypes.rst:4503 msgid "Return a shallow copy of the dictionary." msgstr "Renvoie une copie superficielle du dictionnaire." #: library/stdtypes.rst:4507 msgid "" "Create a new dictionary with keys from *iterable* and values set to *value*." msgstr "" "Crée un nouveau dictionnaire avec les clés de *iterable* et les valeurs à " "*value*." #: library/stdtypes.rst:4509 msgid "" ":meth:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``. All of the values refer to just a single instance, so " "it generally doesn't make sense for *value* to be a mutable object such as " "an empty list. To get distinct values, use a :ref:`dict comprehension " "` instead." msgstr "" ":meth:`fromkeys` est une méthode de classe qui renvoie un nouveau " "dictionnaire. *value* vaut par défaut ``None``. Toutes les valeurs se " "réfèrent à une seule instance, donc il n'est généralement pas logique que " "*value* soit un objet mutable comme une liste vide. Pour avoir des valeurs " "distinctes, utilisez plutôt une :ref:`compréhension de dictionnaire `." #: library/stdtypes.rst:4517 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " "raises a :exc:`KeyError`." msgstr "" "Renvoie la valeur de *key* si *key* est dans le dictionnaire, sinon " "*default*. Si *default* n'est pas donné, il vaut ``None`` par défaut, de " "manière à ce que cette méthode ne lève jamais :exc:`KeyError`." #: library/stdtypes.rst:4523 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "the :ref:`documentation of view objects `." msgstr "" "Renvoie une nouvelle vue des éléments du dictionnaire (paires de ``(key, " "value)``). Voir la :ref:`documentation des vues `." #: library/stdtypes.rst:4528 msgid "" "Return a new view of the dictionary's keys. See the :ref:`documentation of " "view objects `." msgstr "" "Renvoie une nouvelle vue des clés du dictionnaire. Voir la :ref:" "`documentation des vues `." #: library/stdtypes.rst:4533 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" "Si *key* est dans le dictionnaire elle est supprimée et sa valeur est " "renvoyée, sinon renvoie *default*. Si *default* n'est pas donné et que " "*key* n'est pas dans le dictionnaire, une :exc:`KeyError` est levée." #: library/stdtypes.rst:4539 msgid "" "Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " "returned in :abbr:`LIFO (last-in, first-out)` order." msgstr "" "Supprime et renvoie une paire ``(key, value)`` du dictionnaire. Les paires " "sont renvoyées dans un ordre :abbr:`LIFO (Last In - First Out c.-à-d. " "dernier entré, premier sorti)`." #: library/stdtypes.rst:4542 msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :meth:" "`popitem` raises a :exc:`KeyError`." msgstr "" ":meth:`popitem` est pratique pour itérer un dictionnaire de manière " "destructive, comme souvent dans les algorithmes sur les ensembles. Si le " "dictionnaire est vide, appeler :meth:`popitem` lève une :exc:`KeyError`." # suit un : #: library/stdtypes.rst:4546 msgid "" "LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " "return an arbitrary key/value pair." msgstr "" "l'ordre « dernier entré, premier sorti » (LIFO) est désormais assuré. Dans " "les versions précédentes, :meth:`popitem` renvoyait une paire clé-valeur " "arbitraire." #: library/stdtypes.rst:4552 msgid "" "Return a reverse iterator over the keys of the dictionary. This is a " "shortcut for ``reversed(d.keys())``." msgstr "" "Renvoie un itérateur inversé sur les clés du dictionnaire. C'est un " "raccourci pour ``reversed(d.keys())``." #: library/stdtypes.rst:4559 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" "Si *key* est dans le dictionnaire, sa valeur est renvoyée. Sinon, insère " "*key* avec comme valeur *default* et renvoie *default*. *default* vaut " "``None`` par défaut." #: library/stdtypes.rst:4565 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" "Met à jour le dictionnaire avec les paires de clé-valeur d'*other*, écrasant " "les clés existantes. Renvoie ``None``." #: library/stdtypes.rst:4568 msgid "" ":meth:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " "arguments are specified, the dictionary is then updated with those key/value " "pairs: ``d.update(red=1, blue=2)``." msgstr "" ":meth:`update` accepte aussi bien un autre dictionnaire qu'un itérable de " "clé-valeur (sous forme de *n*-uplets ou autres itérables de longueur deux). " "Si des arguments nommés sont donnés, le dictionnaire est alors mis à jour " "avec ces paires clé-valeur : ``d.update(red=1, blue=2)``." #: library/stdtypes.rst:4575 msgid "" "Return a new view of the dictionary's values. See the :ref:`documentation " "of view objects `." msgstr "" "Renvoie une nouvelle vue des valeurs du dictionnaire. Voir la :ref:" "`documentation des vues `." #: library/stdtypes.rst:4578 msgid "" "An equality comparison between one ``dict.values()`` view and another will " "always return ``False``. This also applies when comparing ``dict.values()`` " "to itself::" msgstr "" "Une comparaison d'égalité entre une vue de ``dict.values()`` et une autre " "renvoie toujours ``False``. Cela s'applique aussi lorsque l'on compare " "``dict.values()`` à lui-même ::" #: library/stdtypes.rst:4588 msgid "" "Create a new dictionary with the merged keys and values of *d* and *other*, " "which must both be dictionaries. The values of *other* take priority when " "*d* and *other* share keys." msgstr "" "Crée un nouveau dictionnaire avec les clés et les valeurs fusionnées de *d* " "et *other*, qui doivent tous deux être des dictionnaires. Les valeurs de " "*other* sont prioritaires lorsque *d* et *other* partagent des clés." #: library/stdtypes.rst:4596 msgid "" "Update the dictionary *d* with keys and values from *other*, which may be " "either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " "values of *other* take priority when *d* and *other* share keys." msgstr "" "Met à jour le dictionnaire *d* avec les clés et les valeurs de *other*, qui " "peut être soit un :term:`tableau de correspondances ` soit un :term:" "`itérable ` de paires clé-valeur. Les valeurs de *other* sont " "prioritaires lorsque *d* et *other* partagent des clés." #: library/stdtypes.rst:4602 msgid "" "Dictionaries compare equal if and only if they have the same ``(key, " "value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " "'>') raise :exc:`TypeError`." msgstr "" "Deux dictionnaires sont égaux si et seulement s'ils ont les mêmes paires de " "clé-valeur (``(key, value)``, peu importe leur ordre). Les comparaisons " "d'ordre (``<``, ``<=``, ``>=``, ``>``) lèvent une :exc:`TypeError`." #: library/stdtypes.rst:4606 msgid "" "Dictionaries preserve insertion order. Note that updating a key does not " "affect the order. Keys added after deletion are inserted at the end. ::" msgstr "" "Les dictionnaires préservent l'ordre des insertions. Notez que modifier une " "clé n'affecte pas l'ordre. Les clés ajoutées après un effacement sont " "insérées à la fin. ::" # suit un : #: library/stdtypes.rst:4624 msgid "" "Dictionary order is guaranteed to be insertion order. This behavior was an " "implementation detail of CPython from 3.6." msgstr "" "l'ordre d'un dictionnaire est toujours l'ordre des insertions. Ce " "comportement était un détail d'implémentation de CPython depuis la version " "3.6." #: library/stdtypes.rst:4628 msgid "Dictionaries and dictionary views are reversible. ::" msgstr "Les dictionnaires et les vues de dictionnaires sont réversibles. ::" # suit un ':' ("changed in version X.Y") #: library/stdtypes.rst:4640 msgid "Dictionaries are now reversible." msgstr "les dictionnaires sont maintenant réversibles." #: library/stdtypes.rst:4645 msgid "" ":class:`types.MappingProxyType` can be used to create a read-only view of a :" "class:`dict`." msgstr "" ":class:`types.MappingProxyType` peut être utilisé pour créer une vue en " "lecture seule d'un :class:`dict`." #: library/stdtypes.rst:4652 msgid "Dictionary view objects" msgstr "Les vues de dictionnaires" #: library/stdtypes.rst:4654 msgid "" "The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" "`dict.items` are *view objects*. They provide a dynamic view on the " "dictionary's entries, which means that when the dictionary changes, the view " "reflects these changes." msgstr "" "Les objets renvoyés par :meth:`dict.keys`, :meth:`dict.values` et :meth:" "`dict.items` sont des *vues*. Ils fournissent une vue dynamique des " "éléments du dictionnaire, ce qui signifie que si le dictionnaire change, la " "vue reflète ces changements." #: library/stdtypes.rst:4659 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" "Les vues de dictionnaires peuvent être itérées et ainsi renvoyer les données " "du dictionnaire ; elle gèrent aussi les tests d'appartenance :" #: library/stdtypes.rst:4664 msgid "Return the number of entries in the dictionary." msgstr "Renvoie le nombre d'entrées du dictionnaire." #: library/stdtypes.rst:4668 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" "Renvoie un itérateur sur les clés, les valeurs ou les éléments (représentés " "par des paires ``(clé, valeur)``) du dictionnaire." #: library/stdtypes.rst:4671 msgid "" "Keys and values are iterated over in insertion order. This allows the " "creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." "values(), d.keys())``. Another way to create the same list is ``pairs = " "[(v, k) for (k, v) in d.items()]``." msgstr "" "Les clés et les valeurs sont itérées dans l'ordre de leur insertion. Ceci " "permet la création de paires de ``(key, value)`` en utilisant :func:`zip` : " "``pairs = zip(d.values(), d.keys())``. Un autre moyen de construire la même " "liste est ``pairs = [(v, k) for (k, v) in d.items()]``." #: library/stdtypes.rst:4676 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" "Parcourir des vues tout en ajoutant ou supprimant des entrées dans un " "dictionnaire peut lever une :exc:`RuntimeError` ou ne pas fournir toutes les " "entrées." # suit un : #: library/stdtypes.rst:4679 msgid "Dictionary order is guaranteed to be insertion order." msgstr "l'ordre d'un dictionnaire est toujours l'ordre des insertions." #: library/stdtypes.rst:4684 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" "Renvoie ``True`` si *x* est dans les clés, les valeurs ou les éléments du " "dictionnaire sous-jacent (dans le dernier cas, *x* doit être une paire " "``(key, value)``)." #: library/stdtypes.rst:4689 msgid "" "Return a reverse iterator over the keys, values or items of the dictionary. " "The view will be iterated in reverse order of the insertion." msgstr "" "Renvoie un itérateur inversé sur les clés, les valeurs ou les éléments du " "dictionnaire. La vue est itérée dans l'ordre inverse d'insertion." # suit un ':' ("changed in version X.Y") #: library/stdtypes.rst:4692 msgid "Dictionary views are now reversible." msgstr "les vues de dictionnaires sont dorénavant réversibles." #: library/stdtypes.rst:4697 msgid "" "Return a :class:`types.MappingProxyType` that wraps the original dictionary " "to which the view refers." msgstr "" "Renvoie une :class:`types.MappingProxyType` qui encapsule le dictionnaire " "original auquel la vue se réfère." #: library/stdtypes.rst:4702 msgid "" "Keys views are set-like since their entries are unique and hashable. If all " "values are hashable, so that ``(key, value)`` pairs are unique and hashable, " "then the items view is also set-like. (Values views are not treated as set-" "like since the entries are generally not unique.) For set-like views, all " "of the operations defined for the abstract base class :class:`collections." "abc.Set` are available (for example, ``==``, ``<``, or ``^``)." msgstr "" "Les vues de clés sont semblables à des ensembles puisque leurs entrées sont " "uniques et hachables. Si toutes les valeurs sont hachables, et qu'ainsi " "toutes les paires de ``(clé, valeur)`` sont uniques et hachables, alors la " "vue donnée par *items()* est aussi semblable à un ensemble. (Les vues sur " "les valeurs ne sont généralement pas traitées comme des ensembles, car ces " "entrées ne sont généralement pas uniques.) Pour les vues semblables aux " "ensembles, toutes les opérations définies dans la classe mère abstraite :" "class:`collections.abc.Set` sont disponibles (comme ``==``, ``<``, ou ``^``)." #: library/stdtypes.rst:4709 msgid "An example of dictionary view usage::" msgstr "Voici un exemple d'utilisation de vue de dictionnaire ::" #: library/stdtypes.rst:4750 msgid "Context Manager Types" msgstr "Le type gestionnaire de contexte" #: library/stdtypes.rst:4757 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using a pair of methods " "that allow user-defined classes to define a runtime context that is entered " "before the statement body is executed and exited when the statement ends:" msgstr "" "L'instruction Python :keyword:`with` permet de créer des contextes " "d'exécution à l'aide de gestionnaires de contextes. L'implémentation est " "réalisée via deux méthodes permettant aux classes définies par l'utilisateur " "de définir un contexte d'exécution, dans lequel on entre avant l'exécution " "du corps de l'instruction et que l'on quitte lorsque l'instruction se " "termine :" #: library/stdtypes.rst:4765 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " "to the identifier in the :keyword:`!as` clause of :keyword:`with` statements " "using this context manager." msgstr "" "Entre dans le contexte d'exécution, soit se renvoyant lui-même, soit en " "renvoyant un autre objet en lien avec ce contexte. La valeur renvoyée par " "cette méthode est liée à l'identifiant donné au :keyword:`!as` de " "l'instruction :keyword:`with` utilisant ce gestionnaire de contexte." #: library/stdtypes.rst:4770 msgid "" "An example of a context manager that returns itself is a :term:`file " "object`. File objects return themselves from __enter__() to allow :func:" "`open` to be used as the context expression in a :keyword:`with` statement." msgstr "" "Un exemple de gestionnaire de contexte se renvoyant lui-même est l':term:" "`objet fichier`. Les objets fichiers se renvoient eux-même " "depuis ``__enter__()`` pour ainsi permettre à :func:`open` d'être utilisée " "comme expression dans une instruction :keyword:`with`." #: library/stdtypes.rst:4774 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " "decimal context to a copy of the original decimal context and then return " "the copy. This allows changes to be made to the current decimal context in " "the body of the :keyword:`with` statement without affecting code outside " "the :keyword:`!with` statement." msgstr "" "Un exemple de gestionnaire de contexte renvoyant un objet connexe est celui " "renvoyé par :func:`decimal.localcontext`. Ces gestionnaires remplacent le " "contexte décimal courant par une copie de l'original, copie qui est " "renvoyée. Ça permet de changer le contexte courant dans le corps du :keyword:" "`with` sans affecter le code en dehors de l'instruction :keyword:`!with`." #: library/stdtypes.rst:4784 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " "executing the body of the :keyword:`with` statement, the arguments contain " "the exception type, value and traceback information. Otherwise, all three " "arguments are ``None``." msgstr "" "Sort du contexte et renvoie un booléen indiquant si une exception est " "survenue et doit être supprimée. Si une exception est survenue lors de " "l'exécution du corps de l'instruction :keyword:`with`, les arguments " "contiennent le type de l'exception, sa valeur et la trace de la pile " "(*traceback*). Sinon les trois arguments valent ``None``." #: library/stdtypes.rst:4789 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " "statement immediately following the :keyword:`!with` statement. Otherwise " "the exception continues propagating after this method has finished " "executing. Exceptions that occur during execution of this method will " "replace any exception that occurred in the body of the :keyword:`!with` " "statement." msgstr "" "L'instruction :keyword:`with` inhibe l'exception si cette méthode renvoie la " "valeur vraie, l'exécution continuant ainsi à l'instruction suivant " "immédiatement l'instruction :keyword:`!with`. Sinon, l'exception continue de " "se propager après la fin de cette méthode. Les exceptions se produisant " "pendant l'exécution de cette méthode remplacent toute exception qui s'est " "produite dans le corps du :keyword:`!with`." #: library/stdtypes.rst:4796 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " "successfully and does not want to suppress the raised exception. This allows " "context management code to easily detect whether or not an :meth:`__exit__` " "method has actually failed." msgstr "" "L'exception reçue ne doit jamais être relancée explicitement, cette méthode " "devrait plutôt renvoyer une valeur fausse pour indiquer que son exécution " "s'est terminée avec succès et qu'elle ne veut pas supprimer l'exception. " "Ceci permet au code de gestion du contexte de comprendre si une méthode :" "meth:`__exit__` a échoué." #: library/stdtypes.rst:4802 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " "manipulation of the active decimal arithmetic context. The specific types " "are not treated specially beyond their implementation of the context " "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" "Python définit plusieurs gestionnaires de contexte pour faciliter la " "synchronisation des fils d'exécution, la fermeture des fichiers ou d'autres " "objets, et la configuration du contexte arithmétique décimal. Ces types " "spécifiques ne sont pas traités différemment, ils respectent simplement le " "protocole de gestion du contexte. Voir les exemples dans la documentation du " "module :mod:`contextlib`." #: library/stdtypes.rst:4808 msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " "generator function is decorated with the :class:`contextlib.contextmanager` " "decorator, it will return a context manager implementing the necessary :meth:" "`~contextmanager.__enter__` and :meth:`~contextmanager.__exit__` methods, " "rather than the iterator produced by an undecorated generator function." msgstr "" "Les :term:`générateurs ` Python et le décorateur :class:" "`contextlib.contextmanager` permettent d'implémenter simplement ces " "protocoles. Si un générateur est décoré avec :class:`contextlib. " "contextmanager`, il renvoie un gestionnaire de contexte implémentant les " "méthodes :meth:`~contextmanager.__enter__` et :meth:`~contextmanager." "__exit__`, plutôt que l'itérateur produit par un générateur non décoré." #: library/stdtypes.rst:4815 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " "define these methods must provide them as a normal Python accessible method. " "Compared to the overhead of setting up the runtime context, the overhead of " "a single class dictionary lookup is negligible." msgstr "" "Notez qu'il n'y a pas d'emplacement spécifique pour ces méthodes dans la " "structure de type pour les objets Python dans l'API Python/C. Les types " "souhaitant définir ces méthodes doivent les fournir comme une méthode " "accessible en Python. Comparé au coût de la mise en place du contexte " "d'exécution, le coût d'un accès au dictionnaire d'une classe unique est " "négligeable." #: library/stdtypes.rst:4823 msgid "" "Type Annotation Types --- :ref:`Generic Alias `, :ref:" "`Union `" msgstr "" "Types d'annotation de type — :ref:`Alias générique `, :" "ref:`Union `" #: library/stdtypes.rst:4828 msgid "" "The core built-in types for :term:`type annotations ` are :ref:" "`Generic Alias ` and :ref:`Union `." msgstr "" "Les principaux types natifs pour l':term:`annotation de types ` " "sont l':ref:`Alias générique ` et l':ref:`Union `." #: library/stdtypes.rst:4835 msgid "Generic Alias Type" msgstr "Type Alias générique" #: library/stdtypes.rst:4841 msgid "" "``GenericAlias`` objects are generally created by :ref:`subscripting " "` a class. They are most often used with :ref:`container " "classes `, such as :class:`list` or :class:`dict`. For " "example, ``list[int]`` is a ``GenericAlias`` object created by subscripting " "the ``list`` class with the argument :class:`int`. ``GenericAlias`` objects " "are intended primarily for use with :term:`type annotations `." msgstr "" "Les objets ``GenericAlias`` sont généralement créés en :ref:`indiçant " "` une classe. Ils sont le plus souvent utilisés avec des :ref:" "`classes conteneurs `, telles que :class:`list` ou :class:" "`dict`. Par exemple, ``list[int]`` est un objet GenericAlias créé en " "indiçant la classe ``list`` avec l'argument :class:`int`. Les objets " "``GenericAlias`` sont principalement destinés à être utilisés en tant qu':" "term:`annotations de types `." # suit un : #: library/stdtypes.rst:4851 msgid "" "It is generally only possible to subscript a class if the class implements " "the special method :meth:`~object.__class_getitem__`." msgstr "" "il n'est généralement possible d'indicer une classe que si la classe " "implémente la méthode spéciale :meth:`~object.__class_getitem__`." #: library/stdtypes.rst:4854 msgid "" "A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " "implementing *parameterized generics*." msgstr "" "Un objet ``GenericAlias`` agit comme un mandataire pour un :term:`type " "générique`, en implémentant des *types génériques pouvant recevoir des " "paramètres*." #: library/stdtypes.rst:4857 msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " "object contains. For example, ``set[bytes]`` can be used in type annotations " "to signify a :class:`set` in which all the elements are of type :class:" "`bytes`." msgstr "" "Pour une classe conteneur, les arguments fournis comme :ref:`indices " "` de la classe indiquent les types des éléments que l'objet " "peut contenir. Par exemple, ``set[bytes]`` peut être utilisé dans les " "annotations de type pour signifier un :class:`ensemble ` dans lequel " "tous les éléments sont de type :class:`bytes`." #: library/stdtypes.rst:4863 msgid "" "For a class which defines :meth:`~object.__class_getitem__` but is not a " "container, the argument(s) supplied to a subscription of the class will " "often indicate the return type(s) of one or more methods defined on an " "object. For example, :mod:`regular expressions ` can be used on both " "the :class:`str` data type and the :class:`bytes` data type:" msgstr "" "Pour une classe qui définit :meth:`~object.__class_getitem__` mais n'est pas " "un conteneur, les arguments fournis comme indices de la classe indiquent " "souvent les types de retour d'une ou plusieurs méthodes définies sur un " "objet. Par exemple, :mod:`re` (expressions rationnelles) peut être utilisé à " "la fois sur le type de données :class:`str` et sur le type de données :class:" "`bytes` :" # énumération #: library/stdtypes.rst:4869 msgid "" "If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " "both be of type :class:`str`. We can represent this kind of object in type " "annotations with the ``GenericAlias`` ``re.Match[str]``." msgstr "" "si ``x = re.search('foo', 'foo')``, ``x`` est un objet :ref:`re.Match ` où les valeurs de retour de ``x.group(0)`` et ``x[0]`` sont toutes " "les deux de type :class:`str`. Nous pouvons représenter ce type d'objet dans " "des annotations de type avec le ``GenericAlias`` ``re.Match[str]`` ;" # fin d'énumération #: library/stdtypes.rst:4875 msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " "``y`` will also be an instance of ``re.Match``, but the return values of ``y." "group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " "annotations, we would represent this variety of :ref:`re.Match ` objects with ``re.Match[bytes]``." msgstr "" "si ``y = re.search(b'bar', b'bar')``, (notez le ``b`` pour :class:`bytes`), " "``y`` est également une instance de ``re.Match``, mais les valeurs de retour " "de ``y.group(0)`` et ``y[0]`` sont toutes les deux de type :class:`bytes`. " "Dans les annotations de type, nous représenterons cette variété d'objets :" "ref:`re.Match ` par ``re.Match[bytes]``." #: library/stdtypes.rst:4881 msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " "directly." msgstr "" "Les objets ``GenericAlias`` sont des instances de la classe :class:`types." "GenericAlias`, qui peut également être utilisée pour créer directement des " "objets ``GenericAlias``." #: library/stdtypes.rst:4887 msgid "" "Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " "*X*, *Y*, and more depending on the ``T`` used. For example, a function " "expecting a :class:`list` containing :class:`float` elements::" msgstr "" "Crée un ``GenericAlias`` représentant un type ``T`` paramétré par les types " "*X*, *Y* et plus selon le ``T`` utilisé. Par exemple, pour une fonction " "attendant une :class:`list` contenant des éléments :class:`float` ::" #: library/stdtypes.rst:4895 msgid "" "Another example for :term:`mapping` objects, using a :class:`dict`, which is " "a generic type expecting two type parameters representing the key type and " "the value type. In this example, the function expects a ``dict`` with keys " "of type :class:`str` and values of type :class:`int`::" msgstr "" "Un autre exemple peut être un objet :term:`tableau de correspondances " "`, utilisant un :class:`dict`, qui est un type générique attendant " "deux paramètres de type représentant le type clé et le type valeur. Dans cet " "exemple, la fonction attend un ``dict`` avec des clés de type :class:`str` " "et des valeurs de type :class:`int` ::" #: library/stdtypes.rst:4903 msgid "" "The builtin functions :func:`isinstance` and :func:`issubclass` do not " "accept ``GenericAlias`` types for their second argument::" msgstr "" "Les fonctions natives :func:`isinstance` et :func:`issubclass` n'acceptent " "pas les types ``GenericAlias`` pour leur second argument ::" #: library/stdtypes.rst:4911 msgid "" "The Python runtime does not enforce :term:`type annotations `. " "This extends to generic types and their type parameters. When creating a " "container object from a ``GenericAlias``, the elements in the container are " "not checked against their type. For example, the following code is " "discouraged, but will run without errors::" msgstr "" "Lors de l'exécution, Python ne regarde pas les :term:`annotations de type " "`. Cela vaut pour les types génériques et les types qu'on leur " "passe en paramètres. Lors de la création d'un objet conteneur à partir d'un " "``GenericAlias``, les types des éléments du conteneur ne sont pas vérifiés. " "Par exemple, le code suivant est déconseillé, mais s'exécute sans erreur ::" #: library/stdtypes.rst:4921 msgid "" "Furthermore, parameterized generics erase type parameters during object " "creation::" msgstr "" "De plus, les types génériques pouvant recevoir des paramètres effacent les " "paramètres de type lors de la création d'objet ::" #: library/stdtypes.rst:4932 msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" msgstr "" "Appeler :func:`repr` ou :func:`str` sur un type générique affiche le type " "pouvant recevoir des paramètres ::" #: library/stdtypes.rst:4940 msgid "" "The :meth:`~object.__getitem__` method of generic containers will raise an " "exception to disallow mistakes like ``dict[str][str]``::" msgstr "" "La méthode :meth:`~object.__getitem__` des conteneurs génériques lève une " "exception pour interdire les erreurs telles que ``dict[str][str]`` ::" #: library/stdtypes.rst:4948 msgid "" "However, such expressions are valid when :ref:`type variables ` " "are used. The index must have as many elements as there are type variable " "items in the ``GenericAlias`` object's :attr:`~genericalias.__args__`. ::" msgstr "" "Cependant, de telles expressions sont valides lorsque :ref:`des variables de " "type ` sont utilisées. L'indice doit avoir autant d'éléments qu'il " "y a d'éléments variables de type dans l'objet ``GenericAlias`` :attr:" "`~genericalias.__args__`. ::" #: library/stdtypes.rst:4959 msgid "Standard Generic Classes" msgstr "Classes génériques standards" #: library/stdtypes.rst:4961 msgid "" "The following standard library classes support parameterized generics. This " "list is non-exhaustive." msgstr "" "Les classes suivantes de la bibliothèque standard prennent en charge les " "types génériques pouvant accepter des paramètres. Cette liste est non " "exhaustive." #: library/stdtypes.rst:4964 msgid ":class:`tuple`" msgstr ":class:`tuple`" #: library/stdtypes.rst:4965 msgid ":class:`list`" msgstr ":class:`list`" #: library/stdtypes.rst:4966 msgid ":class:`dict`" msgstr ":class:`dict`" #: library/stdtypes.rst:4967 msgid ":class:`set`" msgstr ":class:`set`" #: library/stdtypes.rst:4968 msgid ":class:`frozenset`" msgstr ":class:`frozenset`" #: library/stdtypes.rst:4969 msgid ":class:`type`" msgstr ":class:`type`" #: library/stdtypes.rst:4970 msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" #: library/stdtypes.rst:4971 msgid ":class:`collections.defaultdict`" msgstr ":class:`collections.defaultdict`" #: library/stdtypes.rst:4972 msgid ":class:`collections.OrderedDict`" msgstr ":class:`collections.OrderedDict`" #: library/stdtypes.rst:4973 msgid ":class:`collections.Counter`" msgstr ":class:`collections.Counter`" #: library/stdtypes.rst:4974 msgid ":class:`collections.ChainMap`" msgstr ":class:`collections.ChainMap`" #: library/stdtypes.rst:4975 msgid ":class:`collections.abc.Awaitable`" msgstr ":class:`collections.abc.Awaitable`" #: library/stdtypes.rst:4976 msgid ":class:`collections.abc.Coroutine`" msgstr ":class:`collections.abc.Coroutine`" #: library/stdtypes.rst:4977 msgid ":class:`collections.abc.AsyncIterable`" msgstr ":class:`collections.abc.AsyncIterable`" #: library/stdtypes.rst:4978 msgid ":class:`collections.abc.AsyncIterator`" msgstr ":class:`collections.abc.AsyncIterator`" #: library/stdtypes.rst:4979 msgid ":class:`collections.abc.AsyncGenerator`" msgstr ":class:`collections.abc.AsyncGenerator`" #: library/stdtypes.rst:4980 msgid ":class:`collections.abc.Iterable`" msgstr ":class:`collections.abc.Iterable`" #: library/stdtypes.rst:4981 msgid ":class:`collections.abc.Iterator`" msgstr ":class:`collections.abc.Iterator`" #: library/stdtypes.rst:4982 msgid ":class:`collections.abc.Generator`" msgstr ":class:`collections.abc.Generator`" #: library/stdtypes.rst:4983 msgid ":class:`collections.abc.Reversible`" msgstr ":class:`collections.abc.Reversible`" #: library/stdtypes.rst:4984 msgid ":class:`collections.abc.Container`" msgstr ":class:`collections.abc.Container`" #: library/stdtypes.rst:4985 msgid ":class:`collections.abc.Collection`" msgstr ":class:`collections.abc.Collection`" #: library/stdtypes.rst:4986 msgid ":class:`collections.abc.Callable`" msgstr ":class:`collections.abc.Callable`" #: library/stdtypes.rst:4987 msgid ":class:`collections.abc.Set`" msgstr ":class:`collections.abc.Set`" #: library/stdtypes.rst:4988 msgid ":class:`collections.abc.MutableSet`" msgstr ":class:`collections.abc.MutableSet`" #: library/stdtypes.rst:4989 msgid ":class:`collections.abc.Mapping`" msgstr ":class:`collections.abc.Mapping`" #: library/stdtypes.rst:4990 msgid ":class:`collections.abc.MutableMapping`" msgstr ":class:`collections.abc.MutableMapping`" #: library/stdtypes.rst:4991 msgid ":class:`collections.abc.Sequence`" msgstr ":class:`collections.abc.Sequence`" #: library/stdtypes.rst:4992 msgid ":class:`collections.abc.MutableSequence`" msgstr ":class:`collections.abc.MutableSequence`" #: library/stdtypes.rst:4993 msgid ":class:`collections.abc.ByteString`" msgstr ":class:`collections.abc.ByteString`" #: library/stdtypes.rst:4994 msgid ":class:`collections.abc.MappingView`" msgstr ":class:`collections.abc.MappingView`" #: library/stdtypes.rst:4995 msgid ":class:`collections.abc.KeysView`" msgstr ":class:`collections.abc.KeysView`" #: library/stdtypes.rst:4996 msgid ":class:`collections.abc.ItemsView`" msgstr ":class:`collections.abc.ItemsView`" #: library/stdtypes.rst:4997 msgid ":class:`collections.abc.ValuesView`" msgstr ":class:`collections.abc.ValuesView`" #: library/stdtypes.rst:4998 msgid ":class:`contextlib.AbstractContextManager`" msgstr ":class:`contextlib.AbstractContextManager`" #: library/stdtypes.rst:4999 msgid ":class:`contextlib.AbstractAsyncContextManager`" msgstr ":class:`contextlib.AbstractAsyncContextManager`" #: library/stdtypes.rst:5000 msgid ":class:`dataclasses.Field`" msgstr ":class:`dataclasses.Field`" #: library/stdtypes.rst:5001 msgid ":class:`functools.cached_property`" msgstr ":class:`functools.cached_property`" #: library/stdtypes.rst:5002 msgid ":class:`functools.partialmethod`" msgstr ":class:`functools.partialmethod`" #: library/stdtypes.rst:5003 msgid ":class:`os.PathLike`" msgstr ":class:`os.PathLike`" #: library/stdtypes.rst:5004 msgid ":class:`queue.LifoQueue`" msgstr ":class:`queue.LifoQueue`" #: library/stdtypes.rst:5005 msgid ":class:`queue.Queue`" msgstr ":class:`queue.Queue`" #: library/stdtypes.rst:5006 msgid ":class:`queue.PriorityQueue`" msgstr ":class:`queue.PriorityQueue`" #: library/stdtypes.rst:5007 msgid ":class:`queue.SimpleQueue`" msgstr ":class:`queue.SimpleQueue`" #: library/stdtypes.rst:5008 msgid ":ref:`re.Pattern `" msgstr ":ref:`re.Pattern `" #: library/stdtypes.rst:5009 msgid ":ref:`re.Match `" msgstr ":ref:`re.Match `" #: library/stdtypes.rst:5010 msgid ":class:`shelve.BsdDbShelf`" msgstr ":class:`shelve.BsdDbShelf`" #: library/stdtypes.rst:5011 msgid ":class:`shelve.DbfilenameShelf`" msgstr ":class:`shelve.DbfilenameShelf`" #: library/stdtypes.rst:5012 msgid ":class:`shelve.Shelf`" msgstr ":class:`shelve.Shelf`" #: library/stdtypes.rst:5013 msgid ":class:`types.MappingProxyType`" msgstr ":class:`types.MappingProxyType`" #: library/stdtypes.rst:5014 msgid ":class:`weakref.WeakKeyDictionary`" msgstr ":class:`weakref.WeakKeyDictionary`" #: library/stdtypes.rst:5015 msgid ":class:`weakref.WeakMethod`" msgstr ":class:`weakref.WeakMethod`" #: library/stdtypes.rst:5016 msgid ":class:`weakref.WeakSet`" msgstr ":class:`weakref.WeakSet`" #: library/stdtypes.rst:5017 msgid ":class:`weakref.WeakValueDictionary`" msgstr ":class:`weakref.WeakValueDictionary`" #: library/stdtypes.rst:5022 msgid "Special Attributes of ``GenericAlias`` objects" msgstr "Attributs spéciaux des alias génériques" #: library/stdtypes.rst:5024 msgid "All parameterized generics implement special read-only attributes." msgstr "" "Tous les types génériques pouvant accepter des paramètres implémentent des " "attributs spéciaux en lecture seule." #: library/stdtypes.rst:5028 msgid "This attribute points at the non-parameterized generic class::" msgstr "Cet attribut pointe vers la classe générique sans paramètres ::" #: library/stdtypes.rst:5036 msgid "" "This attribute is a :class:`tuple` (possibly of length 1) of generic types " "passed to the original :meth:`~object.__class_getitem__` of the generic " "class::" msgstr "" "Cet attribut est un :class:`n-uplet ` (éventuellement de longueur 1) " "de types génériques passés à la :meth:`~object.__class_getitem__` d'origine " "de la classe générique ::" #: library/stdtypes.rst:5046 msgid "" "This attribute is a lazily computed tuple (possibly empty) of unique type " "variables found in ``__args__``::" msgstr "" "Cet attribut est un *n*-uplet calculé paresseusement (éventuellement vide) " "de variables de type (chaque type n'est mentionné qu'une seule fois) " "trouvées dans ``__args__`` ::" # suit un : #: library/stdtypes.rst:5057 msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " "have correct ``__parameters__`` after substitution because :class:`typing." "ParamSpec` is intended primarily for static type checking." msgstr "" "un objet ``GenericAlias`` avec des paramètres :class:`typing.ParamSpec` peut " "ne pas avoir de ``__parameters__`` corrects après substitution car :class:" "`typing.ParamSpec` est principalement destiné à la vérification de type " "statique." #: library/stdtypes.rst:5064 msgid "" "A boolean that is true if the alias has been unpacked using the ``*`` " "operator (see :data:`~typing.TypeVarTuple`)." msgstr "" "Booléen qui est vrai si l'alias a été décompressé à l'aide de l'opérateur " "``*`` (voir :data:`~typing.TypeVarTuple`)." #: library/stdtypes.rst:5073 msgid ":pep:`484` - Type Hints" msgstr ":pep:`484` - Indications des types (page en anglais)" #: library/stdtypes.rst:5073 msgid "Introducing Python's framework for type annotations." msgstr "Présentation du cadre Python pour les annotations de type." #: library/stdtypes.rst:5078 msgid ":pep:`585` - Type Hinting Generics In Standard Collections" msgstr "" ":pep:`585` – Types génériques d'indication de type dans les conteneurs " "standard (page en anglais)" #: library/stdtypes.rst:5076 msgid "" "Introducing the ability to natively parameterize standard-library classes, " "provided they implement the special class method :meth:`~object." "__class_getitem__`." msgstr "" "Présentation de la possibilité de paramétrer nativement les classes de la " "bibliothèque standard, à condition qu'elles implémentent la méthode de " "classe spéciale :meth:`~object.__class_getitem__`." #: library/stdtypes.rst:5081 msgid "" ":ref:`Generics`, :ref:`user-defined generics ` and :" "class:`typing.Generic`" msgstr "" ":ref:`Génériques `, :ref:`génériques personnalisés ` et :class:`typing.Generic`" #: library/stdtypes.rst:5081 msgid "" "Documentation on how to implement generic classes that can be parameterized " "at runtime and understood by static type-checkers." msgstr "" "Documentation sur la façon d'implémenter des classes génériques qui peuvent " "être paramétrées à l'exécution et comprises par les vérificateurs de type " "statiques." #: library/stdtypes.rst:5090 msgid "Union Type" msgstr "Type Union" #: library/stdtypes.rst:5096 msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " "primarily for :term:`type annotations `. The union type " "expression enables cleaner type hinting syntax compared to :data:`typing." "Union`." msgstr "" "Un objet *union* contient la valeur de l'opération ``|`` (OU bit à bit) sur " "plusieurs :ref:`objets types `. Ces types sont " "principalement destinés aux :term:`annotations de types `. " "L'expression d'union de types permet une syntaxe plus claire pour les " "indications de type par rapport à :data:`typing.Union`." #: library/stdtypes.rst:5103 msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " "example, the following function expects an argument of type :class:`int` or :" "class:`float`::" msgstr "" "Définit un objet *union* qui contient les types *X*, *Y*, etc. ``X | Y`` " "signifie X ou Y. Cela équivaut à ``typing.Union[X, Y]``. Par exemple, la " "fonction suivante attend un argument de type :class:`int` ou :class:" "`float` ::" #: library/stdtypes.rst:5113 msgid "" "Union objects can be tested for equality with other union objects. Details:" msgstr "" "Les objets *union* peuvent être testés pour savoir s'ils sont égaux à " "d'autres objets *union*. Plus en détails :" #: library/stdtypes.rst:5115 msgid "Unions of unions are flattened::" msgstr "Les unions d'unions sont aplaties ::" #: library/stdtypes.rst:5119 msgid "Redundant types are removed::" msgstr "Les types redondants sont supprimés ::" #: library/stdtypes.rst:5123 msgid "When comparing unions, the order is ignored::" msgstr "Lors de la comparaison d'unions, l'ordre est ignoré ::" #: library/stdtypes.rst:5127 msgid "It is compatible with :data:`typing.Union`::" msgstr "Il est compatible avec :data:`typing.Union` ::" #: library/stdtypes.rst:5131 msgid "Optional types can be spelled as a union with ``None``::" msgstr "" "Les types optionnels peuvent être orthographiés comme une union avec " "``None`` ::" #: library/stdtypes.rst:5138 msgid "" "Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " "union object::" msgstr "" "Les appels à :func:`isinstance` et :func:`issubclass` sont également pris en " "charge avec un objet *union* ::" #: library/stdtypes.rst:5144 msgid "" "However, union objects containing :ref:`parameterized generics ` cannot be used::" msgstr "" "Cependant, les objets *union* contenant des :ref:`types génériques acceptant " "des paramètres ` ne peuvent pas être utilisés ::" #: library/stdtypes.rst:5152 msgid "" "The user-exposed type for the union object can be accessed from :data:`types." "UnionType` and used for :func:`isinstance` checks. An object cannot be " "instantiated from the type::" msgstr "" "Le type indiqué à l'utilisateur pour l'objet *union* est accessible par :" "data:`types.UnionType` et utilisé pour les vérifications :func:`isinstance`. " "Un objet ne peut pas être instancié à partir du type ::" # suit un : #: library/stdtypes.rst:5165 msgid "" "The :meth:`__or__` method for type objects was added to support the syntax " "``X | Y``. If a metaclass implements :meth:`__or__`, the Union may override " "it::" msgstr "" "la méthode :meth:`__or__` pour les objets de type a été ajoutée pour prendre " "en charge la syntaxe ``X | Y``. Si une métaclasse implémente :meth:`__or__`, " "l'*union* peut la remplacer ::" #: library/stdtypes.rst:5183 msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." msgstr ":pep:`604` – PEP proposant la syntaxe ``X | Y`` et le type *Union*." #: library/stdtypes.rst:5191 msgid "Other Built-in Types" msgstr "Autres types natifs" #: library/stdtypes.rst:5193 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." msgstr "" "L'interpréteur gère aussi d'autres types d'objets, la plupart ne gèrent " "cependant qu'une ou deux opérations." #: library/stdtypes.rst:5200 msgid "Modules" msgstr "Modules" #: library/stdtypes.rst:5202 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " "table. Module attributes can be assigned to. (Note that the :keyword:" "`import` statement is not, strictly speaking, an operation on a module " "object; ``import foo`` does not require a module object named *foo* to " "exist, rather it requires an (external) *definition* for a module named " "*foo* somewhere.)" msgstr "" "La seule opération spéciale sur un module est l'accès à ses attributs : ``m." "name``, où *m* est un module et *name* donne accès un nom défini dans la " "table des symboles de *m*. Il est possible d'assigner un attribut de " "module. (Notez que l'instruction :keyword:`import` n'est pas strictement " "une opération sur un objet module. ``import foo`` ne nécessite pas qu'un " "objet module nommé *foo* existe, il nécessite cependant une *définition* " "(externe) d'un module nommé *foo* quelque part.)" #: library/stdtypes.rst:5209 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " "will actually change the module's symbol table, but direct assignment to " "the :attr:`~object.__dict__` attribute is not possible (you can write ``m." "__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't write " "``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is not " "recommended." msgstr "" "Un attribut spécial à chaque module est :attr:`~object.__dict__`. C'est le " "dictionnaire contenant la table des symboles du module. Modifier ce " "dictionnaire change la table des symboles du module, mais assigner " "directement :attr:`~object.__dict__` n'est pas possible (vous pouvez écrire " "``m.__dict__['a'] = 1``, qui donne ``1`` comme valeur pour ``m.a``, mais " "vous ne pouvez pas écrire ``m.__dict__ = {}``). Modifier :attr:`~object." "__dict__` directement n'est pas recommandé." #: library/stdtypes.rst:5217 msgid "" "Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" "Les modules natifs de l'interpréteur sont affichés comme ````. S'ils sont chargés depuis un fichier, ils sont " "affichés sous la forme ````." #: library/stdtypes.rst:5225 msgid "Classes and Class Instances" msgstr "Les classes et instances de classes" #: library/stdtypes.rst:5227 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "Voir :ref:`objects` et :ref:`class`." #: library/stdtypes.rst:5233 msgid "Functions" msgstr "Fonctions" #: library/stdtypes.rst:5235 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." msgstr "" "Les objets fonctions sont créés par les définitions de fonctions. La seule " "opération applicable à un objet fonction est de l'appeler : ``func(argument-" "list)``." #: library/stdtypes.rst:5238 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " "function), but the implementation is different, hence the different object " "types." msgstr "" "Il existe en fait deux catégories d'objets fonctions : les fonctions natives " "et les fonctions définies par l'utilisateur. Les deux gèrent les mêmes " "opérations (l'appel à la fonction), mais leur implémentation est différente, " "d'où les deux types distincts." #: library/stdtypes.rst:5242 msgid "See :ref:`function` for more information." msgstr "Voir :ref:`function` pour plus d'information." #: library/stdtypes.rst:5248 msgid "Methods" msgstr "Méthodes" #: library/stdtypes.rst:5252 msgid "" "Methods are functions that are called using the attribute notation. There " "are two flavors: built-in methods (such as :meth:`append` on lists) and " "class instance methods. Built-in methods are described with the types that " "support them." msgstr "" "Les méthodes sont des fonctions appelées *via* la notation d'attribut. Il en " "existe deux variantes : les méthodes natives (tel que :meth:`append` sur les " "listes) et les méthodes d'instances de classes. Les méthodes natives sont " "décrites avec le type qui les gère." #: library/stdtypes.rst:5257 msgid "" "If you access a method (a function defined in a class namespace) through an " "instance, you get a special object: a :dfn:`bound method` (also called :dfn:" "`instance method`) object. When called, it will add the ``self`` argument to " "the argument list. Bound methods have two special read-only attributes: ``m." "__self__`` is the object on which the method operates, and ``m.__func__`` is " "the function implementing the method. Calling ``m(arg-1, arg-2, ..., arg-" "n)`` is completely equivalent to calling ``m.__func__(m.__self__, arg-1, " "arg-2, ..., arg-n)``." msgstr "" "Si vous accédez à une méthode (une fonction définie dans l'espace de nommage " "d'une classe) via une instance, vous obtenez un objet spécial, une :dfn:" "`bound method` (aussi appelée :dfn:`instance method`). Lorsqu'elle est " "appelée, elle ajoute l'argument ``self`` à la liste des arguments. Les " "méthodes liées ont deux attributs spéciaux, en lecture seule : ``m." "__self__`` est l'objet sur lequel la méthode travaille, et ``m.__func__`` " "est la fonction implémentant la méthode. Appeler ``m(arg-1, arg-2, …, arg-" "n)`` est tout à fait équivalent à appeler ``m.__func__(m.__self__, arg-1, " "arg-2, …, arg-n)``." #: library/stdtypes.rst:5266 msgid "" "Like function objects, bound method objects support getting arbitrary " "attributes. However, since method attributes are actually stored on the " "underlying function object (``meth.__func__``), setting method attributes on " "bound methods is disallowed. Attempting to set an attribute on a method " "results in an :exc:`AttributeError` being raised. In order to set a method " "attribute, you need to explicitly set it on the underlying function object::" msgstr "" "Comme les objets fonctions, les objets méthodes liées acceptent des " "attributs arbitraires. Cependant, puisque les attributs de méthodes doivent " "être stockés dans la fonction sous-jacente (``meth.__func__``), affecter des " "attributs à des objets méthodes liées est interdit. Toute tentative " "d'affecter un attribut sur un objet méthode liée lève une :exc:" "`AttributeError`. Pour affecter l'attribut, vous devez explicitement " "l'affecter à l'objet fonction sous-jacent ::" #: library/stdtypes.rst:5317 msgid "See :ref:`types` for more information." msgstr "Voir :ref:`types` pour plus d'information." #: library/stdtypes.rst:5294 msgid "Code Objects" msgstr "Objets code" #: library/stdtypes.rst:5300 msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " "executable Python code such as a function body. They differ from function " "objects because they don't contain a reference to their global execution " "environment. Code objects are returned by the built-in :func:`compile` " "function and can be extracted from function objects through their :attr:" "`__code__` attribute. See also the :mod:`code` module." msgstr "" "Les objets code sont utilisés par l'implémentation pour représenter du code " "Python « pseudo-compilé », comme un corps de fonction. Ils sont différents " "des objets fonction dans le sens où ils ne contiennent pas de référence à " "leur environnement global d'exécution. Les objets code sont renvoyés par la " "fonction native :func:`compile` et peuvent être obtenus à partir des objets " "fonction *via* l' attribut :attr:`__code__`. Voir aussi le module :mod:" "`code`." #: library/stdtypes.rst:5307 msgid "" "Accessing ``__code__`` raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"__code__\"``." msgstr "" "L'accès à ``__code__`` déclenche un :ref:`événement d'audit ` " "``object.__getattr__`` avec les arguments ``obj`` et ``\"__code__\"``." #: library/stdtypes.rst:5314 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :func:`exec` or :func:`eval` built-in functions." msgstr "" "Les objets code peuvent être exécutés ou évalués en les passant (au lieu " "d'une chaîne contenant du code) aux fonction natives :func:`exec` ou :func:" "`eval`." #: library/stdtypes.rst:5323 msgid "Type Objects" msgstr "Objets type" #: library/stdtypes.rst:5329 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " "operations on types. The standard module :mod:`types` defines names for all " "standard built-in types." msgstr "" "Les objets types représentent les différents types d'objets. Le type d'un " "objet est obtenu via la fonction native :func:`type`. Il n'existe aucune " "opération spéciale sur les types. Le module standard :mod:`types` définit " "les noms de tous les types natifs." #: library/stdtypes.rst:5334 msgid "Types are written like this: ````." msgstr "Les types sont affichés comme suit : ````." #: library/stdtypes.rst:5340 msgid "The Null Object" msgstr "L'objet Null" #: library/stdtypes.rst:5342 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " "``None`` (a built-in name). ``type(None)()`` produces the same singleton." msgstr "" "Cet objet est renvoyé par les fonctions ne renvoyant pas explicitement une " "valeur. Il ne gère aucune opération spéciale. Il existe exactement un seul " "objet *null* nommé ``None`` (c'est un nom natif). ``type(None)()`` produit " "ce singleton." #: library/stdtypes.rst:5346 msgid "It is written as ``None``." msgstr "Il s'écrit ``None``." #: library/stdtypes.rst:5353 msgid "The Ellipsis Object" msgstr "L'objet points de suspension (ou ellipse)" #: library/stdtypes.rst:5355 msgid "" "This object is commonly used by slicing (see :ref:`slicings`). It supports " "no special operations. There is exactly one ellipsis object, named :const:" "`Ellipsis` (a built-in name). ``type(Ellipsis)()`` produces the :const:" "`Ellipsis` singleton." msgstr "" "Cet objet est utilisé classiquement lors des découpes (voir :ref:" "`slicings`). Il ne gère aucune opération spéciale. Il n'y a qu'un seul objet " "*points de suspension*, nommé :const:`Ellipsis` (un nom natif). " "``type(Ellipsis)()`` produit le *singleton* :const:`Ellipsis`." #: library/stdtypes.rst:5360 msgid "It is written as ``Ellipsis`` or ``...``." msgstr "Il s'écrit ``Ellipsis`` ou ``...``." #: library/stdtypes.rst:5366 msgid "The NotImplemented Object" msgstr "L'objet *NotImplemented*" #: library/stdtypes.rst:5368 msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " "more information. There is exactly one ``NotImplemented`` object. " "``type(NotImplemented)()`` produces the singleton instance." msgstr "" "Cet objet est renvoyé depuis des comparaisons ou des opérations binaires " "effectuées sur des types qu'elles ne gèrent pas. Voir :ref:`comparisons` " "pour plus d'informations. Il n'y a qu'un seul objet ``NotImplemented``. " "``type(NotImplemented)()`` renvoie ce *singleton*." #: library/stdtypes.rst:5373 msgid "It is written as ``NotImplemented``." msgstr "Il s'écrit ``NotImplemented``." #: library/stdtypes.rst:5379 msgid "Boolean Values" msgstr "Valeurs booléennes" #: library/stdtypes.rst:5381 msgid "" "Boolean values are the two constant objects ``False`` and ``True``. They " "are used to represent truth values (although other values can also be " "considered false or true). In numeric contexts (for example when used as " "the argument to an arithmetic operator), they behave like the integers 0 and " "1, respectively. The built-in function :func:`bool` can be used to convert " "any value to a Boolean, if the value can be interpreted as a truth value " "(see section :ref:`truth` above)." msgstr "" "Les valeurs booléennes sont les deux objets constants ``False`` et ``True``. " "Ils sont utilisés pour représenter les valeurs de vérité (bien que d'autres " "valeurs peuvent être considérées vraies ou fausses). Dans des contextes " "numériques (par exemple en argument d'un opérateur arithmétique), ils se " "comportent comme les nombres entiers 0 et 1, respectivement. La fonction " "native :func:`bool` peut être utilisée pour convertir n'importe quelle " "valeur en booléen tant que la valeur peut être interprétée en une valeur de " "vérité (voir :ref:`truth` au dessus)." #: library/stdtypes.rst:5394 msgid "They are written as ``False`` and ``True``, respectively." msgstr "Ils s'écrivent ``False`` et ``True``, respectivement." #: library/stdtypes.rst:5400 msgid "Internal Objects" msgstr "Objets internes" #: library/stdtypes.rst:5402 msgid "" "See :ref:`types` for this information. It describes stack frame objects, " "traceback objects, and slice objects." msgstr "" "Voir :ref:`types`. Ils décrivent les objets *stack frame*, *traceback* et " "*slice*." #: library/stdtypes.rst:5409 msgid "Special Attributes" msgstr "Attributs spéciaux" #: library/stdtypes.rst:5411 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" "`dir` built-in function." msgstr "" "L'implémentation ajoute quelques attributs spéciaux en lecture seule à " "certains types, lorsque ça a du sens. Certains ne sont pas listés par la " "fonction native :func:`dir`." #: library/stdtypes.rst:5418 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." msgstr "" "Dictionnaire ou autre objet tableau de correspondances utilisé pour stocker " "les attributs (modifiables) de l'objet." #: library/stdtypes.rst:5424 msgid "The class to which a class instance belongs." msgstr "Classe de l'instance de classe." #: library/stdtypes.rst:5429 msgid "The tuple of base classes of a class object." msgstr "*n*-uplet des classes parentes d'un objet classe." #: library/stdtypes.rst:5434 msgid "" "The name of the class, function, method, descriptor, or generator instance." msgstr "" "Nom de la classe, fonction, méthode, descripteur ou instance du générateur." #: library/stdtypes.rst:5440 msgid "" "The :term:`qualified name` of the class, function, method, descriptor, or " "generator instance." msgstr "" ":term:`Nom qualifié ` de la classe, fonction, méthode, " "descripteur ou instance du générateur." #: library/stdtypes.rst:5448 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." msgstr "" "Cet attribut est un *n*-uplet contenant les classes mères prises en compte " "lors de la résolution de méthode." #: library/stdtypes.rst:5454 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " "and its result is stored in :attr:`~class.__mro__`." msgstr "" "Cette méthode peut être surchargée par une méta-classe pour personnaliser " "l'ordre de la recherche de méthode pour ses instances. Elle est appelée à " "l'initialisation de la classe et son résultat est stocké dans l'attribut :" "attr:`~class.__mro__`." #: library/stdtypes.rst:5461 msgid "" "Each class keeps a list of weak references to its immediate subclasses. " "This method returns a list of all those references still alive. The list is " "in definition order. Example::" msgstr "" "Chaque classe garde une liste de références faibles à ses classes filles " "immédiates. Cette méthode renvoie la liste de toutes ces références encore " "valables. La liste est classée par ordre de définition. Par exemple ::" #: library/stdtypes.rst:5472 msgid "Integer string conversion length limitation" msgstr "Limitation de longueur de conversion de chaîne vers un entier" #: library/stdtypes.rst:5474 msgid "" "CPython has a global limit for converting between :class:`int` and :class:" "`str` to mitigate denial of service attacks. This limit *only* applies to " "decimal or other non-power-of-two number bases. Hexadecimal, octal, and " "binary conversions are unlimited. The limit can be configured." msgstr "" "CPython a une limite globale pour la conversion entre :class:`int` et :class:" "`str` pour atténuer les attaques par déni de service. Cette limite " "s'applique *uniquement* aux décimaux ou autres bases de nombres qui ne sont " "pas des puissances de deux. Les conversions hexadécimales, octales et " "binaires sont illimitées. La limite peut être configurée." #: library/stdtypes.rst:5479 msgid "" "The :class:`int` type in CPython is an arbitrary length number stored in " "binary form (commonly known as a \"bignum\"). There exists no algorithm that " "can convert a string to a binary integer or a binary integer to a string in " "linear time, *unless* the base is a power of 2. Even the best known " "algorithms for base 10 have sub-quadratic complexity. Converting a large " "value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." msgstr "" "Le type :class:`int` dans CPython stocke un nombre de longueur arbitraire " "sous forme binaire (communément appelé « *bignum* »). Il n'existe aucun " "algorithme capable de convertir une chaîne en un entier binaire ou un entier " "binaire en une chaîne en temps linéaire, sauf si la base est une puissance " "de 2. Même les meilleurs algorithmes connus pour la base 10 ont une " "complexité sous-quadratique. La conversion d'une grande valeur telle que " "``int('1' * 500_000)`` peut prendre plus d'une seconde sur un CPU rapide." #: library/stdtypes.rst:5486 msgid "" "Limiting conversion size offers a practical way to avoid `CVE-2020-10735 " "`_." msgstr "" "Limiter la taille de la conversion offre un moyen pratique de limiter la " "vulnérabilité `CVE-2020-10735 `_." #: library/stdtypes.rst:5489 msgid "" "The limit is applied to the number of digit characters in the input or " "output string when a non-linear conversion algorithm would be involved. " "Underscores and the sign are not counted towards the limit." msgstr "" "La limite est appliquée au nombre de caractères numériques dans la chaîne " "d'entrée ou de sortie lorsqu'un algorithme de conversion non linéaire doit " "être appliqué. Les traits de soulignement et le signe ne sont pas comptés " "dans la limite." #: library/stdtypes.rst:5493 msgid "" "When an operation would exceed the limit, a :exc:`ValueError` is raised:" msgstr "" "Si une opération va dépasser la limite, une :exc:`ValueError` est levée :" #: library/stdtypes.rst:5515 msgid "" "The default limit is 4300 digits as provided in :data:`sys.int_info." "default_max_str_digits `. The lowest limit that can be " "configured is 640 digits as provided in :data:`sys.int_info." "str_digits_check_threshold `." msgstr "" "La limite par défaut est de 4 300 chiffres comme indiqué dans :data:`sys." "int_info.default_max_str_digits `. La limite la plus basse " "pouvant être configurée est de 640 chiffres, comme indiqué dans :data:`sys." "int_info.str_digits_check_threshold `." #: library/stdtypes.rst:5520 msgid "Verification:" msgstr "Vérification :" #: library/stdtypes.rst:5535 msgid "Affected APIs" msgstr "API concernées" #: library/stdtypes.rst:5537 msgid "" "The limitation only applies to potentially slow conversions between :class:" "`int` and :class:`str` or :class:`bytes`:" msgstr "" "La limitation s'applique uniquement aux conversions potentiellement lentes " "entre :class:`int` et :class:`str` ou :class:`bytes` :" #: library/stdtypes.rst:5540 msgid "``int(string)`` with default base 10." msgstr "``int(string)`` en base 10 (par défaut)." #: library/stdtypes.rst:5541 msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" "``int(string, base)`` pour toutes les bases qui ne sont pas des puissances " "de 2." #: library/stdtypes.rst:5542 msgid "``str(integer)``." msgstr "``str(integer)``." #: library/stdtypes.rst:5543 msgid "``repr(integer)``." msgstr "``repr(integer)``." #: library/stdtypes.rst:5544 msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, ``" "\"{}\".format(integer)``, or ``b\"%d\" % integer``." msgstr "" "toute autre conversion de chaîne en base 10, par exemple ``f\"{integer}\"``, " "``\"{}\".format(integer)`` ou ``b\"%d\" % integer``." #: library/stdtypes.rst:5547 msgid "The limitations do not apply to functions with a linear algorithm:" msgstr "" "Les limitations ne s'appliquent pas aux fonctions avec un algorithme " "linéaire :" #: library/stdtypes.rst:5549 msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." msgstr "``int(chaîne, base)`` en base 2, 4, 8, 16 ou 32." #: library/stdtypes.rst:5550 msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr ":func:`int.from_bytes` et :func:`int.to_bytes`." #: library/stdtypes.rst:5551 msgid ":func:`hex`, :func:`oct`, :func:`bin`." msgstr ":func:`hex`, :func:`oct`, :func:`bin`." #: library/stdtypes.rst:5552 msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr ":ref:`formatspec` pour les nombres hexadécimaux, octaux et binaires." #: library/stdtypes.rst:5553 msgid ":class:`str` to :class:`float`." msgstr ":class:`str` vers :class:`float`." #: library/stdtypes.rst:5554 msgid ":class:`str` to :class:`decimal.Decimal`." msgstr ":class:`str` vers :class:`decimal.Decimal`." #: library/stdtypes.rst:5557 msgid "Configuring the limit" msgstr "Configuration de la limite" #: library/stdtypes.rst:5559 msgid "" "Before Python starts up you can use an environment variable or an " "interpreter command line flag to configure the limit:" msgstr "" "Avant le démarrage de Python, vous pouvez utiliser une variable " "d'environnement ou une option de ligne de commande d'interpréteur pour " "configurer la limite :" #: library/stdtypes.rst:5562 msgid "" ":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " "to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " "the limitation." msgstr "" ":envvar:`PYTHONINTMAXSTRDIGITS`, par exemple ``PYTHONINTMAXSTRDIGITS=640 " "python3`` pour fixer la limite à 640 chiffres ou ``PYTHONINTMAXSTRDIGITS=0 " "python3`` pour désactiver la limitation." #: library/stdtypes.rst:5565 msgid "" ":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " "int_max_str_digits=640``" msgstr "" ":option:`-X int_max_str_digits <-X>`, par exemple ``python3 -X " "int_max_str_digits=640``" #: library/stdtypes.rst:5567 msgid "" ":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" "`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " "env var and the ``-X`` option are set, the ``-X`` option takes precedence. A " "value of *-1* indicates that both were unset, thus a value of :data:`sys." "int_info.default_max_str_digits` was used during initialization." msgstr "" ":data:`sys.flags.int_max_str_digits` contient la valeur de :envvar:" "`PYTHONINTMAXSTRDIGITS` ou :option:`-X int_max_str_digits <-X>`. Si la " "variable d'environnement et l'option ``-X`` sont définies toutes les deux, " "l'option ``-X`` est prioritaire. Une valeur de *-1* indique que les deux " "n'étaient pas définies, donc qu'une valeur de :data:`sys.int_info." "default_max_str_digits` a été utilisée lors de l'initialisation." #: library/stdtypes.rst:5573 msgid "" "From code, you can inspect the current limit and set a new one using these :" "mod:`sys` APIs:" msgstr "" "Depuis le code, vous pouvez inspecter la limite actuelle et en définir une " "nouvelle à l'aide de ces API :mod:`sys` :" #: library/stdtypes.rst:5576 msgid "" ":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " "are a getter and setter for the interpreter-wide limit. Subinterpreters have " "their own limit." msgstr "" ":func:`sys.get_int_max_str_digits` et :func:`sys.set_int_max_str_digits` " "sont un accesseur et un mutateur pour la limite relative à l'interpréteur. " "Les sous-interprètes possèdent leur propre limite." #: library/stdtypes.rst:5580 msgid "" "Information about the default and minimum can be found in :attr:`sys." "int_info`:" msgstr "" "Des informations sur la valeur par défaut et le minimum peuvent être " "trouvées dans :attr:`sys.int_info` :" #: library/stdtypes.rst:5582 msgid "" ":data:`sys.int_info.default_max_str_digits ` is the compiled-" "in default limit." msgstr "" ":data:`sys.int_info.default_max_str_digits ` est la limite par " "défaut pour la compilation." #: library/stdtypes.rst:5584 msgid "" ":data:`sys.int_info.str_digits_check_threshold ` is the lowest " "accepted value for the limit (other than 0 which disables it)." msgstr "" ":data:`sys.int_info.str_digits_check_threshold ` est la valeur " "la plus basse acceptée pour la limite (autre que 0 qui la désactive)." # suit un : #: library/stdtypes.rst:5591 msgid "" "Setting a low limit *can* lead to problems. While rare, code exists that " "contains integer constants in decimal in their source that exceed the " "minimum threshold. A consequence of setting the limit is that Python source " "code containing decimal integer literals longer than the limit will " "encounter an error during parsing, usually at startup time or import time or " "even at installation time - anytime an up to date ``.pyc`` does not already " "exist for the code. A workaround for source that contains such large " "constants is to convert them to ``0x`` hexadecimal form as it has no limit." msgstr "" "fixer une limite basse *peut* entraîner des problèmes. Bien que rare, du " "code contenant des constantes entières en décimal dans la source qui dépasse " "le seuil minimum peut exister. Une conséquence de la définition de la limite " "est que le code source Python contenant des littéraux entiers décimaux plus " "longs que la limite lèvera une erreur lors de l'analyse, généralement au " "démarrage ou à l'importation ou même au moment de l'installation – dès qu'un " "``.pyc`` à jour n'existe pas déjà pour le code. Une solution de " "contournement pour les sources qui contiennent de si grandes constantes " "consiste à les convertir au format hexadécimal ``0x`` car il n'y a pas de " "limite." #: library/stdtypes.rst:5600 msgid "" "Test your application thoroughly if you use a low limit. Ensure your tests " "run with the limit set early via the environment or flag so that it applies " "during startup and even during any installation step that may invoke Python " "to precompile ``.py`` sources to ``.pyc`` files." msgstr "" "Testez soigneusement votre application si vous utilisez une limite basse. " "Assurez-vous que vos tests s'exécutent avec la limite définie au début *via* " "l'environnement ou l'option de ligne de commande afin qu'elle s'applique au " "démarrage et même lors de toute étape d'installation pouvant invoquer Python " "pour compiler les sources ``.py`` en fichiers ``.pyc``." #: library/stdtypes.rst:5606 msgid "Recommended configuration" msgstr "Configuration recommandée" #: library/stdtypes.rst:5608 msgid "" "The default :data:`sys.int_info.default_max_str_digits` is expected to be " "reasonable for most applications. If your application requires a different " "limit, set it from your main entry point using Python version agnostic code " "as these APIs were added in security patch releases in versions before 3.11." msgstr "" "La valeur par défaut :data:`sys.int_info.default_max_str_digits` devrait " "être raisonnable pour la plupart des applications. Si votre application " "nécessite une limite différente, définissez-la à partir de votre point " "d'entrée principal à l'aide d'un code indépendant de la version Python, car " "ces API ont été ajoutées dans des correctifs de sécurité des versions " "antérieures à 3.11." #: library/stdtypes.rst:5613 msgid "Example::" msgstr "Par exemple ::" #: library/stdtypes.rst:5625 msgid "If you need to disable it entirely, set it to ``0``." msgstr "Pour la désactiver entièrement, réglez-la à ``0``." #: library/stdtypes.rst:5629 msgid "Footnotes" msgstr "Notes" #: library/stdtypes.rst:5630 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." msgstr "" "Plus d'informations sur ces méthodes spéciales peuvent être trouvées dans le " "*Python Reference Manual* (:ref:`customization`)." #: library/stdtypes.rst:5633 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." msgstr "" "Par conséquent, la liste ``[1, 2]`` est considérée égale à ``[1.0, 2.0]``. " "Idem avec des *n*-uplets." #: library/stdtypes.rst:5636 msgid "They must have since the parser can't tell the type of the operands." msgstr "" "Nécessairement, puisque l'analyseur ne peut pas discerner le type des " "opérandes." #: library/stdtypes.rst:5638 msgid "" "Cased characters are those with general category property being one of \"Lu" "\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " "titlecase)." msgstr "" "Les caractères capitalisables sont ceux dont la propriété Unicode *general " "category* est soit \"Lu\" (pour *Letter*, *uppercase*), soit \"Ll\" (pour " "*Letter*, *lowercase*), soit \"Lt\" (pour *Letter*, *titlecase*)." #: library/stdtypes.rst:5641 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." msgstr "" "Pour insérer un *n*-uplet, vous devez donc donner un *n*-uplet d'un seul " "élément, contenant le *n*-uplet à insérer." #~ msgid "" #~ "By default, the *errors* argument is not checked for best performances, " #~ "but only used at the first encoding error. Enable the :ref:`Python " #~ "Development Mode `, or use a :ref:`debug build ` to " #~ "check *errors*." #~ msgstr "" #~ "Par défaut, l'argument *errors* n'est pas testé, mais seulement utilisé à " #~ "la première erreur d'encodage. Activez le :ref:`Python Development Mode " #~ "`, ou utilisez le :ref:`mode de débogage ` pour " #~ "vérifier *errors*." #~ msgid "Support for keyword arguments added." #~ msgstr "Gestion des arguments par mot-clé." #~ msgid "" #~ "By default, the *errors* argument is not checked for best performances, " #~ "but only used at the first decoding error. Enable the :ref:`Python " #~ "Development Mode `, or use a :ref:`debug build ` to " #~ "check *errors*." #~ msgstr "" #~ "Par défaut, pour de meilleures performances, l'argument *errors* n'est " #~ "pas testé, mais seulement utilisé à la première erreur d'encodage. " #~ "Activez le :ref:`Python Development Mode `, ou utilisez le :ref:" #~ "`mode de débogage ` pour vérifier *errors*." #~ msgid "" #~ "For Python 2.x users: In the Python 2.x series, a variety of implicit " #~ "conversions between 8-bit strings (the closest thing 2.x offers to a " #~ "built-in binary data type) and Unicode strings were permitted. This was a " #~ "backwards compatibility workaround to account for the fact that Python " #~ "originally only supported 8-bit text, and Unicode text was a later " #~ "addition. In Python 3.x, those implicit conversions are gone - " #~ "conversions between 8-bit binary data and Unicode text must be explicit, " #~ "and bytes and string objects will always compare unequal." #~ msgstr "" #~ "Pour les utilisateurs de Python 2.x : Dans la série 2.x de Python, une " #~ "variété de conversions implicites entre les chaînes 8-bit (la chose la " #~ "plus proche d'un type natif de données binaires offert par Python 2) et " #~ "des chaînes Unicode étaient permises. C'était une solution de " #~ "contournement, pour garder la rétro-compatibilité, considérant que Python " #~ "ne prenait initialement en charge que le texte 8 bits, le texte Unicode " #~ "est un ajout ultérieur. En Python 3.x, ces conversions implicites ont " #~ "disparues, les conversions entre les données binaires et texte Unicode " #~ "doivent être explicites, et les *bytes* sont toujours différents des " #~ "chaînes." #~ msgid "" #~ "Dictionaries can be created by placing a comma-separated list of ``key: " #~ "value`` pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}" #~ "`` or ``{4098: 'jack', 4127: 'sjoerd'}``, or by the :class:`dict` " #~ "constructor." #~ msgstr "" #~ "Il est possible de créer des dictionnaires en plaçant entre accolades une " #~ "liste de paires de ``key: value`` séparés par des virgules, par exemple: " #~ "``{'jack': 4098, 'sjoerd': 4127}`` ou ``{4098: 'jack', 4127: 'sjoerd'}``, " #~ "ou en utilisant le constructeur de :class:`dict`." #~ msgid "``s.pop([i])``" #~ msgstr "``s.pop([i])``"