It returns <code class="literal">TRUE</code> if the pointer was removed, or <code class="literal">FALSE</code> if the pointerwas not found.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>data</code></em>&#160;:</span></td><td>the pointer to remove.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td><code class="literal">TRUE</code> if the pointer was found in the array.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3163800"></a><h3><a name="g-ptr-array-remove-index-fast"></a>g_ptr_array_remove_index_fast ()</h3><a class="indexterm" name="id3163811"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>    g_ptr_array_remove_index_fast   (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Basic-Types.html#guint">guint</a> index_);</pre><p>Removes the pointer at the given index from the pointer array.The last element in the array is used to fill in the space, so this functiondoes not preserve the order of the array. But it is faster than<a href="glib-Pointer-Arrays.html#g-ptr-array-remove-index"><code class="function">g_ptr_array_remove_index()</code></a>.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></td><td>the index of the pointer to remove.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td>the pointer which was removed.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3163912"></a><h3><a name="g-ptr-array-remove-range"></a>g_ptr_array_remove_range ()</h3><a class="indexterm" name="id3163924"></a><pre class="programlisting">void        g_ptr_array_remove_range        (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Basic-Types.html#guint">guint</a> index_,                                             <a href="glib-Basic-Types.html#guint">guint</a> length);</pre><p>Removes the given number of pointers starting at the given index from a<a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.  The following elements are moved to close the gap.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <em class="parameter"><code>GPtrArray</code></em>.</td></tr><tr><td><span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></td><td>the index of the first pointer to remove.</td></tr><tr><td><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td><td>the number of pointers to remove.</td></tr></tbody></table></div><p>Since 2.4</p></div><hr><div class="refsect2" lang="en"><a name="id3164034"></a><h3><a name="g-ptr-array-sort"></a>g_ptr_array_sort ()</h3><a class="indexterm" name="id3164044"></a><pre class="programlisting">void        g_ptr_array_sort                (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> compare_func);</pre><p>Sorts the array, using <em class="parameter"><code>compare_func</code></em> which should be a <code class="function">qsort()</code>-style comparisonfunction (returns -1 for first arg is less than second arg, 0 for equal, 1 iffirst arg is greater than second arg).</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The comparison function for <a href="glib-Pointer-Arrays.html#g-ptr-array-sort"><code class="function">g_ptr_array_sort()</code></a> doesn't take the pointers from the array as arguments, it takes pointers to the pointers in the array.</p></div><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>compare_func</code></em>&#160;:</span></td><td>comparison function.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3164157"></a><h3><a name="g-ptr-array-sort-with-data"></a>g_ptr_array_sort_with_data ()</h3><a class="indexterm" name="id3164169"></a><pre class="programlisting">void        g_ptr_array_sort_with_data      (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> compare_func,                                             <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre><p>Like <a href="glib-Pointer-Arrays.html#g-ptr-array-sort"><code class="function">g_ptr_array_sort()</code></a>, but the comparison function has a user data argument.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The comparison function for <a href="glib-Pointer-Arrays.html#g-ptr-array-sort-with-data"><code class="function">g_ptr_array_sort_with_data()</code></a> doesn't take the pointers from the array as arguments, it takes pointers to the pointers in the array.</p></div><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>compare_func</code></em>&#160;:</span></td><td>comparison function.</td></tr><tr><td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td><td>data to pass to <em class="parameter"><code>compare_func</code></em>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3164302"></a><h3><a name="g-ptr-array-set-size"></a>g_ptr_array_set_size ()</h3><a class="indexterm" name="id3164313"></a><pre class="programlisting">void        g_ptr_array_set_size            (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Basic-Types.html#gint">gint</a> length);</pre><p>Sets the size of the array, expanding it if necessary.New elements are set to <code class="literal">NULL</code>.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>length</code></em>&#160;:</span></td><td>the new length of the pointer array.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3164396"></a><h3><a name="g-ptr-array-index"></a>g_ptr_array_index()</h3><a class="indexterm" name="id3164406"></a><pre class="programlisting">#define     g_ptr_array_index(array,index_)</pre><p>Returns the pointer at the given index of the pointer array.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>index_</code></em>&#160;:</span></td><td>the index of the pointer to return.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td>the pointer at the given index.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3164473"></a><h3><a name="g-ptr-array-free"></a>g_ptr_array_free ()</h3><a class="indexterm" name="id3164483"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>*   g_ptr_array_free                (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Basic-Types.html#gboolean">gboolean</a> free_seg);</pre><p>Frees all of the memory allocated for the pointer array.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td>a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr><tr><td><span class="term"><em class="parameter"><code>free_seg</code></em>&#160;:</span></td><td>if <code class="literal">TRUE</code> the array of pointers (<em class="parameter"><code>pdata</code></em>) is freed.</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td><td><code class="literal">NULL</code> if <em class="parameter"><code>free_seg</code></em> is <code class="literal">TRUE</code>, otherwise the array of pointers (<em class="parameter"><code>pdata</code></em>) is returned.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3164605"></a><h3><a name="g-ptr-array-foreach"></a>g_ptr_array_foreach ()</h3><a class="indexterm" name="id3164616"></a><pre class="programlisting">void        g_ptr_array_foreach             (<a href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array,                                             <a href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,                                             <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre><p>Calls a function for each element of a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>array</code></em>&#160;:</span></td><td> a <a href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a></td></tr><tr><td><span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></td><td> the function to call for each array element</td></tr><tr><td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td><td> user data to pass to the function</td></tr></tbody></table></div><p>Since  2.4</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-Arrays.html"><b>&lt;&lt;&#160;Arrays</b></a></td><td align="right"><a accesskey="n" href="glib-Byte-Arrays.html"><b>Byte Arrays&#160;&gt;&gt;</b></a></td></tr></table></body></html>