程式碼物件¶

程式碼物件是 CPython 實作的低階細節。每個程式碼物件都代表一段尚未綁定到函式的可執行程式碼。

type PyCodeObject¶: 用於描述程式碼物件的 C 結構。此型別的欄位隨時可能變更。

PyTypeObject PyCode_Type¶: 這是 PyTypeObject 的一個實例，代表 Python 的程式碼物件。

int PyCode_Check(PyObject *co)¶: 如果 co 是程式碼物件，則回傳 true。此函式總會成功執行。

Py_ssize_t PyCode_GetNumFree(PyCodeObject *co)¶: 回傳程式碼物件中自由（閉包）變數的數量。

int PyUnstable_Code_GetFirstFree(PyCodeObject *co)¶: 這是不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

回傳程式碼物件中第一個自由（閉包）變數的位置。

在 3.13 版的變更: Renamed from PyCode_GetFirstFree as part of 不穩定的 C API. The old name is deprecated, but will remain available until the signature changes again.

PyCodeObject *PyUnstable_Code_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, PyObject *qualname, int firstlineno, PyObject *linetable, PyObject *exceptiontable)¶

這是不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

Return a new code object. If you need a dummy code object to create a frame, use PyCode_NewEmpty() instead.

Since the definition of the bytecode changes often, calling PyUnstable_Code_New() directly can bind you to a precise Python version.

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 版的變更: 新增 qualname 和 exceptiontable 參數。

在 3.12 版的變更: Renamed from PyCode_New as part of 不穩定的 C API. The old name is deprecated, but will remain available until the signature changes again.

PyCodeObject *PyUnstable_Code_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, PyObject *qualname, int firstlineno, PyObject *linetable, PyObject *exceptiontable)¶: 這是不穩定 API，它可能在小版本發布中沒有任何警告地被變更。

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

在 3.8 版被加入: 名為 PyCode_NewWithPosOnlyArgs

在 3.11 版的變更: 新增 qualname 和 exceptiontable 參數。

在 3.12 版的變更: 重新命名為 PyUnstable_Code_NewWithPosOnlyArgs。舊的名稱已被棄用，但在簽名再次變更前仍可使用。

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

int PyCode_Addr2Line(PyCodeObject *co, int byte_offset)¶

Return the line number of the instruction that occurs on or before byte_offset and ends after it. If you just need the line number of a frame, use PyFrame_GetLineNumber() instead.

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.

如果函式成功則回傳 1，否則回傳 0。

在 3.11 版被加入.

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 *