Sequence.searchIter

Like g_sequence_search(), but uses a #GSequenceIterCompareFunc instead of a #GCompareDataFunc as the compare function.

@iter_cmp is called with two iterators pointing into @seq. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first.

If you are simply searching for an existing element of the sequence, consider using g_sequence_lookup_iter().

This function will fail if the data contained in the sequence is unsorted. Use g_sequence_insert_sorted() or g_sequence_insert_sorted_iter() to add data to your sequence or, if you want to add a large amount of data, call g_sequence_sort() after doing unsorted insertions.

class Sequence
searchIter

Parameters

data void*

data for the new item

iterCmp GSequenceIterCompareFunc

the function used to compare iterators in the sequence

cmpData void*

user data passed to @iter_cmp

Return Value

a #GSequenceIter pointing to the position in @seq where @data would have been inserted according to @iter_cmp and @cmp_data

Meta

Since

2.14