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
This method is not directly available to language bindings.

Parameters

data gpointer
 

Data for the new item.

 The argument can be NULL.
 The data is owned by the caller of the function.
iter_cmp GSequenceIterCompareFunc
 

The function used to compare iterators in the sequence.

cmp_data gpointer
 

User data passed to iter_cmp.

 The argument can be NULL.
 The data is owned by the caller of the function.

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.