glib-singly-linked-lists.html

glid编写实例

<a name="id3118911"></a><h3>
<a name="g-slist-next"></a>g_slist_next()</h3>
<a class="indexterm" name="id3118921"></a><pre class="programlisting">#define     g_slist_next(slist)</pre>
<p>
A convenience macro to gets the next 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>slist</code></em>&#160;:</span></td>
<td>an element in 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 next element, or <code class="literal">NULL</code> if there are no more elements.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3118988"></a><h3>
<a name="g-slist-nth"></a>g_slist_nth ()</h3>
<a class="indexterm" name="id3118998"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_nth                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Basic-Types.html#guint">guint</a> n);</pre>
<p>
Gets the element at the given position 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"><em class="parameter"><code>n</code></em>&#160;:</span></td>
<td>the position of the element, counting from 0.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the element, or <code class="literal">NULL</code> if the position is off the end of 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="id3119107"></a><h3>
<a name="g-slist-nth-data"></a>g_slist_nth_data ()</h3>
<a class="indexterm" name="id3119118"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>    g_slist_nth_data                (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Basic-Types.html#guint">guint</a> n);</pre>
<p>
Gets the data of the element at the given position.
</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>n</code></em>&#160;:</span></td>
<td>the position of the element.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the element's data, or <code class="literal">NULL</code> if the position is off the end of 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="id3119219"></a><h3>
<a name="g-slist-find"></a>g_slist_find ()</h3>
<a class="indexterm" name="id3119230"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_find                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Finds the element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> which contains the given data.
</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>data</code></em>&#160;:</span></td>
<td>the element data to find.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the found <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element, or <code class="literal">NULL</code> if it is not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3119339"></a><h3>
<a name="g-slist-find-custom"></a>g_slist_find_custom ()</h3>
<a class="indexterm" name="id3119350"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*     g_slist_find_custom             (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
                                             <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> func);</pre>
<p>
Finds an element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>, using a supplied function to find the desired
element.
It iterates over the list, calling the given function which should return 0
when the desired element is found.
The function takes two <a href="glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> arguments, the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element's data
and the given user data.
</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>data</code></em>&#160;:</span></td>
<td>user data passed to the function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></td>
<td>the function to call for each element. It should return 0 when the
desired element is found.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the found <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element, or <code class="literal">NULL</code> if it is not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3119503"></a><h3>
<a name="g-slist-position"></a>g_slist_position ()</h3>
<a class="indexterm" name="id3119513"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>        g_slist_position                (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *llink);</pre>
<p>
Gets the position of the given element in the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> (starting from 0).
</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>llink</code></em>&#160;:</span></td>
<td>an element in the <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 position of the element in the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>, or -1 if the element
is not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3119624"></a><h3>
<a name="g-slist-index"></a>g_slist_index ()</h3>
<a class="indexterm" name="id3119635"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>        g_slist_index                   (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Gets the position of the element containing the given data (starting from 0).
</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>data</code></em>&#160;:</span></td>
<td>the data to find.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the index of the element containing the data, or -1 if the data
is not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3119724"></a><h3>
<a name="g-slist-push-allocator"></a>g_slist_push_allocator ()</h3>
<a class="indexterm" name="id3119735"></a><pre class="programlisting">void        g_slist_push_allocator          (<a href="glib-Memory-Allocators.html#GAllocator">GAllocator</a> *allocator);</pre>
<p>
Sets the allocator to use to allocate <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> elements.
Use <a href="glib-Singly-Linked-Lists.html#g-slist-pop-allocator"><code class="function">g_slist_pop_allocator()</code></a> to restore the previous allocator.
</p>
<p>
Note that this function is not available if GLib has been compiled
with <code class="option">--disable-mem-pools</code>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>allocator</code></em>&#160;:</span></td>
<td>the <a href="glib-Memory-Allocators.html#GAllocator"><span class="type">GAllocator</span></a> to use when allocating <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> elements.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3119826"></a><h3>
<a name="g-slist-pop-allocator"></a>g_slist_pop_allocator ()</h3>
<a class="indexterm" name="id3119837"></a><pre class="programlisting">void        g_slist_pop_allocator           (void);</pre>
<p>
Restores the previous <a href="glib-Memory-Allocators.html#GAllocator"><span class="type">GAllocator</span></a>, used when allocating <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> elements.
</p>
<p>
Note that this function is not available if GLib has been compiled
with <code class="option">--disable-mem-pools</code>
</p>
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="glib-Doubly-Linked-Lists.html"><b>&lt;&lt;&#160;Doubly-Linked Lists</b></a></td>
<td align="right"><a accesskey="n" href="glib-Double-ended-Queues.html"><b>Double-ended Queues&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>