# Frame Objects

type PyFrameObject
  Part of the 제한된 API (as an opaque struct).

  The C structure of the objects used to describe frame objects.

  There are no public members in this structure.

  버전 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)

  Get the frame’s `f_builtins` attribute.

  Return a strong reference. The result cannot be `NULL`.

  버전 3.11에 추가.

PyCodeObject *PyFrame_GetCode( PyFrameObject *frame)
  Part of the 안정 ABI 버전 3.10 이후로.

  Get the frame code.

  Return a 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`.

  Return a strong reference, or `NULL`.

  버전 3.11에 추가.

PyObject *PyFrame_GetGlobals( PyFrameObject *frame)

  Get the frame’s `f_globals` attribute.

  Return a strong reference. The result cannot be `NULL`.

  버전 3.11에 추가.

int PyFrame_GetLasti( PyFrameObject *frame)

  Get the frame’s `f_lasti` attribute.

  Returns -1 if `frame.f_lasti` is `None`.

  버전 3.11에 추가.

PyObject *PyFrame_GetLocals( PyFrameObject *frame)

  Get the frame’s `f_locals` attribute (`dict`).

  Return a strong reference.

  버전 3.11에 추가.

int PyFrame_GetLineNumber( PyFrameObject *frame)
  Part of the 안정 ABI 버전 3.10 이후로.

  Return the line number that frame is currently executing.