Code Objects — Python 3.8.20 documentation (original) (raw)

Code objects are a low-level detail of the CPython implementation. Each one represents a chunk of executable code that hasn’t yet been bound into a function.

PyCodeObject¶

The C structure of the objects used to describe code objects. The fields of this type are subject to change at any time.

PyTypeObject PyCode_Type¶

This is an instance of PyTypeObject representing the Pythoncode type.

int PyCode_Check(PyObject *co)¶

Return true if co is a code object.

int PyCode_GetNumFree(PyCodeObject *co)¶

Return the number of free variables in 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.

Return a new code object. If you need a dummy code object to create a frame, use PyCode_NewEmpty() instead. Calling PyCode_New() directly can bind you to a precise Python version since the definition of the bytecode changes often.

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.

New in version 3.8.

PyCodeObject* PyCode_NewEmpty(const char *filename, const char *funcname, int firstlineno)¶

Return value: New reference.

Return a new empty code object with the specified filename, function name, and first line number. It is illegal toexec() or eval() the resulting code object.