函数
GLibPtrArrayfind_with_equal_func
since: 2.54
声明 [src]
gboolean
g_ptr_array_find_with_equal_func (
GPtrArray* haystack,
gconstpointer needle,
GEqualFunc equal_func,
guint* index_
)
描述 [src]
检查 needle
是否存在于 haystack
中,使用给定的 equal_func
。如果找到元素,则返回 TRUE
并将元素的索引返回到 index_
(如果非 NULL
)。否则,返回 FALSE
且 index_
未定义。如果 needle
在 haystack
中多次出现,则返回第一个实例的索引。
equal_func
使用数组的元素作为第一个参数被调用,以 needle
作为第二个参数。如果 equal_func
是 NULL
,则使用指针等价性。
Available since: 2.54
此函数无法直接用于语言绑定。
参数
haystack
-
类型:一个
gpointer
数组要搜索的指针数组。
数据由函数的调用者拥有。 needle
-
类型:
gconstpointer
要查找的指针。
参数可以是 NULL
。数据由函数的调用者拥有。 equal_func
-
类型:
GEqualFunc
对于每个元素调用的函数,当找到所需元素时返回
TRUE
;或NULL
以使用指针等价性。 index_
-
类型:
guint*
返回元素索引的位置,如果找到的话。
此参数将由函数设置。 参数可以是 NULL
。