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.
