Кодовые объекты¶

Объекты кода - это низкоуровневая деталь реализации 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)¶

Return value: New reference.

Возвращает новый объект кода. Если вам нужен фиктивный объект кода для создания фрейма, используйте вместо него 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)¶

Return value: New reference.

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

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

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

Return value: New reference.

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

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)¶

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

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