douuvid/python-docs-fr
1
0
Fork 0
forked from AFPy/python-docs-fr
Code Pull Requests Activity
707f05d2d7
python-docs-fr/library/dis.po
Julien Palard 707f05d2d7 merge pot files.
2017-12-01 07:48:13 +01:00

1209 lines
35 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2016, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-12-01 07:43+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../Doc/library/dis.rst:2
msgid ":mod:`dis` --- Disassembler for Python bytecode"
msgstr ""
#: ../Doc/library/dis.rst:7
msgid "**Source code:** :source:`Lib/dis.py`"
msgstr "**Code source :** :source:`Lib/dis.py`"
#: ../Doc/library/dis.rst:11
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 ""
#: ../Doc/library/dis.rst:18
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 ""
#: ../Doc/library/dis.rst:23
msgid ""
"Use 2 bytes for each instruction. Previously the number of bytes varied by "
"instruction."
msgstr ""
#: ../Doc/library/dis.rst:28
msgid "Example: Given the function :func:`myfunc`::"
msgstr ""
#: ../Doc/library/dis.rst:33
msgid ""
"the following command can be used to display the disassembly of :func:"
"`myfunc`::"
msgstr ""
#: ../Doc/library/dis.rst:42
msgid "(The \"2\" is a line number)."
msgstr ""
#: ../Doc/library/dis.rst:45
msgid "Bytecode analysis"
msgstr ""
#: ../Doc/library/dis.rst:49
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 ""
#: ../Doc/library/dis.rst:56
msgid ""
"Analyse the bytecode corresponding to a function, generator, method, string "
"of source code, or a code object (as returned by :func:`compile`)."
msgstr ""
#: ../Doc/library/dis.rst:59
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 ""
#: ../Doc/library/dis.rst:63 ../Doc/library/dis.rst:204
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 ""
#: ../Doc/library/dis.rst:68
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 ""
#: ../Doc/library/dis.rst:74
msgid ""
"Construct a :class:`Bytecode` instance from the given traceback, setting "
"*current_offset* to the instruction responsible for the exception."
msgstr ""
#: ../Doc/library/dis.rst:79
msgid "The compiled code object."
msgstr ""
#: ../Doc/library/dis.rst:83
msgid "The first source line of the code object (if available)"
msgstr ""
#: ../Doc/library/dis.rst:87
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 ""
#: ../Doc/library/dis.rst:92
msgid ""
"Return a formatted multi-line string with detailed information about the "
"code object, like :func:`code_info`."
msgstr ""
#: ../Doc/library/dis.rst:95
msgid "Example::"
msgstr "Exemples ::"
#: ../Doc/library/dis.rst:108
msgid "Analysis functions"
msgstr ""
#: ../Doc/library/dis.rst:110
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 ""
#: ../Doc/library/dis.rst:116
msgid ""
"Return a formatted multi-line string with detailed code object information "
"for the supplied function, generator, method, source code string or code "
"object."
msgstr ""
#: ../Doc/library/dis.rst:119
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 ""
#: ../Doc/library/dis.rst:128
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 ""
#: ../Doc/library/dis.rst:132
msgid ""
"This is a convenient shorthand for ``print(code_info(x), file=file)``, "
"intended for interactive exploration at the interpreter prompt."
msgstr ""
#: ../Doc/library/dis.rst:137 ../Doc/library/dis.rst:155
#: ../Doc/library/dis.rst:168 ../Doc/library/dis.rst:192
msgid "Added *file* parameter."
msgstr ""
#: ../Doc/library/dis.rst:143
msgid ""
"Disassemble the *x* object. *x* can denote either a module, a class, a "
"method, a function, a generator, a 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. 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."
msgstr ""
#: ../Doc/library/dis.rst:152 ../Doc/library/dis.rst:165
#: ../Doc/library/dis.rst:189
msgid ""
"The disassembly is written as text to the supplied *file* argument if "
"provided and to ``sys.stdout`` otherwise."
msgstr ""
#: ../Doc/library/dis.rst:161
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 ""
#: ../Doc/library/dis.rst:175
msgid ""
"Disassemble a code object, indicating the last instruction if *lasti* was "
"provided. The output is divided in the following columns:"
msgstr ""
#: ../Doc/library/dis.rst:178
msgid "the line number, for the first instruction of each line"
msgstr ""
#: ../Doc/library/dis.rst:179
msgid "the current instruction, indicated as ``-->``,"
msgstr ""
#: ../Doc/library/dis.rst:180
msgid "a labelled instruction, indicated with ``>>``,"
msgstr ""
#: ../Doc/library/dis.rst:181
msgid "the address of the instruction,"
msgstr ""
#: ../Doc/library/dis.rst:182
msgid "the operation code name,"
msgstr ""
#: ../Doc/library/dis.rst:183
msgid "operation parameters, and"
msgstr ""
#: ../Doc/library/dis.rst:184
msgid "interpretation of the parameters in parentheses."
msgstr ""
#: ../Doc/library/dis.rst:186
msgid ""
"The parameter interpretation recognizes local and global variable names, "
"constant values, branch targets, and compare operators."
msgstr ""
#: ../Doc/library/dis.rst:198
msgid ""
"Return an iterator over the instructions in the supplied function, method, "
"source code string or code object."
msgstr ""
#: ../Doc/library/dis.rst:201
msgid ""
"The iterator generates a series of :class:`Instruction` named tuples giving "
"the details of each operation in the supplied code."
msgstr ""
#: ../Doc/library/dis.rst:214
msgid ""
"This generator function uses the ``co_firstlineno`` and ``co_lnotab`` "
"attributes 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. "
"See :source:`Objects/lnotab_notes.txt` for the ``co_lnotab`` format and how "
"to decode it."
msgstr ""
#: ../Doc/library/dis.rst:220
msgid "Line numbers can be decreasing. Before, they were always increasing."
msgstr ""
#: ../Doc/library/dis.rst:226
msgid ""
"Detect all offsets in the code object *code* which are jump targets, and "
"return a list of these offsets."
msgstr ""
#: ../Doc/library/dis.rst:232
msgid "Compute the stack effect of *opcode* with argument *oparg*."
msgstr ""
#: ../Doc/library/dis.rst:239
msgid "Python Bytecode Instructions"
msgstr ""
#: ../Doc/library/dis.rst:241
msgid ""
"The :func:`get_instructions` function and :class:`Bytecode` class provide "
"details of bytecode instructions as :class:`Instruction` instances:"
msgstr ""
#: ../Doc/library/dis.rst:246
msgid "Details for a bytecode operation"
msgstr ""
#: ../Doc/library/dis.rst:250
msgid ""
"numeric code for operation, corresponding to the opcode values listed below "
"and the bytecode values in the :ref:`opcode_collections`."
msgstr ""
#: ../Doc/library/dis.rst:256
msgid "human readable name for operation"
msgstr ""
#: ../Doc/library/dis.rst:261
msgid "numeric argument to operation (if any), otherwise ``None``"
msgstr ""
#: ../Doc/library/dis.rst:266
msgid "resolved arg value (if known), otherwise same as arg"
msgstr ""
#: ../Doc/library/dis.rst:271
msgid "human readable description of operation argument"
msgstr ""
#: ../Doc/library/dis.rst:276
msgid "start index of operation within bytecode sequence"
msgstr ""
#: ../Doc/library/dis.rst:281
msgid "line started by this opcode (if any), otherwise ``None``"
msgstr ""
#: ../Doc/library/dis.rst:286
msgid "``True`` if other code jumps to here, otherwise ``False``"
msgstr ""
#: ../Doc/library/dis.rst:291
msgid ""
"The Python compiler currently generates the following bytecode instructions."
msgstr ""
#: ../Doc/library/dis.rst:294
msgid "**General instructions**"
msgstr ""
#: ../Doc/library/dis.rst:298
msgid "Do nothing code. Used as a placeholder by the bytecode optimizer."
msgstr ""
#: ../Doc/library/dis.rst:303
msgid "Removes the top-of-stack (TOS) item."
msgstr ""
#: ../Doc/library/dis.rst:308
msgid "Swaps the two top-most stack items."
msgstr ""
#: ../Doc/library/dis.rst:313
msgid ""
"Lifts second and third stack item one position up, moves top down to "
"position three."
msgstr ""
#: ../Doc/library/dis.rst:319
msgid "Duplicates the reference on top of the stack."
msgstr ""
#: ../Doc/library/dis.rst:324
msgid ""
"Duplicates the two references on top of the stack, leaving them in the same "
"order."
msgstr ""
#: ../Doc/library/dis.rst:328
msgid "**Unary operations**"
msgstr ""
#: ../Doc/library/dis.rst:330
msgid ""
"Unary operations take the top of the stack, apply the operation, and push "
"the result back on the stack."
msgstr ""
#: ../Doc/library/dis.rst:335
msgid "Implements ``TOS = +TOS``."
msgstr ""
#: ../Doc/library/dis.rst:340
msgid "Implements ``TOS = -TOS``."
msgstr ""
#: ../Doc/library/dis.rst:345
msgid "Implements ``TOS = not TOS``."
msgstr ""
#: ../Doc/library/dis.rst:350
msgid "Implements ``TOS = ~TOS``."
msgstr ""
#: ../Doc/library/dis.rst:355
msgid "Implements ``TOS = iter(TOS)``."
msgstr ""
#: ../Doc/library/dis.rst:360
msgid ""
"If ``TOS`` is a :term:`generator iterator` or :term:`coroutine` object it is "
"left as is. Otherwise, implements ``TOS = iter(TOS)``."
msgstr ""
#: ../Doc/library/dis.rst:366
msgid "**Binary operations**"
msgstr ""
#: ../Doc/library/dis.rst:368
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 ""
#: ../Doc/library/dis.rst:374
msgid "Implements ``TOS = TOS1 ** TOS``."
msgstr ""
#: ../Doc/library/dis.rst:379
msgid "Implements ``TOS = TOS1 * TOS``."
msgstr ""
#: ../Doc/library/dis.rst:384
msgid "Implements ``TOS = TOS1 @ TOS``."
msgstr ""
#: ../Doc/library/dis.rst:391
msgid "Implements ``TOS = TOS1 // TOS``."
msgstr ""
#: ../Doc/library/dis.rst:396
msgid "Implements ``TOS = TOS1 / TOS``."
msgstr ""
#: ../Doc/library/dis.rst:401
msgid "Implements ``TOS = TOS1 % TOS``."
msgstr ""
#: ../Doc/library/dis.rst:406
msgid "Implements ``TOS = TOS1 + TOS``."
msgstr ""
#: ../Doc/library/dis.rst:411
msgid "Implements ``TOS = TOS1 - TOS``."
msgstr ""
#: ../Doc/library/dis.rst:416
msgid "Implements ``TOS = TOS1[TOS]``."
msgstr ""
#: ../Doc/library/dis.rst:421
msgid "Implements ``TOS = TOS1 << TOS``."
msgstr ""
#: ../Doc/library/dis.rst:426
msgid "Implements ``TOS = TOS1 >> TOS``."
msgstr ""
#: ../Doc/library/dis.rst:431
msgid "Implements ``TOS = TOS1 & TOS``."
msgstr ""
#: ../Doc/library/dis.rst:436
msgid "Implements ``TOS = TOS1 ^ TOS``."
msgstr ""
#: ../Doc/library/dis.rst:441
msgid "Implements ``TOS = TOS1 | TOS``."
msgstr ""
#: ../Doc/library/dis.rst:444
msgid "**In-place operations**"
msgstr ""
#: ../Doc/library/dis.rst:446
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 ""
#: ../Doc/library/dis.rst:453
msgid "Implements in-place ``TOS = TOS1 ** TOS``."
msgstr ""
#: ../Doc/library/dis.rst:458
msgid "Implements in-place ``TOS = TOS1 * TOS``."
msgstr ""
#: ../Doc/library/dis.rst:463
msgid "Implements in-place ``TOS = TOS1 @ TOS``."
msgstr ""
#: ../Doc/library/dis.rst:470
msgid "Implements in-place ``TOS = TOS1 // TOS``."
msgstr ""
#: ../Doc/library/dis.rst:475
msgid "Implements in-place ``TOS = TOS1 / TOS``."
msgstr ""
#: ../Doc/library/dis.rst:480
msgid "Implements in-place ``TOS = TOS1 % TOS``."
msgstr ""
#: ../Doc/library/dis.rst:485
msgid "Implements in-place ``TOS = TOS1 + TOS``."
msgstr ""
#: ../Doc/library/dis.rst:490
msgid "Implements in-place ``TOS = TOS1 - TOS``."
msgstr ""
#: ../Doc/library/dis.rst:495
msgid "Implements in-place ``TOS = TOS1 << TOS``."
msgstr ""
#: ../Doc/library/dis.rst:500
msgid "Implements in-place ``TOS = TOS1 >> TOS``."
msgstr ""
#: ../Doc/library/dis.rst:505
msgid "Implements in-place ``TOS = TOS1 & TOS``."
msgstr ""
#: ../Doc/library/dis.rst:510
msgid "Implements in-place ``TOS = TOS1 ^ TOS``."
msgstr ""
#: ../Doc/library/dis.rst:515
msgid "Implements in-place ``TOS = TOS1 | TOS``."
msgstr ""
#: ../Doc/library/dis.rst:520
msgid "Implements ``TOS1[TOS] = TOS2``."
msgstr ""
#: ../Doc/library/dis.rst:525
msgid "Implements ``del TOS1[TOS]``."
msgstr ""
#: ../Doc/library/dis.rst:528
msgid "**Coroutine opcodes**"
msgstr ""
#: ../Doc/library/dis.rst:532
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__``."
msgstr ""
#: ../Doc/library/dis.rst:540
msgid ""
"Implements ``TOS = get_awaitable(TOS.__aiter__())``. See ``GET_AWAITABLE`` "
"for details about ``get_awaitable``"
msgstr ""
#: ../Doc/library/dis.rst:546
msgid ""
"Implements ``PUSH(get_awaitable(TOS.__anext__()))``. See ``GET_AWAITABLE`` "
"for details about ``get_awaitable``"
msgstr ""
#: ../Doc/library/dis.rst:552
msgid ""
"Resolves ``__aenter__`` and ``__aexit__`` from the object on top of the "
"stack. Pushes ``__aexit__`` and result of ``__aenter__()`` to the stack."
msgstr ""
#: ../Doc/library/dis.rst:558
msgid "Creates a new frame object."
msgstr ""
#: ../Doc/library/dis.rst:562
msgid "**Miscellaneous opcodes**"
msgstr ""
#: ../Doc/library/dis.rst:566
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 ""
#: ../Doc/library/dis.rst:573
msgid "Terminates a loop due to a :keyword:`break` statement."
msgstr ""
#: ../Doc/library/dis.rst:578
msgid ""
"Continues a loop due to a :keyword:`continue` statement. *target* is the "
"address to jump to (which should be a :opcode:`FOR_ITER` instruction)."
msgstr ""
#: ../Doc/library/dis.rst:584
msgid ""
"Calls ``set.add(TOS1[-i], TOS)``. Used to implement set comprehensions."
msgstr ""
#: ../Doc/library/dis.rst:589
msgid ""
"Calls ``list.append(TOS[-i], TOS)``. Used to implement list comprehensions."
msgstr ""
#: ../Doc/library/dis.rst:594
msgid ""
"Calls ``dict.setitem(TOS1[-i], TOS, TOS1)``. Used to implement dict "
"comprehensions."
msgstr ""
#: ../Doc/library/dis.rst:597
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 ""
#: ../Doc/library/dis.rst:605
msgid "Returns with TOS to the caller of the function."
msgstr ""
#: ../Doc/library/dis.rst:610
msgid "Pops TOS and yields it from a :term:`generator`."
msgstr ""
#: ../Doc/library/dis.rst:615
msgid "Pops TOS and delegates to it as a subiterator from a :term:`generator`."
msgstr ""
#: ../Doc/library/dis.rst:621
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 ""
#: ../Doc/library/dis.rst:630
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 ""
#: ../Doc/library/dis.rst:637
msgid ""
"Removes one block from the block stack. Per frame, there is a stack of "
"blocks, denoting nested loops, try statements, and such."
msgstr ""
#: ../Doc/library/dis.rst:643
msgid ""
"Removes one block from the block stack. The popped block must be an "
"exception handler block, as implicitly created when entering an except "
"handler. In addition to popping extraneous values from the frame stack, the "
"last three popped values are used to restore the exception state."
msgstr ""
#: ../Doc/library/dis.rst:651
msgid ""
"Terminates a :keyword:`finally` clause. The interpreter recalls whether the "
"exception has to be re-raised, or whether the function returns, and "
"continues with the outer-next block."
msgstr ""
#: ../Doc/library/dis.rst:658
msgid ""
"Pushes :func:`builtins.__build_class__` onto the stack. It is later called "
"by :opcode:`CALL_FUNCTION` to construct a class."
msgstr ""
#: ../Doc/library/dis.rst:664
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_CLEANUP`. Then, :meth:"
"`~object.__enter__` is called, and a finally block pointing to *delta* is "
"pushed. Finally, the result of calling the enter method is pushed onto the "
"stack. The next opcode will either ignore it (:opcode:`POP_TOP`), or store "
"it in (a) variable(s) (:opcode:`STORE_FAST`, :opcode:`STORE_NAME`, or :"
"opcode:`UNPACK_SEQUENCE`)."
msgstr ""
#: ../Doc/library/dis.rst:676
msgid ""
"Cleans up the stack when a :keyword:`with` statement block exits. TOS is "
"the context manager's :meth:`__exit__` bound method. Below TOS are 1--3 "
"values indicating how/why the finally clause was entered:"
msgstr ""
#: ../Doc/library/dis.rst:680
msgid "SECOND = ``None``"
msgstr ""
#: ../Doc/library/dis.rst:681
msgid "(SECOND, THIRD) = (``WHY_{RETURN,CONTINUE}``), retval"
msgstr ""
#: ../Doc/library/dis.rst:682
msgid "SECOND = ``WHY_*``; no retval below it"
msgstr ""
#: ../Doc/library/dis.rst:683
msgid "(SECOND, THIRD, FOURTH) = exc_info()"
msgstr ""
#: ../Doc/library/dis.rst:685
msgid ""
"In the last case, ``TOS(SECOND, THIRD, FOURTH)`` is called, otherwise "
"``TOS(None, None, None)``. Pushes SECOND and result of the call to the "
"stack."
msgstr ""
#: ../Doc/library/dis.rst:692
msgid "Pops exception type and result of 'exit' function call from the stack."
msgstr ""
#: ../Doc/library/dis.rst:694
msgid ""
"If the stack represents an exception, *and* the function call returns a "
"'true' value, this information is \"zapped\" and replaced with a single "
"``WHY_SILENCED`` to prevent :opcode:`END_FINALLY` from re-raising the "
"exception. (But non-local gotos will still be resumed.)"
msgstr ""
#: ../Doc/library/dis.rst:702
msgid "All of the following opcodes use their arguments."
msgstr ""
#: ../Doc/library/dis.rst:706
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 ""
#: ../Doc/library/dis.rst:713
msgid ""
"Implements ``del name``, where *namei* is the index into :attr:`co_names` "
"attribute of the code object."
msgstr ""
#: ../Doc/library/dis.rst:719
msgid ""
"Unpacks TOS into *count* individual values, which are put onto the stack "
"right-to-left."
msgstr ""
#: ../Doc/library/dis.rst:725
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 ""
#: ../Doc/library/dis.rst:730
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 ""
#: ../Doc/library/dis.rst:737
msgid ""
"Implements ``TOS.name = TOS1``, where *namei* is the index of name in :attr:"
"`co_names`."
msgstr ""
#: ../Doc/library/dis.rst:743
msgid ""
"Implements ``del TOS.name``, using *namei* as index into :attr:`co_names`."
msgstr ""
#: ../Doc/library/dis.rst:748
msgid "Works as :opcode:`STORE_NAME`, but stores the name as a global."
msgstr ""
#: ../Doc/library/dis.rst:753
msgid "Works as :opcode:`DELETE_NAME`, but deletes a global name."
msgstr ""
#: ../Doc/library/dis.rst:758
msgid "Pushes ``co_consts[consti]`` onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:763
msgid "Pushes the value associated with ``co_names[namei]`` onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:768
msgid ""
"Creates a tuple consuming *count* items from the stack, and pushes the "
"resulting tuple onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:774
msgid "Works as :opcode:`BUILD_TUPLE`, but creates a list."
msgstr ""
#: ../Doc/library/dis.rst:779
msgid "Works as :opcode:`BUILD_TUPLE`, but creates a set."
msgstr ""
#: ../Doc/library/dis.rst:784
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 ""
#: ../Doc/library/dis.rst:788
msgid ""
"The dictionary is created from stack items instead of creating an empty "
"dictionary pre-sized to hold *count* items."
msgstr ""
#: ../Doc/library/dis.rst:795
msgid ""
"The version of :opcode:`BUILD_MAP` specialized for constant keys. *count* "
"values are consumed from the stack. The top element on the stack contains a "
"tuple of keys."
msgstr ""
#: ../Doc/library/dis.rst:804
msgid ""
"Concatenates *count* strings from the stack and pushes the resulting string "
"onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:812
msgid ""
"Pops *count* iterables from the stack, joins them in a single tuple, and "
"pushes the result. Implements iterable unpacking in tuple displays ``(*x, "
"*y, *z)``."
msgstr ""
#: ../Doc/library/dis.rst:821
msgid ""
"This is similar to :opcode:`BUILD_TUPLE_UNPACK`, but is used for ``f(*x, *y, "
"*z)`` call syntax. The stack item at position ``count + 1`` should be the "
"corresponding callable ``f``."
msgstr ""
#: ../Doc/library/dis.rst:830
msgid ""
"This is similar to :opcode:`BUILD_TUPLE_UNPACK`, but pushes a list instead "
"of tuple. Implements iterable unpacking in list displays ``[*x, *y, *z]``."
msgstr ""
#: ../Doc/library/dis.rst:839
msgid ""
"This is similar to :opcode:`BUILD_TUPLE_UNPACK`, but pushes a set instead of "
"tuple. Implements iterable unpacking in set displays ``{*x, *y, *z}``."
msgstr ""
#: ../Doc/library/dis.rst:848
msgid ""
"Pops *count* mappings from the stack, merges them into a single dictionary, "
"and pushes the result. Implements dictionary unpacking in dictionary "
"displays ``{**x, **y, **z}``."
msgstr ""
#: ../Doc/library/dis.rst:857
msgid ""
"This is similar to :opcode:`BUILD_MAP_UNPACK`, but is used for ``f(**x, **y, "
"**z)`` call syntax. The stack item at position ``count + 2`` should be the "
"corresponding callable ``f``."
msgstr ""
#: ../Doc/library/dis.rst:862
msgid ""
"The position of the callable is determined by adding 2 to the opcode "
"argument instead of encoding it in the second byte of the argument."
msgstr ""
#: ../Doc/library/dis.rst:869
msgid "Replaces TOS with ``getattr(TOS, co_names[namei])``."
msgstr ""
#: ../Doc/library/dis.rst:874
msgid ""
"Performs a Boolean operation. The operation name can be found in "
"``cmp_op[opname]``."
msgstr ""
#: ../Doc/library/dis.rst:880
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 ""
#: ../Doc/library/dis.rst:889
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 ""
#: ../Doc/library/dis.rst:896
msgid "Increments bytecode counter by *delta*."
msgstr ""
#: ../Doc/library/dis.rst:901
msgid "If TOS is true, sets the bytecode counter to *target*. TOS is popped."
msgstr ""
#: ../Doc/library/dis.rst:906
msgid "If TOS is false, sets the bytecode counter to *target*. TOS is popped."
msgstr ""
#: ../Doc/library/dis.rst:911
msgid ""
"If TOS is true, sets the bytecode counter to *target* and leaves TOS on the "
"stack. Otherwise (TOS is false), TOS is popped."
msgstr ""
#: ../Doc/library/dis.rst:917
msgid ""
"If TOS is false, sets the bytecode counter to *target* and leaves TOS on the "
"stack. Otherwise (TOS is true), TOS is popped."
msgstr ""
#: ../Doc/library/dis.rst:923
msgid "Set bytecode counter to *target*."
msgstr ""
#: ../Doc/library/dis.rst:928
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 "
"it). If the iterator indicates it is exhausted TOS is popped, and the byte "
"code counter is incremented by *delta*."
msgstr ""
#: ../Doc/library/dis.rst:936
msgid "Loads the global named ``co_names[namei]`` onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:941
msgid ""
"Pushes a block for a loop onto the block stack. The block spans from the "
"current instruction with a size of *delta* bytes."
msgstr ""
#: ../Doc/library/dis.rst:947
msgid ""
"Pushes a try block from a try-except clause onto the block stack. *delta* "
"points to the first except block."
msgstr ""
#: ../Doc/library/dis.rst:953
msgid ""
"Pushes a try block from a try-except clause onto the block stack. *delta* "
"points to the finally block."
msgstr ""
#: ../Doc/library/dis.rst:959
msgid ""
"Pushes a reference to the local ``co_varnames[var_num]`` onto the stack."
msgstr ""
#: ../Doc/library/dis.rst:964
msgid "Stores TOS into the local ``co_varnames[var_num]``."
msgstr ""
#: ../Doc/library/dis.rst:969
msgid "Deletes local ``co_varnames[var_num]``."
msgstr ""
#: ../Doc/library/dis.rst:974
msgid "Stores TOS as ``locals()['__annotations__'][co_names[namei]] = TOS``."
msgstr ""
#: ../Doc/library/dis.rst:981
msgid ""
"Pushes a reference to the cell contained in slot *i* of the cell and free "
"variable storage. The name of the variable is ``co_cellvars[i]`` if *i* is "
"less than the length of *co_cellvars*. Otherwise it is ``co_freevars[i - "
"len(co_cellvars)]``."
msgstr ""
#: ../Doc/library/dis.rst:989
msgid ""
"Loads the cell contained in slot *i* of the cell and free variable storage. "
"Pushes a reference to the object the cell contains on the stack."
msgstr ""
#: ../Doc/library/dis.rst:995
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 ""
#: ../Doc/library/dis.rst:1002
msgid ""
"Stores TOS into the cell contained in slot *i* of the cell and free variable "
"storage."
msgstr ""
#: ../Doc/library/dis.rst:1008
msgid ""
"Empties the cell contained in slot *i* of the cell and free variable "
"storage. Used by the :keyword:`del` statement."
msgstr ""
#: ../Doc/library/dis.rst:1014
msgid ""
"Raises an exception. *argc* indicates the number of parameters to the raise "
"statement, ranging from 0 to 3. The handler will find the traceback as "
"TOS2, the parameter as TOS1, and the exception as TOS."
msgstr ""
#: ../Doc/library/dis.rst:1021
msgid ""
"Calls a function. *argc* indicates the number of positional arguments. The "
"positional arguments are on the stack, with the right-most argument on top. "
"Below the arguments, the function object to call is on the stack. Pops all "
"function arguments, and the function itself off the stack, and pushes the "
"return value."
msgstr ""
#: ../Doc/library/dis.rst:1027
msgid "This opcode is used only for calls with positional arguments."
msgstr ""
#: ../Doc/library/dis.rst:1033
msgid ""
"Calls a function. *argc* indicates the number of arguments (positional and "
"keyword). The top element on the stack contains a tuple of keyword argument "
"names. Below the tuple, keyword arguments are on the stack, in the order "
"corresponding to the tuple. Below the keyword arguments, the positional "
"arguments are on the stack, with the right-most parameter on top. Below the "
"arguments, the function object to call is on the stack. Pops all function "
"arguments, and the function itself off the stack, and pushes the return "
"value."
msgstr ""
#: ../Doc/library/dis.rst:1042
msgid ""
"Keyword arguments are packed in a tuple instead of a dictionary, *argc* "
"indicates the total number of arguments"
msgstr ""
#: ../Doc/library/dis.rst:1049
msgid ""
"Calls a function. The lowest bit of *flags* indicates whether the var-"
"keyword argument is placed at the top of the stack. Below the var-keyword "
"argument, the var-positional argument is on the stack. Below the arguments, "
"the function object to call is placed. Pops all function arguments, and the "
"function itself off the stack, and pushes the return value. Note that this "
"opcode pops at most three items from the stack. Var-positional and var-"
"keyword arguments are packed by :opcode:`BUILD_TUPLE_UNPACK_WITH_CALL` and :"
"opcode:`BUILD_MAP_UNPACK_WITH_CALL`."
msgstr ""
#: ../Doc/library/dis.rst:1064
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 ""
#: ../Doc/library/dis.rst:1067
msgid "``0x01`` a tuple of default argument objects in positional order"
msgstr ""
#: ../Doc/library/dis.rst:1068
msgid "``0x02`` a dictionary of keyword-only parameters' default values"
msgstr ""
#: ../Doc/library/dis.rst:1069
msgid "``0x04`` an annotation dictionary"
msgstr ""
#: ../Doc/library/dis.rst:1070
msgid "``0x08`` a tuple containing cells for free variables, making a closure"
msgstr ""
#: ../Doc/library/dis.rst:1071
msgid "the code associated with the function (at TOS1)"
msgstr ""
#: ../Doc/library/dis.rst:1072
msgid "the :term:`qualified name` of the function (at TOS)"
msgstr ""
#: ../Doc/library/dis.rst:1079
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 ""
#: ../Doc/library/dis.rst:1086
msgid ""
"Prefixes any opcode which has an argument too big to fit into the default "
"two bytes. *ext* holds two additional bytes which, taken together with the "
"subsequent opcode's argument, comprise a four-byte argument, *ext* being the "
"two most-significant bytes."
msgstr ""
#: ../Doc/library/dis.rst:1094
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 ""
#: ../Doc/library/dis.rst:1098
msgid "``(flags & 0x03) == 0x00``: *value* is formatted as-is."
msgstr ""
#: ../Doc/library/dis.rst:1099
msgid ""
"``(flags & 0x03) == 0x01``: call :func:`str` on *value* before formatting it."
msgstr ""
#: ../Doc/library/dis.rst:1101
msgid ""
"``(flags & 0x03) == 0x02``: call :func:`repr` on *value* before formatting "
"it."
msgstr ""
#: ../Doc/library/dis.rst:1103
msgid ""
"``(flags & 0x03) == 0x03``: call :func:`ascii` on *value* before formatting "
"it."
msgstr ""
#: ../Doc/library/dis.rst:1105
msgid ""
"``(flags & 0x04) == 0x04``: pop *fmt_spec* from the stack and use it, else "
"use an empty *fmt_spec*."
msgstr ""
#: ../Doc/library/dis.rst:1108
msgid ""
"Formatting is performed using :c:func:`PyObject_Format`. The result is "
"pushed on the stack."
msgstr ""
#: ../Doc/library/dis.rst:1116
msgid ""
"This is not really an opcode. It identifies the dividing line between "
"opcodes which don't use their argument and those that do (``< "
"HAVE_ARGUMENT`` and ``>= HAVE_ARGUMENT``, respectively)."
msgstr ""
#: ../Doc/library/dis.rst:1120
msgid ""
"Now every instruction has an argument, but opcodes ``< HAVE_ARGUMENT`` "
"ignore it. Before, only opcodes ``>= HAVE_ARGUMENT`` had an argument."
msgstr ""
#: ../Doc/library/dis.rst:1128
msgid "Opcode collections"
msgstr ""
#: ../Doc/library/dis.rst:1130
msgid ""
"These collections are provided for automatic introspection of bytecode "
"instructions:"
msgstr ""
#: ../Doc/library/dis.rst:1135
msgid "Sequence of operation names, indexable using the bytecode."
msgstr ""
#: ../Doc/library/dis.rst:1140
msgid "Dictionary mapping operation names to bytecodes."
msgstr ""
#: ../Doc/library/dis.rst:1145
msgid "Sequence of all compare operation names."
msgstr ""
#: ../Doc/library/dis.rst:1150
msgid "Sequence of bytecodes that have a constant parameter."
msgstr ""
#: ../Doc/library/dis.rst:1155
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 ""
#: ../Doc/library/dis.rst:1163
msgid "Sequence of bytecodes that access an attribute by name."
msgstr ""
#: ../Doc/library/dis.rst:1168
msgid "Sequence of bytecodes that have a relative jump target."
msgstr ""
#: ../Doc/library/dis.rst:1173
msgid "Sequence of bytecodes that have an absolute jump target."
msgstr ""
#: ../Doc/library/dis.rst:1178
msgid "Sequence of bytecodes that access a local variable."
msgstr ""
#: ../Doc/library/dis.rst:1183
msgid "Sequence of bytecodes of Boolean operations."
msgstr ""
View Git Blame Copy Permalink