gobject: Mention g_clear_object() in g_object_unref() documentation

https://bugzilla.gnome.org/show_bug.cgi?id=741779
This commit is contained in:
Philip Withnall 2014-12-19 19:02:15 +00:00
parent 18c9a4e17a
commit 4aedc85fb3

View File

@ -3057,6 +3057,11 @@ g_object_ref (gpointer _object)
* *
* Decreases the reference count of @object. When its reference count * Decreases the reference count of @object. When its reference count
* drops to 0, the object is finalized (i.e. its memory is freed). * drops to 0, the object is finalized (i.e. its memory is freed).
*
* If the pointer to the #GObject may be reused in future (for example, if it is
* an instance variable of another object), it is recommended to clear the
* pointer to %NULL rather than retain a dangling pointer to a potentially
* invalid #GObject instance. Use g_clear_object() for this.
*/ */
void void
g_object_unref (gpointer _object) g_object_unref (gpointer _object)