glib-arrays.html

最新gtk中文资料集

</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
<a class="link" href="glib-Arrays.html#g-array-append-val"><code class="function">g_array_append_val()</code></a> is a macro which uses a reference to the value
parameter <em class="parameter"><code>v</code></em>. This means that you cannot use it with literal values
such as "27". You must use variables.
</p>
</div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>a</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em>&#160;:</span></p></td>
<td>the value to append to the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315880"></a><h3>
<a name="g-array-append-vals"></a>g_array_append_vals ()</h3>
<a class="indexterm" name="id3315893"></a><pre class="programlisting"><a class="link" href="glib-Arrays.html#GArray">GArray</a>*             g_array_append_vals                 (<a class="link" href="glib-Arrays.html#GArray">GArray</a> *array,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> len);</pre>
<p>
Adds <em class="parameter"><code>len</code></em> elements onto the end of the array.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>a pointer to the elements to append to the end of the array.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td>the number of elements to append.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316016"></a><h3>
<a name="g-array-prepend-val"></a>g_array_prepend_val()</h3>
<a class="indexterm" name="id3316029"></a><pre class="programlisting">#define             g_array_prepend_val(a,v)</pre>
<p>
Adds the value on to the start of the array.
The array will grow in size automatically if necessary.
</p>
<p>
This operation is slower than <a class="link" href="glib-Arrays.html#g-array-append-val"><code class="function">g_array_append_val()</code></a> since the existing elements
in the array have to be moved to make space for the new element.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
<a class="link" href="glib-Arrays.html#g-array-prepend-val"><code class="function">g_array_prepend_val()</code></a> is a macro which uses a reference to the value
parameter <em class="parameter"><code>v</code></em>. This means that you cannot use it with literal values
such as "27". You must use variables.
</p>
</div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>a</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em>&#160;:</span></p></td>
<td>the value to prepend to the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316153"></a><h3>
<a name="g-array-prepend-vals"></a>g_array_prepend_vals ()</h3>
<a class="indexterm" name="id3316166"></a><pre class="programlisting"><a class="link" href="glib-Arrays.html#GArray">GArray</a>*             g_array_prepend_vals                (<a class="link" href="glib-Arrays.html#GArray">GArray</a> *array,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> len);</pre>
<p>
Adds <em class="parameter"><code>len</code></em> elements onto the start of the array.
</p>
<p>
This operation is slower than <a class="link" href="glib-Arrays.html#g-array-append-vals"><code class="function">g_array_append_vals()</code></a> since the existing elements
in the array have to be moved to make space for the new elements.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>a pointer to the elements to prepend to the start of the array.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td>the number of elements to prepend.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316306"></a><h3>
<a name="g-array-insert-val"></a>g_array_insert_val()</h3>
<a class="indexterm" name="id3316319"></a><pre class="programlisting">#define             g_array_insert_val(a,i,v)</pre>
<p>
Inserts an element into an array at the given index.
</p>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
<a class="link" href="glib-Arrays.html#g-array-insert-val"><code class="function">g_array_insert_val()</code></a> is a macro which uses a reference to the value
parameter <em class="parameter"><code>v</code></em>. This means that you cannot use it with literal values
such as "27". You must use variables.
</p>
</div>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>a</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>i</code></em>&#160;:</span></p></td>
<td>the index to place the element at.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em>&#160;:</span></p></td>
<td>the value to insert into the array.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316432"></a><h3>
<a name="g-array-insert-vals"></a>g_array_insert_vals ()</h3>
<a class="indexterm" name="id3316445"></a><pre class="programlisting"><a class="link" href="glib-Arrays.html#GArray">GArray</a>*             g_array_insert_vals                 (<a class="link" href="glib-Arrays.html#GArray">GArray</a> *array,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> index_,
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> len);</pre>
<p>
Inserts <em class="parameter"><code>len</code></em> elements into a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a> at the given index.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></p></td>
<td>the index to place the elements at.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></p></td>
<td>a pointer to the elements to insert.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td>the number of elements to insert.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316598"></a><h3>
<a name="g-array-remove-index"></a>g_array_remove_index ()</h3>
<a class="indexterm" name="id3316611"></a><pre class="programlisting"><a class="link" href="glib-Arrays.html#GArray">GArray</a>*             g_array_remove_index                (<a class="link" href="glib-Arrays.html#GArray">GArray</a> *array,
                                                         <a class="link" href="glib-Basic-Types.html#guint">guint</a> index_);</pre>
<p>
Removes the element at the given index from a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
The following elements are moved down one place.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></p></td>
<td>a <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></p></td>
<td>the index 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>the <a class="link" href="glib-Arrays.html#GArray"><span class="type">GArray</span></a>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">