[glib/th/g-ptr-array-set-null-terminated: 1/2] garray: Add missing (transfer full) introspection annotations




commit a9321c365222c4fe0fe7a33e0d3c0a0cb635b318
Author: Philip Withnall <pwithnall endlessos org>
Date:   Fri May 27 14:27:12 2022 +0100

    garray: Add missing (transfer full) introspection annotations
    
    Signed-off-by: Philip Withnall <pwithnall endlessos org>

 glib/garray.c | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)
---
diff --git a/glib/garray.c b/glib/garray.c
index 8dfba17b5c..6878dd3173 100644
--- a/glib/garray.c
+++ b/glib/garray.c
@@ -1171,8 +1171,9 @@ g_ptr_array_new (void)
  * g_assert (chunk_buffer->len == 0);
  * ]|
  *
- * Returns: (transfer full): the element data, which should be
- *     freed using g_free().
+ * Returns: (transfer full) (nullable): the element data, which should be
+ *     freed using g_free(). This may be %NULL if the array doesn’t have any
+ *     elements (i.e. if `*len` is zero).
  *
  * Since: 2.64
  */
@@ -1309,7 +1310,7 @@ g_array_copy (GArray *array)
  * either via g_ptr_array_unref(), when g_ptr_array_free() is called with
  * @free_segment set to %TRUE or when removing elements.
  *
- * Returns: A new #GPtrArray
+ * Returns: (transfer full): A new #GPtrArray
  *
  * Since: 2.22
  */
@@ -1333,7 +1334,7 @@ g_ptr_array_new_with_free_func (GDestroyNotify element_free_func)
  * g_ptr_array_unref(), when g_ptr_array_free() is called with
  * @free_segment set to %TRUE or when removing elements.
  *
- * Returns: A new #GPtrArray
+ * Returns: (transfer full): A new #GPtrArray
  *
  * Since: 2.30
  */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]