# 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.