luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-03-30 20:33:08 +02:00
Code Issues Packages Projects Releases Wiki Activity

doc: Correctly annotate GAsyncQueue methods

Browse Source 
Generic pointers are assumed to be nullable unless explicitly marked as
not nullable.
This commit is contained in:
Emmanuele Bassi 2022-10-13 23:44:11 +01:00
parent 9fb7edd845
commit 80f56c9eb4
1 changed files with 19 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
glib/gasyncqueue.c
View File

@ -281,9 +281,11 @@ g_async_queue_unlock (GAsyncQueue *queue)
/**
* g_async_queue_push:
* @queue: a #GAsyncQueue
* @data: @data to push into the @queue
* @data: (not nullable): data to push onto the @queue
*
* Pushes the @data into the @queue. @data must not be %NULL.
* Pushes the @data into the @queue.
*
* The @data parameter must not be %NULL.
*/
void
g_async_queue_push (GAsyncQueue *queue,
@ -300,9 +302,11 @@ g_async_queue_push (GAsyncQueue *queue,
/**
* g_async_queue_push_unlocked:
* @queue: a #GAsyncQueue
* @data: @data to push into the @queue
* @data: (not nullable): data to push onto the @queue
*
* Pushes the @data into the @queue. @data must not be %NULL.
* Pushes the @data into the @queue.
*
* The @data parameter must not be %NULL.
*
* This function must be called while holding the @queue's lock.
*/
@ -321,7 +325,7 @@ g_async_queue_push_unlocked (GAsyncQueue *queue,
/**
* g_async_queue_push_sorted:
* @queue: a #GAsyncQueue
* @data: the @data to push into the @queue
* @data: (not nullable): the @data to push into the @queue
* @func: the #GCompareDataFunc is used to sort @queue
* @user_data: user data passed to @func.
*
@ -362,7 +366,7 @@ g_async_queue_invert_compare (gpointer v1,
/**
* g_async_queue_push_sorted_unlocked:
* @queue: a #GAsyncQueue
* @data: the @data to push into the @queue
* @data: the data to push into the @queue
* @func: the #GCompareDataFunc is used to sort @queue
* @user_data: user data passed to @func.
*
@ -798,7 +802,7 @@ g_async_queue_sort_unlocked (GAsyncQueue *queue,
/**
* g_async_queue_remove:
* @queue: a #GAsyncQueue
* @item: the data to remove from the @queue
* @item: (not nullable): the data to remove from the @queue
*
* Remove an item from the queue.
*
@ -848,7 +852,7 @@ g_async_queue_remove_unlocked (GAsyncQueue *queue,
/**
* g_async_queue_push_front:
* @queue: a #GAsyncQueue
* @item: data to push into the @queue
* @item: (not nullable): data to push into the @queue
*
* Pushes the @item into the @queue. @item must not be %NULL.
* In contrast to g_async_queue_push(), this function
@ -872,7 +876,7 @@ g_async_queue_push_front (GAsyncQueue *queue,
/**
* g_async_queue_push_front_unlocked:
* @queue: a #GAsyncQueue
* @item: data to push into the @queue
* @item: (not nullable): data to push into the @queue
*
* Pushes the @item into the @queue. @item must not be %NULL.
* In contrast to g_async_queue_push_unlocked(), this function