glib-double-ended-queues.html

最新gtk中文资料集

A statically-allocated <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a> must be initialized with this macro before it
can be used.  This macro can be used to initialize a variable, but it cannot
be assigned to a variable.  In that case you have to use <a class="link" href="glib-Double-ended-Queues.html#g-queue-init"><code class="function">g_queue_init()</code></a>.
</p>
<div class="informalexample"><pre class="programlisting">
GQueue my_queue = G_QUEUE_INIT;
</pre></div>
<p class="since">Since 2.14


</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3261650"></a><h3>
<a name="g-queue-init"></a>g_queue_init ()</h3>
<a class="indexterm" name="id3261665"></a><pre class="programlisting">void                g_queue_init                        (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
A statically-allocated <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a> must be initialized with this function
before it can be used. Alternatively you can initialize it with
<a class="link" href="glib-Double-ended-Queues.html#G-QUEUE-INIT:CAPS"><span class="type">G_QUEUE_INIT</span></a>. It is not necessary to initialize queues created with
<a class="link" href="glib-Double-ended-Queues.html#g-queue-new"><code class="function">g_queue_new()</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>queue</code></em>&#160;:</span></p></td>
<td> an uninitialized <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3261759"></a><h3>
<a name="g-queue-clear"></a>g_queue_clear ()</h3>
<a class="indexterm" name="id3261774"></a><pre class="programlisting">void                g_queue_clear                       (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
Removes all the elements in <em class="parameter"><code>queue</code></em>. If queue elements contain
dynamically-allocated memory, they should be freed first.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.14
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3261846"></a><h3>
<a name="g-queue-is-empty"></a>g_queue_is_empty ()</h3>
<a class="indexterm" name="id3261859"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_queue_is_empty                    (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
Returns <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the queue is empty.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the queue is empty.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3261948"></a><h3>
<a name="g-queue-get-length"></a>g_queue_get_length ()</h3>
<a class="indexterm" name="id3261964"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint">guint</a>               g_queue_get_length                  (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
Returns the number of items in <em class="parameter"><code>queue</code></em>.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</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 items in <em class="parameter"><code>queue</code></em>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3262050"></a><h3>
<a name="g-queue-reverse"></a>g_queue_reverse ()</h3>
<a class="indexterm" name="id3262065"></a><pre class="programlisting">void                g_queue_reverse                     (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
Reverses the order of the items in <em class="parameter"><code>queue</code></em>.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</td>
</tr></tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3262135"></a><h3>
<a name="g-queue-copy"></a>g_queue_copy ()</h3>
<a class="indexterm" name="id3262150"></a><pre class="programlisting"><a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a>*             g_queue_copy                        (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue);</pre>
<p>
Copies a <em class="parameter"><code>queue</code></em>. Note that is a shallow copy. If the elements in the
queue consist of pointers to data, the pointers are copied, but the
actual data is not.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> A copy of <em class="parameter"><code>queue</code></em>

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3262239"></a><h3>
<a name="g-queue-foreach"></a>g_queue_foreach ()</h3>
<a class="indexterm" name="id3262253"></a><pre class="programlisting">void                g_queue_foreach                     (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue,
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
<p>
Calls <em class="parameter"><code>func</code></em> for each element in the queue passing <em class="parameter"><code>user_data</code></em> to the
function.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</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's data
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td> user data to pass to <em class="parameter"><code>func</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3262380"></a><h3>
<a name="g-queue-find"></a>g_queue_find ()</h3>
<a class="indexterm" name="id3262395"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_queue_find                        (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
<p>
Finds the first link in <em class="parameter"><code>queue</code></em> which contains <em class="parameter"><code>data</code></em>.</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>queue</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td> data to find
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> The first link in <em class="parameter"><code>queue</code></em> which contains <em class="parameter"><code>data</code></em>.

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3262516"></a><h3>
<a name="g-queue-find-custom"></a>g_queue_find_custom ()</h3>
<a class="indexterm" name="id3262532"></a><pre class="programlisting"><a class="link" href="glib-Doubly-Linked-Lists.html#GList">GList</a>*              g_queue_find_custom                 (<a class="link" href="glib-Double-ended-Queues.html#GQueue">GQueue</a> *queue,
                                                         <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-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a>, using a supplied function to find the
desired element. It iterates over the queue, calling the given function
which should return 0 when the desired element is found. The function
takes two gconstpointer arguments, the <a class="link" href="glib-Double-ended-Queues.html#GQueue"><span class="type">GQueue</span></a> element's data as the
first argument and the given user data as the second argument.</p>