# Objetos código

Os objetos código são um detalhe de baixo nível da implementação do CPython. Cada um representa um pedaço de código executável que ainda não foi vinculado a uma função.

type `PyCodeObject`

  A estrutura C dos objetos usados para descrever objetos código. Os campos deste tipo estão sujeitos a alterações a qualquer momento.

PyTypeObject `PyCode_Type`

  Esta é uma instância de `PyTypeObject` representando o tipo Python `code`.

int `PyCode_Check`(PyObject *co)

  Retorna verdadeiro se co for um objeto `code`. Esta função sempre tem sucesso.

int `PyCode_GetNumFree`(PyCodeObject *co)

  Retorna o número de variáveis livres em 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)
  Retorna valor: Nova referência.

  Retorna um novo objeto código. Se você precisa de um objeto código fictício para criar um quadro, use `PyCode_NewEmpty()` no caso. Chamar `PyCode_New()` diretamente pode vinculá-lo a uma versão precisa do Python, uma vez que a definição do bytecode muda frequentemente.

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)
  Retorna valor: Nova referência.

  Semelhante a `PyCode_New()`, mas com um “posonlyargcount” extra para argumentos apenas posicionais.

  Novo na versão 3.8.

PyCodeObject *`PyCode_NewEmpty`(const char *filename, const char *funcname, int firstlineno)
  Retorna valor: Nova referência.

  Retorna um novo objeto código vazio com o nome do arquivo especificado, o nome da função e o número da primeira linha. É ilegal executar `exec()` ou `eval()` no objeto código resultante.

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

  Retorna o número da linha da instrução que ocorre em ou antes de `byte_offset` e termina depois disso. Se você só precisa do número da linha de um quadro, use `PyFrame_GetLineNumber()`.

  Para iterar de forma eficiente os números de linha em um objeto código, use a API descrita no PEP 626.