代碼對(duì)象

代碼對(duì)象是 Cpython 實(shí)現(xiàn)的低級(jí)細(xì)節(jié)。 每個(gè)代表一塊尚未綁定到函數(shù)中的可執(zhí)行代碼。

type PyCodeObject

用于描述代碼對(duì)象的對(duì)象的 C 結(jié)構(gòu)。 此類型字段可隨時(shí)更改。

PyTypeObject PyCode_Type

這是一個(gè) PyTypeObject 實(shí)例，其表示Python的 code 類型。

int PyCode_Check(PyObject *co)

如果 co 是一個(gè) code 對(duì)象則返回真值。 此函數(shù)總是會(huì)成功執(zhí)行。

int PyCode_GetNumFree(PyCodeObject *co)

返回 co 中的自由變量數(shù)。

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 *linetable, PyObject *exceptiontable)

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 will bind you to a precise Python version since the definition of the bytecode changes often. The many arguments of this function are inter-dependent in complex ways, meaning that subtle changes to values are likely to result in incorrect execution or VM crashes. Use this function only with extreme care.

在 3.11 版更改: Added exceptiontable parameter.

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 *linetable, PyObject *exceptiontable)

Return value: New reference.

Similar to PyCode_New(), but with an extra “posonlyargcount” for positional-only arguments. The same caveats that apply to PyCode_New also apply to this function.

3.8 新版功能.

在 3.11 版更改: Added exceptiontable parameter.

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. The resulting code object will raise an Exception if executed.

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)

返回在 byte_offset 位置或之前以及之后發(fā)生的指令的行號(hào)。 如果你只需要一個(gè)幀的行號(hào)，請(qǐng)改用 PyFrame_GetLineNumber()。

For efficiently iterating over the line numbers in a code object, use the API described in PEP 626.

int PyCode_Addr2Location(PyObject *co, int byte_offset, int *start_line, int *start_column, int *end_line, int *end_column)

Sets the passed int pointers to the source code line and column numbers for the instruction at byte_offset. Sets the value to 0 when information is not available for any particular element.

Returns 1 if the function succeeds and 0 otherwise.

PyObject *PyCode_GetCode(PyCodeObject *co)

Equivalent to the Python code getattr(co, 'co_code'). Returns a strong reference to a PyBytesObject representing the bytecode in a code object. On error, NULL is returned and an exception is raised.

This PyBytesObject may be created on-demand by the interpreter and does not necessarily represent the bytecode actually executed by CPython. The primary use case for this function is debuggers and profilers.

3.11 新版功能.

PyObject *PyCode_GetVarnames(PyCodeObject *co)

Equivalent to the Python code getattr(co, 'co_varnames'). Returns a new reference to a PyTupleObject containing the names of the local variables. On error, NULL is returned and an exception is raised.

3.11 新版功能.

PyObject *PyCode_GetCellvars(PyCodeObject *co)

Equivalent to the Python code getattr(co, 'co_cellvars'). Returns a new reference to a PyTupleObject containing the names of the local variables that are referenced by nested functions. On error, NULL is returned and an exception is raised.

3.11 新版功能.

PyObject *PyCode_GetFreevars(PyCodeObject *co)

Equivalent to the Python code getattr(co, 'co_freevars'). Returns a new reference to a PyTupleObject containing the names of the free variables. On error, NULL is returned and an exception is raised.

3.11 新版功能.

網(wǎng)站標(biāo)題：創(chuàng)新互聯(lián)Python教程：代碼對(duì)象
網(wǎng)頁(yè)地址：http://www.dlmjj.cn/article/cdoogsh.html