方法

GLibSequencesearch

自：2.14

声明 [源代码]

GSequenceIter*
g_sequence_search (
  GSequence* seq,
  gpointer data,
  GCompareDataFunc cmp_func,
  gpointer cmp_data
)

描述 [源代码]

返回一个迭代器，指向根据 cmp_func 和 cmp_data 插入 data 的位置。

cmp_func 使用 seq 的两个项和 cmp_data 调用。如果项相等，它应该返回0；如果第一个项在第二个项之前，应返回负值；如果第二个项在第一个项之前，应返回正值。

如果您只是要搜索序列中的现有元素，请考虑使用 g_sequence_lookup()。

如果序列中的数据未排序，此函数将失败。

自：2.14

参数

data

类型： gpointer

新项的数据。

该参数可以是 NULL。
数据由方法调用者拥有。
cmp_func

类型： GCompareDataFunc

用于比较序列中项的函数。

cmp_data

类型： gpointer

传递给 cmp_func 的用户数据。

该参数可以是 NULL。
数据由方法调用者拥有。

返回值

类型： GSequenceIter

一个指向根据 cmp_func 和 cmp_data 应插入的位置的 GSequenceIter。

返回的数据由实例拥有。