← Back to branch summary

~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gobject/html/gobject-Value-arrays.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-09 11:28:22 UTC
  • mfrom: (3.4.8 experimental)
  • Revision ID: james.westby@ubuntu.com-20100309112822-j4n0v3xbtsup8s97
Tags: 2.23.5-1ubuntu1
* Resync on Debian
* debian/patches/01_gettext-desktopfiles.patch:
  - updated to use gettext for X-GNOME-Fullname too
* debian/patches/71_gio_launch_handler.patch:
  - new gio default launch handle feature required for wncksync
* debian/control.in, 
  debian/patches/80-gtester-subunit.patch:
  - gtester-report subunit support
* debian/libglib2.0-0.symbols:
  - updated the symbols list for the gio launcher handler
* debian/rules:
  - don't break build on test suite errors, debian recently activated this but
    the build breaks even when there is no error in the testsuite

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gobject/html/gobject-Value-arrays.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Value arrays</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="GObject Reference Manual">
8
8
<link rel="up" href="rn01.html" title="API Reference">
9
9
<link rel="prev" href="gobject-Closures.html" title="Closures">
10
10
<link rel="next" href="rn02.html" title="Tools Reference">
11
 
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="preface" href="pr01.html" title="Introduction">
14
14
<link rel="part" href="pt01.html" title="Part I. Concepts">
52
52
</tr>
53
53
<tr><td colspan="5" class="shortcuts">
54
54
<a href="#gobject-Value-arrays.synopsis" class="shortcut">Top</a>
55
 
                   | 
56
 
                  <a href="#gobject-Value-arrays.description" class="shortcut">Description</a>
 
55
                 | 
 
56
                <a href="#gobject-Value-arrays.description" class="shortcut">Description</a>
57
57
</td></tr>
58
58
</table>
59
59
<div class="refentry" title="Value arrays">
69
69
<div class="refsynopsisdiv" title="Synopsis">
70
70
<a name="gobject-Value-arrays.synopsis"></a><h2>Synopsis</h2>
71
71
<pre class="synopsis">
 
72
 
72
73
#include &lt;glib-object.h&gt;
73
74
 
74
75
                    <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>;
75
 
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a>*             <a class="link" href="gobject-Value-arrays.html#g-value-array-get-nth" title="g_value_array_get_nth ()">g_value_array_get_nth</a>               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
76
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_);
77
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-new" title="g_value_array_new ()">g_value_array_new</a>                   (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_prealloced);
78
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-copy" title="g_value_array_copy ()">g_value_array_copy</a>                  (const <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array);
79
 
<span class="returnvalue">void</span>                <a class="link" href="gobject-Value-arrays.html#g-value-array-free" title="g_value_array_free ()">g_value_array_free</a>                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array);
80
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-append" title="g_value_array_append ()">g_value_array_append</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
81
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);
82
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-prepend" title="g_value_array_prepend ()">g_value_array_prepend</a>               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
83
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);
84
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-insert" title="g_value_array_insert ()">g_value_array_insert</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
85
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_,
86
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);
87
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-remove" title="g_value_array_remove ()">g_value_array_remove</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
88
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_);
89
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-sort" title="g_value_array_sort ()">g_value_array_sort</a>                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
90
 
                                                         <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="returnvalue">GCompareFunc</span></a> compare_func);
91
 
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-sort-with-data" title="g_value_array_sort_with_data ()">g_value_array_sort_with_data</a>        (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
92
 
                                                         <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="returnvalue">GCompareDataFunc</span></a> compare_func,
93
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 
76
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a>*             <a class="link" href="gobject-Value-arrays.html#g-value-array-get-nth" title="g_value_array_get_nth ()">g_value_array_get_nth</a>               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
77
                                                         <a
 
78
href="./../glib/glib/glib-Basic-Types.html#guint"
 
79
>guint</a> index_);
 
80
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-new" title="g_value_array_new ()">g_value_array_new</a>                   (<a
 
81
href="./../glib/glib/glib-Basic-Types.html#guint"
 
82
>guint</a> n_prealloced);
 
83
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-copy" title="g_value_array_copy ()">g_value_array_copy</a>                  (const <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array);
 
84
void                <a class="link" href="gobject-Value-arrays.html#g-value-array-free" title="g_value_array_free ()">g_value_array_free</a>                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array);
 
85
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-append" title="g_value_array_append ()">g_value_array_append</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
86
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);
 
87
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-prepend" title="g_value_array_prepend ()">g_value_array_prepend</a>               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
88
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);
 
89
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-insert" title="g_value_array_insert ()">g_value_array_insert</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
90
                                                         <a
 
91
href="./../glib/glib/glib-Basic-Types.html#guint"
 
92
>guint</a> index_,
 
93
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);
 
94
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-remove" title="g_value_array_remove ()">g_value_array_remove</a>                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
95
                                                         <a
 
96
href="./../glib/glib/glib-Basic-Types.html#guint"
 
97
>guint</a> index_);
 
98
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-sort" title="g_value_array_sort ()">g_value_array_sort</a>                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
99
                                                         <a
 
100
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"
 
101
>GCompareFunc</a> compare_func);
 
102
<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        <a class="link" href="gobject-Value-arrays.html#g-value-array-sort-with-data" title="g_value_array_sort_with_data ()">g_value_array_sort_with_data</a>        (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
103
                                                         <a
 
104
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"
 
105
>GCompareDataFunc</a> compare_func,
 
106
                                                         <a
 
107
href="./../glib/glib/glib-Basic-Types.html#gpointer"
 
108
>gpointer</a> user_data);
94
109
</pre>
95
110
</div>
96
111
<div class="refsect1" title="Description">
99
114
The prime purpose of a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a> is for it to be used as an
100
115
object property that holds an array of values. A <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a> wraps
101
116
an array of <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> elements in order for it to be used as a boxed
102
 
type through <a class="link" href="gobject-Generic-values.html#G-TYPE-VALUE-ARRAY:CAPS" title="G_TYPE_VALUE_ARRAY"><code class="literal">G_TYPE_VALUE_ARRAY</code></a>.</p>
 
117
type through <a class="link" href="gobject-Generic-values.html#G-TYPE-VALUE-ARRAY--CAPS" title="G_TYPE_VALUE_ARRAY"><code class="literal">G_TYPE_VALUE_ARRAY</code></a>.</p>
 
118
<p>
 
119
</p>
103
120
</div>
104
121
<div class="refsect1" title="Details">
105
122
<a name="gobject-Value-arrays.details"></a><h2>Details</h2>
112
129
</pre>
113
130
<p>
114
131
A <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a> contains an array of <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> elements.</p>
 
132
<p>
 
133
</p>
115
134
<div class="variablelist"><table border="0">
116
135
<col align="left" valign="top">
117
136
<tbody>
118
137
<tr>
119
 
<td><p><span class="term"><a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> <em class="structfield"><code><a name="GValueArray.n-values"></a>n_values</code></em>;</span></p></td>
 
138
<td><p><span class="term"><a
 
139
href="./../glib/glib/glib-Basic-Types.html#guint"
 
140
>guint</a> <em class="structfield"><code>n_values</code></em>;</span></p></td>
120
141
<td> number of values contained in the array
121
142
</td>
122
143
</tr>
123
144
<tr>
124
 
<td><p><span class="term"><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *<em class="structfield"><code><a name="GValueArray.values"></a>values</code></em>;</span></p></td>
 
145
<td><p><span class="term"><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *<em class="structfield"><code>values</code></em>;</span></p></td>
125
146
<td> array of values
126
147
</td>
127
148
</tr>
131
152
<hr>
132
153
<div class="refsect2" title="g_value_array_get_nth ()">
133
154
<a name="g-value-array-get-nth"></a><h3>g_value_array_get_nth ()</h3>
134
 
<pre class="programlisting"><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a>*             g_value_array_get_nth               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
135
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_);</pre>
 
155
<pre class="programlisting"><a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a>*             g_value_array_get_nth               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
156
                                                         <a
 
157
href="./../glib/glib/glib-Basic-Types.html#guint"
 
158
>guint</a> index_);</pre>
136
159
<p>
137
160
Return a pointer to the value at <em class="parameter"><code>index_</code></em> containd in <em class="parameter"><code>value_array</code></em>.</p>
 
161
<p>
 
162
</p>
138
163
<div class="variablelist"><table border="0">
139
164
<col align="left" valign="top">
140
165
<tbody>
159
184
<hr>
160
185
<div class="refsect2" title="g_value_array_new ()">
161
186
<a name="g-value-array-new"></a><h3>g_value_array_new ()</h3>
162
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_new                   (<a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> n_prealloced);</pre>
 
187
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_new                   (<a
 
188
href="./../glib/glib/glib-Basic-Types.html#guint"
 
189
>guint</a> n_prealloced);</pre>
163
190
<p>
164
191
Allocate and initialize a new <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a>, optionally preserve space
165
192
for <em class="parameter"><code>n_prealloced</code></em> elements. New arrays always contain 0 elements,
166
193
regardless of the value of <em class="parameter"><code>n_prealloced</code></em>.</p>
 
194
<p>
 
195
</p>
167
196
<div class="variablelist"><table border="0">
168
197
<col align="left" valign="top">
169
198
<tbody>
183
212
<hr>
184
213
<div class="refsect2" title="g_value_array_copy ()">
185
214
<a name="g-value-array-copy"></a><h3>g_value_array_copy ()</h3>
186
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_copy                  (const <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array);</pre>
 
215
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_copy                  (const <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array);</pre>
187
216
<p>
188
217
Construct an exact copy of a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a> by duplicating all its
189
218
contents.</p>
 
219
<p>
 
220
</p>
190
221
<div class="variablelist"><table border="0">
191
222
<col align="left" valign="top">
192
223
<tbody>
206
237
<hr>
207
238
<div class="refsect2" title="g_value_array_free ()">
208
239
<a name="g-value-array-free"></a><h3>g_value_array_free ()</h3>
209
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_value_array_free                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array);</pre>
 
240
<pre class="programlisting">void                g_value_array_free                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array);</pre>
210
241
<p>
211
242
Free a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="type">GValueArray</span></a> including its contents.</p>
 
243
<p>
 
244
</p>
212
245
<div class="variablelist"><table border="0">
213
246
<col align="left" valign="top">
214
247
<tbody><tr>
221
254
<hr>
222
255
<div class="refsect2" title="g_value_array_append ()">
223
256
<a name="g-value-array-append"></a><h3>g_value_array_append ()</h3>
224
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_append                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
225
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);</pre>
 
257
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_append                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
258
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);</pre>
226
259
<p>
227
260
Insert a copy of <em class="parameter"><code>value</code></em> as last element of <em class="parameter"><code>value_array</code></em>.</p>
 
261
<p>
 
262
</p>
228
263
<div class="variablelist"><table border="0">
229
264
<col align="left" valign="top">
230
265
<tbody>
249
284
<hr>
250
285
<div class="refsect2" title="g_value_array_prepend ()">
251
286
<a name="g-value-array-prepend"></a><h3>g_value_array_prepend ()</h3>
252
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_prepend               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
253
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);</pre>
 
287
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_prepend               (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
288
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);</pre>
254
289
<p>
255
290
Insert a copy of <em class="parameter"><code>value</code></em> as first element of <em class="parameter"><code>value_array</code></em>.</p>
 
291
<p>
 
292
</p>
256
293
<div class="variablelist"><table border="0">
257
294
<col align="left" valign="top">
258
295
<tbody>
277
314
<hr>
278
315
<div class="refsect2" title="g_value_array_insert ()">
279
316
<a name="g-value-array-insert"></a><h3>g_value_array_insert ()</h3>
280
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_insert                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
281
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_,
282
 
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *value);</pre>
 
317
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_insert                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
318
                                                         <a
 
319
href="./../glib/glib/glib-Basic-Types.html#guint"
 
320
>guint</a> index_,
 
321
                                                         const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue">GValue</a> *value);</pre>
283
322
<p>
284
323
Insert a copy of <em class="parameter"><code>value</code></em> at specified position into <em class="parameter"><code>value_array</code></em>.</p>
 
324
<p>
 
325
</p>
285
326
<div class="variablelist"><table border="0">
286
327
<col align="left" valign="top">
287
328
<tbody>
311
352
<hr>
312
353
<div class="refsect2" title="g_value_array_remove ()">
313
354
<a name="g-value-array-remove"></a><h3>g_value_array_remove ()</h3>
314
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_remove                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
315
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a> index_);</pre>
 
355
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_remove                (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
356
                                                         <a
 
357
href="./../glib/glib/glib-Basic-Types.html#guint"
 
358
>guint</a> index_);</pre>
316
359
<p>
317
360
Remove the value at position <em class="parameter"><code>index_</code></em> from <em class="parameter"><code>value_array</code></em>.</p>
 
361
<p>
 
362
</p>
318
363
<div class="variablelist"><table border="0">
319
364
<col align="left" valign="top">
320
365
<tbody>
339
384
<hr>
340
385
<div class="refsect2" title="g_value_array_sort ()">
341
386
<a name="g-value-array-sort"></a><h3>g_value_array_sort ()</h3>
342
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_sort                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
343
 
                                                         <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="returnvalue">GCompareFunc</span></a> compare_func);</pre>
 
387
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_sort                  (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
388
                                                         <a
 
389
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"
 
390
>GCompareFunc</a> compare_func);</pre>
344
391
<p>
345
392
Sort <em class="parameter"><code>value_array</code></em> using <em class="parameter"><code>compare_func</code></em> to compare the elements accoring to
346
 
the semantics of <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a>.
 
393
the semantics of <a
 
394
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"
 
395
><span class="type">GCompareFunc</span></a>.
347
396
</p>
348
397
<p>
349
398
The current implementation uses Quick-Sort as sorting algorithm.</p>
 
399
<p>
 
400
</p>
350
401
<div class="variablelist"><table border="0">
351
402
<col align="left" valign="top">
352
403
<tbody>
371
422
<hr>
372
423
<div class="refsect2" title="g_value_array_sort_with_data ()">
373
424
<a name="g-value-array-sort-with-data"></a><h3>g_value_array_sort_with_data ()</h3>
374
 
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a>*        g_value_array_sort_with_data        (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray"><span class="returnvalue">GValueArray</span></a> *value_array,
375
 
                                                         <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="returnvalue">GCompareDataFunc</span></a> compare_func,
376
 
                                                         <a href="./../glib/glib/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
425
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a>*        g_value_array_sort_with_data        (<a class="link" href="gobject-Value-arrays.html#GValueArray" title="GValueArray">GValueArray</a> *value_array,
 
426
                                                         <a
 
427
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"
 
428
>GCompareDataFunc</a> compare_func,
 
429
                                                         <a
 
430
href="./../glib/glib/glib-Basic-Types.html#gpointer"
 
431
>gpointer</a> user_data);</pre>
377
432
<p>
378
433
Sort <em class="parameter"><code>value_array</code></em> using <em class="parameter"><code>compare_func</code></em> to compare the elements accoring
379
 
to the semantics of <a href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a>.
 
434
to the semantics of <a
 
435
href="./../glib/glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"
 
436
><span class="type">GCompareDataFunc</span></a>.
380
437
</p>
381
438
<p>
382
439
The current implementation uses Quick-Sort as sorting algorithm.</p>
 
440
<p>
 
441
</p>
383
442
<div class="variablelist"><table border="0">
384
443
<col align="left" valign="top">
385
444
<tbody>
409
468
</div>
410
469
<div class="refsect1" title="See Also">
411
470
<a name="gobject-Value-arrays.see-also"></a><h2>See Also</h2>
412
 
<a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a>, <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray" title="GParamSpecValueArray"><span class="type">GParamSpecValueArray</span></a>, <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-value-array" title="g_param_spec_value_array ()"><code class="function">g_param_spec_value_array()</code></a>
 
471
#GValue, <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#GParamSpecValueArray" title="GParamSpecValueArray"><span class="type">GParamSpecValueArray</span></a>, <a class="link" href="gobject-Standard-Parameter-and-Value-Types.html#g-param-spec-value-array" title="g_param_spec_value_array ()"><code class="function">g_param_spec_value_array()</code></a>
413
472
</div>
414
473
</div>
415
474
<div class="footer">
416
475
<hr>
417
 
          Generated by GTK-Doc V1.13</div>
 
476
          Generated by GTK-Doc V1.11</div>
418
477
</body>
419
 
</html>
 
 
b'\\ No newline at end of file'
 
478
</html>