Method

GObjectObjectweak_ref

Declaration

void
g_object_weak_ref (
  GObject* object,
  GWeakNotify notify,
  gpointer data
)

Description

Adds a weak reference callback to an object. Weak references are used for notification when an object is disposed. They are called “weak references” because they allow you to safely hold a pointer to an object without calling g_object_ref() (g_object_ref() adds a strong reference, that is, forces the object to stay alive).

Note that the weak references created by this method are not thread-safe: they cannot safely be used in one thread if the object’s last g_object_unref() might happen in another thread. Use GWeakRef if thread-safety is required.

Parameters

notify GWeakNotify
 

Callback to invoke before the object is freed.

data gpointer
 

Extra data to pass to notify.