Function

GObjectWeakNotify

Declaration

void
(* GWeakNotify) (
  gpointer data,
  GObject* where_the_object_was
)

Description

A GWeakNotify function can be added to an object as a callback that gets triggered when the object is finalized.

Since the object is already being disposed when the GWeakNotify is called, there’s not much you could do with the object, apart from e.g. using its address as hash-index or the like.

In particular, this means it’s invalid to call g_object_ref(), g_weak_ref_init(), g_weak_ref_set(), g_object_add_toggle_ref(), g_object_weak_ref(), g_object_add_weak_pointer() or any function which calls them on the object from this callback.

Parameters

data

Type: gpointer

Data that was provided when the weak reference was established.

The argument can be NULL.

The data is owned by the caller of the function.

where_the_object_was

Type: GObject

The object being disposed.

The data is owned by the caller of the function.