函数

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)。否则,返回 FALSEindex_ 未定义。如果 needlehaystack 中多次出现,则返回第一个实例的索引。

equal_func 使用数组的元素作为第一个参数被调用,以 needle 作为第二个参数。如果 equal_funcNULL,则使用指针等价性。

Available since: 2.54

此函数无法直接用于语言绑定。

参数

haystack

类型:一个 gpointer 数组

要搜索的指针数组。

数据由函数的调用者拥有。
needle

类型:gconstpointer

要查找的指针。

参数可以是 NULL
数据由函数的调用者拥有。
equal_func

类型:GEqualFunc

对于每个元素调用的函数,当找到所需元素时返回 TRUE;或 NULL 以使用指针等价性。

index_

类型: guint*

返回元素索引的位置,如果找到的话。

此参数将由函数设置。
参数可以是 NULL

返回值

类型: gboolean

TRUE 表示 needlehaystack 中的元素之一。