Struct InterpreterFrame 

pub struct InterpreterFrame {
    pub locals: FrameLocals,
    pub lasti: PyAtomic<u32>,
    pub generator: PyAtomicBorrow,
    /* private fields */
}

Lightweight execution frame. Not a PyObject. Analogous to CPython’s _PyInterpreterFrame.

The four identity fields (code, globals, builtins, func_obj) are borrowed raw pointers. Construction is unsafe and is what establishes that they stay valid for the frame’s life (or until init_iframe_ptrs overwrites them). A live InterpreterFrame may then be executed through safe APIs such as run_iframe.

Fields

locals: FrameLocals

lasti: PyAtomic<u32>

index of last instruction ran

generator: PyAtomicBorrow

Back-reference to owning generator/coroutine/async generator. Borrowed reference (not ref-counted) to avoid Generator↔FrameObject cycle. Cleared by the generator’s Drop impl.

Implementations

impl InterpreterFrame

pub fn get_lasti(&self) -> u32

Get the last instruction index.

pub fn previous(&self) -> *const Self

Get the previous InterpreterFrame in the chain, or null.

pub fn code(&self) -> &Py<PyCode>

Borrowed code object.

pub fn globals(&self) -> &Py<PyDict>

Borrowed globals dict.

pub fn builtins(&self) -> &PyObject

Borrowed builtins object.

pub fn func_obj(&self) -> Option<&PyObject>

Borrowed function object, or None if not set.