Objets code

Les objets Code sont spécifiques à l'implémentation bas niveau de CPython. Chacun d'eux représente une partie de code exécutable, qui n'a pas encore été lié dans une fonction.

type PyCodeObject

La structure C utilisée pour décrire les objets Code. Les attributs de cette structure sont sujets à changer à tout moment.

PyTypeObject PyCode_Type

C'est une instance de PyTypeObject représentant le type Python code.

int PyCode_Check(PyObject *co)

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

int PyCode_GetNumFree(PyCodeObject *co)

Renvoie le nombre de variables libres dans 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.

Renvoie un nouvel objet code. Si vous avez besoin d'un objet code factice pour créer une frame, utilisez plutôt PyCode_NewEmpty(). Appeler PyCode_New() peut vous lier directement à une version spécifique de Python, le bytecode étant sujet à modifications.

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.

Nouveau dans la version 3.8.

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

Renvoie un nouvel objet code avec le nom de fichier, le nom de fonction, et le numéro de première ligne donnés. Il n'est pas permis d'utiliser exec() ou eval() sur l'objet renvoyé.

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)

Return the line number of the instruction that occurs on or before byte_offset and ends after it. If you just need the line number of a frame, use PyFrame_GetLineNumber() instead.

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