另请参阅 Py_INCREF()。
3.10 新版功能.
PyObject *Py_XNewRef(PyObject *o)
Part of the Stable ABI since version 3.10.类似于 Py_NewRef()，但对象 o 可以为 NULL。
如果对象 o 为 NULL，该函数也·将返回 NULL。
3.10 新版功能.
void Py_DECREF(PyObject *o)
释放一个指向对象 o 的 strong reference，表明该引用不再被使用。
当最后一个 strong reference 被释放时 (即对象的引用计数变为 0)，将会发起调用该对象所属类型的 deallocation 函数 (它必须不为 NULL)。
此函数通常被用于在退出作用域之前删除一个 strong reference。
此对象必须不为 NULL；如果你不能确定它不为 NULL，请使用 Py_XDECREF()。
Do not expect this function to actually modify o in any way.
释放函数会导致任意 Python 代码被发起调用（例如当一个带有 __del__() 方法的类实例被释放时就是如此）。 虽然这些代码中的异常不会被传播，但被执行的代码能够自由访问所有 Python 全局变量。 这意味着在调用 Py_DECREF() 之前任何可通过全局变量获取的对象都应该处于完好的状态。 例如，从一个列表中删除对象的代码应该将被删除对象的引用拷贝到一个临时变量中，更新列表数据结构，然后再为临时变量调用 Py_DECREF()。
void Py_CLEAR(PyObject *o)
释放一个指向对象 o 的 strong reference。 对象可以为 NULL，在此情况下该宏将没有任何效果；在其他情况下其效果与 Py_DECREF() 相同，区别在于其参数也会被设为 NULL。 针对 Py_DECREF() 的警告不适用于所传递的对象，因为该宏会细心地使用一个临时变量并在释放引用之前将参数设为 NULL。
当需要释放指向一个在垃圾回收期间可能被会遍历的对象的引用时使用该宏是一个好主意。
void Py_DecRef(PyObject *o)
Part of the Stable ABI.释放一个指向对象 o 的 strong reference。 Py_XDECREF() 的函数版本。 它可被用于 Python 的运行时动态嵌入。
以下函数或宏仅可在解释器核心内部使用: _Py_Dealloc(), _Py_ForgetReference(), _Py_NewReference() 以及全局变量 _Py_RefTotal。
This page is licensed under the Python Software Foundation License Version 2.
Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
See History and License for more information.
The Python Software Foundation is a non-profit corporation.
Please donate.
最后更新于 9月 03, 2023.
Found a bug?
