code.rst 1.62 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
.. 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.

18
.. c:type:: PyCodeObject
19 20 21 22 23

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


24
.. c:var:: PyTypeObject PyCode_Type
25

26
   This is an instance of :c:type:`PyTypeObject` representing the Python
27 28 29
   :class:`code` type.


30
.. c:function:: int PyCode_Check(PyObject *co)
31 32 33

   Return true if *co* is a :class:`code` object

34
.. c:function:: int PyCode_GetNumFree(PyCodeObject *co)
35 36 37

   Return the number of free variables in *co*.

38
.. c:function:: 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)
39 40

   Return a new code object.  If you need a dummy code object to
41 42
   create a frame, use :c:func:`PyCode_NewEmpty` instead.  Calling
   :c:func:`PyCode_New` directly can bind you to a precise Python
43 44 45
   version since the definition of the bytecode changes often.


46
.. c:function:: PyCodeObject* PyCode_NewEmpty(const char *filename, const char *funcname, int firstlineno)
47 48 49

   Return a new empty code object with the specified filename,
   function name, and first line number.  It is illegal to
50
   :func:`exec` or :func:`eval` the resulting code object.