Method

GLibSequencelookup_iter

Declaration

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

Description

Like g_sequence_lookup(), 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.

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

Available since:2.28
This method is not directly available to language bindings.

Parameters

data gpointer
 

Data to look up.

 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
 

An GSequenceIter pointing to the position of the first item found equal to data according to iter_cmp and cmp_data, or NULL if no such item exists.

 The data is owned by the instance.
 The return value can be NULL.