📄 glib-pointer-arrays.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Pointer Arrays</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GLib Reference Manual"><link rel="up" href="glib-data-types.html" title="GLib Data Types"><link rel="prev" href="glib-Arrays.html" title="Arrays"><link rel="next" href="glib-Byte-Arrays.html" title="Byte Arrays"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="glib.html" title="GLib Overview"><link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals"><link rel="chapter" href="glib-core.html" title="GLib Core Application Support"><link rel="chapter" href="glib-utilities.html" title="GLib Utilities"><link rel="chapter" href="glib-data-types.html" title="GLib Data Types"><link rel="chapter" href="tools.html" title="GLib Tools"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"><link rel="index" href="ix09.html" title="Index of new symbols in 2.14"><link rel="index" href="ix10.html" title="Index of new symbols in 2.16"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="glib-Arrays.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="glib-data-types.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GLib Reference Manual</th><td><a accesskey="n" href="glib-Byte-Arrays.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3320735" class="shortcut">Top</a>  |  <a href="#id3321164" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="glib-Pointer-Arrays"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3320735"></a><span class="refentrytitle">Pointer Arrays</span></h2><p>Pointer Arrays — arrays of pointers to any type of data, which grow automatically as newelements are added</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <glib.h> <a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a>;<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a>* <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-new">g_ptr_array_new</a> (void);<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a>* <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-sized-new">g_ptr_array_sized_new</a> (<a class="link" href="glib-Basic-Types.html#guint">guint</a> reserved_size);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-add">g_ptr_array_add</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove">g_ptr_array_remove</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-index">g_ptr_array_remove_index</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#guint">guint</a> index_);<a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-fast">g_ptr_array_remove_fast</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> data);<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-index-fast">g_ptr_array_remove_index_fast</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#guint">guint</a> index_);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-range">g_ptr_array_remove_range</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#guint">guint</a> index_, <a class="link" href="glib-Basic-Types.html#guint">guint</a> length);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-sort">g_ptr_array_sort</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> compare_func);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-sort-with-data">g_ptr_array_sort_with_data</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> compare_func, <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-set-size">g_ptr_array_set_size</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#gint">gint</a> length);#define <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-index">g_ptr_array_index</a> (array,index_)<a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a>* <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-free">g_ptr_array_free</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a> free_seg);void <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-foreach">g_ptr_array_foreach</a> (<a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a> *array, <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></div><div class="refsect1" lang="en"><a name="id3321164"></a><h2>Description</h2><p>Pointer Arrays are similar to Arrays but are used only for storing pointers.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>If you remove elements from the array, elements at the end of the arrayare moved into the space previously occupied by the removed element.This means that you should not rely on the index of particular elementsremaining the same. You should also be careful when deleting elements whileiterating over the array.</p></div><p>To create a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-new"><code class="function">g_ptr_array_new()</code></a>.</p><p>To add elements to a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-add"><code class="function">g_ptr_array_add()</code></a>.</p><p>To remove elements from a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove"><code class="function">g_ptr_array_remove()</code></a>,<a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-index"><code class="function">g_ptr_array_remove_index()</code></a> or <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-remove-index-fast"><code class="function">g_ptr_array_remove_index_fast()</code></a>.</p><p>To access an element of a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-index"><code class="function">g_ptr_array_index()</code></a>.</p><p>To set the size of a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-set-size"><code class="function">g_ptr_array_set_size()</code></a>.</p><p>To free a pointer array, use <a class="link" href="glib-Pointer-Arrays.html#g-ptr-array-free"><code class="function">g_ptr_array_free()</code></a>.</p><div class="example"><a name="id3321300"></a><p class="title"><b>Example 21. Using a <span class="structname">GPtrArray</span></b></p><div class="example-contents"><pre class="programlisting"> GPtrArray *gparray; gchar *string1 = "one", *string2 = "two", *string3 = "three"; gparray = g_ptr_array_new (); g_ptr_array_add (gparray, (gpointer) string1); g_ptr_array_add (gparray, (gpointer) string2); g_ptr_array_add (gparray, (gpointer) string3); if (g_ptr_array_index (gparray, 0) != (gpointer) string1) g_print ("ERROR: got %p instead of %p\n", g_ptr_array_index (gparray, 0), string1); g_ptr_array_free (gparray, TRUE);</pre></div></div><br class="example-break"></div><div class="refsect1" lang="en"><a name="id3321319"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3321336"></a><h3><a name="GPtrArray"></a>GPtrArray</h3><a class="indexterm" name="id3321348"></a><pre class="programlisting">typedef struct { gpointer *pdata; guint len;} GPtrArray;</pre><p>Contains the public fields of a pointer array.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> *<em class="structfield"><code>pdata</code></em>;</span></p></td><td>points to the array of pointers, which may be moved when the array grows.</td></tr><tr><td><p><span class="term"><a class="link" href="glib-Basic-Types.html#guint">guint</a> <em class="structfield"><code>len</code></em>;</span></p></td><td>number of pointers in the array.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3321411"></a><h3><a name="g-ptr-array-new"></a>g_ptr_array_new ()</h3><a class="indexterm" name="id3321424"></a><pre class="programlisting"><a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a>* g_ptr_array_new (void);</pre><p>Creates a new <a class="link" href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</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> :</span></p></td><td>the new <a class="link" href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id3321476"></a><h3><a name="g-ptr-array-sized-new"></a>g_ptr_array_sized_new ()</h3><a class="indexterm" name="id3321489"></a><pre class="programlisting"><a class="link" href="glib-Pointer-Arrays.html#GPtrArray">GPtrArray</a>* g_ptr_array_sized_new (<a class="link" href="glib-Basic-Types.html#guint">guint</a> reserved_size);</pre><p>Creates a new <a class="link" href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> with <em class="parameter"><code>reserved_size</code></em> pointerspreallocated. This avoids frequent reallocation, if you are going toadd many pointers to the array. Note however that the size of thearray is still 0.</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><p><span class="term"><em class="parameter"><code>reserved_size</code></em> :</span></p></td><td>number of pointers preallocated.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a>.</td></tr></tbody>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -