引用计数 — Python 文档

来自菜鸟教程
Python/docs/2.7/c-api/refcounting
跳转至:导航、​搜索

引用计数

本节中的宏用于管理 Python 对象的引用计数。

void Py_INCREF(PyObject *o)
增加对象 o 的引用计数。 对象不得为 NULL; 如果您不确定它不是 NULL,请使用 Py_XINCREF()
void Py_XINCREF(PyObject *o)
增加对象 o 的引用计数。 对象可能是 NULL,在这种情况下宏不起作用。
void Py_DECREF(PyObject *o)

减少对象 o 的引用计数。 对象不得为 NULL; 如果您不确定它不是 NULL,请使用 Py_XDECREF()。 如果引用计数达到零,则调用对象类型的释放函数(不能是 NULL)。

警告

释放函数可以导致任意 Python 代码被调用(例如 当具有 __del__() 方法的类实例被释放时)。 虽然此类代码中的异常不会传播,但执行的代码可以自由访问所有 Python 全局变量。 这意味着在调用 Py_DECREF() 之前,可从全局变量访问的任何对象都应处于一致状态。 例如,从列表中删除对象的代码应复制临时变量中对已删除对象的引用,更新列表数据结构,然后为临时变量调用 Py_DECREF()

void Py_XDECREF(PyObject *o)
减少对象 o 的引用计数。 对象可能是NULL,在这种情况下宏不起作用; 否则效果与 Py_DECREF() 相同,并适用相同的警告。
void Py_CLEAR(PyObject *o)

减少对象 o 的引用计数。 对象可能是NULL,在这种情况下宏不起作用; 否则效果与 Py_DECREF() 相同,只是参数也设置为 NULLPy_DECREF() 的警告不适用于传递的对象,因为宏小心地使用临时变量并将参数设置为 NULL,然后再减少其引用计数。

每当减少垃圾回收期间可能遍历的变量的值时,最好使用此宏。

2.4 版中的新功能。

以下函数用于 Python 的运行时动态嵌入:Py_IncRef(PyObject *o)Py_DecRef(PyObject *o)。 它们分别是 Py_XINCREF()Py_XDECREF() 的简单导出函数版本。

以下函数或宏仅用于解释器核心:_Py_Dealloc()_Py_ForgetReference()_Py_NewReference(),以及全局变量_Py_RefTotal