Function
GLibListinsert_sorted_with_data
since: 2.10
Declaration
GList*
g_list_insert_sorted_with_data (
GList* list,
gpointer data,
GCompareDataFunc func,
gpointer user_data
)
Description
Inserts a new element into the list, using the given comparison function to determine its position.
If you are adding many new elements to a list, and the number of
new elements is much larger than the length of the list, use
g_list_prepend() to add the new items and sort the list afterwards
with g_list_sort().
Available since: 2.10
This function is not directly available to language bindings.
Parameters
list-
Type: A list of
gpointerA pointer to a
GList, this must point to the top of the already sorted list.The data is owned by the caller of the function. data-
Type:
gpointerThe data for the new element.
The argument can be NULL.The data is owned by the caller of the function. func-
Type:
GCompareDataFuncThe function to compare elements in the list. It should return a number > 0 if the first parameter comes after the second parameter in the sort order.
user_data-
Type:
gpointerUser data to pass to comparison function.
The argument can be NULL.The data is owned by the caller of the function.