WeakRef

A structure containing a weak reference to a #GObject. It can either be empty (i.e. point to %NULL), or point to an object for as long as at least one "strong" reference to that object exists. Before the object's #GObjectClass.dispose method is called, every #GWeakRef associated with becomes empty (i.e. points to %NULL).

Like #GValue, #GWeakRef can be statically allocated, stack- or heap-allocated, or embedded in larger structures.

Unlike g_object_weak_ref() and g_object_add_weak_pointer(), this weak reference is thread-safe: converting a weak pointer to a reference is atomic with respect to invalidation of weak pointers to destroyed objects.

If the object's #GObjectClass.dispose method results in additional references to the object being held, any #GWeakRefs taken before it was disposed will continue to point to %NULL. If #GWeakRefs are taken after the object is disposed and re-referenced, they will continue to point to it until its refcount goes back to zero, at which point they too will be invalidated.

Constructors

this
this(GWeakRef* gWeakRef, bool ownedRef)

Sets our main struct and passes it to the parent class.

this
this(void* object)

Members

Functions

clear
void clear()

Frees resources associated with a non-statically-allocated #GWeakRef. After this call, the #GWeakRef is left in an undefined state.

get
ObjectG get()

If @weak_ref is not empty, atomically acquire a strong reference to the object it points to, and return that reference.

getStruct
void* getStruct()

the main Gtk struct as a void*

getWeakRefStruct
GWeakRef* getWeakRefStruct(bool transferOwnership)

Get the main Gtk struct

init
void init(ObjectG object)

Initialise a non-statically-allocated #GWeakRef.

set
void set(ObjectG object)

Change the object to which @weak_ref points, or set it to %NULL.

Variables

gWeakRef
GWeakRef* gWeakRef;

the main Gtk struct

ownedRef
bool ownedRef;
Undocumented in source.

Meta