Объекты кадров

type PyFrameObject

Часть ограниченного API (в виде непрозрачной структуры).

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

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

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

Для получения объекта кадра можно использовать функции 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_GetVar(PyFrameObject *frame, PyObject *name)

Возвращаемое значение: новая ссылка.

Получает переменную с именем name из frame.

• В случае успеха возвращает сильную ссылку на значение переменной.
• Вызывает NameError и возвращает NULL, если переменная не существует.
• В случае ошибки вызывает исключение и возвращает NULL.

Тип name должен быть str.

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

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

Возвращаемое значение: новая ссылка.

Аналогична PyFrame_GetVar(), но имя переменной представляет собой строку C в кодировке UTF-8.

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

PyObject *PyFrame_GetLocals(PyFrameObject *frame)

Возвращаемое значение: новая ссылка.

Получает атрибут f_locals объекта frame. Если кадр относится к оптимизированной области видимости, возвращается прокси-объект, передающий изменения и позволяющий изменять локальные переменные. Во всех остальных случаях (классы, модули, exec(), eval()) напрямую возвращается отображение, представляющее локальные переменные кадра (как описано для locals()).

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

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

Изменено в версии 3.13: В соответствии с PEP 667 возвращает экземпляр PyFrameLocalsProxy_Type.

int PyFrame_GetLineNumber(PyFrameObject *frame)

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

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