函数
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。