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
The pointer array to be searched.
The data is owned by the caller of the function. needle
-
Type:
gconstpointer
The pointer to look for.
The argument can be NULL
.The data is owned by the caller of the function. index_
-
Type:
guint*
The return location for the index of the element, if found.
The argument will be set by the function. The argument can be NULL
.