glib-doubly-linked-lists.html

glid编写实例

<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-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="id3109354"></a><h3>
<a name="g-list-nth-data"></a>g_list_nth_data ()</h3>
<a class="indexterm" name="id3109364"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>    g_list_nth_data                 (<a href="glib-Doubly-Linked-Lists.html#GList">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-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="id3109466"></a><h3>
<a name="g-list-nth-prev"></a>g_list_nth_prev ()</h3>
<a class="indexterm" name="id3109476"></a><pre class="programlisting"><a href="glib-Doubly-Linked-Lists.html#GList">GList</a>*      g_list_nth_prev                 (<a href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                             <a href="glib-Basic-Types.html#guint">guint</a> n);</pre>
<p>
Gets the element <em class="parameter"><code>n</code></em> places before <em class="parameter"><code>list</code></em>.
</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-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="id3109589"></a><h3>
<a name="g-list-find"></a>g_list_find ()</h3>
<a class="indexterm" name="id3109599"></a><pre class="programlisting"><a href="glib-Doubly-Linked-Lists.html#GList">GList</a>*      g_list_find                     (<a href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                             <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Finds the element in a <a href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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="id3109708"></a><h3>
<a name="g-list-find-custom"></a>g_list_find_custom ()</h3>
<a class="indexterm" name="id3109719"></a><pre class="programlisting"><a href="glib-Doubly-Linked-Lists.html#GList">GList</a>*      g_list_find_custom              (<a href="glib-Doubly-Linked-Lists.html#GList">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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="id3109871"></a><h3>
<a name="g-list-position"></a>g_list_position ()</h3>
<a class="indexterm" name="id3109881"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>        g_list_position                 (<a href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                             <a href="glib-Doubly-Linked-Lists.html#GList">GList</a> *llink);</pre>
<p>
Gets the position of the given element in the <a href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>, or -1 if the element is
not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3109993"></a><h3>
<a name="g-list-index"></a>g_list_index ()</h3>
<a class="indexterm" name="id3110003"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>        g_list_index                    (<a href="glib-Doubly-Linked-Lists.html#GList">GList</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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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="id3110091"></a><h3>
<a name="g-list-push-allocator"></a>g_list_push_allocator ()</h3>
<a class="indexterm" name="id3110102"></a><pre class="programlisting">void        g_list_push_allocator           (<a href="glib-Memory-Allocators.html#GAllocator">GAllocator</a> *allocator);</pre>
<p>
Sets the allocator to use to allocate <a href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> elements.
Use <a href="glib-Doubly-Linked-Lists.html#g-list-pop-allocator"><code class="function">g_list_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-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> elements.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3110193"></a><h3>
<a name="g-list-pop-allocator"></a>g_list_pop_allocator ()</h3>
<a class="indexterm" name="id3110204"></a><pre class="programlisting">void        g_list_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-Doubly-Linked-Lists.html#GList"><span class="type">GList</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-Memory-Chunks.html"><b>&lt;&lt;&#160;Memory Chunks</b></a></td>
<td align="right"><a accesskey="n" href="glib-Singly-Linked-Lists.html"><b>Singly-Linked Lists&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>