Struct

GLibQueue

Description

struct GQueue {
  GList* head;
  GList* tail;
  guint length;
}

Contains the public fields of a [Queue][glib-Double-ended-Queues].

Structure members

`head`	A pointer to the first element of the queue.
`tail`	A pointer to the last element of the queue.
`length`	The number of elements in the queue.

Functions

Instance methods

g_queue_clear

Removes all the elements in queue. If queue elements contain dynamically-allocated memory, they should be freed first.

Available since: 2.14

g_queue_clear_full

Convenience method, which frees all the memory used by a GQueue, and calls the provided free_func on each item in the GQueue.

Available since: 2.60

g_queue_copy

Copies a queue. Note that is a shallow copy. If the elements in the queue consist of pointers to data, the pointers are copied, but the actual data is not.

Available since: 2.4

g_queue_delete_link

Removes link_ from queue and frees it.

Available since: 2.4

g_queue_find

Finds the first link in queue which contains data.

Available since: 2.4

Finds an element in a GQueue, using a supplied function to find the desired element. It iterates over the queue, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the GQueue element’s data as the first argument and the given user data as the second argument.

Available since: 2.4

g_queue_foreach

Calls func for each element in the queue passing user_data to the function.

Available since: 2.4

g_queue_free

Frees the memory allocated for the GQueue. Only call this function if queue was created with g_queue_new(). If queue elements contain dynamically-allocated memory, they should be freed first.

g_queue_free_full

Convenience method, which frees all the memory used by a GQueue, and calls the specified destroy function on every element’s data.

Available since: 2.32

g_queue_get_length

Returns the number of items in queue.

Available since: 2.4

g_queue_index

Returns the position of the first element in queue which contains data.

Available since: 2.4

g_queue_init

A statically-allocated GQueue must be initialized with this function before it can be used. Alternatively you can initialize it with G_QUEUE_INIT. It is not necessary to initialize queues created with g_queue_new().

Available since: 2.14