Sequence.search

Returns an iterator pointing to the position where @data would be inserted according to @cmp_func and @cmp_data.

@cmp_func is called with two items of the @seq and @user_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first.

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

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
search

Parameters

data void*

data for the new item

cmpFunc GCompareDataFunc

the function used to compare items in the sequence

cmpData void*

user data passed to @cmp_func

Return: an #GSequenceIter pointing to the position where @data would have been inserted according to @cmp_func and @cmp_data

Meta

Since

2.14