Function
GLibPtrArrayfind_with_equal_func
since: 2.54
Declaration
gboolean
g_ptr_array_find_with_equal_func (
GPtrArray* haystack,
gconstpointer needle,
GEqualFunc equal_func,
guint* index_
)
Description
Checks whether needle exists in haystack, using the given equal_func.
If the element is found, TRUE is returned and the element’s index is
returned in index_ (if non-NULL). Otherwise, FALSE is returned and index_
is undefined. If needle exists multiple times in haystack, the index of
the first instance is returned.
equal_func is called with the element from the array as its first parameter,
and needle as its second parameter. If equal_func is NULL, pointer
equality is used.
Available since: 2.54
This function is not directly available to language bindings.
Parameters
haystack-
Type: An array of
gpointerPointer array to be searched.
The data is owned by the caller of the function. needle-
Type:
gconstpointerPointer to look for.
The argument can be NULL.The data is owned by the caller of the function. equal_func-
Type:
GEqualFuncThe function to call for each element, which should return
TRUEwhen the desired element is found; orNULLto use pointer equality. index_-
Type:
guint*Return location for the index of the element, if found.
The argument will be set by the function. The argument can be NULL.