summaryrefslogtreecommitdiffstats
path: root/Doc/library/dis.rst
diff options
context:
space:
mode:
authorBenjamin Peterson <benjamin@python.org>2009-06-28 03:18:59 (GMT)
committerBenjamin Peterson <benjamin@python.org>2009-06-28 03:18:59 (GMT)
commit876b2f286b9af1a69846c84d1229014b2a885c97 (patch)
tree1934d1ce119603a4ae7a0a37c01957a3ca2d17a2 /Doc/library/dis.rst
parentd2397753ee3d20579aa60b5e1c037e9e20db7ccb (diff)
downloadcpython-876b2f286b9af1a69846c84d1229014b2a885c97.zip
cpython-876b2f286b9af1a69846c84d1229014b2a885c97.tar.gz
cpython-876b2f286b9af1a69846c84d1229014b2a885c97.tar.bz2
Merged revisions 72912,72920,72940 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r72912 | benjamin.peterson | 2009-05-25 08:13:44 -0500 (Mon, 25 May 2009) | 5 lines add a SETUP_WITH opcode It speeds up the with statement and correctly looks up the special methods involved. ........ r72920 | benjamin.peterson | 2009-05-25 15:12:57 -0500 (Mon, 25 May 2009) | 1 line take into account the fact that SETUP_WITH pushes a finally block ........ r72940 | benjamin.peterson | 2009-05-26 07:49:59 -0500 (Tue, 26 May 2009) | 1 line teach the peepholer about SETUP_WITH ........
Diffstat (limited to 'Doc/library/dis.rst')
-rw-r--r--Doc/library/dis.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 8d4d956..341beb5 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -436,6 +436,18 @@ the stack so that it is available for further iterations of the loop.
by ``CALL_FUNCTION`` to construct a class.
+.. opcode:: SETUP_WITH (delta)
+
+ 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`).
+
+
.. opcode:: WITH_CLEANUP ()
Cleans up the stack when a :keyword:`with` statement block exits. TOS is