glib-singly-linked-lists.html

最新gtk中文资料集

<a class="indexterm" name="id3253930"></a><pre class="programlisting">#define             g_slist_next(slist)</pre>
<p>
A convenience macro to gets the next element in a <a class="link" 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><p><span class="term"><em class="parameter"><code>slist</code></em>&#160;:</span></p></td>
<td>an element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the next element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no more elements.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254002"></a><h3>
<a name="g-slist-nth"></a>g_slist_nth ()</h3>
<a class="indexterm" name="id3254014"></a><pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_nth                         (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n);</pre>
<p>
Gets the element at the given position in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n</code></em>&#160;:</span></p></td>
<td> the position of the element, counting from 0
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the position is off 
    the end of the <a class="link" 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="id3254131"></a><h3>
<a name="g-slist-nth-data"></a>g_slist_nth_data ()</h3>
<a class="indexterm" name="id3254144"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>            g_slist_nth_data                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> n);</pre>
<p>
Gets the data of the element at the given position.</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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n</code></em>&#160;:</span></p></td>
<td> the position of the element
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the element's data, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the position 
    is off the end of the <a class="link" 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="id3254253"></a><h3>
<a name="g-slist-find"></a>g_slist_find ()</h3>
<a class="indexterm" name="id3254266"></a><pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Finds the element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> which 
contains 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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> the element data to find
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the found <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element, 
    or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it is not found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254383"></a><h3>
<a name="g-slist-find-custom"></a>g_slist_find_custom ()</h3>
<a class="indexterm" name="id3254396"></a><pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find_custom                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> func);</pre>
<p>
Finds an element in a <a class="link" 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 class="link" href="glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> arguments, 
the <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element's data as the first argument and the 
given user 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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> user data passed to the function
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></p></td>
<td> the function to call for each element. 
    It should return 0 when the desired element is found
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the found <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if it is not found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3254557"></a><h3>
<a name="g-slist-position"></a>g_slist_position ()</h3>
<a class="indexterm" name="id3254570"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_slist_position                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *llink);</pre>
<p>
Gets the position of the given element 
in the <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> (starting from 0).</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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the position of the element in the <a class="link" 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="id3254685"></a><h3>
<a name="g-slist-index"></a>g_slist_index ()</h3>
<a class="indexterm" name="id3254698"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint">gint</a>                g_slist_index                       (<a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
                                                         <a class="link" 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>
<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-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> the data to find
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></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="id3254790"></a><h3>
<a name="g-slist-push-allocator"></a>g_slist_push_allocator ()</h3>
<a class="indexterm" name="id3254806"></a><pre class="programlisting">void                g_slist_push_allocator              (<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> dummy);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_slist_push_allocator</code> has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> has been
converted to the <a class="link" href="glib-Memory-Slices.html" title="Memory Slices">slice allocator</a></p>
</div>
<p>
Sets the allocator to use to allocate <a class="link" href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> elements.
Use <a class="link" 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 h