Method

GLibSequencesearch_iter

Declaration

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

Description

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.

Available since:2.14

Parameters

data gpointer
 

Data for the new item.

iter_cmp GSequenceIterCompareFunc
 

The function used to compare iterators in the sequence.

cmp_data gpointer
 

User data passed to iter_cmp.

Return value

Returns: GSequenceIter
 

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

 The data is owned by the instance.