Frame 物件

type PyFrameObject
為 受限 API 的一部分 （做為一個不透明結構 (opaque struct)）.

用來描述 frame 物件的 C 結構。

在這個結構中沒有公開的成員。

在 3.11 版的變更: The members of this structure were removed from the public C API. Refer to the What's New entry for details.

The PyEval_GetFrame() and PyThreadState_GetFrame() functions can be used to get a frame object.

See also Reflection.

PyTypeObject PyFrame_Type

The type of frame objects. It is the same object as types.FrameType in the Python layer.

在 3.11 版的變更: Previously, this type was only available after including <frameobject.h>.

int PyFrame_Check(PyObject *obj)

Return non-zero if obj is a frame object.

在 3.11 版的變更: Previously, this function was only available after including <frameobject.h>.

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame)
回傳值：新的參照。

Get the frame next outer frame.

Return a strong reference, or NULL if frame has no outer frame.

在 3.9 版被加入.

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame)
回傳值：新的參照。

取得 frame 的 f_builtins 屬性。

回傳 strong reference。結果不能為 NULL。

在 3.11 版被加入.

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame)
回傳值：新的參照。 為 穩定 ABI 的一部分 自 3.10 版本開始.

Get the frame code.

回傳 strong reference。

The result (frame code) cannot be NULL.

在 3.9 版被加入.

PyObject *PyFrame_GetGenerator(PyFrameObject *frame)
回傳值：新的參照。

Get the generator, coroutine, or async generator that owns this frame, or NULL if this frame is not owned by a generator. Does not raise an exception, even if the return value is NULL.

回傳 strong reference 或 NULL。

在 3.11 版被加入.

PyObject *PyFrame_GetGlobals(PyFrameObject *frame)
回傳值：新的參照。

取得 frame 的 f_globals 屬性。

回傳 strong reference。結果不能為 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。

  • 在成功時回傳變數值的 strong reference。

  • 如果變數不存在，則引發 NameError 並回傳 NULL。

  • 在錯誤時引發例外並回傳 NULL。

name 的型別必須是 str。

在 3.12 版被加入.

PyObject *PyFrame_GetVarString(PyFrameObject *frame, const char *name)
回傳值：新的參照。

Similar to PyFrame_GetVar(), but the variable name is a C string encoded in UTF-8.

在 3.12 版被加入.

PyObject *PyFrame_GetLocals(PyFrameObject *frame)
回傳值：新的參照。

Get the frame's f_locals attribute. If the frame refers to an optimized scope, this returns a write-through proxy object that allows modifying the locals. In all other cases (classes, modules, exec(), eval()) it returns the mapping representing the frame locals directly (as described for locals()).

回傳 strong reference。

在 3.11 版被加入.

在 3.13 版的變更: As part of PEP 667, return an instance of PyFrameLocalsProxy_Type.

int PyFrame_GetLineNumber(PyFrameObject *frame)
為 穩定 ABI 的一部分 自 3.10 版本開始.

Return the line number that frame is currently executing.

Frame Locals Proxies

在 3.13 版被加入.

The f_locals attribute on a frame object is an instance of a "frame-locals proxy". The proxy object exposes a write-through view of the underlying locals dictionary for the frame. This ensures that the variables exposed by f_locals are always up to date with the live local variables in the frame itself.

See PEP 667 for more information.

PyTypeObject PyFrameLocalsProxy_Type

The type of frame locals() proxy objects.

int PyFrameLocalsProxy_Check(PyObject *obj)

Return non-zero if obj is a frame locals() proxy.

Internal Frames

Unless using PEP 523, you will not need this.

struct _PyInterpreterFrame

The interpreter's internal frame representation.

在 3.11 版被加入.

PyObject *PyUnstable_InterpreterFrame_GetCode(struct _PyInterpreterFrame *frame);
這是 不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

Return a strong reference to the code object for the frame.

在 3.12 版被加入.

int PyUnstable_InterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);
這是 不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

Return the byte offset into the last executed instruction.

在 3.12 版被加入.

int PyUnstable_InterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);
這是 不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

Return the currently executing line number, or -1 if there is no line number.

在 3.12 版被加入.