Объекты кода

Объекты кода — это низкоуровневый элемент реализации CPython. Каждый из них представляет собой фрагмент исполняемого кода, который ещё не был связан с функцией.

type PyCodeObject

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

PyTypeObject PyCode_Type

Это экземпляр PyTypeObject, представляющий тип Python code.

int PyCode_Check(PyObject *co)

Возвращает true, если co является объектом code. Эта функция всегда выполняется успешно.

int PyCode_GetNumFree(PyCodeObject *co)

Возвращает количество свободных переменных в co.

PyCodeObject *PyCode_New(int argcount, int kwonlyargcount, int nlocals, int stacksize, int flags, PyObject *code, PyObject *consts, PyObject *names, PyObject *varnames, PyObject *freevars, PyObject *cellvars, PyObject *filename, PyObject *name, int firstlineno, PyObject *lnotab)

Значение возврата: новая ссылка.

Возвращает новый объект кода. Если вам нужен фиктивный объект кода для создания фрейма, используйте PyCode_NewEmpty() вместо этого. Прямое обращение к PyCode_New() может привязать вас к определённой версии Python, поскольку определение байткода часто меняется.

PyCodeObject *PyCode_NewWithPosOnlyArgs(int argcount, int posonlyargcount, int kwonlyargcount, int nlocals, int stacksize, int flags, PyObject *code, PyObject *consts, PyObject *names, PyObject *varnames, PyObject *freevars, PyObject *cellvars, PyObject *filename, PyObject *name, int firstlineno, PyObject *lnotab)

Значение возврата: новая ссылка.

Аналогично PyCode_New(), но с дополнительным параметром «posonlyargcount» для позиционных аргументов только.

Новая функция в версии 3.8.

PyCodeObject *PyCode_NewEmpty(const char *filename, const char *funcname, int firstlineno)

Значение возврата: новая ссылка.

Возвращает новый пустой объект кода с указанным именем файла, именем функции и номером первой строки. Недопустимо применять exec() или eval() к полученному объекту кода.

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)

Возвращает номер строки инструкции, которая находится на или перед byte_offset и заканчивается после неё. Если вам нужен только номер строки фрейма, используйте PyFrame_GetLineNumber() вместо этого.

Для эффективной итерации по номерам строк в объекте кода используйте API, описанный в PEP 626.