代码对象
********

代码对象是 CPython 实现的低层级细节。 每个代表一块尚未绑定到函数中的可
执行代码。

type PyCodeObject

   用于描述代码对象的对象的 C 结构。 此类型字段可随时更改。

PyTypeObject PyCode_Type

   这是一个 "PyTypeObject" 实例，其表示Python的 "code" 类型。

int PyCode_Check(PyObject *co)

   如果 *co* 是一个 "code" 对象则返回真值。 此函数总是会成功执行。

int PyCode_GetNumFree(PyCodeObject *co)

   返回 *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)
    *返回值：新的引用。*

   返回一个新的代码对象。 如果你需要一个虚拟代码对象来创建一个代码帧，
   请使用 "PyCode_NewEmpty()"。 调用 "PyCode_New()" 直接可以绑定到准确
   的 Python 版本，因为字节码的定义经常变化。

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)
    *返回值：新的引用。*

   类似于 "PyCode_New()"，但带有一个额外的 "posonlyargcount" 用于仅限
   位置参数。

   3.8 新版功能.

PyCodeObject *PyCode_NewEmpty(const char *filename, const char *funcname, int firstlineno)
    *返回值：新的引用。*

   返回具有指定文件名、函数名和第一行号的新空代码对象。 对于 "exec()"
   或 "eval()" 生成的代码对象是非法的。

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)

   返回在 "byte_offset" 位置或之前以及之后发生的指令的行号。 如果你只
   需要一个帧的行号，请改用 "PyFrame_GetLineNumber()"。

   要高效地迭代一个代码对象中的行号，请使用 PEP 626 描述的 API。
