Объекты фреймов

type PyFrameObject

Часть Ограниченного API (как неявная структура).

C-структура объектов, используемых для описания объектов фреймов.

В этой структуре нет публичных членов.

Изменено в версии 3.11: Члены этой структуры были удалены из публичного C API. Подробности см. в статье изменений.

Функции PyEval_GetFrame() и PyThreadState_GetFrame() могут быть использованы для получения объекта фрейма.

См. также Рефлексию.

PyTypeObject PyFrame_Type

Тип объектов фреймов. Это тот же объект, что и types.FrameType на уровне Python.

Изменено в версии 3.11: Ранее этот тип был доступен только после включения <frameobject.h>.

int PyFrame_Check(PyObject *obj)

Возвращает ненулевое значение, если obj — объект фрейма.

Изменено в версии 3.11: Ранее эта функция была доступна только после включения <frameobject.h>.

PyFrameObject *PyFrame_GetBack(PyFrameObject *frame)

Получить внешний фрейм объекта frame.

Возвращает сильную ссылку, или NULL если у frame нет внешнего фрейма.

Добавлена в версии 3.9.

PyObject *PyFrame_GetBuiltins(PyFrameObject *frame)

Получить атрибут f_builtins объекта frame.

Возвращает сильную ссылку. Результат не может быть NULL.

Добавлена в версии 3.11.

PyCodeObject *PyFrame_GetCode(PyFrameObject *frame)

Часть Стабильного ABI с версии 3.10.

Получить код объекта frame.

Возвращает сильную ссылку.

Результат (код фрейма) не может быть NULL.

Добавлена в версии 3.9.

PyObject *PyFrame_GetGenerator(PyFrameObject *frame)

Получить генератор, корутину или асинхронный генератор, владеющий этим фреймом, или NULL если этот фрейм не принадлежит генератору. Не генерирует исключение, даже если возвращаемое значение является NULL.

Возвращает сильную ссылку или NULL.

Добавлена в версии 3.11.

PyObject *PyFrame_GetGlobals(PyFrameObject *frame)

Получить атрибут f_globals объекта frame.

Возвращает сильную ссылку. Результат не может быть NULL.

Добавлена в версии 3.11.

int PyFrame_GetLasti(PyFrameObject *frame)

Получить атрибут f_lasti объекта frame.

Возвращает -1, если frame.f_lasti равно None.

Добавлена в версии 3.11.

PyObject *PyFrame_GetLocals(PyFrameObject *frame)

Получить атрибут f_locals объекта frame (dict).

Возвращает сильную ссылку.

Добавлена в версии 3.11.

int PyFrame_GetLineNumber(PyFrameObject *frame)

Часть Стабильного ABI с версии 3.10.

Возвращает номер строки, которую в данный момент выполняет frame.