代码对象 ¶

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.

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

PyTypeObject PyCode_Type ¶: This is an instance of PyTypeObject representing the Python code object .

int PyCode_Check ( PyObject * co ) ¶: 返回 True 若 co 是 code object . This function always succeeds.

Py_ssize_t PyCode_GetNumFree ( PyCodeObject * co ) ¶: 返回数量为 free (closure) variables in a code object.

int PyUnstable_Code_GetFirstFree ( PyCodeObject * co ) ¶

这为 Unstable API . It may change without warning in minor releases.

Return the position of the first free (closure) variable in a code object.

Changed in version 3.13: Renamed from PyCode_GetFirstFree as part of Unstable C API . The old name is deprecated, but will remain available until the signature changes again.

Extra information ¶

To support low-level extensions to frame evaluation, such as external just-in-time compilers, it is possible to attach arbitrary extra data to code objects.

These functions are part of the unstable C API tier: this functionality is a CPython implementation detail, and the API may change without deprecation warnings.

Py_ssize_t PyUnstable_Eval_RequestCodeExtraIndex ( freefunc free ) ¶

这为 Unstable API . It may change without warning in minor releases.

Return a new an opaque index value used to adding data to code objects.

You generally call this function once (per interpreter) and use the result with PyCode_GetExtra and PyCode_SetExtra to manipulate data on individual code objects.

若 free 不是 NULL : when a code object is deallocated, free will be called on non- NULL data stored under the new index. Use Py_DecRef() when storing PyObject .

Added in version 3.6: as _PyEval_RequestCodeExtraIndex

3.12 版改变： Renamed to PyUnstable_Eval_RequestCodeExtraIndex . The old private name is deprecated, but will be available until the API changes.

int PyUnstable_Code_GetExtra ( PyObject * code , Py_ssize_t index , void * * extra ) ¶

这为 Unstable API . It may change without warning in minor releases.

Set extra to the extra data stored under the given index. Return 0 on success. Set an exception and return -1 on failure.

If no data was set under the index, set extra to NULL and return 0 without setting an exception.

Added in version 3.6: as _PyCode_GetExtra

3.12 版改变： Renamed to PyUnstable_Code_GetExtra . The old private name is deprecated, but will be available until the API changes.

int PyUnstable_Code_SetExtra ( PyObject * code , Py_ssize_t index , void * extra ) ¶

这为 Unstable API . It may change without warning in minor releases.

Set the extra data stored under the given index to extra . Return 0 on success. Set an exception and return -1 on failure.

Added in version 3.6: as _PyCode_SetExtra

3.12 版改变： Renamed to PyUnstable_Code_SetExtra . The old private name is deprecated, but will be available until the API changes.

代码对象 ¶

Extra information ¶

内容表

上一话题

下一话题

本页