方法

GLibSequencesearch_iter

since: 2.14

声明 [src]

GSequenceIter*
g_sequence_search_iter (
  GSequence* seq,
  gpointer data,
  GSequenceIterCompareFunc iter_cmp,
  gpointer cmp_data
)

描述 [src]

类似于g_sequence_search()，但使用GSequenceIterCompareFunc而不是GCompareDataFunc作为比较函数。

iter_cmp使用指向seq中两个迭代器的指针被调用。如果迭代器相等，应返回0；如果第一个迭代器在第二个迭代器之前，应返回负值；如果第二个迭代器在第一个迭代器之前，应返回正值。

如果您只是搜索序列中存在的元素，请考虑使用g_sequence_lookup_iter()。

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

Available since: 2.14

参数

data

类型： gpointer

新项的数据。

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

类型： GSequenceIterCompareFunc

用于在序列中比较迭代器的函数。

cmp_data

类型： gpointer

传递给iter_cmp的用用户数据。

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

返回值

类型： GSequenceIter

一个指向seq中根据iter_cmp和cmp_data插入数据位置的GSequenceIter。

返回的数据由实例所有。