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.