Skip to content

Commit b045174

Browse files
bpo-44964: Correct the note about the f_lasti field (GH-28208) (GH-28276)
(cherry picked from commit ab327f2) Co-authored-by: Pablo Galindo Salgado <[email protected]>
1 parent 60ddf49 commit b045174

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

Doc/reference/datamodel.rst

+2-3
Original file line numberDiff line numberDiff line change
@@ -1034,9 +1034,8 @@ Internal types
10341034
:attr:`f_code` is the code object being executed in this frame; :attr:`f_locals`
10351035
is the dictionary used to look up local variables; :attr:`f_globals` is used for
10361036
global variables; :attr:`f_builtins` is used for built-in (intrinsic) names;
1037-
:attr:`f_lasti` gives the precise instruction (it represents a wordcode index, which
1038-
means that to get an index into the bytecode string of the code object it needs to be
1039-
multiplied by 2).
1037+
:attr:`f_lasti` gives the precise instruction (this is an index into the
1038+
bytecode string of the code object).
10401039

10411040
Accessing ``f_code`` raises an :ref:`auditing event <auditing>`
10421041
``object.__getattr__`` with arguments ``obj`` and ``"f_code"``.

Doc/whatsnew/3.10.rst

+2-1
Original file line numberDiff line numberDiff line change
@@ -1948,7 +1948,8 @@ Changes in the C API
19481948
offset instead of a simple offset into the bytecode string. This means that this
19491949
number needs to be multiplied by 2 to be used with APIs that expect a byte offset
19501950
instead (like :c:func:`PyCode_Addr2Line` for example). Notice as well that the
1951-
``f_lasti`` member of ``FrameObject`` objects is not considered stable.
1951+
``f_lasti`` member of ``FrameObject`` objects is not considered stable: please
1952+
use :c:func:`PyFrame_GetLineNumber` instead.
19521953
19531954
CPython bytecode changes
19541955
========================

0 commit comments

Comments
 (0)