Top |
GstQueueArray is an object that provides standard queue functionality based on an array instead of linked lists. This reduces the overhead caused by memory management by a large factor.
GstQueueArray *
gst_queue_array_new (guint initial_size
);
Allocates a new GstQueueArray object with an initial
queue size of initial_size
.
[skip]
Since: 1.2
void
gst_queue_array_free (GstQueueArray *array
);
Frees queue array
and all memory associated to it.
[skip]
Since: 1.2
guint
gst_queue_array_get_length (GstQueueArray *array
);
Returns the length of the queue array
[skip]
Since: 1.2
gpointer
gst_queue_array_pop_head (GstQueueArray *array
);
Returns and head of the queue array
and removes
it from the queue.
[skip]
Since: 1.2
gpointer
gst_queue_array_peek_head (GstQueueArray *array
);
Returns and head of the queue array
and does not
remove it from the queue.
[skip]
Since: 1.2
void gst_queue_array_push_tail (GstQueueArray *array
,gpointer data
);
Pushes data
to the tail of the queue array
.
[skip]
Since: 1.2
gboolean
gst_queue_array_is_empty (GstQueueArray *array
);
Checks if the queue array
is empty.
[skip]
Since: 1.2
gpointer gst_queue_array_drop_element (GstQueueArray *array
,guint idx
);
Drops the queue element at position idx
from queue array
.
[skip]
Since: 1.2
guint gst_queue_array_find (GstQueueArray *array
,GCompareFunc func
,gpointer data
);
Finds an element in the queue array
, either by comparing every element
with func
or by looking up data
if no compare function func
is provided,
and returning the index of the found element.
Note that the index is not 0-based, but an internal index number with a
random offset. The index can be used in connection with
gst_queue_array_drop_element()
. FIXME: return index 0-based and make
gst_queue_array_drop_element()
take a 0-based index.
[skip]
array |
a GstQueueArray object |
|
func |
comparison function, or |
[allow-none] |
data |
data for comparison function |
Since: 1.2