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(). Note 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. Since 2.14

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