| .. highlightlang:: c |
| |
| .. _codeobjects: |
| |
| Code Objects |
| ------------ |
| |
| .. sectionauthor:: Jeffrey Yasskin <jyasskin@gmail.com> |
| |
| |
| .. 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. |