# Об’єкти коду

Об’єкти коду є низькорівневими деталями реалізації CPython. Кожен з них представляє фрагмент виконуваного коду, який ще не прив’язано до функції.

type `PyCodeObject`

  Структура C об’єктів, яка використовується для опису об’єктів коду. Поля цього типу можуть бути змінені в будь-який час.

PyTypeObject `PyCode_Type`

  This is an instance of `PyTypeObject` representing the Python `code` type.

int `PyCode_Check`(PyObject *co)

  Return true if co is a `code` object. This function always succeeds.

int `PyCode_GetNumFree`(PyCodeObject *co)

  Return the number of free variables in 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.

  Return a new code object. If you need a dummy code object to create a frame, use `PyCode_NewEmpty()` instead. Calling `PyCode_New()` directly can bind you to a precise Python version since the definition of the bytecode changes often.

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.

  Similar to `PyCode_New()`, but with an extra «posonlyargcount» for positional-only arguments.

  Нове в версії 3.8.

PyCodeObject *`PyCode_NewEmpty`(const char *filename, const char *funcname, int firstlineno)
  Return value: New reference.

  Return a new empty code object with the specified filename, function name, and first line number. It is illegal to `exec()` or `eval()` the resulting code object.

int `PyCode_Addr2Line`(PyCodeObject *co, int byte_offset)

  Повертає номер рядка інструкції, яка виникає до або перед `byte_offset` і закінчується після нього. Якщо вам потрібен лише номер рядка кадру, використовуйте натомість `PyFrame_GetLineNumber()`.

  For efficiently iterating over the line numbers in a code object, use the API described in PEP 626.