Function
GLibPtrArrayfind
since: 2.54
Declaration [src]
gboolean
g_ptr_array_find (
GPtrArray* haystack,
gconstpointer needle,
guint* index_
)
Description [src]
Checks whether needle
exists in haystack
. 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.
This does pointer comparisons only. If you want to use more complex equality checks, such as string comparisons, use g_ptr_array_find_with_equal_func().
Available since: 2.54
This function is not directly available to language bindings.
Parameters
haystack
-
Type: An array of
gpointer
Pointer array to be searched.
The data is owned by the caller of the function. needle
-
Type:
gconstpointer
Pointer to look for.
The argument can be NULL
.The data is owned by the caller of the function. 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
.