rb-async-queue-watch

rb-async-queue-watch — GSource for watching a GAsyncQueue in the main loop

Synopsis

void                (*RBAsyncQueueWatchFunc)            (gpointer item,
                                                         gpointer data);
guint               rb_async_queue_watch_new            (GAsyncQueue *queue,
                                                         gint priority,
                                                         RBAsyncQueueWatchFunc callback,
                                                         gpointer user_data,
                                                         GDestroyNotify notify,
                                                         GMainContext *context);

Description

Details

RBAsyncQueueWatchFunc ()

void                (*RBAsyncQueueWatchFunc)            (gpointer item,
                                                         gpointer data);

Callback to call when an item is found in the queue.

item :

the item found in the queue

data :

user data specified when creating the watch

rb_async_queue_watch_new ()

guint               rb_async_queue_watch_new            (GAsyncQueue *queue,
                                                         gint priority,
                                                         RBAsyncQueueWatchFunc callback,
                                                         gpointer user_data,
                                                         GDestroyNotify notify,
                                                         GMainContext *context);

Creates a new GSource that triggers when the GAsyncQueue is non-empty. This is used in rhythmbox to process queues within RhythmDB in the main thread without polling.

queue :

the GAsyncQueue to watch

priority :

priority value for the GSource

callback :

callback to invoke when the queue is non-empty

user_data :

user data to pass to the callback

notify :

function to call to clean up the user data for the callback

context :

the GMainContext to attach the source to

Returns :

the ID of the new GSource