Function

GLibSListfind_custom

Declaration 

GSList*
g_slist_find_custom (
  GSList* list,
  gconstpointer data,
  GCompareFunc func
)

Description

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

This function is not directly available to language bindings.

Parameters

list

Type: A list of gpointer

A GSList.

The data is owned by the caller of the function.
data

Type: gconstpointer

User data passed to the function.

The argument can be NULL.
The data is owned by the caller of the function.
func

Type: GCompareFunc

The function to call for each element. It should return 0 when the desired element is found.

Return value

Type: A list of gpointer

The found GSList element, or NULL if it is not found.

The data is owned by the called function.