/*! \brief Add a weak pointer to an PAGE. * \par Function Description * Adds the weak pointer at \a weak_pointer_loc to \a page. The * value of \a weak_pointer_loc will be set to NULL when \a page is * destroyed. * * \sa s_page_remove_weak_ptr * * \param [in,out] page Page to weak-reference. * \param [in] weak_pointer_loc Memory address of a pointer. */ void s_page_add_weak_ptr (PAGE *page, void *weak_pointer_loc) { g_return_if_fail (page != NULL); page->weak_refs = s_weakref_add_ptr (page->weak_refs, weak_pointer_loc); }
/*! \brief Add a weak pointer to an OBJECT. * \par Function Description * Adds the weak pointer at \a weak_pointer_loc to \a object. The * value of \a weak_pointer_loc will be set to NULL when \a object is * destroyed. * * \sa s_object_remove_weak_ptr * * \param [in,out] object Object to weak-reference. * \param [in] weak_pointer_loc Memory address of a pointer. */ void s_object_add_weak_ptr (OBJECT *object, void *weak_pointer_loc) { g_return_if_fail (object != NULL); object->weak_refs = s_weakref_add_ptr (object->weak_refs, weak_pointer_loc); }
/*! \brief Add a weak pointer to an TOPLEVEL. * \par Function Description * Adds the weak pointer at \a weak_pointer_loc to \a toplevel. The * value of \a weak_pointer_loc will be set to NULL when \a toplevel is * destroyed. * * \sa s_toplevel_remove_weak_ptr * * \param [in,out] toplevel Toplevel to weak-reference. * \param [in] weak_pointer_loc Memory address of a pointer. */ void s_toplevel_add_weak_ptr (TOPLEVEL *toplevel, void *weak_pointer_loc) { g_return_if_fail (toplevel != NULL); toplevel->weak_refs = s_weakref_add_ptr (toplevel->weak_refs, (void**) weak_pointer_loc); }