GObject.set_weak_pointer
Description: Reference for GObject.set_weak_pointer

### Function Macro

# GObjectset_weak_pointer

since: 2.56

#### Declaration [src]

    #define g_set_weak_pointer (
      weak_pointer_location,
      new_object
    )

#### Description [src]

Updates a pointer to weakly refer to `new_object`.

It assigns `new_object` to `weak_pointer_location` and ensures that `weak_pointer_location` will automatically be set to `NULL` if `new_object` gets destroyed. The assignment is not atomic. The weak reference is not thread-safe, see `g_object_add_weak_pointer()` for details.

The `weak_pointer_location` argument must not be `NULL`.

A macro is also included that allows this function to be used without pointer casts. The function itself is static inline, so its address may vary between compilation units.

One convenient usage of this function is in implementing property setters:

      void
      foo_set_bar (Foo *foo,
                   Bar *new_bar)
      {
        g_return_if_fail (IS_FOO (foo));
        g_return_if_fail (new_bar == NULL || IS_BAR (new_bar));

        if (g_set_weak_pointer (&foo->bar, new_bar))
          g_object_notify (foo, "bar");
      }

Available since: 2.56

This function is not directly available to language bindings.

#### Parameters

`weak_pointer_location`

  Type: `-`

  The memory address of a pointer.

`new_object`

  Type: `-`

  A pointer to the new `GObject` to assign to it, or `NULL` to clear the pointer.