![]() |
![]() |
![]() |
GStreamer 0.10 Core Reference Manual | ![]() |
---|---|---|---|---|
#include <gst/gst.h> gboolean (*GstFilterFunc) (gpointer obj, gpointer user_data); GList* gst_filter_run (const GList *list, GstFilterFunc func, gboolean first, gpointer user_data);
Example 9. Filtering a list
GList *node; GstObject *result = NULL; node = gst_filter_run (list, (GstFilterFunc) my_filter, TRUE, NULL); if (node) { result = GST_OBJECT (node->data); gst_object_ref (result); gst_list_free (node); }
gboolean (*GstFilterFunc) (gpointer obj, gpointer user_data);
Function prototype for a filter callback taht can be use in gst_filter_run()
.
The function should apply its filtering to obj
. Additional data passed to
gst_filter_run()
are in data
.
obj : |
the object |
user_data : |
filter data |
Returns : | TRUE for success.
|
GList* gst_filter_run (const GList *list, GstFilterFunc func, gboolean first, gpointer user_data);
Iterates over the elements in list
, calling func
with the
list item data for each item. If func
returns TRUE, data
is
prepended to the list of results returned. If first
is true,
the search is halted after the first result is found.
list : |
a linked list |
func : |
the function to execute for each item |
first : |
flag to stop execution after a successful item |
user_data : |
user data |
Returns : | the list of results |