14710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* Weak references objects for Python. */ 24710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 34710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifndef Py_WEAKREFOBJECT_H 44710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define Py_WEAKREFOBJECT_H 54710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef __cplusplus 64710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmextern "C" { 74710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif 84710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 94710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 104710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmtypedef struct _PyWeakReference PyWeakReference; 114710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 124710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* PyWeakReference is the base struct for the Python ReferenceType, ProxyType, 134710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * and CallableProxyType. 144710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm */ 154710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmstruct _PyWeakReference { 164710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyObject_HEAD 174710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 184710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm /* The object to which this is a weak reference, or Py_None if none. 194710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * Note that this is a stealth reference: wr_object's refcount is 204710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * not incremented to reflect this pointer. 214710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm */ 224710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyObject *wr_object; 234710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 244710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm /* A callable to invoke when wr_object dies, or NULL if none. */ 254710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyObject *wr_callback; 264710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 274710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm /* A cache for wr_object's hash code. As usual for hashes, this is -1 284710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * if the hash code isn't known yet. 294710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm */ 304710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm long hash; 314710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 324710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm /* If wr_object is weakly referenced, wr_object has a doubly-linked NULL- 334710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * terminated list of weak references to it. These are the list pointers. 344710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * If wr_object goes away, wr_object is set to Py_None, and these pointers 354710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm * have no meaning then. 364710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm */ 374710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyWeakReference *wr_prev; 384710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyWeakReference *wr_next; 394710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm}; 404710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 414710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_DATA(PyTypeObject) _PyWeakref_RefType; 424710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_DATA(PyTypeObject) _PyWeakref_ProxyType; 434710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_DATA(PyTypeObject) _PyWeakref_CallableProxyType; 444710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 454710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyWeakref_CheckRef(op) PyObject_TypeCheck(op, &_PyWeakref_RefType) 464710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyWeakref_CheckRefExact(op) \ 474710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm (Py_TYPE(op) == &_PyWeakref_RefType) 484710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyWeakref_CheckProxy(op) \ 494710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm ((Py_TYPE(op) == &_PyWeakref_ProxyType) || \ 504710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm (Py_TYPE(op) == &_PyWeakref_CallableProxyType)) 514710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 524710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm/* This macro calls PyWeakref_CheckRef() last since that can involve a 534710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm function call; this makes it more likely that the function call 544710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm will be avoided. */ 554710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyWeakref_Check(op) \ 564710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm (PyWeakref_CheckRef(op) || PyWeakref_CheckProxy(op)) 574710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 584710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 594710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyWeakref_NewRef(PyObject *ob, 604710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyObject *callback); 614710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyWeakref_NewProxy(PyObject *ob, 624710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm PyObject *callback); 634710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(PyObject *) PyWeakref_GetObject(PyObject *ref); 644710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 654710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(Py_ssize_t) _PyWeakref_GetWeakrefCount(PyWeakReference *head); 664710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 674710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylmPyAPI_FUNC(void) _PyWeakref_ClearRef(PyWeakReference *self); 684710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 694710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#define PyWeakref_GET_OBJECT(ref) (((PyWeakReference *)(ref))->wr_object) 704710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 714710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm 724710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#ifdef __cplusplus 734710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm} 744710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif 754710c53dcad1ebf3755f3efb9e80ac24bd72a9b2darylm#endif /* !Py_WEAKREFOBJECT_H */ 76