python-docs-fr/library/dis.po

1533 lines
47 KiB
Plaintext
Raw Permalink 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"
2023-07-23 12:39:39 +00:00
"POT-Creation-Date: 2023-07-23 14:38+0200\n"
2019-07-18 19:13:30 +00:00
"PO-Revision-Date: 2019-07-18 21:03+0200\n"
2019-09-04 09:35:23 +00:00
"Last-Translator: Aya Keddam <aya.keddam@etu.sorbonne-universite.fr>\n"
2018-07-04 09:14:25 +00:00
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
2017-05-23 22:40:56 +00:00
"Language: fr\n"
2016-10-30 09:46:26 +00:00
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
2019-07-18 19:13:30 +00:00
"X-Generator: Poedit 2.2.1\n"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:2
2016-10-30 09:46:26 +00:00
msgid ":mod:`dis` --- Disassembler for Python bytecode"
2019-07-18 19:13:30 +00:00
msgstr ":mod:`dis` Désassembleur pour le code intermédiaire de Python"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:7
2016-10-30 09:46:26 +00:00
msgid "**Source code:** :source:`Lib/dis.py`"
msgstr "**Code source :** :source:`Lib/dis.py`"
#: library/dis.rst:17
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by "
"disassembling it. The CPython bytecode which this module takes as an input "
"is defined in the file :file:`Include/opcode.h` and used by the compiler and "
"the interpreter."
msgstr ""
2019-07-18 19:13:30 +00:00
"La bibliothèque :mod:`dis` supporte l'analyse du :term:`bytecode` CPython "
"en le désassemblant. Le code intermédiaire CPython, que cette bibliothèque "
"prend en paramètre, est défini dans le fichier :file:`Include/opcode.h` et "
"est utilisé par le compilateur et l'interpréteur."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:24
2016-10-30 09:46:26 +00:00
msgid ""
"Bytecode is an implementation detail of the CPython interpreter. No "
"guarantees are made that bytecode will not be added, removed, or changed "
"between versions of Python. Use of this module should not be considered to "
"work across Python VMs or Python releases."
msgstr ""
2019-07-18 19:13:30 +00:00
"Le code intermédiaire est un détail d'implémentation de l'interpréteur "
"CPython. Il n'y a pas de garantie que le code intermédiaire sera ajouté, "
"retiré, ou modifié dans les différentes versions de Python. L'utilisation de "
"cette bibliothèque ne fonctionne pas nécessairement sur les machines "
"virtuelles Python ni les différentes versions de Python."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:29
2017-04-02 20:14:06 +00:00
msgid ""
"Use 2 bytes for each instruction. Previously the number of bytes varied by "
"instruction."
msgstr ""
2019-07-18 19:13:30 +00:00
"Utilisez 2 bits pour chaque instruction. Avant, le nombre de bits variait "
"par instruction."
2017-04-02 20:14:06 +00:00
#: library/dis.rst:33
msgid ""
"The argument of jump, exception handling and loop instructions is now the "
"instruction offset rather than the byte offset."
msgstr ""
#: library/dis.rst:37
2022-03-23 17:40:12 +00:00
msgid ""
"Some instructions are accompanied by one or more inline cache entries, which "
"take the form of :opcode:`CACHE` instructions. These instructions are hidden "
"by default, but can be shown by passing ``show_caches=True`` to any :mod:"
"`dis` utility. Furthermore, the interpreter now adapts the bytecode to "
"specialize it for different runtime conditions. The adaptive bytecode can be "
"shown by passing ``adaptive=True``."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:46
2016-10-30 09:46:26 +00:00
msgid "Example: Given the function :func:`myfunc`::"
2019-07-18 19:13:30 +00:00
msgstr "Exemple : Etant donné la fonction :func:`myfunc` ::"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:51
#, fuzzy
2016-10-30 09:46:26 +00:00
msgid ""
"the following command can be used to display the disassembly of :func:"
"`myfunc`:"
2016-10-30 09:46:26 +00:00
msgstr ""
2019-07-18 19:13:30 +00:00
"la commande suivante peut-être utilisé pour afficher le désassemblage de :"
"func:`myfunc` :"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:65
2016-10-30 09:46:26 +00:00
msgid "(The \"2\" is a line number)."
2019-07-18 19:13:30 +00:00
msgstr "(Le \"2\" est un numéro de ligne)."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:68
2016-10-30 09:46:26 +00:00
msgid "Bytecode analysis"
2019-07-18 19:13:30 +00:00
msgstr "Analyse du code intermédiaire"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:72
2016-10-30 09:46:26 +00:00
msgid ""
"The bytecode analysis API allows pieces of Python code to be wrapped in a :"
"class:`Bytecode` object that provides easy access to details of the compiled "
"code."
msgstr ""
2019-07-18 19:13:30 +00:00
"L'analyse de l'*API* code intermédiaire permet de rassembler des blocs de "
"code en Python dans une classe :class:`Bytecode`, qui permet un accès facile "
"aux détails du code compilé."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:79
2016-10-30 09:46:26 +00:00
msgid ""
2018-06-28 13:32:56 +00:00
"Analyse the bytecode corresponding to a function, generator, asynchronous "
"generator, coroutine, method, string of source code, or a code object (as "
"returned by :func:`compile`)."
2016-10-30 09:46:26 +00:00
msgstr ""
2019-07-18 19:13:30 +00:00
"Analyse le code intermédiaire correspondant à une fonction, un générateur, "
"un générateur asynchrone, une coroutine, une méthode, une chaîne de "
"caractères du code source, ou bien une classe (comme retourne la fonction :"
"func:`compile`)."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:83
2016-10-30 09:46:26 +00:00
msgid ""
"This is a convenience wrapper around many of the functions listed below, "
"most notably :func:`get_instructions`, as iterating over a :class:`Bytecode` "
"instance yields the bytecode operations as :class:`Instruction` instances."
msgstr ""
2019-07-18 19:13:30 +00:00
"Ceci est *wrapper* sur plusieurs fonctions de la liste ci-dessous, "
"notamment :func:`get_instructions`, étant donné qu'une itération sur une "
"instance de la classe :class:`Bytecode` rend les opérations du code "
"intermédiaire des instances de :class:`Instruction`."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:276
2016-10-30 09:46:26 +00:00
msgid ""
"If *first_line* is not ``None``, it indicates the line number that should be "
"reported for the first source line in the disassembled code. Otherwise, the "
"source line information (if any) is taken directly from the disassembled "
"code object."
msgstr ""
2019-07-18 19:13:30 +00:00
"Si *first_line* ne vaut pas ``None``, elle indique le nombre de la ligne qui "
"doit être considérée comme première ligne source dans le code désassemblé. "
"Autrement, les informations sur la ligne source sont prises directement à "
"partir de la classe du code désassemblé."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:92
2016-10-30 09:46:26 +00:00
msgid ""
"If *current_offset* is not ``None``, it refers to an instruction offset in "
"the disassembled code. Setting this means :meth:`.dis` will display a "
"\"current instruction\" marker against the specified opcode."
msgstr ""
2019-07-18 19:13:30 +00:00
"Si la valeur de *current_offset* est différente de ``None``, c'est une "
"référence à un offset d'une instruction dans le code désassemblé. Cela veut "
"dire que :meth:`.dis` va générer un marqueur de \" l'instruction en cours\" "
"contre le code d'opération donné."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:96
msgid ""
"If *show_caches* is ``True``, :meth:`.dis` will display inline cache entries "
"used by the interpreter to specialize the bytecode."
msgstr ""
#: library/dis.rst:99
msgid ""
"If *adaptive* is ``True``, :meth:`.dis` will display specialized bytecode "
"that may be different from the original bytecode."
msgstr ""
#: library/dis.rst:104
2016-10-30 09:46:26 +00:00
msgid ""
"Construct a :class:`Bytecode` instance from the given traceback, setting "
"*current_offset* to the instruction responsible for the exception."
msgstr ""
2019-07-18 19:13:30 +00:00
"Construisez une instance :class:`Bytecode` à partir de la trace d'appel, en "
"mettant *current_offet* à l'instruction responsable de l'exception."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:109
2016-10-30 09:46:26 +00:00
msgid "The compiled code object."
2019-07-18 19:13:30 +00:00
msgstr "Le code compilé objet."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:113
2016-10-30 09:46:26 +00:00
msgid "The first source line of the code object (if available)"
2019-07-18 19:13:30 +00:00
msgstr "La première ligne source du code objet (si disponible)"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:117
2016-10-30 09:46:26 +00:00
msgid ""
"Return a formatted view of the bytecode operations (the same as printed by :"
"func:`dis.dis`, but returned as a multi-line string)."
msgstr ""
2019-07-18 19:13:30 +00:00
"Retourne une vue formatée des opérations du code intermédiaire (la même que "
"celle envoyée par :func:`dis.dis`, mais comme une chaîne de caractères de "
"plusieurs lignes )."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:122
2016-10-30 09:46:26 +00:00
msgid ""
"Return a formatted multi-line string with detailed information about the "
"code object, like :func:`code_info`."
msgstr ""
2019-07-18 19:13:30 +00:00
"Retourne une chaîne de caractères de plusieurs lignes formatée avec des "
"informations détaillées sur l'objet code comme :func:`code_info`."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:166 library/dis.rst:218
2018-06-28 13:32:56 +00:00
msgid "This can now handle coroutine and asynchronous generator objects."
msgstr ""
2019-07-18 19:13:30 +00:00
"Cette version supporte la coroutine et les objets générateurs asynchrones."
2018-06-28 13:32:56 +00:00
#: library/dis.rst:221 library/dis.rst:264 library/dis.rst:285
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "Added the *show_caches* and *adaptive* parameters."
2022-03-23 17:40:12 +00:00
msgstr "Ajout du paramètre *file*."
#: library/dis.rst:131
#, fuzzy
msgid "Example:"
msgstr "Exemple :"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:148
2016-10-30 09:46:26 +00:00
msgid "Analysis functions"
2019-07-18 19:13:30 +00:00
msgstr "Analyse de fonctions"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:150
2016-10-30 09:46:26 +00:00
msgid ""
"The :mod:`dis` module also defines the following analysis functions that "
"convert the input directly to the desired output. They can be useful if only "
"a single operation is being performed, so the intermediate analysis object "
"isn't useful:"
msgstr ""
2019-07-18 19:13:30 +00:00
"La bibliothèque :mod:`dis` comprend également l'analyse des fonctions "
"suivantes, qui envoient l'entrée directement à la sortie souhaitée. Elles "
"peuvent être utiles si il n'y a qu'une seule opération à effectuer, la "
"représentation intermédiaire objet n'étant donc pas utile dans ce cas :"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:156
2016-10-30 09:46:26 +00:00
msgid ""
"Return a formatted multi-line string with detailed code object information "
2018-06-28 13:32:56 +00:00
"for the supplied function, generator, asynchronous generator, coroutine, "
"method, source code string or code object."
2016-10-30 09:46:26 +00:00
msgstr ""
2019-07-18 19:13:30 +00:00
"Retourne une chaîne de caractères de plusieurs lignes formatée avec des "
"informations détaillées sur l'objet code pour les fonctions données, les "
"générateurs asynchrone, coroutine, la méthode, la chaine de caractères du "
"code source ou objet."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:160
2016-10-30 09:46:26 +00:00
msgid ""
"Note that the exact contents of code info strings are highly implementation "
"dependent and they may change arbitrarily across Python VMs or Python "
"releases."
msgstr ""
2019-07-18 19:13:30 +00:00
"Il est à noter que le contenu exact des chaînes de caractères figurant dans "
"les informations du code dépendent fortement sur l'implémentation, et "
"peuvent changer arbitrairement sous machines virtuelles Python ou les "
"versions de Python."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:172
2016-10-30 09:46:26 +00:00
msgid ""
"Print detailed code object information for the supplied function, method, "
"source code string or code object to *file* (or ``sys.stdout`` if *file* is "
"not specified)."
msgstr ""
2019-07-18 19:13:30 +00:00
"Affiche des informations détaillées sur le code de la fonction fournie, la "
"méthode, la chaîne de caractère du code source ou du code objet à *file* (ou "
"bien ``sys.stdout`` si *file* n'est pas spécifié)."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:176
2016-10-30 09:46:26 +00:00
msgid ""
"This is a convenient shorthand for ``print(code_info(x), file=file)``, "
"intended for interactive exploration at the interpreter prompt."
msgstr ""
2019-07-18 19:13:30 +00:00
"Ceci est un raccourci convenable de ``print(code_info(x), file=file)``, "
"principalement fait pour l'exploration interactive sur l'invite de "
"l'interpréteur."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:212 library/dis.rst:261
2016-10-30 09:46:26 +00:00
msgid "Added *file* parameter."
2019-07-18 19:13:30 +00:00
msgstr "Ajout du paramètre *file*."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:187
2016-10-30 09:46:26 +00:00
msgid ""
"Disassemble the *x* object. *x* can denote either a module, a class, a "
2018-10-13 15:54:03 +00:00
"method, a function, a generator, an asynchronous generator, a coroutine, a "
2018-06-28 13:32:56 +00:00
"code object, a string of source code or a byte sequence of raw bytecode. For "
"a module, it disassembles all functions. For a class, it disassembles all "
"methods (including class and static methods). For a code object or sequence "
"of raw bytecode, it prints one line per bytecode instruction. It also "
"recursively disassembles nested code objects (the code of comprehensions, "
"generator expressions and nested functions, and the code used for building "
"nested classes). Strings are first compiled to code objects with the :func:"
"`compile` built-in function before being disassembled. If no object is "
"provided, this function disassembles the last traceback."
2016-10-30 09:46:26 +00:00
msgstr ""
2019-07-18 19:13:30 +00:00
"Désassemble l'objet *x*. *x* peut être une bibliothèque , une classe, une "
"méthode, une fonction, un générateur, un générateur asynchrone, une "
"coroutine, un code objet, une chaine de caractères du coude source ou une "
"séquence de bits du code intermédiaire brut. Pour une bibliothèque , elle "
"désassemble toutes les fonctions. Pour une classe, elle désassemble toutes "
"les méthodes (y compris les classes et méthodes statiques). Pour un code "
"objet ou une séquence de code intermédiaire brut, elle affiche une ligne par "
"instruction code intermédiaire. Aussi, elle désassemble les codes objets "
"internes récursivement (le code en compréhension, les expressions des "
"générateurs et les fonctions imbriquées, et le code utilisé pour la "
"construction des classes internes). Les chaînes de caractères sont d'abord "
"compilées pour coder des objets avec les fonctions intégrées de :func:"
"`compile` avant qu'elles ne soient désassemblées. Si aucun objet n'est "
"fourni, cette fonction désassemble les dernières traces d'appel."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:231 library/dis.rst:258
2016-10-30 09:46:26 +00:00
msgid ""
"The disassembly is written as text to the supplied *file* argument if "
"provided and to ``sys.stdout`` otherwise."
msgstr ""
2019-07-18 19:13:30 +00:00
"Le désassemblage est envoyé sous forme de texte à l'argument du fichier "
"*file* si il est fourni, et à ``sys.stdout`` sinon."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:203
2018-06-28 13:32:56 +00:00
msgid ""
"The maximal depth of recursion is limited by *depth* unless it is ``None``. "
"``depth=0`` means no recursion."
msgstr ""
2019-07-18 19:13:30 +00:00
"La profondeur maximale de récursion est limitée par *depth* sauf si elle "
"correspond à ``None``. ``depth=0`` indique qu'il n'y a pas de récursion."
2018-06-28 13:32:56 +00:00
#: library/dis.rst:206
msgid ""
"If *show_caches* is ``True``, this function will display inline cache "
"entries used by the interpreter to specialize the bytecode."
msgstr ""
#: library/dis.rst:209
msgid ""
"If *adaptive* is ``True``, this function will display specialized bytecode "
"that may be different from the original bytecode."
msgstr ""
#: library/dis.rst:215
2018-06-28 13:32:56 +00:00
msgid "Implemented recursive disassembling and added *depth* parameter."
msgstr ""
2019-07-18 19:13:30 +00:00
"Le désassemblage récursif a été implémenté, et le paramètre *depth* a été "
"ajouté."
2018-06-28 13:32:56 +00:00
#: library/dis.rst:227
2016-10-30 09:46:26 +00:00
msgid ""
"Disassemble the top-of-stack function of a traceback, using the last "
"traceback if none was passed. The instruction causing the exception is "
"indicated."
msgstr ""
2019-07-18 19:13:30 +00:00
"Désassemble la fonction du haut de la pile des traces d'appels, en utilisant "
"la dernière trace d'appels si rien n'a été envoyé. L'instruction à l'origine "
"de l'exception est indiquée."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:244
2016-10-30 09:46:26 +00:00
msgid ""
"Disassemble a code object, indicating the last instruction if *lasti* was "
"provided. The output is divided in the following columns:"
msgstr ""
2019-07-18 19:13:30 +00:00
"Désassemble un code objet, en indiquant la dernière instruction si *lasti* "
"est fournie. La sortie est répartie sur les colonnes suivantes :"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:247
2016-10-30 09:46:26 +00:00
msgid "the line number, for the first instruction of each line"
2019-07-18 19:13:30 +00:00
msgstr "le numéro de ligne, pour la première instruction de chaque ligne"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:248
2016-10-30 09:46:26 +00:00
msgid "the current instruction, indicated as ``-->``,"
2019-07-18 19:13:30 +00:00
msgstr "l'instruction en cours, indiquée par ``-->``,"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:249
2016-10-30 09:46:26 +00:00
msgid "a labelled instruction, indicated with ``>>``,"
2019-07-18 19:13:30 +00:00
msgstr "une instruction libellée, indiquée par ``> >``,"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:250
2016-10-30 09:46:26 +00:00
msgid "the address of the instruction,"
2019-07-18 19:13:30 +00:00
msgstr "l'adresse de l'instruction,"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:251
2016-10-30 09:46:26 +00:00
msgid "the operation code name,"
2019-07-18 19:13:30 +00:00
msgstr "le nom de le code d'opération,"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:252
2016-10-30 09:46:26 +00:00
msgid "operation parameters, and"
2019-07-18 19:13:30 +00:00
msgstr "paramètres de l'opération, et"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:253
2016-10-30 09:46:26 +00:00
msgid "interpretation of the parameters in parentheses."
2019-07-18 19:13:30 +00:00
msgstr "interprétation des paramètres entre parenthèses."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:255
2016-10-30 09:46:26 +00:00
msgid ""
"The parameter interpretation recognizes local and global variable names, "
"constant values, branch targets, and compare operators."
msgstr ""
2019-07-18 19:13:30 +00:00
"L'interprétation du paramètre reconnaît les noms des variables locales et "
"globales, des valeurs constantes, des branchements cibles, et des opérateurs "
"de comparaison."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:270
2016-10-30 09:46:26 +00:00
msgid ""
"Return an iterator over the instructions in the supplied function, method, "
"source code string or code object."
msgstr ""
2019-07-18 19:13:30 +00:00
"Retourne un itérateur sur les instructions dans la fonction fournie, la "
"méthode, les chaînes de caractères du code source ou objet."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:273
2016-10-30 09:46:26 +00:00
msgid ""
"The iterator generates a series of :class:`Instruction` named tuples giving "
"the details of each operation in the supplied code."
msgstr ""
"Cet itérateur génère une série de *n*-uplets de :class:`Instruction` qui "
2019-07-18 19:13:30 +00:00
"donnent les détails de chacune des opérations dans le code fourni."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:281
msgid ""
"The *show_caches* and *adaptive* parameters work as they do in :func:`dis`."
msgstr ""
#: library/dis.rst:291
2016-10-30 09:46:26 +00:00
msgid ""
"This generator function uses the ``co_lines`` method of the code object "
"*code* to find the offsets which are starts of lines in the source code. "
"They are generated as ``(offset, lineno)`` pairs."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:295
2017-04-02 20:14:06 +00:00
msgid "Line numbers can be decreasing. Before, they were always increasing."
2016-10-30 09:46:26 +00:00
msgstr ""
2019-07-18 19:13:30 +00:00
"Les numéros de lignes peuvent être décroissants. Avant, ils étaient toujours "
"croissants."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:298
msgid ""
"The :pep:`626` ``co_lines`` method is used instead of the ``co_firstlineno`` "
"and ``co_lnotab`` attributes of the code object."
msgstr ""
#: library/dis.rst:305
2016-10-30 09:46:26 +00:00
msgid ""
2020-05-24 14:31:50 +00:00
"Detect all offsets in the raw compiled bytecode string *code* which are jump "
"targets, and return a list of these offsets."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:311
2016-10-30 09:46:26 +00:00
msgid "Compute the stack effect of *opcode* with argument *oparg*."
msgstr ""
#: library/dis.rst:313
2019-09-04 09:35:23 +00:00
msgid ""
"If the code has a jump target and *jump* is ``True``, :func:`~stack_effect` "
"will return the stack effect of jumping. If *jump* is ``False``, it will "
"return the stack effect of not jumping. And if *jump* is ``None`` (default), "
"it will return the maximal stack effect of both cases."
msgstr ""
#: library/dis.rst:320
2019-09-04 09:35:23 +00:00
#, fuzzy
msgid "Added *jump* parameter."
msgstr "Ajout du paramètre *file*."
#: library/dis.rst:327
2016-10-30 09:46:26 +00:00
msgid "Python Bytecode Instructions"
2019-07-18 19:13:30 +00:00
msgstr "Les instructions du code intermédiaire en Python"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:329
2016-10-30 09:46:26 +00:00
msgid ""
"The :func:`get_instructions` function and :class:`Bytecode` class provide "
"details of bytecode instructions as :class:`Instruction` instances:"
msgstr ""
2019-07-18 19:13:30 +00:00
"La fonction :func:`get_instructions` et la méthode :class:`Bytecode` fournit "
"des détails sur le code intermédiaire des instructions comme :class:"
"`Instruction` instances :"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:334
2016-10-30 09:46:26 +00:00
msgid "Details for a bytecode operation"
2019-07-18 19:13:30 +00:00
msgstr "Détails sur le code intermédiaire de l'opération"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:338
2016-10-30 09:46:26 +00:00
msgid ""
"numeric code for operation, corresponding to the opcode values listed below "
"and the bytecode values in the :ref:`opcode_collections`."
msgstr ""
2019-07-18 19:13:30 +00:00
"code numérique pour l'opération, correspondant aux valeurs de l'*opcode* ci-"
"dessous et les valeurs du code intermédiaire dans la :ref:"
"`opcode_collections`."
2016-10-30 09:46:26 +00:00
#: library/dis.rst:344
2016-10-30 09:46:26 +00:00
msgid "human readable name for operation"
2019-07-18 19:13:30 +00:00
msgstr "nom lisible/compréhensible de l'opération"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:349
2016-10-30 09:46:26 +00:00
msgid "numeric argument to operation (if any), otherwise ``None``"
2019-07-18 19:13:30 +00:00
msgstr "le cas échéant, argument numérique de l'opération sinon ``None``"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:354
2022-03-23 17:40:12 +00:00
#, fuzzy
msgid "resolved arg value (if any), otherwise ``None``"
msgstr "le cas échéant, argument numérique de l'opération sinon ``None``"
2016-10-30 09:46:26 +00:00
#: library/dis.rst:359
2022-03-23 17:40:12 +00:00
msgid ""
"human readable description of operation argument (if any), otherwise an "
"empty string."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:365
2016-10-30 09:46:26 +00:00
msgid "start index of operation within bytecode sequence"
msgstr ""
#: library/dis.rst:370
2016-10-30 09:46:26 +00:00
msgid "line started by this opcode (if any), otherwise ``None``"
msgstr ""
#: library/dis.rst:375
2016-10-30 09:46:26 +00:00
msgid "``True`` if other code jumps to here, otherwise ``False``"
msgstr ""
#: library/dis.rst:380
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
":class:`dis.Positions` object holding the start and end locations that are "
"covered by this instruction."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:387
2022-03-23 17:40:12 +00:00
msgid "Field ``positions`` is added."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:392
msgid ""
"In case the information is not available, some fields might be ``None``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:402
2022-03-23 17:40:12 +00:00
msgid ""
"The Python compiler currently generates the following bytecode instructions."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:405
2022-03-23 17:40:12 +00:00
msgid "**General instructions**"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:409
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Do nothing code. Used as a placeholder by the bytecode optimizer, and to "
"generate line tracing events."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:415
2022-03-23 17:40:12 +00:00
msgid "Removes the top-of-stack (TOS) item."
2019-09-04 09:35:23 +00:00
msgstr ""
#: library/dis.rst:420
2022-03-23 17:40:12 +00:00
msgid ""
"Push the *i*-th item to the top of the stack. The item is not removed from "
"its original location."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:428
2022-03-23 17:40:12 +00:00
msgid "Swap TOS with the item at position *i*."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:435
msgid ""
"Rather than being an actual instruction, this opcode is used to mark extra "
"space for the interpreter to cache useful data directly in the bytecode "
"itself. It is automatically hidden by all ``dis`` utilities, but can be "
"viewed with ``show_caches=True``."
msgstr ""
#: library/dis.rst:440
msgid ""
"Logically, this space is part of the preceding instruction. Many opcodes "
"expect to be followed by an exact number of caches, and will instruct the "
"interpreter to skip over them at runtime."
msgstr ""
#: library/dis.rst:444
msgid ""
"Populated caches can look like arbitrary instructions, so great care should "
"be taken when reading or modifying raw, adaptive bytecode containing "
"quickened data."
msgstr ""
#: library/dis.rst:451
2016-10-30 09:46:26 +00:00
msgid "**Unary operations**"
msgstr ""
#: library/dis.rst:453
2016-10-30 09:46:26 +00:00
msgid ""
"Unary operations take the top of the stack, apply the operation, and push "
"the result back on the stack."
msgstr ""
#: library/dis.rst:458
2016-10-30 09:46:26 +00:00
msgid "Implements ``TOS = +TOS``."
msgstr ""
#: library/dis.rst:463
2016-10-30 09:46:26 +00:00
msgid "Implements ``TOS = -TOS``."
msgstr ""
#: library/dis.rst:468
2016-10-30 09:46:26 +00:00
msgid "Implements ``TOS = not TOS``."
msgstr ""
#: library/dis.rst:473
2016-10-30 09:46:26 +00:00
msgid "Implements ``TOS = ~TOS``."
msgstr ""
#: library/dis.rst:478
2016-10-30 09:46:26 +00:00
msgid "Implements ``TOS = iter(TOS)``."
msgstr ""
#: library/dis.rst:483
2016-10-30 09:46:26 +00:00
msgid ""
"If ``TOS`` is a :term:`generator iterator` or :term:`coroutine` object it is "
"left as is. Otherwise, implements ``TOS = iter(TOS)``."
msgstr ""
#: library/dis.rst:489
2022-03-23 17:40:12 +00:00
msgid "**Binary and in-place operations**"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:491
2016-10-30 09:46:26 +00:00
msgid ""
"Binary operations remove the top of the stack (TOS) and the second top-most "
"stack item (TOS1) from the stack. They perform the operation, and put the "
"result back on the stack."
msgstr ""
#: library/dis.rst:495
2016-10-30 09:46:26 +00:00
msgid ""
"In-place operations are like binary operations, in that they remove TOS and "
"TOS1, and push the result back on the stack, but the operation is done in-"
"place when TOS1 supports it, and the resulting TOS may be (but does not have "
"to be) the original TOS1."
msgstr ""
#: library/dis.rst:503
2022-03-23 17:40:12 +00:00
msgid ""
"Implements the binary and in-place operators (depending on the value of "
"*op*)."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:511
2022-03-23 17:40:12 +00:00
msgid "Implements ``TOS = TOS1[TOS]``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:516
2022-03-23 17:40:12 +00:00
msgid "Implements ``TOS1[TOS] = TOS2``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:521
2022-03-23 17:40:12 +00:00
msgid "Implements ``del TOS1[TOS]``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:524
2022-03-23 17:40:12 +00:00
msgid "**Coroutine opcodes**"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:528
2022-03-23 17:40:12 +00:00
msgid ""
"Implements ``TOS = get_awaitable(TOS)``, where ``get_awaitable(o)`` returns "
"``o`` if ``o`` is a coroutine object or a generator object with the "
"CO_ITERABLE_COROUTINE flag, or resolves ``o.__await__``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:533
2022-03-23 17:40:12 +00:00
msgid ""
"If the ``where`` operand is nonzero, it indicates where the instruction "
"occurs:"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:536
2022-03-23 17:40:12 +00:00
msgid "``1`` After a call to ``__aenter__``"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:537
2022-03-23 17:40:12 +00:00
msgid "``2`` After a call to ``__aexit__``"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:541
2022-03-23 17:40:12 +00:00
msgid "Previously, this instruction did not have an oparg."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:547
2018-06-28 13:32:56 +00:00
msgid "Implements ``TOS = TOS.__aiter__()``."
msgstr ""
#: library/dis.rst:550
2018-06-28 13:32:56 +00:00
msgid "Returning awaitable objects from ``__aiter__`` is no longer supported."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:557
2016-10-30 09:46:26 +00:00
msgid ""
"Pushes ``get_awaitable(TOS.__anext__())`` to the stack. See "
"``GET_AWAITABLE`` for details about ``get_awaitable``."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:565
2019-09-04 09:35:23 +00:00
msgid ""
"Terminates an :keyword:`async for` loop. Handles an exception raised when "
"awaiting a next item. The stack contains the async iterable in TOS1 and the "
"raised exception in TOS. Both are popped. If the exception is not :exc:"
"`StopAsyncIteration`, it is re-raised."
2019-09-04 09:35:23 +00:00
msgstr ""
#: library/dis.rst:650 library/dis.rst:661
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Exception representation on the stack now consist of one, not three, items."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:577
2022-03-23 17:40:12 +00:00
msgid ""
"Resolves ``__aenter__`` and ``__aexit__`` from the object on top of the "
"stack. Pushes ``__aexit__`` and result of ``__aenter__()`` to the stack."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:584
2016-10-30 09:46:26 +00:00
msgid "**Miscellaneous opcodes**"
msgstr ""
#: library/dis.rst:588
2016-10-30 09:46:26 +00:00
msgid ""
"Implements the expression statement for the interactive mode. TOS is "
"removed from the stack and printed. In non-interactive mode, an expression "
"statement is terminated with :opcode:`POP_TOP`."
msgstr ""
#: library/dis.rst:595
2016-10-30 09:46:26 +00:00
msgid ""
"Calls ``set.add(TOS1[-i], TOS)``. Used to implement set comprehensions."
msgstr ""
#: library/dis.rst:600
2016-10-30 09:46:26 +00:00
msgid ""
2020-09-11 07:11:46 +00:00
"Calls ``list.append(TOS1[-i], TOS)``. Used to implement list comprehensions."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:605
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"Calls ``dict.__setitem__(TOS1[-i], TOS1, TOS)``. Used to implement dict "
2016-10-30 09:46:26 +00:00
"comprehensions."
msgstr ""
#: library/dis.rst:609
2019-09-04 09:35:23 +00:00
msgid "Map value is TOS and map key is TOS1. Before, those were reversed."
msgstr ""
#: library/dis.rst:612
2016-10-30 09:46:26 +00:00
msgid ""
"For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` and :opcode:"
"`MAP_ADD` instructions, while the added value or key/value pair is popped "
"off, the container object remains on the stack so that it is available for "
"further iterations of the loop."
msgstr ""
#: library/dis.rst:620
2016-10-30 09:46:26 +00:00
msgid "Returns with TOS to the caller of the function."
msgstr ""
#: library/dis.rst:625
2016-10-30 09:46:26 +00:00
msgid "Pops TOS and yields it from a :term:`generator`."
msgstr ""
#: library/dis.rst:631
2016-10-30 09:46:26 +00:00
msgid ""
"Checks whether ``__annotations__`` is defined in ``locals()``, if not it is "
"set up to an empty ``dict``. This opcode is only emitted if a class or "
"module body contains :term:`variable annotations <variable annotation>` "
"statically."
msgstr ""
#: library/dis.rst:641
2016-10-30 09:46:26 +00:00
msgid ""
"Loads all symbols not starting with ``'_'`` directly from the module TOS to "
"the local namespace. The module is popped after loading all names. This "
"opcode implements ``from module import *``."
msgstr ""
#: library/dis.rst:648
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Pops a value from the stack, which is used to restore the exception state."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:655
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Re-raises the exception currently on top of the stack. If oparg is non-zero, "
"pops an additional value from the stack which is used to set ``f_lasti`` of "
"the current frame."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:666
msgid ""
2022-03-23 17:40:12 +00:00
"Pops a value from the stack. Pushes the current exception to the top of the "
"stack. Pushes the value originally popped back to the stack. Used in "
"exception handlers."
2019-09-04 09:35:23 +00:00
msgstr ""
#: library/dis.rst:674
2022-05-22 21:15:02 +00:00
msgid ""
"Performs exception matching for ``except``. Tests whether the TOS1 is an "
"exception matching TOS. Pops TOS and pushes the boolean result of the test."
msgstr ""
#: library/dis.rst:681
2022-05-22 21:15:02 +00:00
msgid ""
"Performs exception matching for ``except*``. Applies ``split(TOS)`` on the "
"exception group representing TOS1."
msgstr ""
#: library/dis.rst:684
2022-05-22 21:15:02 +00:00
msgid ""
"In case of a match, pops two items from the stack and pushes the non-"
"matching subgroup (``None`` in case of full match) followed by the matching "
"subgroup. When there is no match, pops one item (the match type) and pushes "
"``None``."
msgstr ""
#: library/dis.rst:693
2022-05-22 21:15:02 +00:00
msgid ""
"Combines the raised and reraised exceptions list from TOS, into an exception "
"group to propagate from a try-except* block. Uses the original exception "
"group from TOS1 to reconstruct the structure of reraised exceptions. Pops "
"two items from the stack and pushes the exception to reraise or ``None`` if "
"there isn't one."
msgstr ""
#: library/dis.rst:703
2019-09-04 09:35:23 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Calls the function in position 4 on the stack with arguments (type, val, tb) "
"representing the exception at the top of the stack. Used to implement the "
"call ``context_manager.__exit__(*exc_info())`` when an exception has "
"occurred in a :keyword:`with` statement."
msgstr ""
#: library/dis.rst:710
2022-03-23 17:40:12 +00:00
msgid ""
"The ``__exit__`` function is in position 4 of the stack rather than 7. "
"Exception representation on the stack now consist of one, not three, items."
2019-09-04 09:35:23 +00:00
msgstr ""
#: library/dis.rst:717
2016-10-30 09:46:26 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"Pushes :exc:`AssertionError` onto the stack. Used by the :keyword:`assert` "
"statement."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:725
2016-10-30 09:46:26 +00:00
msgid ""
"Pushes :func:`builtins.__build_class__` onto the stack. It is later called "
2022-03-23 17:40:12 +00:00
"to construct a class."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:731
2016-10-30 09:46:26 +00:00
msgid ""
"This opcode performs several operations before a with block starts. First, "
"it loads :meth:`~object.__exit__` from the context manager and pushes it "
"onto the stack for later use by :opcode:`WITH_EXCEPT_START`. Then, :meth:"
2022-03-23 17:40:12 +00:00
"`~object.__enter__` is called. Finally, the result of calling the "
"``__enter__()`` method is pushed onto the stack."
msgstr ""
#: library/dis.rst:742
msgid "Push ``len(TOS)`` onto the stack."
msgstr ""
#: library/dis.rst:749
msgid ""
"If TOS is an instance of :class:`collections.abc.Mapping` (or, more "
2023-07-23 12:39:39 +00:00
"technically: if it has the :c:macro:`Py_TPFLAGS_MAPPING` flag set in its :c:"
"member:`~PyTypeObject.tp_flags`), push ``True`` onto the stack. Otherwise, "
"push ``False``."
msgstr ""
#: library/dis.rst:759
msgid ""
"If TOS is an instance of :class:`collections.abc.Sequence` and is *not* an "
"instance of :class:`str`/:class:`bytes`/:class:`bytearray` (or, more "
2023-07-23 12:39:39 +00:00
"technically: if it has the :c:macro:`Py_TPFLAGS_SEQUENCE` flag set in its :c:"
"member:`~PyTypeObject.tp_flags`), push ``True`` onto the stack. Otherwise, "
"push ``False``."
msgstr ""
#: library/dis.rst:769
msgid ""
"TOS is a tuple of mapping keys, and TOS1 is the match subject. If TOS1 "
"contains all of the keys in TOS, push a :class:`tuple` containing the "
2022-03-23 17:40:12 +00:00
"corresponding values. Otherwise, push ``None``."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1323
2022-03-23 17:40:12 +00:00
msgid ""
"Previously, this instruction also pushed a boolean value indicating success "
"(``True``) or failure (``False``)."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:782
2016-10-30 09:46:26 +00:00
msgid ""
"Implements ``name = TOS``. *namei* is the index of *name* in the attribute :"
"attr:`co_names` of the code object. The compiler tries to use :opcode:"
"`STORE_FAST` or :opcode:`STORE_GLOBAL` if possible."
msgstr ""
#: library/dis.rst:789
2016-10-30 09:46:26 +00:00
msgid ""
"Implements ``del name``, where *namei* is the index into :attr:`co_names` "
"attribute of the code object."
msgstr ""
#: library/dis.rst:795
2016-10-30 09:46:26 +00:00
msgid ""
"Unpacks TOS into *count* individual values, which are put onto the stack "
"right-to-left."
msgstr ""
#: library/dis.rst:801
2016-10-30 09:46:26 +00:00
msgid ""
"Implements assignment with a starred target: Unpacks an iterable in TOS into "
"individual values, where the total number of values can be smaller than the "
"number of items in the iterable: one of the new values will be a list of all "
"leftover items."
msgstr ""
#: library/dis.rst:806
2016-10-30 09:46:26 +00:00
msgid ""
"The low byte of *counts* is the number of values before the list value, the "
"high byte of *counts* the number of values after it. The resulting values "
"are put onto the stack right-to-left."
msgstr ""
#: library/dis.rst:813
2016-10-30 09:46:26 +00:00
msgid ""
"Implements ``TOS.name = TOS1``, where *namei* is the index of name in :attr:"
"`co_names`."
msgstr ""
#: library/dis.rst:819
2016-10-30 09:46:26 +00:00
msgid ""
"Implements ``del TOS.name``, using *namei* as index into :attr:`co_names`."
msgstr ""
#: library/dis.rst:824
2016-10-30 09:46:26 +00:00
msgid "Works as :opcode:`STORE_NAME`, but stores the name as a global."
msgstr ""
#: library/dis.rst:829
2016-10-30 09:46:26 +00:00
msgid "Works as :opcode:`DELETE_NAME`, but deletes a global name."
msgstr ""
#: library/dis.rst:834
2016-10-30 09:46:26 +00:00
msgid "Pushes ``co_consts[consti]`` onto the stack."
msgstr ""
#: library/dis.rst:839
2016-10-30 09:46:26 +00:00
msgid "Pushes the value associated with ``co_names[namei]`` onto the stack."
msgstr ""
#: library/dis.rst:844
2016-10-30 09:46:26 +00:00
msgid ""
"Creates a tuple consuming *count* items from the stack, and pushes the "
"resulting tuple onto the stack."
msgstr ""
#: library/dis.rst:850
2016-10-30 09:46:26 +00:00
msgid "Works as :opcode:`BUILD_TUPLE`, but creates a list."
msgstr ""
#: library/dis.rst:855
2016-10-30 09:46:26 +00:00
msgid "Works as :opcode:`BUILD_TUPLE`, but creates a set."
msgstr ""
#: library/dis.rst:860
2017-04-02 20:14:06 +00:00
msgid ""
"Pushes a new dictionary object onto the stack. Pops ``2 * count`` items so "
"that the dictionary holds *count* entries: ``{..., TOS3: TOS2, TOS1: TOS}``."
msgstr ""
#: library/dis.rst:864
2016-10-30 09:46:26 +00:00
msgid ""
2017-04-02 20:14:06 +00:00
"The dictionary is created from stack items instead of creating an empty "
"dictionary pre-sized to hold *count* items."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:871
2016-10-30 09:46:26 +00:00
msgid ""
2020-05-24 14:31:50 +00:00
"The version of :opcode:`BUILD_MAP` specialized for constant keys. Pops the "
"top element on the stack which contains a tuple of keys, then starting from "
"``TOS1``, pops *count* values to form values in the built dictionary."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:880
2016-10-30 09:46:26 +00:00
msgid ""
"Concatenates *count* strings from the stack and pushes the resulting string "
"onto the stack."
msgstr ""
#: library/dis.rst:888
2017-04-02 20:14:06 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"Pops a list from the stack and pushes a tuple containing the same values."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:895
2020-07-20 08:56:42 +00:00
msgid "Calls ``list.extend(TOS1[-i], TOS)``. Used to build lists."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:902
2020-07-20 08:56:42 +00:00
msgid "Calls ``set.update(TOS1[-i], TOS)``. Used to build sets."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:909
2020-07-20 08:56:42 +00:00
msgid "Calls ``dict.update(TOS1[-i], TOS)``. Used to build dicts."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:916
2020-07-20 08:56:42 +00:00
msgid "Like :opcode:`DICT_UPDATE` but raises an exception for duplicate keys."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:923
2020-07-20 08:56:42 +00:00
msgid "Replaces TOS with ``getattr(TOS, co_names[namei])``."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:928
2017-04-02 20:14:06 +00:00
msgid ""
2020-07-20 08:56:42 +00:00
"Performs a Boolean operation. The operation name can be found in "
"``cmp_op[opname]``."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:934
2020-07-20 08:56:42 +00:00
msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:941
2020-07-20 08:56:42 +00:00
msgid "Performs ``in`` comparison, or ``not in`` if ``invert`` is 1."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:948
2016-10-30 09:46:26 +00:00
msgid ""
"Imports the module ``co_names[namei]``. TOS and TOS1 are popped and provide "
"the *fromlist* and *level* arguments of :func:`__import__`. The module "
"object is pushed onto the stack. The current namespace is not affected: for "
"a proper import statement, a subsequent :opcode:`STORE_FAST` instruction "
"modifies the namespace."
msgstr ""
#: library/dis.rst:957
2016-10-30 09:46:26 +00:00
msgid ""
"Loads the attribute ``co_names[namei]`` from the module found in TOS. The "
"resulting object is pushed onto the stack, to be subsequently stored by a :"
"opcode:`STORE_FAST` instruction."
msgstr ""
#: library/dis.rst:964
2016-10-30 09:46:26 +00:00
msgid "Increments bytecode counter by *delta*."
msgstr ""
#: library/dis.rst:969
2022-05-22 21:15:02 +00:00
msgid "Decrements bytecode counter by *delta*. Checks for interrupts."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:976
2022-05-22 21:15:02 +00:00
msgid "Decrements bytecode counter by *delta*. Does not check for interrupts."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:983
2022-03-23 17:40:12 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is true, increments the bytecode counter by *delta*. TOS is popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:990
2022-05-22 21:15:02 +00:00
msgid ""
"If TOS is true, decrements the bytecode counter by *delta*. TOS is popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:997
2020-07-20 08:56:42 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is false, increments the bytecode counter by *delta*. TOS is popped."
2020-07-20 08:56:42 +00:00
msgstr ""
#: library/dis.rst:1004
2022-03-23 17:40:12 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is false, decrements the bytecode counter by *delta*. TOS is popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:1011
2022-03-23 17:40:12 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is not ``None``, increments the bytecode counter by *delta*. TOS is "
"popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:1018
2022-05-22 21:15:02 +00:00
msgid ""
"If TOS is not ``None``, decrements the bytecode counter by *delta*. TOS is "
"popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:1025
2022-03-23 17:40:12 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is ``None``, increments the bytecode counter by *delta*. TOS is "
"popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:1032
2016-10-30 09:46:26 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is ``None``, decrements the bytecode counter by *delta*. TOS is "
"popped."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1039
2016-10-30 09:46:26 +00:00
msgid ""
2022-05-22 21:15:02 +00:00
"If TOS is true, increments the bytecode counter by *delta* and leaves TOS on "
"the stack. Otherwise (TOS is false), TOS is popped."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1054
2022-05-22 21:15:02 +00:00
msgid "The oparg is now a relative delta rather than an absolute target."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1049
2022-05-22 21:15:02 +00:00
msgid ""
"If TOS is false, increments the bytecode counter by *delta* and leaves TOS "
"on the stack. Otherwise (TOS is true), TOS is popped."
2022-03-23 17:40:12 +00:00
msgstr ""
#: library/dis.rst:1060
2016-10-30 09:46:26 +00:00
msgid ""
"TOS is an :term:`iterator`. Call its :meth:`~iterator.__next__` method. If "
"this yields a new value, push it on the stack (leaving the iterator below "
2020-07-20 08:56:42 +00:00
"it). If the iterator indicates it is exhausted, TOS is popped, and the byte "
2016-10-30 09:46:26 +00:00
"code counter is incremented by *delta*."
msgstr ""
#: library/dis.rst:1068
2022-03-23 17:40:12 +00:00
msgid "Loads the global named ``co_names[namei>>1]`` onto the stack."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1070
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"If the low bit of ``namei`` is set, then a ``NULL`` is pushed to the stack "
"before the global variable."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1076
2016-10-30 09:46:26 +00:00
msgid ""
"Pushes a reference to the local ``co_varnames[var_num]`` onto the stack."
msgstr ""
#: library/dis.rst:1081
2016-10-30 09:46:26 +00:00
msgid "Stores TOS into the local ``co_varnames[var_num]``."
msgstr ""
#: library/dis.rst:1086
2016-10-30 09:46:26 +00:00
msgid "Deletes local ``co_varnames[var_num]``."
msgstr ""
#: library/dis.rst:1091
2016-10-30 09:46:26 +00:00
msgid ""
2023-07-23 12:39:39 +00:00
"Creates a new cell in slot ``i``. If that slot is nonempty then that value "
"is stored into the new cell."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1099
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Pushes a reference to the cell contained in slot ``i`` of the \"fast "
"locals\" storage. The name of the variable is ``co_fastlocalnames[i]``."
msgstr ""
#: library/dis.rst:1102
2022-03-23 17:40:12 +00:00
msgid ""
"Note that ``LOAD_CLOSURE`` is effectively an alias for ``LOAD_FAST``. It "
"exists to keep bytecode a little more readable."
msgstr ""
#: library/dis.rst:1114 library/dis.rst:1135 library/dis.rst:1146
2022-03-23 17:40:12 +00:00
msgid "``i`` is no longer offset by the length of ``co_varnames``."
msgstr ""
#: library/dis.rst:1111
2022-03-23 17:40:12 +00:00
msgid ""
"Loads the cell contained in slot ``i`` of the \"fast locals\" storage. "
2016-10-30 09:46:26 +00:00
"Pushes a reference to the object the cell contains on the stack."
msgstr ""
#: library/dis.rst:1120
2016-10-30 09:46:26 +00:00
msgid ""
"Much like :opcode:`LOAD_DEREF` but first checks the locals dictionary before "
"consulting the cell. This is used for loading free variables in class "
"bodies."
msgstr ""
#: library/dis.rst:1132
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Stores TOS into the cell contained in slot ``i`` of the \"fast locals\" "
2016-10-30 09:46:26 +00:00
"storage."
msgstr ""
#: library/dis.rst:1141
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Empties the cell contained in slot ``i`` of the \"fast locals\" storage. "
"Used by the :keyword:`del` statement."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1152
2022-03-23 17:40:12 +00:00
msgid ""
"Copies the ``n`` free variables from the closure into the frame. Removes the "
"need for special code on the caller's side when calling closures."
msgstr ""
#: library/dis.rst:1161
2016-10-30 09:46:26 +00:00
msgid ""
2019-09-04 09:35:23 +00:00
"Raises an exception using one of the 3 forms of the ``raise`` statement, "
"depending on the value of *argc*:"
msgstr ""
#: library/dis.rst:1164
2019-09-04 09:35:23 +00:00
msgid "0: ``raise`` (re-raise previous exception)"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1165
2019-09-04 09:35:23 +00:00
msgid "1: ``raise TOS`` (raise exception instance or type at ``TOS``)"
msgstr ""
#: library/dis.rst:1166
2019-09-04 09:35:23 +00:00
msgid ""
"2: ``raise TOS1 from TOS`` (raise exception instance or type at ``TOS1`` "
"with ``__cause__`` set to ``TOS``)"
msgstr ""
#: library/dis.rst:1172
2017-04-02 20:14:06 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Calls a callable object with the number of arguments specified by ``argc``, "
"including the named arguments specified by the preceding :opcode:`KW_NAMES`, "
"if any. On the stack are (in ascending order), either:"
msgstr ""
#: library/dis.rst:1177
2022-03-23 17:40:12 +00:00
msgid "NULL"
msgstr ""
#: library/dis.rst:1184
2022-03-23 17:40:12 +00:00
msgid "The callable"
msgstr ""
#: library/dis.rst:1179
2022-03-23 17:40:12 +00:00
msgid "The positional arguments"
msgstr ""
#: library/dis.rst:1187
2022-03-23 17:40:12 +00:00
msgid "The named arguments"
msgstr ""
#: library/dis.rst:1182
2022-03-23 17:40:12 +00:00
msgid "or:"
msgstr ""
#: library/dis.rst:1185
2022-03-23 17:40:12 +00:00
msgid "``self``"
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:1186
2022-03-23 17:40:12 +00:00
msgid "The remaining positional arguments"
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:1189
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"``argc`` is the total of the positional and named arguments, excluding "
"``self`` when a ``NULL`` is not present."
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1192
2017-04-02 20:14:06 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"``CALL`` pops all arguments and the callable object off the stack, calls the "
"callable object with those arguments, and pushes the return value returned "
"by the callable object."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:1201
2017-04-02 20:14:06 +00:00
msgid ""
2018-10-13 15:54:03 +00:00
"Calls a callable object with variable set of positional and keyword "
"arguments. If the lowest bit of *flags* is set, the top of the stack "
2020-07-20 08:56:42 +00:00
"contains a mapping object containing additional keyword arguments. Before "
"the callable is called, the mapping object and iterable object are each "
"\"unpacked\" and their contents passed in as keyword and positional "
"arguments respectively. ``CALL_FUNCTION_EX`` pops all arguments and the "
"callable object off the stack, calls the callable object with those "
"arguments, and pushes the return value returned by the callable object."
2017-04-02 20:14:06 +00:00
msgstr ""
#: library/dis.rst:1216
2018-06-28 13:32:56 +00:00
msgid ""
2020-02-04 10:14:03 +00:00
"Loads a method named ``co_names[namei]`` from the TOS object. TOS is popped. "
"This bytecode distinguishes two cases: if TOS has a method with the correct "
"name, the bytecode pushes the unbound method and TOS. TOS will be used as "
2022-03-23 17:40:12 +00:00
"the first argument (``self``) by :opcode:`CALL` when calling the unbound "
"method. Otherwise, ``NULL`` and the object return by the attribute lookup "
"are pushed."
msgstr ""
#: library/dis.rst:1228
2022-03-23 17:40:12 +00:00
msgid ""
"Prefixes :opcode:`CALL`. Logically this is a no op. It exists to enable "
"effective specialization of calls. ``argc`` is the number of arguments as "
"described in :opcode:`CALL`."
msgstr ""
#: library/dis.rst:1237
2022-03-23 17:40:12 +00:00
msgid ""
"Pushes a ``NULL`` to the stack. Used in the call sequence to match the "
"``NULL`` pushed by :opcode:`LOAD_METHOD` for non-method calls."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/dis.rst:1246
2018-06-28 13:32:56 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Prefixes :opcode:`PRECALL`. Stores a reference to ``co_consts[consti]`` into "
"an internal variable for use by :opcode:`CALL`. ``co_consts[consti]`` must "
"be a tuple of strings."
2018-06-28 13:32:56 +00:00
msgstr ""
#: library/dis.rst:1255
2016-10-30 09:46:26 +00:00
msgid ""
"Pushes a new function object on the stack. From bottom to top, the consumed "
"stack must consist of values if the argument carries a specified flag value"
msgstr ""
#: library/dis.rst:1258
2018-10-13 15:54:03 +00:00
msgid ""
"``0x01`` a tuple of default values for positional-only and positional-or-"
"keyword parameters in positional order"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1260
2016-10-30 09:46:26 +00:00
msgid "``0x02`` a dictionary of keyword-only parameters' default values"
msgstr ""
#: library/dis.rst:1261
msgid "``0x04`` a tuple of strings containing parameters' annotations"
2016-10-30 09:46:26 +00:00
msgstr ""
#: library/dis.rst:1262
2016-10-30 09:46:26 +00:00
msgid "``0x08`` a tuple containing cells for free variables, making a closure"
msgstr ""
#: library/dis.rst:1263
2023-07-23 12:39:39 +00:00
msgid "the code associated with the function (at TOS)"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1265
msgid "Flag value ``0x04`` is a tuple of strings instead of dictionary"
2016-10-30 09:46:26 +00:00
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1268
msgid "Qualified name at TOS was removed."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1276
2016-10-30 09:46:26 +00:00
msgid ""
"Pushes a slice object on the stack. *argc* must be 2 or 3. If it is 2, "
"``slice(TOS1, TOS)`` is pushed; if it is 3, ``slice(TOS2, TOS1, TOS)`` is "
"pushed. See the :func:`slice` built-in function for more information."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1283
2016-10-30 09:46:26 +00:00
msgid ""
"Prefixes any opcode which has an argument too big to fit into the default "
2019-09-04 09:35:23 +00:00
"one byte. *ext* holds an additional byte which act as higher bits in the "
"argument. For each opcode, at most three prefixal ``EXTENDED_ARG`` are "
"allowed, forming an argument from two-byte to four-byte."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1291
2016-10-30 09:46:26 +00:00
msgid ""
"Used for implementing formatted literal strings (f-strings). Pops an "
"optional *fmt_spec* from the stack, then a required *value*. *flags* is "
"interpreted as follows:"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1295
2016-10-30 09:46:26 +00:00
msgid "``(flags & 0x03) == 0x00``: *value* is formatted as-is."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1296
2016-10-30 09:46:26 +00:00
msgid ""
"``(flags & 0x03) == 0x01``: call :func:`str` on *value* before formatting it."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1298
2016-10-30 09:46:26 +00:00
msgid ""
"``(flags & 0x03) == 0x02``: call :func:`repr` on *value* before formatting "
"it."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1300
2016-10-30 09:46:26 +00:00
msgid ""
"``(flags & 0x03) == 0x03``: call :func:`ascii` on *value* before formatting "
"it."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1302
2016-10-30 09:46:26 +00:00
msgid ""
"``(flags & 0x04) == 0x04``: pop *fmt_spec* from the stack and use it, else "
"use an empty *fmt_spec*."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1305
2016-10-30 09:46:26 +00:00
msgid ""
"Formatting is performed using :c:func:`PyObject_Format`. The result is "
"pushed on the stack."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1313
msgid ""
"TOS is a tuple of keyword attribute names, TOS1 is the class being matched "
"against, and TOS2 is the match subject. *count* is the number of positional "
"sub-patterns."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1317
msgid ""
2022-03-23 17:40:12 +00:00
"Pop TOS, TOS1, and TOS2. If TOS2 is an instance of TOS1 and has the "
"positional and keyword attributes required by *count* and TOS, push a tuple "
"of extracted attributes. Otherwise, push ``None``."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1330
2022-03-23 17:40:12 +00:00
msgid "A no-op. Performs internal tracing, debugging and optimization checks."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1332
2022-03-23 17:40:12 +00:00
msgid "The ``where`` operand marks where the ``RESUME`` occurs:"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1334
2022-03-23 17:40:12 +00:00
msgid "``0`` The start of a function"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1335
2022-03-23 17:40:12 +00:00
msgid "``1`` After a ``yield`` expression"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1336
2022-03-23 17:40:12 +00:00
msgid "``2`` After a ``yield from`` expression"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1337
2022-03-23 17:40:12 +00:00
msgid "``3`` After an ``await`` expression"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1344
2016-10-30 09:46:26 +00:00
msgid ""
2022-03-23 17:40:12 +00:00
"Create a generator, coroutine, or async generator from the current frame. "
"Clear the current frame and return the newly created generator."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1352
2022-03-23 17:40:12 +00:00
msgid ""
"Sends ``None`` to the sub-generator of this generator. Used in ``yield "
"from`` and ``await`` statements."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1360
2022-03-23 17:40:12 +00:00
msgid ""
"Wraps the value on top of the stack in an ``async_generator_wrapped_value``. "
"Used to yield in async generators."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1368
2022-03-23 17:40:12 +00:00
msgid ""
2016-10-30 09:46:26 +00:00
"This is not really an opcode. It identifies the dividing line between "
2017-04-02 20:14:06 +00:00
"opcodes which don't use their argument and those that do (``< "
"HAVE_ARGUMENT`` and ``>= HAVE_ARGUMENT``, respectively)."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1372
2017-04-02 20:14:06 +00:00
msgid ""
"Now every instruction has an argument, but opcodes ``< HAVE_ARGUMENT`` "
"ignore it. Before, only opcodes ``>= HAVE_ARGUMENT`` had an argument."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1380
2016-10-30 09:46:26 +00:00
msgid "Opcode collections"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1382
2016-10-30 09:46:26 +00:00
msgid ""
"These collections are provided for automatic introspection of bytecode "
"instructions:"
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1387
2016-10-30 09:46:26 +00:00
msgid "Sequence of operation names, indexable using the bytecode."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1392
2016-10-30 09:46:26 +00:00
msgid "Dictionary mapping operation names to bytecodes."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1397
2016-10-30 09:46:26 +00:00
msgid "Sequence of all compare operation names."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1402
2018-10-13 15:54:03 +00:00
msgid "Sequence of bytecodes that access a constant."
2016-10-30 09:46:26 +00:00
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1407
2016-10-30 09:46:26 +00:00
msgid ""
"Sequence of bytecodes that access a free variable (note that 'free' in this "
"context refers to names in the current scope that are referenced by inner "
"scopes or names in outer scopes that are referenced from this scope. It "
"does *not* include references to global or builtin scopes)."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1415
2016-10-30 09:46:26 +00:00
msgid "Sequence of bytecodes that access an attribute by name."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1420
2016-10-30 09:46:26 +00:00
msgid "Sequence of bytecodes that have a relative jump target."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1425
2016-10-30 09:46:26 +00:00
msgid "Sequence of bytecodes that have an absolute jump target."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1430
2016-10-30 09:46:26 +00:00
msgid "Sequence of bytecodes that access a local variable."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1435
2016-10-30 09:46:26 +00:00
msgid "Sequence of bytecodes of Boolean operations."
msgstr ""
2023-07-23 12:39:39 +00:00
#: library/dis.rst:1274
#, fuzzy
msgid "built-in function"
msgstr "Analyse de fonctions"
#: library/dis.rst:1274
msgid "slice"
msgstr ""