glib-doubly-linked-lists.html

最新gtk中文资料集

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> the data of the element to remove
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3240346"></a><h3>
<a name="g-list-remove-link"></a>g_list_remove_link ()</h3>
<a class="indexterm" name="id3240359"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_list_remove_link                  (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *llink);</pre>
<p>
Removes an element from a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>, without freeing the element.
The removed element's prev and next links are set to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, so 
that it becomes a self-contained list with one element.</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>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>llink</code></em>&#160;:</span></p></td>
<td> an element in the <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the new start of the <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>, without the element
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3240485"></a><h3>
<a name="g-list-delete-link"></a>g_list_delete_link ()</h3>
<a class="indexterm" name="id3240498"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_list_delete_link                  (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *link_);</pre>
<p>
Removes the node link_ from the list and frees it. 
Compare this to <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-remove-link"><code class="function">g_list_remove_link()</code></a> which removes the node 
without freeing it.</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>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>link_</code></em>&#160;:</span></p></td>
<td> node to delete from <em class="parameter"><code>list</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the new head of <em class="parameter"><code>list</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3240611"></a><h3>
<a name="g-list-remove-all"></a>g_list_remove_all ()</h3>
<a class="indexterm" name="id3240624"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_list_remove_all                   (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Removes all list nodes with data equal to <em class="parameter"><code>data</code></em>. 
Returns the new head of the list. Contrast with 
<a class="link" href="glib-Doubly-Linked-Lists.html#g-list-remove"><code class="function">g_list_remove()</code></a> which removes only the first node 
matching the given data.</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>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data to remove
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> new head of <em class="parameter"><code>list</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3240739"></a><h3>
<a name="g-list-free"></a>g_list_free ()</h3>
<a class="indexterm" name="id3240751"></a><pre class="programlisting">void                g_list_free                         (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list);</pre>
<p>
Frees all of the memory used by a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>.
The freed elements are returned to the slice allocator.
</p>
<p>
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
If list elements contain dynamically-allocated memory, 
they should be freed first.
</p>
</div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" 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="id3240826"></a><h3>
<a name="g-list-alloc"></a>g_list_alloc ()</h3>
<a class="indexterm" name="id3240838"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_list_alloc                        (void);</pre>
<p>
Allocates space for one <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> element.
It is called by <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-append"><code class="function">g_list_append()</code></a>, <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-prepend"><code class="function">g_list_prepend()</code></a>, <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-insert"><code class="function">g_list_insert()</code></a> and
<a class="link" href="glib-Doubly-Linked-Lists.html#g-list-insert-sorted"><code class="function">g_list_insert_sorted()</code></a> and so is rarely used on its own.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>a pointer to the newly-allocated <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> element.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3240934"></a><h3>
<a name="g-list-free-1"></a>g_list_free_1 ()</h3>
<a class="indexterm" name="id3240947"></a><pre class="programlisting">void                g_list_free_1                       (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list);</pre>
<p>
Frees one <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> element.
It is usually used after <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-remove-link"><code class="function">g_list_remove_link()</code></a>.</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>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> element
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3241024"></a><h3>
<a name="g-list-free1"></a>g_list_free1</h3>
<a class="indexterm" name="id3241037"></a><pre class="programlisting">#define             g_list_free1</pre>
<p>
Another name for <a class="link" href="glib-Doubly-Linked-Lists.html#g-list-free-1"><code class="function">g_list_free_1()</code></a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3241063"></a><h3>
<a name="g-list-length"></a>g_list_length ()</h3>
<a class="indexterm" name="id3241075"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_list_length                       (<a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a> *list);</pre>
<p>
Gets the number of elements in a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>.
</p>
<p>
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
This function iterates over the whole list to 
count its elements.
</p>
</div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>list</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the number of elements in the <a class="link" 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="id3241167"></a><h3>