.. highlightlang:: c .. _codeobjects: Code Objects ------------ .. sectionauthor:: Jeffrey Yasskin .. index:: object: code 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. .. ctype:: PyCodeObject The C structure of the objects used to describe code objects. The fields of this type are subject to change at any time. .. cvar:: PyTypeObject PyCode_Type This is an instance of :ctype:`PyTypeObject` representing the Python :class:`code` type. .. cfunction:: int PyCode_Check(PyObject *co) Return true if *co* is a :class:`code` object .. cfunction:: int PyCode_GetNumFree(PyObject *co) Return the number of free variables in *co*. .. cfunction:: PyCodeObject *PyCode_New(int argcount, 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 a new code object. If you need a dummy code object to create a frame, use :cfunc:`PyCode_NewEmpty` instead. Calling :cfunc:`PyCode_New` directly can bind you to a precise Python version since the definition of the bytecode changes often. .. cfunction:: int PyCode_NewEmpty(const char *filename, const char *funcname, int firstlineno) Return a new empty code object with the specified filename, function name, and first line number. It is illegal to :keyword:`exec` or :func:`eval` the resulting code object.