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 |
|
The argument can be NULL . | |
The data is owned by the caller of the function. |
Return value
Returns: | GSequenceIter |
An |
|
The data is owned by the instance. | |
The return value can be NULL . |