glib-singly-linked-lists.html

glid编写实例

<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3117924"></a><h3>
<a name="g-slist-free-1"></a>g_slist_free_1 ()</h3>
<a class="indexterm" name="id3117934"></a><pre class="programlisting">void        g_slist_free_1                  (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
<p>
Frees one <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element.
It is usually used after <a href="glib-Singly-Linked-Lists.html#g-slist-remove-link"><code class="function">g_slist_remove_link()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118008"></a><h3>
<a name="g-slist-length"></a>g_slist_length ()</h3>
<a class="indexterm" name="id3118018"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_slist_length                  (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
<p>
Gets the number of elements in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the number of elements in the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118099"></a><h3>
<a name="g-slist-copy"></a>g_slist_copy ()</h3>
<a class="indexterm" name="id3118109"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_copy                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
<p>
Copies a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</p>
<p>
Note that this is a "shallow" copy. If the list elements consist of pointers
to data, the pointers are copied but the actual data isn't.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>a copy of <em class="parameter"><code>list</code></em>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118193"></a><h3>
<a name="g-slist-reverse"></a>g_slist_reverse ()</h3>
<a class="indexterm" name="id3118203"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_reverse                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
<p>
Reverses a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the start of the reversed <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118284"></a><h3>
<a name="g-slist-sort"></a>g_slist_sort ()</h3>
<a class="indexterm" name="id3118294"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_sort                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> compare_func);</pre>
<p>
Sorts a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> using the given comparison function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>compare_func</code></em>&#160;:</span></td>
<td>
<code class="function"><code class="function">qsort()</code></code>-style comparison function.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the start of the sorted <a href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118413"></a><h3>
<a name="g-slist-sort-with-data"></a>g_slist_sort_with_data ()</h3>
<a class="indexterm" name="id3118424"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_sort_with_data          (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> compare_func,
                                             <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
<p>
Like <a href="glib-Singly-Linked-Lists.html#g-slist-sort"><code class="function">g_slist_sort()</code></a>, but the sort function accepts a user data argument.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>compare_func</code></em>&#160;:</span></td>
<td>comparison function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>data to pass to comparison function.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>new head of the list.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118543"></a><h3>
<a name="g-slist-concat"></a>g_slist_concat ()</h3>
<a class="indexterm" name="id3118554"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_concat                  (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list1,
                                             <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list2);</pre>
<p>
Adds the second <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> onto the end of the first <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
Note that the elements of the second <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> are not copied.
They are used directly.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list1</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>list2</code></em>&#160;:</span></td>
<td>the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> to add to the end of the first <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the start of the new <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118689"></a><h3>
<a name="g-slist-foreach"></a>g_slist_foreach ()</h3>
<a class="indexterm" name="id3118699"></a><pre class="programlisting">void        g_slist_foreach                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
                                             <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
<p>
Calls a function for each element of a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></td>
<td>the function to call with each element's data.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>user data to pass to the function.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118806"></a><h3>
<a name="g-slist-last"></a>g_slist_last ()</h3>
<a class="indexterm" name="id3118816"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_last                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
<p>
Gets the last element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></td>
<td>a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the last element in the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>, or <code class="literal">NULL</code> if the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> has no
elements.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">