帧对象

type PyFrameObject

有限 API 的一部分（作为不透明结构体）。

用于描述帧对象的 C 结构体。

此结构体中没有公共成员。

版本 3.11 中更改: 此结构体的成员已从公共 C API 中移除。有关详细信息，请参阅新增功能条目。

可以使用 PyEval_GetFrame() 和 PyThreadState_GetFrame() 函数来获取帧对象。

另请参阅 反射。

PyTypeObject PyFrame_Type

帧对象的类型。它与 Python 层中的 types.FrameType 是同一个对象。

版本 3.11 中更改: 以前，此类型仅在包含 <frameobject.h> 后才可用。

int PyFrame_Check(PyObject *obj)

如果 *obj* 是帧对象，则返回非零值。

版本 3.11 中更改: 以前，此函数仅在包含 <frameobject.h> 后才可用。

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame)

获取 *frame* 的下一个外部帧。

返回一个 强引用，如果 *frame* 没有外部帧，则返回 NULL。

3.9 版新增。

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame)

获取 *frame* 的 f_builtins 属性。

返回一个 强引用。结果不能为 NULL。

3.11 版新增。

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame)

从 3.10 版开始成为 稳定 ABI 的一部分。

获取 *frame* 代码。

返回一个 强引用。

结果（帧代码）不能为 NULL。

3.9 版新增。

PyObject *PyFrame_GetGenerator(PyFrameObject *frame)

获取拥有此帧的生成器、协程或异步生成器，如果此帧不属于任何生成器，则返回 NULL。即使返回值为 NULL，也不会引发异常。

返回一个 强引用，或 NULL。

3.11 版新增。

PyObject *PyFrame_GetGlobals(PyFrameObject *frame)

获取 *frame* 的 f_globals 属性。

返回一个 强引用。结果不能为 NULL。

3.11 版新增。

int PyFrame_GetLasti(PyFrameObject *frame)

获取 *frame* 的 f_lasti 属性。

如果 frame.f_lasti 为 None，则返回 -1。

3.11 版新增。

PyObject *PyFrame_GetVar(PyFrameObject *frame, PyObject *name)

获取 *frame* 的变量 *name*。

• 成功时返回对变量值的 强引用。

• 如果变量不存在，则引发 NameError 并返回 NULL。

• 出错时引发异常并返回 NULL。

*name* 类型必须为 str。

3.12 版新增。

PyObject *PyFrame_GetVarString(PyFrameObject *frame, const char *name)

与 PyFrame_GetVar() 类似，但变量名是一个以 UTF-8 编码的 C 字符串。

3.12 版新增。

PyObject *PyFrame_GetLocals(PyFrameObject *frame)

获取 frame 的 f_locals 属性（dict）。

返回一个 强引用。

3.11 版新增。

int PyFrame_GetLineNumber(PyFrameObject *frame)

从 3.10 版开始成为 稳定 ABI 的一部分。

返回 frame 当前正在执行的行号。

内部帧

除非使用 PEP 523，否则你不需要这个。

struct _PyInterpreterFrame

解释器的内部帧表示。

3.11 版新增。

PyObject *PyUnstable_InterpreterFrame_GetCode(struct _PyInterpreterFrame *frame);

这是不稳定的 API。它可能会在次要版本中发生变化，恕不另行通知。

返回对帧的代码对象的强引用。

3.12 版新增。

int PyUnstable_InterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);

这是不稳定的 API。它可能会在次要版本中发生变化，恕不另行通知。

返回最后执行指令的字节偏移量。

3.12 版新增。

int PyUnstable_InterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);

这是不稳定的 API。它可能会在次要版本中发生变化，恕不另行通知。

返回当前正在执行的行号，如果没有行号，则返回 -1。

3.12 版新增。