diff options
author | Georg Brandl <georg@python.org> | 2009-01-01 12:09:40 (GMT) |
---|---|---|
committer | Georg Brandl <georg@python.org> | 2009-01-01 12:09:40 (GMT) |
commit | 775c30706882291fe6385066899f702f768ed95f (patch) | |
tree | e64dacc8ba3e477eb74ed44e26761c94226bddb2 /Doc | |
parent | 2adde0551a51002c9a43bfabf684be0c960ed192 (diff) | |
download | cpython-775c30706882291fe6385066899f702f768ed95f.zip cpython-775c30706882291fe6385066899f702f768ed95f.tar.gz cpython-775c30706882291fe6385066899f702f768ed95f.tar.bz2 |
#4222: document dis.findlabels() and dis.findlinestarts() and
put them into dis.__all__.
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/dis.rst | 17 |
1 files changed, 15 insertions, 2 deletions
diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst index e9cbb13..909e229 100644 --- a/Doc/library/dis.rst +++ b/Doc/library/dis.rst @@ -64,10 +64,23 @@ The :mod:`dis` module defines the following functions and constants: .. function:: disco(code[, lasti]) - A synonym for disassemble. It is more convenient to type, and kept for - compatibility with earlier Python releases. + A synonym for :func:`disassemble`. It is more convenient to type, and kept + for compatibility with earlier Python releases. +.. function:: findlinestarts(code) + + 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. + + +.. function:: findlabels(code) + + Detect all offsets in the code object *code* which are jump targets, and + return a list of these offsets. + + .. data:: opname Sequence of operation names, indexable using the bytecode. |