glib-sequences.html

最新gtk中文资料集

    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.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em>&#160;:</span></p></td>
<td> user data passed to <em class="parameter"><code>cmp_func</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3276849"></a><h3>
<a name="g-sequence-remove"></a>g_sequence_remove ()</h3>
<a class="indexterm" name="id3276864"></a><pre class="programlisting">void                g_sequence_remove                   (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *iter);</pre>
<p>
Removes the item pointed to by <em class="parameter"><code>iter</code></em>. It is an error to pass the
end iterator to this function.
</p>
<p>
If the sequnce has a data destroy function associated with it, this
function is called on the data for the removed item.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3276942"></a><h3>
<a name="g-sequence-remove-range"></a>g_sequence_remove_range ()</h3>
<a class="indexterm" name="id3276957"></a><pre class="programlisting">void                g_sequence_remove_range             (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
                                                         <a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end);</pre>
<p>
Removes all items in the (<em class="parameter"><code>begin</code></em>, <em class="parameter"><code>end</code></em>) range.
</p>
<p>
If the sequence has a data destroy function associated with it, this
function is called on the data for the removed items.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>begin</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>end</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3277069"></a><h3>
<a name="g-sequence-move-range"></a>g_sequence_move_range ()</h3>
<a class="indexterm" name="id3277084"></a><pre class="programlisting">void                g_sequence_move_range               (<a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *dest,
                                                         <a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *begin,
                                                         <a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a> *end);</pre>
<p>
Inserts the (<em class="parameter"><code>begin</code></em>, <em class="parameter"><code>end</code></em>) range at the destination pointed to by ptr.
The <em class="parameter"><code>begin</code></em> and <em class="parameter"><code>end</code></em> iters must point into the same sequence. It is
allowed for <em class="parameter"><code>dest</code></em> to point to a different sequence than the one pointed
into by <em class="parameter"><code>begin</code></em> and <em class="parameter"><code>end</code></em>.
</p>
<p>
If <em class="parameter"><code>dest</code></em> is NULL, the range indicated by <em class="parameter"><code>begin</code></em> and <em class="parameter"><code>end</code></em> is
removed from the sequence. If <em class="parameter"><code>dest</code></em> iter points to a place within
the (<em class="parameter"><code>begin</code></em>, <em class="parameter"><code>end</code></em>) range, the range does not move.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>dest</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>begin</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>end</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3277292"></a><h3>
<a name="g-sequence-search"></a>g_sequence_search ()</h3>
<a class="indexterm" name="id3277308"></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,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> cmp_func,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
<p>
Returns an iterator pointing to the position where <em class="parameter"><code>data</code></em> would
be inserted according to <em class="parameter"><code>cmp_func</code></em> and <em class="parameter"><code>cmp_data</code></em>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>seq</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data for the new item
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cmp_func</code></em>&#160;:</span></p></td>
<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
    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
    return 0 if the items are equal, a negative value if the first
    item comes before the second, and a positive value if the second
    item comes before the first.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em>&#160;:</span></p></td>
<td> user data passed to <em class="parameter"><code>cmp_func</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> an <a class="link" href="glib-Sequences.html#GSequenceIter"><span class="type">GSequenceIter</span></a> pointing to the position where <em class="parameter"><code>data</code></em>
would have been inserted according to <em class="parameter"><code>cmp_func</code></em> and <em class="parameter"><code>cmp_data</code></em>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3277524"></a><h3>
<a name="g-sequence-search-iter"></a>g_sequence_search_iter ()</h3>
<a class="indexterm" name="id3277540"></a><pre class="programlisting"><a class="link" href="glib-Sequences.html#GSequenceIter">GSequenceIter</a>*      g_sequence_search_iter              (<a class="link" href="glib-Sequences.html#GSequence">GSequence</a> *seq,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data,
                                                         <a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc">GSequenceIterCompareFunc</a> iter_cmp,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> cmp_data);</pre>
<p>
Like <a class="link" href="glib-Sequences.html#g-sequence-search"><code class="function">g_sequence_search()</code></a>, but uses
a <a class="link" href="glib-Sequences.html#GSequenceIterCompareFunc"><span class="type">GSequenceIterCompareFunc</span></a> instead of a <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> as
the compare function.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>seq</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Sequences.html#GSequence"><span class="type">GSequence</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data for the new item
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>iter_cmp</code></em>&#160;:</span></p></td>
<td> the <span class="type">GSequenceIterCompare</span> function used to compare iterators
    in the sequence. It is called with two iterators pointing into <em class="parameter"><code>seq</code></em>.
    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.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cmp_data</code></em>&#160;:</span></p></td>
<td> user data passed to <em class="parameter"><code>iter_cmp</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<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>
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>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3277768"></a><h3>
<a name="g-sequence-get"></a>g_sequence_get ()</h3>
<a class="indexterm" name="id3277782"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            g_sequence_get                      (<a class="link" href="glib-Sequen