Sequence.searchIter

Like glib.sequence.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 glib.sequence.Sequence.lookupIter.

This function will fail if the data contained in the sequence is unsorted.

Parameters

data void*

data for the new item

iterCmp glib.types.SequenceIterCompareFunc

the function used to compare iterators in the sequence

Return Value

Type: glib.sequence_iter.SequenceIter

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