> **Источник:** https://python-all.ru/3.9/c-api/code.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Объекты кода

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

**`PyCodeObject`**

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

**[PyTypeObject](https://python-all.ru/3.9/c-api/type.html#c.PyTypeObject) `PyCode_Type`**

Это экземпляр [`PyTypeObject`](https://python-all.ru/3.9/c-api/type.html#c.PyTypeObject), представляющий тип [`code`](https://python-all.ru/3.9/library/code.html#module-code) Python.

#### `int PyCode_Check(PyObject *co)`

Возвращает истину, если *co* является объектом [`code`](https://python-all.ru/3.9/library/code.html#module-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()`](https://python-all.ru/3.9/c-api/code.html#c.PyCode_NewEmpty). Вызов [`PyCode_New()`](https://python-all.ru/3.9/c-api/code.html#c.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()`](https://python-all.ru/3.9/c-api/code.html#c.PyCode_New), но с дополнительным параметром «posonlyargcount» для позиционных аргументов.

Новое в версии 3.8.

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

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

Возвращает новый пустой объект кода с указанными именем файла, именем функции и номером первой строки. Недопустимо [`exec()`](https://python-all.ru/3.9/library/functions.html#exec) или [`eval()`](https://python-all.ru/3.9/library/functions.html#eval) результирующий объект кода.