36
37
<th width="100%" align="center">GLib Reference Manual</th>
37
38
<td><a accesskey="n" href="glib-Trash-Stacks.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
39
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3329417" class="shortcut">Top</a>
41
<a href="#id3330603" class="shortcut">Description</a></nobr></td></tr>
40
<tr><td colspan="5" class="shortcuts">
41
<a href="#glib-Sequences.synopsis" class="shortcut">Top</a>
43
<a href="#glib-Sequences.description" class="shortcut">Description</a>
43
46
<div class="refentry" lang="en">
44
47
<a name="glib-Sequences"></a><div class="titlepage"></div>
45
48
<div class="refnamediv"><table width="100%"><tr>
48
<a name="id3329417"></a><span class="refentrytitle">Sequences</span>
50
<p>Sequences — scalable lists</p>
50
<h2><span class="refentrytitle"><a name="glib-Sequences.top_of_page"></a>Sequences</span></h2>
51
<p>Sequences — scalable lists</p>
52
53
<td valign="top" align="right"></td>
53
54
</tr></table></div>
54
55
<div class="refsynopsisdiv">
56
<a name="glib-Sequences.synopsis"></a><h2>Synopsis</h2>
56
57
<pre class="synopsis">
58
59
#include <glib.h>
61
<a class="link" href="glib-Sequences.html#GSequence">GSequence</a>;
62
typedef <a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>;
63
<a class="link" href="glib-Basic-Types.html#gint">gint</a> (<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">*GSequenceIterCompareFunc</a>) (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *a,
64
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *b,
65
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
67
<a class="link" href="glib-Sequences.html#GSequence">GSequence</a>* <a class="link" href="glib-Sequences.html#g-sequence-new">g_sequence_new</a> (<a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> data_destroy);
68
void <a class="link" href="glib-Sequences.html#g-sequence-free">g_sequence_free</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);
69
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-get-length">g_sequence_get_length</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);
70
void <a class="link" href="glib-Sequences.html#g-sequence-foreach">g_sequence_foreach</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
71
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
72
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);
73
void <a class="link" href="glib-Sequences.html#g-sequence-foreach-range">g_sequence_foreach_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
74
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end,
75
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
76
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);
77
void <a class="link" href="glib-Sequences.html#g-sequence-sort">g_sequence_sort</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
78
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
79
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
80
void <a class="link" href="glib-Sequences.html#g-sequence-sort-iter">g_sequence_sort_iter</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
81
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> cmp_func,
82
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
84
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-get-begin-iter">g_sequence_get_begin_iter</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);
85
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-get-end-iter">g_sequence_get_end_iter</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);
86
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-get-iter-at-pos">g_sequence_get_iter_at_pos</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
87
<a class="link" href="glib-Basic-Types.html#gint">gint</a> pos);
88
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-append">g_sequence_append</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
89
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
90
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-prepend">g_sequence_prepend</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
91
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
92
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-insert-before">g_sequence_insert_before</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
93
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
94
void <a class="link" href="glib-Sequences.html#g-sequence-move">g_sequence_move</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *src,
95
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *dest);
96
void <a class="link" href="glib-Sequences.html#g-sequence-swap">g_sequence_swap</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *a,
97
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *b);
98
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted">g_sequence_insert_sorted</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
99
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
100
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
101
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
102
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter">g_sequence_insert_sorted_iter</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
103
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
104
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> iter_cmp,
105
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
106
void <a class="link" href="glib-Sequences.html#g-sequence-sort-changed">g_sequence_sort_changed</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
107
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
108
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
109
void <a class="link" href="glib-Sequences.html#g-sequence-sort-changed-iter">g_sequence_sort_changed_iter</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
110
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> iter_cmp,
111
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
112
void <a class="link" href="glib-Sequences.html#g-sequence-remove">g_sequence_remove</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
113
void <a class="link" href="glib-Sequences.html#g-sequence-remove-range">g_sequence_remove_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
114
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end);
115
void <a class="link" href="glib-Sequences.html#g-sequence-move-range">g_sequence_move_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *dest,
116
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
117
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end);
118
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-search">g_sequence_search</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
119
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
120
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
121
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
122
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-search-iter">g_sequence_search_iter</a> (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
123
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
124
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> iter_cmp,
125
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);
127
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="glib-Sequences.html#g-sequence-get">g_sequence_get</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
128
void <a class="link" href="glib-Sequences.html#g-sequence-set">g_sequence_set</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
129
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);
131
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-is-begin">g_sequence_iter_is_begin</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
132
<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-is-end">g_sequence_iter_is_end</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
133
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-iter-next">g_sequence_iter_next</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
134
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-iter-prev">g_sequence_iter_prev</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
135
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-get-position">g_sequence_iter_get_position</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
136
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-iter-move">g_sequence_iter_move</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
137
<a class="link" href="glib-Basic-Types.html#gint">gint</a> delta);
138
<a class="link" href="glib-Sequences.html#GSequence">GSequence</a>* <a class="link" href="glib-Sequences.html#g-sequence-iter-get-sequence">g_sequence_iter_get_sequence</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);
140
<a class="link" href="glib-Basic-Types.html#gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-compare">g_sequence_iter_compare</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *a,
141
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *b);
142
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* <a class="link" href="glib-Sequences.html#g-sequence-range-get-midpoint">g_sequence_range_get_midpoint</a> (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
143
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end);
61
<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a>;
62
typedef <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a>;
63
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> (<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">*GSequenceIterCompareFunc</a>) (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *a,
64
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *b,
65
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
67
<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> * <a class="link" href="glib-Sequences.html#g-sequence-new" title="g_sequence_new ()">g_sequence_new</a> (<a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> data_destroy);
68
void <a class="link" href="glib-Sequences.html#g-sequence-free" title="g_sequence_free ()">g_sequence_free</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);
69
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-get-length" title="g_sequence_get_length ()">g_sequence_get_length</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);
70
void <a class="link" href="glib-Sequences.html#g-sequence-foreach" title="g_sequence_foreach ()">g_sequence_foreach</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
71
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
72
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
73
void <a class="link" href="glib-Sequences.html#g-sequence-foreach-range" title="g_sequence_foreach_range ()">g_sequence_foreach_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *begin,
74
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *end,
75
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
76
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
77
void <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()">g_sequence_sort</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
78
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
79
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
80
void <a class="link" href="glib-Sequences.html#g-sequence-sort-iter" title="g_sequence_sort_iter ()">g_sequence_sort_iter</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
81
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">GSequenceIterCompareFunc</a> cmp_func,
82
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
84
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-get-begin-iter" title="g_sequence_get_begin_iter ()">g_sequence_get_begin_iter</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);
85
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-get-end-iter" title="g_sequence_get_end_iter ()">g_sequence_get_end_iter</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);
86
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-get-iter-at-pos" title="g_sequence_get_iter_at_pos ()">g_sequence_get_iter_at_pos</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
87
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> pos);
88
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-append" title="g_sequence_append ()">g_sequence_append</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
89
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
90
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-prepend" title="g_sequence_prepend ()">g_sequence_prepend</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
91
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
92
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-insert-before" title="g_sequence_insert_before ()">g_sequence_insert_before</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
93
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
94
void <a class="link" href="glib-Sequences.html#g-sequence-move" title="g_sequence_move ()">g_sequence_move</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *src,
95
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *dest);
96
void <a class="link" href="glib-Sequences.html#g-sequence-swap" title="g_sequence_swap ()">g_sequence_swap</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *a,
97
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *b);
98
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted" title="g_sequence_insert_sorted ()">g_sequence_insert_sorted</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
99
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
100
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
101
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
102
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-insert-sorted-iter" title="g_sequence_insert_sorted_iter ()">g_sequence_insert_sorted_iter</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
103
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
104
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">GSequenceIterCompareFunc</a> iter_cmp,
105
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
106
void <a class="link" href="glib-Sequences.html#g-sequence-sort-changed" title="g_sequence_sort_changed ()">g_sequence_sort_changed</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
107
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
108
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
109
void <a class="link" href="glib-Sequences.html#g-sequence-sort-changed-iter" title="g_sequence_sort_changed_iter ()">g_sequence_sort_changed_iter</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
110
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">GSequenceIterCompareFunc</a> iter_cmp,
111
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
112
void <a class="link" href="glib-Sequences.html#g-sequence-remove" title="g_sequence_remove ()">g_sequence_remove</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
113
void <a class="link" href="glib-Sequences.html#g-sequence-remove-range" title="g_sequence_remove_range ()">g_sequence_remove_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *begin,
114
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *end);
115
void <a class="link" href="glib-Sequences.html#g-sequence-move-range" title="g_sequence_move_range ()">g_sequence_move_range</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *dest,
116
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *begin,
117
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *end);
118
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-search" title="g_sequence_search ()">g_sequence_search</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
119
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
120
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
121
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
122
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-search-iter" title="g_sequence_search_iter ()">g_sequence_search_iter</a> (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
123
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
124
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">GSequenceIterCompareFunc</a> iter_cmp,
125
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);
127
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> <a class="link" href="glib-Sequences.html#g-sequence-get" title="g_sequence_get ()">g_sequence_get</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
128
void <a class="link" href="glib-Sequences.html#g-sequence-set" title="g_sequence_set ()">g_sequence_set</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
129
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
131
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-is-begin" title="g_sequence_iter_is_begin ()">g_sequence_iter_is_begin</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
132
<a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-is-end" title="g_sequence_iter_is_end ()">g_sequence_iter_is_end</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
133
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-iter-next" title="g_sequence_iter_next ()">g_sequence_iter_next</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
134
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-iter-prev" title="g_sequence_iter_prev ()">g_sequence_iter_prev</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
135
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-get-position" title="g_sequence_iter_get_position ()">g_sequence_iter_get_position</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
136
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-iter-move" title="g_sequence_iter_move ()">g_sequence_iter_move</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
137
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> delta);
138
<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> * <a class="link" href="glib-Sequences.html#g-sequence-iter-get-sequence" title="g_sequence_iter_get_sequence ()">g_sequence_iter_get_sequence</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);
140
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> <a class="link" href="glib-Sequences.html#g-sequence-iter-compare" title="g_sequence_iter_compare ()">g_sequence_iter_compare</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *a,
141
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *b);
142
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * <a class="link" href="glib-Sequences.html#g-sequence-range-get-midpoint" title="g_sequence_range_get_midpoint ()">g_sequence_range_get_midpoint</a> (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *begin,
143
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *end);
146
146
<div class="refsect1" lang="en">
147
<a name="id3330603"></a><h2>Description</h2>
147
<a name="glib-Sequences.description"></a><h2>Description</h2>
149
The <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a> data structure has the API of a list, but is
149
The <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> data structure has the API of a list, but is
150
150
implemented internally with a balanced binary tree. This means that it
151
151
is possible to maintain a sorted list of n elements in time O(n log
152
152
n). The data contained in each element can be either integer values, by
154
154
<a class="link" href="glib-Type-Conversion-Macros.html" title="Type Conversion Macros">Type Conversion Macros</a>,
155
155
or simply pointers to any type of data.
158
A <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a> is accessed through <em class="firstterm">iterators</em>,
159
represented by a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>. An iterator represents a position
158
A <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> is accessed through <em class="firstterm">iterators</em>,
159
represented by a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>. An iterator represents a position
160
160
between two elements of the sequence. For example, the
161
161
<em class="firstterm">begin</em> iterator represents the gap immediately
162
162
before the first element of the sequence, and the
255
250
<div class="refsect2" lang="en">
256
<a name="id3331029"></a><h3>
257
<a name="g-sequence-new"></a>g_sequence_new ()</h3>
258
<a class="indexterm" name="id3331044"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequence">GSequence</a>* g_sequence_new (<a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> data_destroy);</pre>
251
<a name="g-sequence-new"></a><h3>g_sequence_new ()</h3>
252
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> * g_sequence_new (<a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()">GDestroyNotify</a> data_destroy);</pre>
260
Creates a new GSequence. The <em class="parameter"><code>data_destroy</code></em> function, if non-<a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will
254
Creates a new GSequence. The <em class="parameter"><code>data_destroy</code></em> function, if non-<a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> will
261
255
be called on all items when the sequence is destroyed and on items that
262
256
are removed from the sequence.</p>
266
259
<div class="variablelist"><table border="0">
267
260
<col align="left" valign="top">
270
<td><p><span class="term"><em class="parameter"><code>data_destroy</code></em> :</span></p></td>
271
<td> a <a class="link" href="glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> function, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
263
<td><p><span class="term"><em class="parameter"><code>data_destroy</code></em> :</span></p></td>
264
<td> a <a class="link" href="glib-Datasets.html#GDestroyNotify" title="GDestroyNotify ()"><span class="type">GDestroyNotify</span></a> function, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>
275
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
276
<td> a new <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
268
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
269
<td> a new <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
282
<p class="since">Since 2.14
275
<p class="since">Since 2.14</p>
286
278
<div class="refsect2" lang="en">
287
<a name="id3331157"></a><h3>
288
<a name="g-sequence-free"></a>g_sequence_free ()</h3>
289
<a class="indexterm" name="id3331172"></a><pre class="programlisting">void g_sequence_free (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);</pre>
279
<a name="g-sequence-free"></a><h3>g_sequence_free ()</h3>
280
<pre class="programlisting">void g_sequence_free (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);</pre>
291
282
Frees the memory allocated for <em class="parameter"><code>seq</code></em>. If <em class="parameter"><code>seq</code></em> has a data destroy
292
283
function associated with it, that function is called on all items in
293
284
<em class="parameter"><code>seq</code></em>.</p>
297
287
<div class="variablelist"><table border="0">
298
288
<col align="left" valign="top">
300
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
301
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
290
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
291
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
305
<p class="since">Since 2.14
295
<p class="since">Since 2.14</p>
309
298
<div class="refsect2" lang="en">
310
<a name="id3331255"></a><h3>
311
<a name="g-sequence-get-length"></a>g_sequence_get_length ()</h3>
312
<a class="indexterm" name="id3331270"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_sequence_get_length (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);</pre>
299
<a name="g-sequence-get-length"></a><h3>g_sequence_get_length ()</h3>
300
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_sequence_get_length (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);</pre>
314
302
Returns the length of <em class="parameter"><code>seq</code></em></p>
318
305
<div class="variablelist"><table border="0">
319
306
<col align="left" valign="top">
322
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
323
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
309
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
310
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
327
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
314
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
328
315
<td> the length of <em class="parameter"><code>seq</code></em>
334
<p class="since">Since 2.14
321
<p class="since">Since 2.14</p>
338
324
<div class="refsect2" lang="en">
339
<a name="id3331355"></a><h3>
340
<a name="g-sequence-foreach"></a>g_sequence_foreach ()</h3>
341
<a class="indexterm" name="id3331371"></a><pre class="programlisting">void g_sequence_foreach (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
342
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
343
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
325
<a name="g-sequence-foreach"></a><h3>g_sequence_foreach ()</h3>
326
<pre class="programlisting">void g_sequence_foreach (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
327
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
328
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
345
330
Calls <em class="parameter"><code>func</code></em> for each item in the sequence passing <em class="parameter"><code>user_data</code></em>
346
331
to the function.</p>
350
334
<div class="variablelist"><table border="0">
351
335
<col align="left" valign="top">
354
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
355
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
338
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
339
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
359
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
343
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
360
344
<td> the function to call for each item in <em class="parameter"><code>seq</code></em>
364
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
348
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
365
349
<td> user data passed to <em class="parameter"><code>func</code></em>
370
<p class="since">Since 2.14
354
<p class="since">Since 2.14</p>
374
357
<div class="refsect2" lang="en">
375
<a name="id3331502"></a><h3>
376
<a name="g-sequence-foreach-range"></a>g_sequence_foreach_range ()</h3>
377
<a class="indexterm" name="id3331518"></a><pre class="programlisting">void g_sequence_foreach_range (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
378
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end,
379
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
380
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
358
<a name="g-sequence-foreach-range"></a><h3>g_sequence_foreach_range ()</h3>
359
<pre class="programlisting">void g_sequence_foreach_range (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *begin,
360
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *end,
361
<a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
362
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
382
364
Calls <em class="parameter"><code>func</code></em> for each item in the range (<em class="parameter"><code>begin</code></em>, <em class="parameter"><code>end</code></em>) passing
383
365
<em class="parameter"><code>user_data</code></em> to the function.</p>
387
368
<div class="variablelist"><table border="0">
388
369
<col align="left" valign="top">
391
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
392
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
396
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
397
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
401
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
402
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc"><span class="type">GFunc</span></a>
406
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
372
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
373
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
377
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
378
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
382
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
383
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="type">GFunc</span></a>
387
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
407
388
<td> user data passed to <em class="parameter"><code>func</code></em>
412
<p class="since">Since 2.14
393
<p class="since">Since 2.14</p>
416
396
<div class="refsect2" lang="en">
417
<a name="id3331694"></a><h3>
418
<a name="g-sequence-sort"></a>g_sequence_sort ()</h3>
419
<a class="indexterm" name="id3331709"></a><pre class="programlisting">void g_sequence_sort (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
420
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
421
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
397
<a name="g-sequence-sort"></a><h3>g_sequence_sort ()</h3>
398
<pre class="programlisting">void g_sequence_sort (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
399
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
400
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);</pre>
423
402
Sorts <em class="parameter"><code>seq</code></em> using <em class="parameter"><code>cmp_func</code></em>.</p>
427
405
<div class="variablelist"><table border="0">
428
406
<col align="left" valign="top">
431
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
432
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
409
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
410
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
436
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
437
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> used to sort <em class="parameter"><code>seq</code></em>. This function is
414
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
415
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="type">GCompareDataFunc</span></a> used to sort <em class="parameter"><code>seq</code></em>. This function is
438
416
passed two items of <em class="parameter"><code>seq</code></em> and should return 0 if they are equal,
439
417
a negative value fi the first comes before the second, and a
440
418
positive value if the second comes before the first.
444
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
422
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
445
423
<td> user data passed to <em class="parameter"><code>cmp_func</code></em>
450
<p class="since">Since 2.14
428
<p class="since">Since 2.14</p>
454
431
<div class="refsect2" lang="en">
455
<a name="id3331858"></a><h3>
456
<a name="g-sequence-sort-iter"></a>g_sequence_sort_iter ()</h3>
457
<a class="indexterm" name="id3331873"></a><pre class="programlisting">void g_sequence_sort_iter (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
458
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> cmp_func,
459
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
432
<a name="g-sequence-sort-iter"></a><h3>g_sequence_sort_iter ()</h3>
433
<pre class="programlisting">void g_sequence_sort_iter (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
434
<a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()">GSequenceIterCompareFunc</a> cmp_func,
435
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);</pre>
461
Like <a class="link" href="glib-Sequences.html#g-sequence-sort"><code class="function">g_sequence_sort()</code></a>, but uses a <a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc"><span class="type">GSequenceIterCompareFunc</span></a> instead
437
Like <a class="link" href="glib-Sequences.html#g-sequence-sort" title="g_sequence_sort ()"><code class="function">g_sequence_sort()</code></a>, but uses a <a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc" title="GSequenceIterCompareFunc ()"><span class="type">GSequenceIterCompareFunc</span></a> instead
462
438
of a GCompareDataFunc as the compare function</p>
466
441
<div class="variablelist"><table border="0">
467
442
<col align="left" valign="top">
470
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
471
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
445
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
446
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
475
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
450
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
476
451
<td> the <span class="type">GSequenceItercompare</span> used to compare iterators in the
477
452
sequence. It is called with two iterators pointing into <em class="parameter"><code>seq</code></em>. It should
478
453
return 0 if the iterators are equal, a negative value if the first
484
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
459
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
485
460
<td> user data passed to <em class="parameter"><code>cmp_func</code></em>
490
<p class="since">Since 2.14
465
<p class="since">Since 2.14</p>
494
468
<div class="refsect2" lang="en">
495
<a name="id3332029"></a><h3>
496
<a name="g-sequence-get-begin-iter"></a>g_sequence_get_begin_iter ()</h3>
497
<a class="indexterm" name="id3332044"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_get_begin_iter (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);</pre>
469
<a name="g-sequence-get-begin-iter"></a><h3>g_sequence_get_begin_iter ()</h3>
470
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_get_begin_iter (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);</pre>
499
472
Returns the begin iterator for <em class="parameter"><code>seq</code></em>.</p>
503
475
<div class="variablelist"><table border="0">
504
476
<col align="left" valign="top">
507
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
508
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
479
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
480
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
512
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
484
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
513
485
<td> the begin iterator for <em class="parameter"><code>seq</code></em>.
519
<p class="since">Since 2.14
491
<p class="since">Since 2.14</p>
523
494
<div class="refsect2" lang="en">
524
<a name="id3332130"></a><h3>
525
<a name="g-sequence-get-end-iter"></a>g_sequence_get_end_iter ()</h3>
526
<a class="indexterm" name="id3332145"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_get_end_iter (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq);</pre>
495
<a name="g-sequence-get-end-iter"></a><h3>g_sequence_get_end_iter ()</h3>
496
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_get_end_iter (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq);</pre>
528
498
Returns the end iterator for <em class="parameter"><code>seg</code></em></p>
532
501
<div class="variablelist"><table border="0">
533
502
<col align="left" valign="top">
536
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
537
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
505
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
506
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
541
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
510
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
542
511
<td> the end iterator for <em class="parameter"><code>seq</code></em>
548
<p class="since">Since 2.14
517
<p class="since">Since 2.14</p>
552
520
<div class="refsect2" lang="en">
553
<a name="id3332231"></a><h3>
554
<a name="g-sequence-get-iter-at-pos"></a>g_sequence_get_iter_at_pos ()</h3>
555
<a class="indexterm" name="id3332247"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_get_iter_at_pos (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
556
<a class="link" href="glib-Basic-Types.html#gint">gint</a> pos);</pre>
521
<a name="g-sequence-get-iter-at-pos"></a><h3>g_sequence_get_iter_at_pos ()</h3>
522
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_get_iter_at_pos (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
523
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> pos);</pre>
558
525
Returns the iterator at position <em class="parameter"><code>pos</code></em>. If <em class="parameter"><code>pos</code></em> is negative or larger
559
526
than the number of items in <em class="parameter"><code>seq</code></em>, the end iterator is returned.</p>
563
529
<div class="variablelist"><table border="0">
564
530
<col align="left" valign="top">
567
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
568
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
533
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
534
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
572
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
538
<td><p><span class="term"><em class="parameter"><code>pos</code></em> :</span></p></td>
573
539
<td> a position in <em class="parameter"><code>seq</code></em>, or -1 for the end.
577
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
578
<td> The <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> at position <em class="parameter"><code>pos</code></em>
543
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
544
<td> The <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> at position <em class="parameter"><code>pos</code></em>
584
<p class="since">Since 2.14
550
<p class="since">Since 2.14</p>
588
553
<div class="refsect2" lang="en">
589
<a name="id3332382"></a><h3>
590
<a name="g-sequence-append"></a>g_sequence_append ()</h3>
591
<a class="indexterm" name="id3332397"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_append (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
592
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
554
<a name="g-sequence-append"></a><h3>g_sequence_append ()</h3>
555
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_append (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
556
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
594
558
Adds a new item to the end of <em class="parameter"><code>seq</code></em>.</p>
598
561
<div class="variablelist"><table border="0">
599
562
<col align="left" valign="top">
602
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
565
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
603
566
<td> a <span class="type">GSequencePointer</span>
607
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
570
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
608
571
<td> the data for the new item
612
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
575
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
613
576
<td> an iterator pointing to the new item
619
<p class="since">Since 2.14
582
<p class="since">Since 2.14</p>
623
585
<div class="refsect2" lang="en">
624
<a name="id3332501"></a><h3>
625
<a name="g-sequence-prepend"></a>g_sequence_prepend ()</h3>
626
<a class="indexterm" name="id3332517"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_prepend (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
627
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
586
<a name="g-sequence-prepend"></a><h3>g_sequence_prepend ()</h3>
587
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_prepend (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
588
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
629
590
Adds a new item to the front of <em class="parameter"><code>seq</code></em></p>
633
593
<div class="variablelist"><table border="0">
634
594
<col align="left" valign="top">
637
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
638
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
597
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
598
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
642
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
602
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
643
603
<td> the data for the new item
647
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
607
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
648
608
<td> an iterator pointing to the new item
654
<p class="since">Since 2.14
614
<p class="since">Since 2.14</p>
658
617
<div class="refsect2" lang="en">
659
<a name="id3332618"></a><h3>
660
<a name="g-sequence-insert-before"></a>g_sequence_insert_before ()</h3>
661
<a class="indexterm" name="id3332633"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_insert_before (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
662
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
618
<a name="g-sequence-insert-before"></a><h3>g_sequence_insert_before ()</h3>
619
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_insert_before (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
620
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
664
622
Inserts a new item just before the item pointed to by <em class="parameter"><code>iter</code></em>.</p>
668
625
<div class="variablelist"><table border="0">
669
626
<col align="left" valign="top">
672
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
673
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
629
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
630
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
677
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
634
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
678
635
<td> the data for the new item
682
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
639
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
683
640
<td> an iterator pointing to the new item
689
<p class="since">Since 2.14
646
<p class="since">Since 2.14</p>
693
649
<div class="refsect2" lang="en">
694
<a name="id3332738"></a><h3>
695
<a name="g-sequence-move"></a>g_sequence_move ()</h3>
696
<a class="indexterm" name="id3332753"></a><pre class="programlisting">void g_sequence_move (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *src,
697
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *dest);</pre>
650
<a name="g-sequence-move"></a><h3>g_sequence_move ()</h3>
651
<pre class="programlisting">void g_sequence_move (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *src,
652
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *dest);</pre>
699
654
Moves the item pointed to by <em class="parameter"><code>src</code></em> to the position indicated by <em class="parameter"><code>dest</code></em>.
700
655
After calling this function <em class="parameter"><code>dest</code></em> will point to the position immediately
701
656
after <em class="parameter"><code>src</code></em>. It is allowed for <em class="parameter"><code>src</code></em> and <em class="parameter"><code>dest</code></em> to point into different
706
660
<div class="variablelist"><table border="0">
707
661
<col align="left" valign="top">
710
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
711
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the item to move
664
<td><p><span class="term"><em class="parameter"><code>src</code></em> :</span></p></td>
665
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the item to move
715
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
716
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position to which
669
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
670
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position to which
717
671
the item is moved.
722
<p class="since">Since 2.14
676
<p class="since">Since 2.14</p>
726
679
<div class="refsect2" lang="en">
727
<a name="id3332887"></a><h3>
728
<a name="g-sequence-swap"></a>g_sequence_swap ()</h3>
729
<a class="indexterm" name="id3332903"></a><pre class="programlisting">void g_sequence_swap (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *a,
730
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *b);</pre>
680
<a name="g-sequence-swap"></a><h3>g_sequence_swap ()</h3>
681
<pre class="programlisting">void g_sequence_swap (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *a,
682
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *b);</pre>
732
684
Swaps the items pointed to by <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em>. It is allowed for <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em>
733
685
to point into difference sequences.</p>
737
688
<div class="variablelist"><table border="0">
738
689
<col align="left" valign="top">
741
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
742
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
692
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
693
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
746
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
747
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
697
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
698
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
752
<p class="since">Since 2.14
703
<p class="since">Since 2.14</p>
756
706
<div class="refsect2" lang="en">
757
<a name="id3333021"></a><h3>
758
<a name="g-sequence-insert-sorted"></a>g_sequence_insert_sorted ()</h3>
759
<a class="indexterm" name="id3333036"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_insert_sorted (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
760
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
761
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
762
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
707
<a name="g-sequence-insert-sorted"></a><h3>g_sequence_insert_sorted ()</h3>
708
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_insert_sorted (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
709
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
710
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
711
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);</pre>
764
713
Inserts <em class="parameter"><code>data</code></em> into <em class="parameter"><code>sequence</code></em> using <em class="parameter"><code>func</code></em> to determine the new position.
765
714
The sequence must already be sorted according to <em class="parameter"><code>cmp_func</code></em>; otherwise the
766
715
new position of <em class="parameter"><code>data</code></em> is undefined.</p>
770
718
<div class="variablelist"><table border="0">
771
719
<col align="left" valign="top">
774
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
775
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
722
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
723
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
779
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
727
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
780
728
<td> the data to insert
784
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
785
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> used to compare items in the sequence. It
732
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
733
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="type">GCompareDataFunc</span></a> used to compare items in the sequence. It
786
734
is called with two items of the <em class="parameter"><code>seq</code></em> and <em class="parameter"><code>user_data</code></em>. It should
787
735
return 0 if the items are equal, a negative value if the first
788
736
item comes before the second, and a positive value if the second
1018
949
removed from the sequence. If <em class="parameter"><code>dest</code></em> iter points to a place within
1019
950
the (<em class="parameter"><code>begin</code></em>, <em class="parameter"><code>end</code></em>) range, the range does not move.</p>
1023
953
<div class="variablelist"><table border="0">
1024
954
<col align="left" valign="top">
1027
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
1028
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1032
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
1033
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1037
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
1038
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
957
<td><p><span class="term"><em class="parameter"><code>dest</code></em> :</span></p></td>
958
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
962
<td><p><span class="term"><em class="parameter"><code>begin</code></em> :</span></p></td>
963
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
967
<td><p><span class="term"><em class="parameter"><code>end</code></em> :</span></p></td>
968
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1043
<p class="since">Since 2.14
973
<p class="since">Since 2.14</p>
1047
976
<div class="refsect2" lang="en">
1048
<a name="id3334265"></a><h3>
1049
<a name="g-sequence-search"></a>g_sequence_search ()</h3>
1050
<a class="indexterm" name="id3334280"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_search (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
1051
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
1052
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
1053
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
977
<a name="g-sequence-search"></a><h3>g_sequence_search ()</h3>
978
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_search (<a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> *seq,
979
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
980
<a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> cmp_func,
981
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> cmp_data);</pre>
1055
983
Returns an iterator pointing to the position where <em class="parameter"><code>data</code></em> would
1056
984
be inserted according to <em class="parameter"><code>cmp_func</code></em> and <em class="parameter"><code>cmp_data</code></em>.</p>
1060
987
<div class="variablelist"><table border="0">
1061
988
<col align="left" valign="top">
1064
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
1065
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
991
<td><p><span class="term"><em class="parameter"><code>seq</code></em> :</span></p></td>
992
<td> a <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a>
1069
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
996
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1070
997
<td> data for the new item
1074
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
1075
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> used to compare items in the sequence. It
1001
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em> :</span></p></td>
1002
<td> the <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="type">GCompareDataFunc</span></a> used to compare items in the sequence. It
1076
1003
is called with two items of the <em class="parameter"><code>seq</code></em> and <em class="parameter"><code>user_data</code></em>. It should
1077
1004
return 0 if the items are equal, a negative value if the first
1078
1005
item comes before the second, and a positive value if the second
1137
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
1061
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em> :</span></p></td>
1138
1062
<td> user data passed to <em class="parameter"><code>iter_cmp</code></em>
1142
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1143
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position in <em class="parameter"><code>seq</code></em>
1066
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1067
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position in <em class="parameter"><code>seq</code></em>
1144
1068
where <em class="parameter"><code>data</code></em> would have been inserted according to <em class="parameter"><code>iter_cmp</code></em> and <em class="parameter"><code>cmp_data</code></em>.
1150
<p class="since">Since 2.14
1074
<p class="since">Since 2.14</p>
1154
1077
<div class="refsect2" lang="en">
1155
<a name="id3334740"></a><h3>
1156
<a name="g-sequence-get"></a>g_sequence_get ()</h3>
1157
<a class="indexterm" name="id3334755"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> g_sequence_get (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1078
<a name="g-sequence-get"></a><h3>g_sequence_get ()</h3>
1079
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> g_sequence_get (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1159
1081
Returns the data that <em class="parameter"><code>iter</code></em> points to.</p>
1163
1084
<div class="variablelist"><table border="0">
1164
1085
<col align="left" valign="top">
1167
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1168
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1088
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1089
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1172
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1093
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1173
1094
<td> the data that <em class="parameter"><code>iter</code></em> points to
1179
<p class="since">Since 2.14
1100
<p class="since">Since 2.14</p>
1183
1103
<div class="refsect2" lang="en">
1184
<a name="id3334843"></a><h3>
1185
<a name="g-sequence-set"></a>g_sequence_set ()</h3>
1186
<a class="indexterm" name="id3334858"></a><pre class="programlisting">void g_sequence_set (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
1187
<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
1104
<a name="g-sequence-set"></a><h3>g_sequence_set ()</h3>
1105
<pre class="programlisting">void g_sequence_set (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
1106
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
1189
1108
Changes the data for the item pointed to by <em class="parameter"><code>iter</code></em> to be <em class="parameter"><code>data</code></em>. If
1190
1109
the sequence has a data destroy function associated with it, that
1191
1110
function is called on the existing data that <em class="parameter"><code>iter</code></em> pointed to.</p>
1195
1113
<div class="variablelist"><table border="0">
1196
1114
<col align="left" valign="top">
1199
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1200
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1117
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1118
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1204
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1122
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1205
1123
<td> new data for the item
1210
<p class="since">Since 2.14
1128
<p class="since">Since 2.14</p>
1214
1131
<div class="refsect2" lang="en">
1215
<a name="id3334965"></a><h3>
1216
<a name="g-sequence-iter-is-begin"></a>g_sequence_iter_is_begin ()</h3>
1217
<a class="indexterm" name="id3334980"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_sequence_iter_is_begin (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1132
<a name="g-sequence-iter-is-begin"></a><h3>g_sequence_iter_is_begin ()</h3>
1133
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_sequence_iter_is_begin (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1219
1135
Returns whether <em class="parameter"><code>iter</code></em> is the begin iterator</p>
1223
1138
<div class="variablelist"><table border="0">
1224
1139
<col align="left" valign="top">
1227
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1228
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1142
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1143
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1232
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1147
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1233
1148
<td> whether <em class="parameter"><code>iter</code></em> is the begin iterator
1239
<p class="since">Since 2.14
1154
<p class="since">Since 2.14</p>
1243
1157
<div class="refsect2" lang="en">
1244
<a name="id3335069"></a><h3>
1245
<a name="g-sequence-iter-is-end"></a>g_sequence_iter_is_end ()</h3>
1246
<a class="indexterm" name="id3335084"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> g_sequence_iter_is_end (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1158
<a name="g-sequence-iter-is-end"></a><h3>g_sequence_iter_is_end ()</h3>
1159
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean" title="gboolean">gboolean</a> g_sequence_iter_is_end (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1248
1161
Returns whether <em class="parameter"><code>iter</code></em> is the end iterator</p>
1252
1164
<div class="variablelist"><table border="0">
1253
1165
<col align="left" valign="top">
1256
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1257
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1168
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1169
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1261
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1173
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1262
1174
<td> Whether <em class="parameter"><code>iter</code></em> is the end iterator.
1268
<p class="since">Since 2.14
1180
<p class="since">Since 2.14</p>
1272
1183
<div class="refsect2" lang="en">
1273
<a name="id3335172"></a><h3>
1274
<a name="g-sequence-iter-next"></a>g_sequence_iter_next ()</h3>
1275
<a class="indexterm" name="id3335188"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_iter_next (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1184
<a name="g-sequence-iter-next"></a><h3>g_sequence_iter_next ()</h3>
1185
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_iter_next (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1277
1187
Returns an iterator pointing to the next position after <em class="parameter"><code>iter</code></em>. If
1278
1188
<em class="parameter"><code>iter</code></em> is the end iterator, the end iterator is returned.</p>
1282
1191
<div class="variablelist"><table border="0">
1283
1192
<col align="left" valign="top">
1286
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1287
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1195
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1196
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1291
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1292
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the next position after <em class="parameter"><code>iter</code></em>.
1200
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1201
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the next position after <em class="parameter"><code>iter</code></em>.
1298
<p class="since">Since 2.14
1207
<p class="since">Since 2.14</p>
1302
1210
<div class="refsect2" lang="en">
1303
<a name="id3335292"></a><h3>
1304
<a name="g-sequence-iter-prev"></a>g_sequence_iter_prev ()</h3>
1305
<a class="indexterm" name="id3335307"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_iter_prev (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1211
<a name="g-sequence-iter-prev"></a><h3>g_sequence_iter_prev ()</h3>
1212
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_iter_prev (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1307
1214
Returns an iterator pointing to the previous position before <em class="parameter"><code>iter</code></em>. If
1308
1215
<em class="parameter"><code>iter</code></em> is the begin iterator, the begin iterator is returned.</p>
1312
1218
<div class="variablelist"><table border="0">
1313
1219
<col align="left" valign="top">
1316
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1317
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1222
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1223
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1321
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1322
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the previous position before
1227
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1228
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the previous position before
1323
1229
<em class="parameter"><code>iter</code></em>.
1329
<p class="since">Since 2.14
1235
<p class="since">Since 2.14</p>
1333
1238
<div class="refsect2" lang="en">
1334
<a name="id3335411"></a><h3>
1335
<a name="g-sequence-iter-get-position"></a>g_sequence_iter_get_position ()</h3>
1336
<a class="indexterm" name="id3335427"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_sequence_iter_get_position (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1239
<a name="g-sequence-iter-get-position"></a><h3>g_sequence_iter_get_position ()</h3>
1240
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_sequence_iter_get_position (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1338
1242
Returns the position of <em class="parameter"><code>iter</code></em></p>
1342
1245
<div class="variablelist"><table border="0">
1343
1246
<col align="left" valign="top">
1346
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1347
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1249
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1250
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1351
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1352
1255
<td> the position of <em class="parameter"><code>iter</code></em>
1358
<p class="since">Since 2.14
1261
<p class="since">Since 2.14</p>
1362
1264
<div class="refsect2" lang="en">
1363
<a name="id3335514"></a><h3>
1364
<a name="g-sequence-iter-move"></a>g_sequence_iter_move ()</h3>
1365
<a class="indexterm" name="id3335530"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>* g_sequence_iter_move (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter,
1366
<a class="link" href="glib-Basic-Types.html#gint">gint</a> delta);</pre>
1265
<a name="g-sequence-iter-move"></a><h3>g_sequence_iter_move ()</h3>
1266
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> * g_sequence_iter_move (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter,
1267
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> delta);</pre>
1368
Returns the <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em> positions away from <em class="parameter"><code>iter</code></em>.
1269
Returns the <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em> positions away from <em class="parameter"><code>iter</code></em>.
1369
1270
If <em class="parameter"><code>iter</code></em> is closer than -<em class="parameter"><code>delta</code></em> positions to the beginning of the sequence,
1370
1271
the begin iterator is returned. If <em class="parameter"><code>iter</code></em> is closer than <em class="parameter"><code>delta</code></em> positions
1371
1272
to the end of the sequence, the end iterator is returned.</p>
1375
1275
<div class="variablelist"><table border="0">
1376
1276
<col align="left" valign="top">
1379
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1380
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1279
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1280
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1384
<td><p><span class="term"><em class="parameter"><code>delta</code></em> :</span></p></td>
1284
<td><p><span class="term"><em class="parameter"><code>delta</code></em> :</span></p></td>
1385
1285
<td> A positive or negative number indicating how many positions away
1386
from <em class="parameter"><code>iter</code></em> the returned <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> will be.
1286
from <em class="parameter"><code>iter</code></em> the returned <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> will be.
1390
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1391
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em> positions away from <em class="parameter"><code>iter</code></em>.
1290
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1291
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a> which is <em class="parameter"><code>delta</code></em> positions away from <em class="parameter"><code>iter</code></em>.
1397
<p class="since">Since 2.14
1297
<p class="since">Since 2.14</p>
1401
1300
<div class="refsect2" lang="en">
1402
<a name="id3335710"></a><h3>
1403
<a name="g-sequence-iter-get-sequence"></a>g_sequence_iter_get_sequence ()</h3>
1404
<a class="indexterm" name="id3335726"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequence">GSequence</a>* g_sequence_iter_get_sequence (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
1406
Returns the <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em> points into.</p>
1301
<a name="g-sequence-iter-get-sequence"></a><h3>g_sequence_iter_get_sequence ()</h3>
1302
<pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequence" title="GSequence">GSequence</a> * g_sequence_iter_get_sequence (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *iter);</pre>
1304
Returns the <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em> points into.</p>
1410
1307
<div class="variablelist"><table border="0">
1411
1308
<col align="left" valign="top">
1414
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1415
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
1311
<td><p><span class="term"><em class="parameter"><code>iter</code></em> :</span></p></td>
1312
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter"><span class="type">GSequenceIter</span></a>
1419
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1420
<td> the <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em> points into.
1316
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1317
<td> the <a class="link" href="glib-Sequences.html#GSequence" title="GSequence"><span class="type">GSequence</span></a> that <em class="parameter"><code>iter</code></em> points into.
1426
<p class="since">Since 2.14
1323
<p class="since">Since 2.14</p>
1430
1326
<div class="refsect2" lang="en">
1431
<a name="id3335830"></a><h3>
1432
<a name="g-sequence-iter-compare"></a>g_sequence_iter_compare ()</h3>
1433
<a class="indexterm" name="id3335845"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a> g_sequence_iter_compare (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *a,
1434
<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *b);</pre>
1327
<a name="g-sequence-iter-compare"></a><h3>g_sequence_iter_compare ()</h3>
1328
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> g_sequence_iter_compare (<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *a,
1329
<a class="link" href="glib-Sequences.html#GSequenceIter" title="GSequenceIter">GSequenceIter</a> *b);</pre>
1436
1331
Returns a negative number if <em class="parameter"><code>a</code></em> comes before <em class="parameter"><code>b</code></em>, 0 if they are equal,
1437
1332
and a positive number if <em class="parameter"><code>a</code></em> comes after <em class="parameter"><code>b</code></em>.