Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

gh-105678: document SET_FUNCTION_ATTRIBUTE (#105843)

This commit is contained in:
Carl Meyer 2023-06-16 12:36:59 -05:00 committed by GitHub
parent 957a974d4f
commit b356a4749a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
Doc/library/dis.rst
View File

@ -1421,17 +1421,9 @@ iterations of the loop.
.. versionadded:: 3.11
.. opcode:: MAKE_FUNCTION (flags)
.. opcode:: MAKE_FUNCTION
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
* ``0x01`` a tuple of default values for positional-only and
positional-or-keyword parameters in positional order
* ``0x02`` a dictionary of keyword-only parameters' default values
* ``0x04`` a tuple of strings containing parameters' annotations
* ``0x08`` a tuple containing cells for free variables, making a closure
* the code associated with the function (at ``STACK[-1]``)
Pushes a new function object on the stack built from the code object at ``STACK[1]``.
.. versionchanged:: 3.10
Flag value ``0x04`` is a tuple of strings instead of dictionary
@ -1439,6 +1431,25 @@ iterations of the loop.
.. versionchanged:: 3.11
Qualified name at ``STACK[-1]`` was removed.
.. versionchanged:: 3.13
Extra function attributes on the stack, signaled by oparg flags, were
removed. They now use :opcode:`SET_FUNCTION_ATTRIBUTE`.
.. opcode:: SET_FUNCTION_ATTRIBUTE (flag)
Sets an attribute on a function object. Expects the function at ``STACK[-1]``
and the attribute value to set at ``STACK[-2]``; consumes both and leaves the
function at ``STACK[-1]``. The flag determines which attribute to set:
* ``0x01`` a tuple of default values for positional-only and
positional-or-keyword parameters in positional order
* ``0x02`` a dictionary of keyword-only parameters' default values
* ``0x04`` a tuple of strings containing parameters' annotations
* ``0x08`` a tuple containing cells for free variables, making a closure
.. versionadded:: 3.13
.. opcode:: BUILD_SLICE (argc)