luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-10-25 06:22:15 +02:00
Code Issues Packages Projects Releases Wiki Activity

gobject: Annotate (un)ref functions transfer full

Browse Source 
Annotate ref and unref functions with transfer full for better
documentation and correct gir file creation.
This commit is contained in:
Tobias Stoeckmann
2025-08-11 21:43:35 +02:00
parent 3368a9cc7a
commit cad84d5e27
3 changed files with 8 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
gobject/gclosure.c
View File

@@ -611,7 +611,7 @@ closure_ref_internal (GClosure *closure)
* Increments the reference count on a closure to force it staying
* alive while the caller holds a pointer to it.
*
* Returns: (transfer none): The @closure passed in, for convenience
* Returns: (transfer full): The @closure passed in, for convenience
*/
GClosure*
g_closure_ref (GClosure *closure)
@@ -671,7 +671,7 @@ g_closure_invalidate (GClosure *closure)
/**
* g_closure_unref:
* @closure: #GClosure to decrement the reference count on
* @closure: (transfer full): #GClosure to decrement the reference count on
*
* Decrements the reference count of a closure after it was previously
* incremented by the same caller.

4
gobject/gobject.c
View File

@@ -4644,7 +4644,7 @@ retry:
* extension), so any casting the caller needs to do on the return type must be
* explicit.
*
* Returns: (type GObject.Object) (transfer none): the same @object
* Returns: (type GObject.Object) (transfer full): the same @object
*/
gpointer
(g_object_ref) (gpointer _object)
@@ -4720,7 +4720,7 @@ _object_unref_clear_weak_locations (GObject *object, gint *p_old_ref, gboolean d
/**
* g_object_unref:
* @object: (type GObject.Object): a #GObject
* @object: (type GObject.Object) (transfer full):: a #GObject
*
* Decreases the reference count of @object. When its reference count
* drops to 0, the object is finalized (i.e. its memory is freed).

8
gobject/gtype.c
View File

@@ -2775,7 +2775,7 @@ g_type_class_get (GType type)
*
* This function will demand-create the class if it doesn't exist already.
*
* Returns: (type GObject.TypeClass) (transfer none): the #GTypeClass
* Returns: (type GObject.TypeClass) (transfer full): the #GTypeClass
* structure for the given type ID
*
* Deprecated: 2.84: Use g_type_class_get() instead
@@ -2788,7 +2788,7 @@ g_type_class_ref (GType type)
/**
* g_type_class_unref:
* @g_class: (type GObject.TypeClass): a #GTypeClass structure to unref
* @g_class: (type GObject.TypeClass) (transfer full): a #GTypeClass structure to unref
*
* Decrements the reference count of the class structure being passed in.
*
@@ -3028,7 +3028,7 @@ g_type_interface_peek_parent (gpointer g_iface)
*
* Deprecated: 2.84: Use g_type_default_interface_get() instead
*
* Returns: (type GObject.TypeInterface) (transfer none): the default
* Returns: (type GObject.TypeInterface) (transfer full): the default
* vtable for the interface; call g_type_default_interface_unref()
* when you are done using the interface.
*/
@@ -3125,7 +3125,7 @@ g_type_default_interface_peek (GType g_type)
/**
* g_type_default_interface_unref:
* @g_iface: (type GObject.TypeInterface): the default vtable
* @g_iface: (type GObject.TypeInterface) (transfer full): the default vtable
* structure for an interface, as returned by g_type_default_interface_ref()
*
* Decrements the reference count for the type corresponding to the