Объекты слабых ссылок¶Weak Reference Objects

Python поддерживает слабые ссылки как объекты первого класса. Существует два конкретных типа объектов, которые напрямую реализуют слабые ссылки. Первый – простой объект-ссылка, а второй действует как прокси для исходного объекта, насколько это возможно.

int PyWeakref_Check(ob)¶

Возвращает true, если ob является объектом слабой ссылки или прокси-объектом. Эта функция всегда завершается успешно.

int PyWeakref_CheckRef(ob)¶

Возвращает true, если ob является объектом слабой ссылки. Эта функция всегда завершается успешно.

int PyWeakref_CheckProxy(ob)¶

Возвращает true, если ob является прокси-объектом. Эта функция всегда завершается успешно.

PyObject *PyWeakref_NewRef(PyObject *ob, PyObject *callback)¶

Возвращаемое значение: новая ссылка. Часть Stable ABI.

Возвращает объект слабой ссылки для объекта ob. Всегда возвращается новая ссылка, но не гарантируется создание нового объекта; может быть возвращён существующий объект ссылки. Второй параметр, колбэк, может быть вызываемым объектом, который получает уведомление, когда ob собирается сборщиком мусора; он должен принимать один параметр – сам объект слабой ссылки. колбэк также может быть None или NULL. Если ob не является объектом, на который можно создать слабую ссылку, или если колбэк не является вызываемым, None или NULL, будет возвращено NULL и возбуждено TypeError.

PyObject *PyWeakref_NewProxy(PyObject *ob, PyObject *callback)¶

Возвращаемое значение: новая ссылка. Часть Stable ABI.

Возвращает прокси-объект слабой ссылки для объекта ob. Всегда возвращается новая ссылка, но не гарантируется создание нового объекта; может быть возвращён существующий прокси-объект. Второй параметр, колбэк, может быть вызываемым объектом, который получает уведомление, когда ob собирается сборщиком мусора; он должен принимать один параметр – сам объект слабой ссылки. колбэк также может быть None или NULL. Если ob не является объектом, на который можно создать слабую ссылку, или если колбэк не является вызываемым, None или NULL, будет возвращено NULL и возбуждено TypeError.

PyObject *PyWeakref_GetObject(PyObject *ref)¶

Возвращаемое значение: заимствованная ссылка. Часть Stable ABI.

Возвращает объект, на который ссылается слабая ссылка ref. Если этот объект уже удалён, возвращает Py_None.

Примечание

Эта функция возвращает заимствованную ссылку на целевой объект. Это означает, что для объекта всегда следует вызывать Py_INCREF(), за исключением случаев, когда он не может быть уничтожен до последнего использования заимствованной ссылки.

PyObject *PyWeakref_GET_OBJECT(PyObject *ref)¶

Возвращаемое значение: заимствованная ссылка.

Аналогично PyWeakref_GetObject(), но реализовано как макрос, не выполняющий проверку ошибок.

void PyObject_ClearWeakRefs(PyObject *object)¶

Часть Stable ABI.

Эта функция вызывается обработчиком tp_dealloc для очистки слабых ссылок.

Эта функция перебирает слабые ссылки для object и вызывает колбэки для тех ссылок, у которых они есть. Она завершает работу, когда все колбэки были вызваны.