1
0
Fork 0
python-docs-fr/tutorial/errors.po

752 lines
35 KiB
Plaintext
Raw Normal View History

2018-07-04 09:06:45 +00:00
# Copyright (C) 2001-2018, Python Software Foundation
2018-07-04 09:08:42 +00:00
# For licence information, see README file.
2016-10-30 09:46:26 +00:00
#
msgid ""
msgstr ""
2019-12-05 22:15:54 +00:00
"Project-Id-Version: Python 3\n"
2016-10-30 09:46:26 +00:00
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-01-15 22:33+0100\n"
"PO-Revision-Date: 2023-02-04 14:34+0100\n"
"Last-Translator: \n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-16 21:31:05 +00:00
"Language: fr\n"
2017-05-27 17:46:38 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"X-Generator: Poedit 3.2.1\n"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:5
2016-10-30 09:46:26 +00:00
msgid "Errors and Exceptions"
msgstr "Erreurs et exceptions"
#: tutorial/errors.rst:7
2016-10-30 09:46:26 +00:00
msgid ""
"Until now error messages haven't been more than mentioned, but if you have "
"tried out the examples you have probably seen some. There are (at least) "
"two distinguishable kinds of errors: *syntax errors* and *exceptions*."
msgstr ""
2018-02-10 15:26:49 +00:00
"Jusqu'ici, les messages d'erreurs ont seulement été mentionnés. Mais si vous "
"avez essayé les exemples vous avez certainement vu plus que cela. En fait, "
"il y a au moins deux types d'erreurs à distinguer : les *erreurs de syntaxe* "
2018-02-10 15:26:49 +00:00
"et les *exceptions*."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:15
2016-10-30 09:46:26 +00:00
msgid "Syntax Errors"
msgstr "Les erreurs de syntaxe"
#: tutorial/errors.rst:17
2016-10-30 09:46:26 +00:00
msgid ""
"Syntax errors, also known as parsing errors, are perhaps the most common "
"kind of complaint you get while you are still learning Python::"
msgstr ""
"Les erreurs de syntaxe, qui sont des erreurs d'analyse du code, sont peut-"
"être celles que vous rencontrez le plus souvent lorsque vous êtes encore en "
"phase d'apprentissage de Python ::"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:26
2016-10-30 09:46:26 +00:00
msgid ""
"The parser repeats the offending line and displays a little 'arrow' pointing "
"at the earliest point in the line where the error was detected. The error "
"is caused by (or at least detected at) the token *preceding* the arrow: in "
"the example, the error is detected at the function :func:`print`, since a "
"colon (``':'``) is missing before it. File name and line number are printed "
"so you know where to look in case the input came from a script."
msgstr ""
"L'analyseur indique la ligne incriminée et affiche une petite « flèche » "
2016-10-30 09:46:26 +00:00
"pointant vers le premier endroit de la ligne où l'erreur a été détectée. "
"L'erreur est causée (ou, au moins, a été détectée comme telle) par le "
"symbole placé *avant* la flèche. Dans cet exemple la flèche est sur la "
2018-02-10 15:26:49 +00:00
"fonction :func:`print` car il manque deux points (``':'``) juste avant. Le "
"nom du fichier et le numéro de ligne sont affichés pour vous permettre de "
2016-10-30 09:46:26 +00:00
"localiser facilement l'erreur lorsque le code provient d'un script."
#: tutorial/errors.rst:37
2016-10-30 09:46:26 +00:00
msgid "Exceptions"
msgstr "Exceptions"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:39
2016-10-30 09:46:26 +00:00
msgid ""
"Even if a statement or expression is syntactically correct, it may cause an "
"error when an attempt is made to execute it. Errors detected during "
"execution are called *exceptions* and are not unconditionally fatal: you "
"will soon learn how to handle them in Python programs. Most exceptions are "
"not handled by programs, however, and result in error messages as shown "
"here::"
msgstr ""
"Même si une instruction ou une expression est syntaxiquement correcte, elle "
"peut générer une erreur lors de son exécution. Les erreurs détectées durant "
"l'exécution sont appelées des *exceptions* et ne sont pas toujours fatales : "
2018-02-10 15:26:49 +00:00
"nous apprendrons bientôt comment les traiter dans vos programmes. La plupart "
2016-10-30 09:46:26 +00:00
"des exceptions toutefois ne sont pas prises en charge par les programmes, ce "
"qui génère des messages d'erreurs comme celui-ci ::"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:58
2016-10-30 09:46:26 +00:00
msgid ""
"The last line of the error message indicates what happened. Exceptions come "
"in different types, and the type is printed as part of the message: the "
"types in the example are :exc:`ZeroDivisionError`, :exc:`NameError` and :exc:"
"`TypeError`. The string printed as the exception type is the name of the "
"built-in exception that occurred. This is true for all built-in exceptions, "
"but need not be true for user-defined exceptions (although it is a useful "
"convention). Standard exception names are built-in identifiers (not reserved "
"keywords)."
msgstr ""
2018-02-10 15:26:49 +00:00
"La dernière ligne du message d'erreur indique ce qui s'est passé. Les "
"exceptions peuvent être de différents types et ce type est indiqué dans le "
"message : les types indiqués dans l'exemple sont :exc:`ZeroDivisionError`, :"
2016-10-30 09:46:26 +00:00
"exc:`NameError` et :exc:`TypeError`. Le texte affiché comme type de "
"l'exception est le nom de l'exception native qui a été déclenchée. Ceci est "
2018-02-10 15:26:49 +00:00
"vrai pour toutes les exceptions natives mais n'est pas une obligation pour "
2016-10-30 09:46:26 +00:00
"les exceptions définies par l'utilisateur (même si c'est une convention bien "
"pratique). Les noms des exceptions standards sont des identifiants natifs "
"(pas des mots-clef réservés)."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:66
2016-10-30 09:46:26 +00:00
msgid ""
"The rest of the line provides detail based on the type of exception and what "
"caused it."
msgstr ""
"Le reste de la ligne fournit plus de détails en fonction du type de "
2018-02-10 15:26:49 +00:00
"l'exception et de ce qui l'a causée."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:69
2016-10-30 09:46:26 +00:00
msgid ""
"The preceding part of the error message shows the context where the "
2020-07-20 08:56:42 +00:00
"exception occurred, in the form of a stack traceback. In general it contains "
2016-10-30 09:46:26 +00:00
"a stack traceback listing source lines; however, it will not display lines "
"read from standard input."
msgstr ""
"La partie précédente du message d'erreur indique le contexte dans lequel "
"s'est produite l'exception, sous la forme d'une trace de pile d'exécution. "
2022-04-26 16:14:10 +00:00
"En général, celle-ci contient les lignes du code source ; toutefois, les "
"lignes lues à partir de l'entrée standard ne sont pas affichées."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:74
2016-10-30 09:46:26 +00:00
msgid ""
":ref:`bltin-exceptions` lists the built-in exceptions and their meanings."
msgstr ""
2018-02-10 15:26:49 +00:00
"Vous trouvez la liste des exceptions natives et leur signification dans :ref:"
"`bltin-exceptions`."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:80
2016-10-30 09:46:26 +00:00
msgid "Handling Exceptions"
msgstr "Gestion des exceptions"
#: tutorial/errors.rst:82
2016-10-30 09:46:26 +00:00
msgid ""
"It is possible to write programs that handle selected exceptions. Look at "
"the following example, which asks the user for input until a valid integer "
"has been entered, but allows the user to interrupt the program (using :kbd:"
"`Control-C` or whatever the operating system supports); note that a user-"
"generated interruption is signalled by raising the :exc:`KeyboardInterrupt` "
"exception. ::"
msgstr ""
"Il est possible d'écrire des programmes qui prennent en charge certaines "
"exceptions. Regardez l'exemple suivant, qui demande une saisie à "
"l'utilisateur jusqu'à ce qu'un entier valide ait été entré, mais permet à "
"l'utilisateur d'interrompre le programme (en utilisant :kbd:`Control-C` ou "
2022-04-26 16:14:10 +00:00
"un autre raccourci que le système accepte) ; notez qu'une interruption "
2016-10-30 09:46:26 +00:00
"générée par l'utilisateur est signalée en levant l'exception :exc:"
"`KeyboardInterrupt`. ::"
2016-10-30 09:46:26 +00:00
# début d'énumération
#: tutorial/errors.rst:96
2016-10-30 09:46:26 +00:00
msgid "The :keyword:`try` statement works as follows."
msgstr "L'instruction :keyword:`try` fonctionne comme ceci :"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:98
2016-10-30 09:46:26 +00:00
msgid ""
"First, the *try clause* (the statement(s) between the :keyword:`try` and :"
"keyword:`except` keywords) is executed."
msgstr ""
2018-02-10 15:26:49 +00:00
"premièrement, la *clause try* (instruction(s) placée(s) entre les mots-clés :"
"keyword:`try` et :keyword:`except`) est exécutée."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:101
2016-10-30 09:46:26 +00:00
msgid ""
"If no exception occurs, the *except clause* is skipped and execution of the :"
"keyword:`try` statement is finished."
msgstr ""
2018-02-10 15:26:49 +00:00
"si aucune exception n'intervient, la clause ``except`` est sautée et "
"l'exécution de l'instruction :keyword:`try` est terminée."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:104
2016-10-30 09:46:26 +00:00
msgid ""
"If an exception occurs during execution of the :keyword:`try` clause, the "
"rest of the clause is skipped. Then, if its type matches the exception "
"named after the :keyword:`except` keyword, the *except clause* is executed, "
"and then execution continues after the try/except block."
2016-10-30 09:46:26 +00:00
msgstr ""
"si une exception intervient pendant l'exécution de la clause :keyword:`try`, "
"le reste de cette clause est sauté. Si le type d'exception levée correspond "
"à un nom indiqué après le mot-clé :keyword:`except`, la clause ``except`` "
"correspondante est exécutée, puis l'exécution continue après le bloc ``try``/"
"``except``."
2016-10-30 09:46:26 +00:00
# dernier élément de l'énumération
#: tutorial/errors.rst:109
2016-10-30 09:46:26 +00:00
msgid ""
"If an exception occurs which does not match the exception named in the "
"*except clause*, it is passed on to outer :keyword:`try` statements; if no "
2016-10-30 09:46:26 +00:00
"handler is found, it is an *unhandled exception* and execution stops with a "
"message as shown above."
msgstr ""
2018-02-10 15:26:49 +00:00
"si une exception intervient et ne correspond à aucune exception mentionnée "
"dans la clause ``except``, elle est transmise à l'instruction :keyword:`try` "
2022-04-26 16:14:10 +00:00
"de niveau supérieur ; si aucun gestionnaire d'exception n'est trouvé, il "
2016-10-30 09:46:26 +00:00
"s'agit d'une *exception non gérée* et l'exécution s'arrête avec un message "
"comme indiqué ci-dessus."
#: tutorial/errors.rst:114
2016-10-30 09:46:26 +00:00
msgid ""
"A :keyword:`try` statement may have more than one *except clause*, to "
"specify handlers for different exceptions. At most one handler will be "
"executed. Handlers only handle exceptions that occur in the corresponding "
"*try clause*, not in other handlers of the same :keyword:`!try` statement. "
"An *except clause* may name multiple exceptions as a parenthesized tuple, "
"for example::"
2016-10-30 09:46:26 +00:00
msgstr ""
2018-02-10 15:26:49 +00:00
"Une instruction :keyword:`try` peut comporter plusieurs clauses ``except`` "
"pour permettre la prise en charge de différentes exceptions. Mais un seul "
2016-10-30 09:46:26 +00:00
"gestionnaire, au plus, sera exécuté. Les gestionnaires ne prennent en charge "
"que les exceptions qui interviennent dans la clause :keyword:`!try` "
"correspondante, pas dans d'autres gestionnaires de la même instruction :"
"keyword:`!try`. Mais une même clause ``except`` peut citer plusieurs "
"exceptions sous la forme d'un *n*-uplet entre parenthèses, comme dans cet "
"exemple ::"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:123
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"A class in an :keyword:`except` clause is compatible with an exception if it "
"is the same class or a base class thereof (but not the other way around --- "
"an *except clause* listing a derived class is not compatible with a base "
"class). For example, the following code will print B, C, D in that order::"
2017-04-02 20:14:06 +00:00
msgstr ""
2017-04-03 07:23:36 +00:00
"Une classe dans une clause :keyword:`except` est compatible avec une "
2018-02-10 15:26:49 +00:00
"exception si elle est de la même classe ou d'une de ses classes dérivées. "
"Mais l'inverse n'est pas vrai, une clause ``except`` spécifiant une classe "
"dérivée n'est pas compatible avec une classe mère. Par exemple, le code "
"suivant affiche B, C et D dans cet ordre ::"
2017-04-02 20:14:06 +00:00
#: tutorial/errors.rst:147
2017-04-02 20:14:06 +00:00
msgid ""
"Note that if the *except clauses* were reversed (with ``except B`` first), "
"it would have printed B, B, B --- the first matching *except clause* is "
"triggered."
2017-04-02 20:14:06 +00:00
msgstr ""
2018-02-10 15:26:49 +00:00
"Notez que si les clauses ``except`` avaient été inversées (avec ``except B`` "
"en premier), il aurait affiché B, B, B — la première clause ``except`` qui "
"correspond est déclenchée."
2017-04-02 20:14:06 +00:00
#: tutorial/errors.rst:150
2017-04-02 20:14:06 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"When an exception occurs, it may have associated values, also known as the "
"exception's *arguments*. The presence and types of the arguments depend on "
"the exception type."
2016-10-30 09:46:26 +00:00
msgstr ""
2022-05-22 21:15:02 +00:00
"Quand une exception intervient, une valeur peut lui être associée, que l'on "
"appelle *l'argument* de l'exception. La présence de cet argument et son type "
"dépendent du type de l'exception."
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:154
2016-10-30 09:46:26 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"The *except clause* may specify a variable after the exception name. The "
"variable is bound to the exception instance which typically has an ``args`` "
"attribute that stores the arguments. For convenience, builtin exception "
"types define :meth:`__str__` to print all the arguments without explicitly "
"accessing ``.args``. ::"
msgstr ""
2022-05-22 21:15:02 +00:00
"La clause ``except`` peut spécifier un nom de variable après le nom de "
"l'exception. Cette variable est liée à l'instance d'exception avec les "
"arguments stockés dans l'attribut ``args``. Pour plus de commodité, "
"l'instance de l'exception définit la méthode :meth:`__str__` afin que les "
"arguments puissent être affichés directement sans avoir à référencer ``."
"args``. ::"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:177
msgid ""
"The exception's :meth:`__str__` output is printed as the last part "
"('detail') of the message for unhandled exceptions."
msgstr ""
"La sortie produite par :meth:`__str__` de l'exception est affichée en "
"dernière partie (« détail ») du message des exceptions qui ne sont pas "
"gérées."
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:180
msgid ""
":exc:`BaseException` is the common base class of all exceptions. One of its "
"subclasses, :exc:`Exception`, is the base class of all the non-fatal "
"exceptions. Exceptions which are not subclasses of :exc:`Exception` are not "
"typically handled, because they are used to indicate that the program should "
"terminate. They include :exc:`SystemExit` which is raised by :meth:`sys."
"exit` and :exc:`KeyboardInterrupt` which is raised when a user wishes to "
"interrupt the program."
msgstr ""
":exc:`BaseException` est la classe mère de toutes les exceptions. Une de ses "
"sous-classes, :exc:`Exception`, est la classe mère de toutes les exceptions "
"non fatales. Les exceptions qui ne sont pas des sous-classes de :exc:"
"`Exception` ne sont normalement pas gérées, car elles sont utilisées pour "
"indiquer que le programme doit se terminer. C'est le cas de :exc:"
"`SystemExit` qui est levée par :meth:`sys.exit` et :exc:`KeyboardInterrupt` "
"qui est levée quand l'utilisateur souhaite interrompre le programme."
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:188
msgid ""
":exc:`Exception` can be used as a wildcard that catches (almost) everything. "
"However, it is good practice to be as specific as possible with the types of "
"exceptions that we intend to handle, and to allow any unexpected exceptions "
"to propagate on."
msgstr ""
":exc:`Exception` peut être utilisée pour intercepter (presque) tous les cas. "
"Cependant, une bonne pratique consiste à être aussi précis que possible dans "
"les types d'exception que l'on souhaite gérer et autoriser toutes les "
"exceptions non prévues à se propager."
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:193
msgid ""
"The most common pattern for handling :exc:`Exception` is to print or log the "
"exception and then re-raise it (allowing a caller to handle the exception as "
"well)::"
msgstr ""
"La manière la plus utilisée pour gérer une :exc:`Exception` consiste à "
"afficher ou journaliser l'exception et ensuite la lever à nouveau afin de "
"permettre à l'appelant de la gérer à son tour ::"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:211
msgid ""
2016-10-30 09:46:26 +00:00
"The :keyword:`try` ... :keyword:`except` statement has an optional *else "
"clause*, which, when present, must follow all *except clauses*. It is "
"useful for code that must be executed if the *try clause* does not raise an "
"exception. For example::"
2016-10-30 09:46:26 +00:00
msgstr ""
2022-04-26 16:14:10 +00:00
"L'instruction :keyword:`try` … :keyword:`except` accepte également une "
"clause ``else`` optionnelle qui, lorsqu'elle est présente, doit se placer "
2018-02-10 15:26:49 +00:00
"après toutes les clauses ``except``. Elle est utile pour du code qui doit "
"être exécuté lorsqu'aucune exception n'a été levée par la clause ``try``. "
"Par exemple ::"
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:225
2016-10-30 09:46:26 +00:00
msgid ""
2018-12-24 13:20:55 +00:00
"The use of the :keyword:`!else` clause is better than adding additional code "
2016-10-30 09:46:26 +00:00
"to the :keyword:`try` clause because it avoids accidentally catching an "
2018-12-24 13:20:55 +00:00
"exception that wasn't raised by the code being protected by the :keyword:`!"
"try` ... :keyword:`!except` statement."
2016-10-30 09:46:26 +00:00
msgstr ""
2019-01-03 20:36:36 +00:00
"Il vaut mieux utiliser la clause :keyword:`!else` plutôt que d'ajouter du "
2018-02-10 15:26:49 +00:00
"code à la clause :keyword:`try` car cela évite de capturer accidentellement "
2016-10-30 09:46:26 +00:00
"une exception qui n'a pas été levée par le code initialement protégé par "
2022-04-26 16:14:10 +00:00
"l'instruction :keyword:`!try` … :keyword:`!except`."
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:230
2016-10-30 09:46:26 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"Exception handlers do not handle only exceptions that occur immediately in "
"the *try clause*, but also those that occur inside functions that are called "
"(even indirectly) in the *try clause*. For example::"
2016-10-30 09:46:26 +00:00
msgstr ""
"Les gestionnaires d'exceptions n'interceptent pas que les exceptions qui "
"sont levées immédiatement dans leur clause ``try``, mais aussi celles qui "
"sont levées au sein de fonctions appelées (parfois indirectement) dans la "
"clause ``try``. Par exemple ::"
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:248
2016-10-30 09:46:26 +00:00
msgid "Raising Exceptions"
msgstr "Déclencher des exceptions"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:250
2016-10-30 09:46:26 +00:00
msgid ""
"The :keyword:`raise` statement allows the programmer to force a specified "
"exception to occur. For example::"
msgstr ""
"L'instruction :keyword:`raise` permet au programmeur de déclencher une "
"exception spécifique. Par exemple ::"
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:258
2016-10-30 09:46:26 +00:00
msgid ""
"The sole argument to :keyword:`raise` indicates the exception to be raised. "
"This must be either an exception instance or an exception class (a class "
2022-05-22 21:15:02 +00:00
"that derives from :class:`BaseException`, such as :exc:`Exception` or one of "
"its subclasses). If an exception class is passed, it will be implicitly "
"instantiated by calling its constructor with no arguments::"
2016-10-30 09:46:26 +00:00
msgstr ""
"Le seul argument à :keyword:`raise` indique l'exception à déclencher. Cela "
"peut être soit une instance d'exception, soit une classe d'exception (une "
"classe dérivée de :class:`BaseException`, telle que :exc:`Exception` ou une "
"de ses sous-classes). Si une classe est donnée, elle est implicitement "
"instanciée *via* l'appel de son constructeur, sans argument ::"
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:266
2016-10-30 09:46:26 +00:00
msgid ""
"If you need to determine whether an exception was raised but don't intend to "
"handle it, a simpler form of the :keyword:`raise` statement allows you to re-"
"raise the exception::"
msgstr ""
2018-02-10 15:26:49 +00:00
"Si vous avez besoin de savoir si une exception a été levée mais que vous "
"n'avez pas intention de la gérer, une forme plus simple de l'instruction :"
"keyword:`raise` permet de propager l'exception ::"
2016-10-30 09:46:26 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:285
2020-07-20 08:56:42 +00:00
msgid "Exception Chaining"
2020-09-30 12:44:08 +00:00
msgstr "Chaînage d'exceptions"
2020-07-20 08:56:42 +00:00
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:287
2020-07-20 08:56:42 +00:00
msgid ""
"If an unhandled exception occurs inside an :keyword:`except` section, it "
"will have the exception being handled attached to it and included in the "
"error message::"
msgstr ""
"Si une exception non gérée se produit à l'intérieur d'une section :keyword:"
"`except`, l'exception en cours de traitement est jointe à l'exception non "
"gérée et incluse dans le message d'erreur ::"
#: tutorial/errors.rst:306
msgid ""
"To indicate that an exception is a direct consequence of another, the :"
"keyword:`raise` statement allows an optional :keyword:`from<raise>` clause::"
2020-07-20 08:56:42 +00:00
msgstr ""
"Pour indiquer qu'une exception est la conséquence directe d'une autre, "
"l'instruction :keyword:`raise` autorise une clause facultative :keyword:"
"`from<raise>` ::"
2020-07-20 08:56:42 +00:00
#: tutorial/errors.rst:312
2020-07-20 08:56:42 +00:00
msgid "This can be useful when you are transforming exceptions. For example::"
msgstr ""
2020-09-30 12:44:08 +00:00
"Cela peut être utile lorsque vous transformez des exceptions. Par exemple ::"
2020-07-20 08:56:42 +00:00
#: tutorial/errors.rst:333
2020-07-20 08:56:42 +00:00
msgid ""
"It also allows disabling automatic exception chaining using the ``from "
"None`` idiom::"
2020-07-20 08:56:42 +00:00
msgstr ""
"Cela permet également de désactiver le chaînage automatique des exceptions à "
"l'aide de l'idiome ``from None`` ::"
2020-07-20 08:56:42 +00:00
#: tutorial/errors.rst:345
2020-12-18 06:09:57 +00:00
msgid ""
"For more information about chaining mechanics, see :ref:`bltin-exceptions`."
msgstr ""
2021-04-13 08:21:03 +00:00
"Pour plus d'informations sur les mécanismes de chaînage, voir :ref:`bltin-"
"exceptions`."
2020-12-18 06:09:57 +00:00
#: tutorial/errors.rst:351
2016-10-30 09:46:26 +00:00
msgid "User-defined Exceptions"
msgstr "Exceptions définies par l'utilisateur"
#: tutorial/errors.rst:353
2016-10-30 09:46:26 +00:00
msgid ""
"Programs may name their own exceptions by creating a new exception class "
"(see :ref:`tut-classes` for more about Python classes). Exceptions should "
"typically be derived from the :exc:`Exception` class, either directly or "
"indirectly."
msgstr ""
"Les programmes peuvent nommer leurs propres exceptions en créant une "
"nouvelle classe d'exception (voir :ref:`tut-classes` pour en savoir plus sur "
"les classes de Python). Les exceptions sont typiquement dérivées de la "
"classe :exc:`Exception`, directement ou non."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:357
2016-10-30 09:46:26 +00:00
msgid ""
"Exception classes can be defined which do anything any other class can do, "
"but are usually kept simple, often only offering a number of attributes that "
"allow information about the error to be extracted by handlers for the "
2022-03-23 17:40:12 +00:00
"exception."
2016-10-30 09:46:26 +00:00
msgstr ""
"Les classes d'exceptions sont des classes comme les autres, et peuvent donc "
"utiliser toutes les fonctionnalités des classes. Néanmoins, en général, "
"elles demeurent assez simples, et se contentent d'offrir des attributs qui "
"permettent aux gestionnaires de ces exceptions d'extraire les informations "
"relatives à l'erreur qui s'est produite."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:361
2016-10-30 09:46:26 +00:00
msgid ""
2018-11-29 15:13:39 +00:00
"Most exceptions are defined with names that end in \"Error\", similar to the "
2016-10-30 09:46:26 +00:00
"naming of the standard exceptions."
msgstr ""
"La plupart des exceptions sont définies avec des noms qui se terminent par "
2018-02-10 15:26:49 +00:00
"\"Error\", comme les exceptions standards."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:364
2016-10-30 09:46:26 +00:00
msgid ""
"Many standard modules define their own exceptions to report errors that may "
2022-05-22 21:15:02 +00:00
"occur in functions they define."
2016-10-30 09:46:26 +00:00
msgstr ""
2018-02-10 15:26:49 +00:00
"Beaucoup de modules standards définissent leurs propres exceptions pour "
"signaler les erreurs possibles dans les fonctions qu'ils définissent."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:371
2016-10-30 09:46:26 +00:00
msgid "Defining Clean-up Actions"
msgstr "Définition d'actions de nettoyage"
#: tutorial/errors.rst:373
2016-10-30 09:46:26 +00:00
msgid ""
"The :keyword:`try` statement has another optional clause which is intended "
"to define clean-up actions that must be executed under all circumstances. "
"For example::"
msgstr ""
"L'instruction :keyword:`try` a une autre clause optionnelle qui est destinée "
"à définir des actions de nettoyage devant être exécutées dans certaines "
"circonstances. Par exemple ::"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:387
2016-10-30 09:46:26 +00:00
msgid ""
2020-05-24 14:31:50 +00:00
"If a :keyword:`finally` clause is present, the :keyword:`!finally` clause "
2019-10-09 16:10:12 +00:00
"will execute as the last task before the :keyword:`try` statement completes. "
2020-05-24 14:31:50 +00:00
"The :keyword:`!finally` clause runs whether or not the :keyword:`!try` "
2019-10-09 16:10:12 +00:00
"statement produces an exception. The following points discuss more complex "
"cases when an exception occurs:"
msgstr ""
2020-09-30 12:44:08 +00:00
"Si la clause :keyword:`finally` est présente, la clause :keyword:`!finally` "
"est la dernière tâche exécutée avant la fin du bloc :keyword:`try`. La "
2020-09-30 12:44:08 +00:00
"clause :keyword:`!finally` se lance que le bloc :keyword:`!try` produise une "
"exception ou non. Les prochains points parlent de cas plus complexes "
"lorsqu'une exception apparait :"
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:393
2019-10-09 16:10:12 +00:00
msgid ""
"If an exception occurs during execution of the :keyword:`!try` clause, the "
"exception may be handled by an :keyword:`except` clause. If the exception is "
2020-05-24 14:31:50 +00:00
"not handled by an :keyword:`!except` clause, the exception is re-raised "
"after the :keyword:`!finally` clause has been executed."
2019-10-09 16:10:12 +00:00
msgstr ""
"Si une exception se produit durant l'exécution de la clause :keyword:`!try`, "
"elle peut être récupérée par une clause :keyword:`except`. Si l'exception "
2020-09-30 12:44:08 +00:00
"n'est pas récupérée par une clause :keyword:`!except`, l'exception est levée "
"à nouveau après que la clause :keyword:`!finally` a été exécutée."
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:399
2019-10-09 16:10:12 +00:00
msgid ""
"An exception could occur during execution of an :keyword:`!except` or :"
"keyword:`!else` clause. Again, the exception is re-raised after the :keyword:"
"`!finally` clause has been executed."
msgstr ""
"Une exception peut se produire durant l'exécution d'une clause :keyword:`!"
"except` ou :keyword:`!else`. Encore une fois, l'exception est reprise après "
"que la clause :keyword:`!finally` a été exécutée."
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:403
msgid ""
"If the :keyword:`!finally` clause executes a :keyword:`break`, :keyword:"
"`continue` or :keyword:`return` statement, exceptions are not re-raised."
msgstr ""
"Si dans l'exécution d'un bloc :keyword:`!finally`, on atteint une "
"instruction :keyword:`break`, :keyword:`continue` ou :keyword:`return`, "
"alors les exceptions ne sont pas reprises."
#: tutorial/errors.rst:407
2019-10-09 16:10:12 +00:00
msgid ""
"If the :keyword:`!try` statement reaches a :keyword:`break`, :keyword:"
2020-05-24 14:31:50 +00:00
"`continue` or :keyword:`return` statement, the :keyword:`!finally` clause "
"will execute just prior to the :keyword:`!break`, :keyword:`!continue` or :"
"keyword:`!return` statement's execution."
2019-10-09 16:10:12 +00:00
msgstr ""
"Si dans l'exécution d'un bloc :keyword:`!try`, on atteint une instruction :"
"keyword:`break`, :keyword:`continue` ou :keyword:`return`, alors la clause :"
2020-09-30 12:44:08 +00:00
"keyword:`!finally` s'exécute juste avant l'exécution de :keyword:`!break`, :"
"keyword:`!continue` ou :keyword:`!return`."
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:413
2019-10-09 16:10:12 +00:00
msgid ""
2020-05-24 14:31:50 +00:00
"If a :keyword:`!finally` clause includes a :keyword:`!return` statement, the "
"returned value will be the one from the :keyword:`!finally` clause's :"
"keyword:`!return` statement, not the value from the :keyword:`!try` "
"clause's :keyword:`!return` statement."
2019-10-09 16:10:12 +00:00
msgstr ""
2020-09-30 12:44:08 +00:00
"Si la clause :keyword:`!finally` contient une instruction :keyword:`!"
"return`, la valeur retournée sera celle du :keyword:`!return` de la clause :"
"keyword:`!finally`, et non la valeur du :keyword:`!return` de la clause :"
"keyword:`!try`."
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:419
2019-10-09 16:10:12 +00:00
msgid "For example::"
msgstr "Par exemple ::"
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:430
2019-10-09 16:10:12 +00:00
msgid "A more complicated example::"
msgstr "Un exemple plus compliqué ::"
2019-10-09 16:10:12 +00:00
#: tutorial/errors.rst:455
2016-10-30 09:46:26 +00:00
msgid ""
"As you can see, the :keyword:`finally` clause is executed in any event. "
"The :exc:`TypeError` raised by dividing two strings is not handled by the :"
2018-12-24 13:20:55 +00:00
"keyword:`except` clause and therefore re-raised after the :keyword:`!"
"finally` clause has been executed."
2016-10-30 09:46:26 +00:00
msgstr ""
"Comme vous pouvez le voir, la clause :keyword:`finally` est exécutée dans "
2018-02-10 15:26:49 +00:00
"tous les cas. L'exception de type :exc:`TypeError`, déclenchée en divisant "
"deux chaînes de caractères, n'est pas prise en charge par la clause :keyword:"
2019-01-03 20:36:36 +00:00
"`except` et est donc propagée après que la clause :keyword:`!finally` a été "
2018-02-10 15:26:49 +00:00
"exécutée."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:460
2016-10-30 09:46:26 +00:00
msgid ""
"In real world applications, the :keyword:`finally` clause is useful for "
"releasing external resources (such as files or network connections), "
"regardless of whether the use of the resource was successful."
msgstr ""
2018-02-10 15:26:49 +00:00
"Dans les vraies applications, la clause :keyword:`finally` est notamment "
2016-10-30 09:46:26 +00:00
"utile pour libérer des ressources externes (telles que des fichiers ou des "
2018-02-10 15:26:49 +00:00
"connexions réseau), quelle qu'ait été l'utilisation de ces ressources."
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:468
2016-10-30 09:46:26 +00:00
msgid "Predefined Clean-up Actions"
msgstr "Actions de nettoyage prédéfinies"
#: tutorial/errors.rst:470
2016-10-30 09:46:26 +00:00
msgid ""
"Some objects define standard clean-up actions to be undertaken when the "
"object is no longer needed, regardless of whether or not the operation using "
"the object succeeded or failed. Look at the following example, which tries "
"to open a file and print its contents to the screen. ::"
msgstr ""
"Certains objets définissent des actions de nettoyage standards qui doivent "
"être exécutées lorsque l'objet n'est plus nécessaire, indépendamment du fait "
"que l'opération ayant utilisé l'objet ait réussi ou non. Regardez l'exemple "
"suivant, qui tente d'ouvrir un fichier et d'afficher son contenu à l'écran ::"
2016-10-30 09:46:26 +00:00
#: tutorial/errors.rst:478
2016-10-30 09:46:26 +00:00
msgid ""
"The problem with this code is that it leaves the file open for an "
"indeterminate amount of time after this part of the code has finished "
"executing. This is not an issue in simple scripts, but can be a problem for "
"larger applications. The :keyword:`with` statement allows objects like files "
"to be used in a way that ensures they are always cleaned up promptly and "
"correctly. ::"
msgstr ""
"Le problème avec ce code est qu'il laisse le fichier ouvert pendant une "
2018-02-10 15:26:49 +00:00
"durée indéterminée après que le code a fini de s'exécuter. Ce n'est pas un "
2016-10-30 09:46:26 +00:00
"problème avec des scripts simples, mais peut l'être au sein d'applications "
"plus conséquentes. L'instruction :keyword:`with` permet d'utiliser certains "
"objets comme des fichiers d'une façon qui assure qu'ils seront toujours "
"nettoyés rapidement et correctement. ::"
#: tutorial/errors.rst:488
2016-10-30 09:46:26 +00:00
msgid ""
"After the statement is executed, the file *f* is always closed, even if a "
"problem was encountered while processing the lines. Objects which, like "
"files, provide predefined clean-up actions will indicate this in their "
"documentation."
msgstr ""
2018-03-20 23:00:20 +00:00
"Après l'exécution du bloc, le fichier *f* est toujours fermé, même si un "
"problème est survenu pendant l'exécution de ces lignes. D'autres objets qui, "
"comme pour les fichiers, fournissent des actions de nettoyage prédéfinies "
"l'indiquent dans leur documentation."
2022-03-23 17:40:12 +00:00
#: tutorial/errors.rst:496
2022-03-23 17:40:12 +00:00
msgid "Raising and Handling Multiple Unrelated Exceptions"
msgstr "Levée et gestion de multiples exceptions non corrélées"
2022-03-23 17:40:12 +00:00
#: tutorial/errors.rst:498
2022-03-23 17:40:12 +00:00
msgid ""
"There are situations where it is necessary to report several exceptions that "
"have occurred. This is often the case in concurrency frameworks, when "
2022-03-23 17:40:12 +00:00
"several tasks may have failed in parallel, but there are also other use "
"cases where it is desirable to continue execution and collect multiple "
"errors rather than raise the first exception."
msgstr ""
"Il existe des situations où il est nécessaire de signaler plusieurs "
"exceptions qui se sont produites. C'est souvent le cas dans les programmes à "
"multiples fils, lorsque plusieurs tâches échouent en parallèle. Mais il "
"existe également d'autres cas où il est souhaitable de poursuivre "
"l'exécution, de collecter plusieurs erreurs plutôt que de lever la première "
"exception rencontrée."
2022-03-23 17:40:12 +00:00
#: tutorial/errors.rst:504
2022-03-23 17:40:12 +00:00
msgid ""
"The builtin :exc:`ExceptionGroup` wraps a list of exception instances so "
"that they can be raised together. It is an exception itself, so it can be "
"caught like any other exception. ::"
msgstr ""
"L'idiome natif :exc:`ExceptionGroup` englobe une liste d'instances "
"d'exceptions afin de pouvoir les lever en même temps. C'est une exception, "
"et peut donc être interceptée comme toute autre exception. ::"
2022-03-23 17:40:12 +00:00
#: tutorial/errors.rst:530
2022-03-23 17:40:12 +00:00
msgid ""
"By using ``except*`` instead of ``except``, we can selectively handle only "
"the exceptions in the group that match a certain type. In the following "
"example, which shows a nested exception group, each ``except*`` clause "
"extracts from the group exceptions of a certain type while letting all other "
"exceptions propagate to other clauses and eventually to be reraised. ::"
msgstr ""
"En utilisant ``except*`` au lieu de ``except``, vous pouvez choisir de ne "
"gérer que les exceptions du groupe qui correspondent à un certain type. Dans "
"l'exemple qui suit, dans lequel se trouve imbriqué un groupe d'exceptions, "
"chaque clause ``except*`` extrait du groupe des exceptions d'un certain type "
"tout en laissant toutes les autres exceptions se propager vers d'autres "
"clauses et éventuellement être réactivées. ::"
2022-03-23 17:40:12 +00:00
#: tutorial/errors.rst:564
2022-03-23 17:40:12 +00:00
msgid ""
"Note that the exceptions nested in an exception group must be instances, not "
"types. This is because in practice the exceptions would typically be ones "
"that have already been raised and caught by the program, along the following "
"pattern::"
msgstr ""
"Notez que les exceptions imbriquées dans un groupe d'exceptions doivent être "
"des instances, pas des types. En effet, dans la pratique, les exceptions "
"sont normalement celles qui ont déjà été déclenchées et interceptées par le "
"programme, en utilisant le modèle suivant ::"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:582
2022-05-22 21:15:02 +00:00
msgid "Enriching Exceptions with Notes"
msgstr "Enrichissement des exceptions avec des notes"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:584
2022-05-22 21:15:02 +00:00
msgid ""
"When an exception is created in order to be raised, it is usually "
"initialized with information that describes the error that has occurred. "
"There are cases where it is useful to add information after the exception "
"was caught. For this purpose, exceptions have a method ``add_note(note)`` "
"that accepts a string and adds it to the exception's notes list. The "
"standard traceback rendering includes all notes, in the order they were "
"added, after the exception. ::"
msgstr ""
"Quand une exception est créée pour être levée, elle est généralement "
"initialisée avec des informations décrivant l'erreur qui s'est produite. Il "
"existe des cas où il est utile d'ajouter des informations après que "
"l'exception a été interceptée. Dans ce but, les exceptions ont une méthode "
"``add_note(note)`` qui reçoit une chaîne et l'ajoute à la liste des notes de "
"l'exception. L'affichage de la pile de trace standard inclut toutes les "
"notes, dans l'ordre dans lequel elles ont été ajoutées, après l'exception. ::"
2022-05-22 21:15:02 +00:00
#: tutorial/errors.rst:605
2022-05-22 21:15:02 +00:00
msgid ""
"For example, when collecting exceptions into an exception group, we may want "
"to add context information for the individual errors. In the following each "
"exception in the group has a note indicating when this error has occurred. ::"
msgstr ""
"Par exemple, lors de la collecte d'exceptions dans un groupe d'exceptions, "
"il est probable que vous souhaitiez ajouter des informations de contexte aux "
"erreurs individuelles. Dans ce qui suit, chaque exception du groupe est "
"accompagnée d'une note indiquant quand cette erreur s'est produite. ::"
2022-05-22 21:15:02 +00:00
#~ msgid ""
#~ "The :keyword:`raise` statement allows an optional :keyword:`from<raise>` "
#~ "which enables chaining exceptions. For example::"
#~ msgstr ""
#~ "L'instruction :keyword:`raise` autorise un :keyword:`from<raise>` "
#~ "optionnel qui permet de chaîner les exceptions. Par exemple ::"
#~ msgid ""
#~ "Exception chaining happens automatically when an exception is raised "
#~ "inside an :keyword:`except` or :keyword:`finally` section. This can be "
#~ "disabled by using ``from None`` idiom:"
#~ msgstr ""
#~ "Le chaînage d'exceptions se produit automatiquement lorsqu'une exception "
#~ "est levée dans une section :keyword:`except` ou :keyword:`finally`. Le "
#~ "chaînage d'exceptions peut être désactivé en utilisant l'idiome ``from "
#~ "None`` :"
2022-05-22 21:15:02 +00:00
#~ msgid ""
#~ "All exceptions inherit from :exc:`BaseException`, and so it can be used "
#~ "to serve as a wildcard. Use this with extreme caution, since it is easy "
#~ "to mask a real programming error in this way! It can also be used to "
#~ "print an error message and then re-raise the exception (allowing a caller "
#~ "to handle the exception as well)::"
#~ msgstr ""
#~ "Toutes les exceptions héritent de :exc:`BaseException`, il est donc "
#~ "possible de s'en servir comme un joker. C'est toutefois à utiliser avec "
#~ "beaucoup de précautions car il est facile de masquer une vraie erreur de "
#~ "programmation par ce biais. Elle peut aussi être utilisée pour afficher "
#~ "un message d'erreur avant de propager l'exception (en permettant à un "
#~ "appelant de gérer également l'exception) ::"