← Back to branch summary

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

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Andreas Henriksson
  • Date: 2014-03-24 20:58:34 UTC
  • mfrom: (1.66.13)
  • Revision ID: package-import@ubuntu.com-20140324205834-8hsgok8k36ftocqa
Tags: 2.40.0-1
New upstream release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gobject/html/gobject-Value-arrays.html
147
147
object property that holds an array of values. A <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> wraps
148
148
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
149
149
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>
150
 
<p><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> is deprecated in favour of <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> since GLib 2.32. It
151
 
is possible to create a <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> that behaves like a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> by
 
150
<p><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> is deprecated in favour of <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> since GLib 2.32. It
 
151
is possible to create a <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> that behaves like a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> by
152
152
using the size of <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> as the element size, and by setting
153
 
<a class="link" href="gobject-Generic-values.html#g-value-unset" title="g_value_unset ()"><code class="function">g_value_unset()</code></a> as the clear function using <a href="../glib/glib-Arrays.html#g-array-set-clear-func"><code class="function">g_array_set_clear_func()</code></a>,
 
153
<a class="link" href="gobject-Generic-values.html#g-value-unset" title="g_value_unset ()"><code class="function">g_value_unset()</code></a> as the clear function using <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-set-clear-func"><code class="function">g_array_set_clear_func()</code></a>,
154
154
for instance, the following code:</p>
155
155
<div class="informalexample">
156
156
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
171
171
      <tr>
172
172
        <td class="listing_lines" align="right"><pre>1
173
173
2</pre></td>
174
 
        <td class="listing_code"><pre class="programlisting">GArray <span class="gtkdoc opt">*</span>array <span class="gtkdoc opt">=</span> <span class="function"><a href="../glib/glib-Arrays.html#g-array-sized-new">g_array_sized_new</a></span> <span class="gtkdoc opt">(</span>FALSE<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">,</span> <span class="keyword">sizeof</span> <span class="gtkdoc opt">(</span>GValue<span class="gtkdoc opt">),</span> <span class="number">10</span><span class="gtkdoc opt">);</span>
175
 
<span class="function"><a href="../glib/glib-Arrays.html#g-array-set-clear-func">g_array_set_clear_func</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> g_value_unset<span class="gtkdoc opt">);</span></pre></td>
 
174
        <td class="listing_code"><pre class="programlisting">GArray <span class="gtkdoc opt">*</span>array <span class="gtkdoc opt">=</span> <span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-sized-new">g_array_sized_new</a></span> <span class="gtkdoc opt">(</span>FALSE<span class="gtkdoc opt">,</span> TRUE<span class="gtkdoc opt">,</span> <span class="keyword">sizeof</span> <span class="gtkdoc opt">(</span>GValue<span class="gtkdoc opt">),</span> <span class="number">10</span><span class="gtkdoc opt">);</span>
 
175
<span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-set-clear-func">g_array_set_clear_func</a></span> <span class="gtkdoc opt">(</span>array<span class="gtkdoc opt">, (</span>GDestroyNotify<span class="gtkdoc opt">)</span> g_value_unset<span class="gtkdoc opt">);</span></pre></td>
176
176
      </tr>
177
177
    </tbody>
178
178
  </table>
186
186
<a name="g-value-array-get-nth"></a><h3>g_value_array_get_nth ()</h3>
187
187
<pre class="programlisting"><a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="returnvalue">GValue</span></a> *
188
188
g_value_array_get_nth (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>,
189
 
                       <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
 
189
                       <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
190
190
<div class="warning">
191
191
<p><code class="literal">g_value_array_get_nth</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
192
 
<p>Use <a href="../glib/glib-Arrays.html#g-array-index"><code class="function">g_array_index()</code></a> instead.</p>
 
192
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-index"><code class="function">g_array_index()</code></a> instead.</p>
193
193
</div>
194
194
<p>Return a pointer to the value at <em class="parameter"><code>index_</code></em>
195
195
 containd in <em class="parameter"><code>value_array</code></em>
228
228
<div class="refsect2">
229
229
<a name="g-value-array-new"></a><h3>g_value_array_new ()</h3>
230
230
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="returnvalue">GValueArray</span></a> *
231
 
g_value_array_new (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_prealloced</code></em>);</pre>
 
231
g_value_array_new (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> n_prealloced</code></em>);</pre>
232
232
<div class="warning">
233
233
<p><code class="literal">g_value_array_new</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
234
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-sized-new"><code class="function">g_array_sized_new()</code></a> instead.</p>
 
234
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-sized-new"><code class="function">g_array_sized_new()</code></a> instead.</p>
235
235
</div>
236
236
<p>Allocate and initialize a new <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, optionally preserve space
237
237
for <em class="parameter"><code>n_prealloced</code></em>
266
266
g_value_array_copy (<em class="parameter"><code>const <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>);</pre>
267
267
<div class="warning">
268
268
<p><code class="literal">g_value_array_copy</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
269
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-ref"><code class="function">g_array_ref()</code></a> instead.</p>
 
269
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-ref"><code class="function">g_array_ref()</code></a> instead.</p>
270
270
</div>
271
271
<p>Construct an exact copy of a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> by duplicating all its
272
272
contents.</p>
298
298
g_value_array_free (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>);</pre>
299
299
<div class="warning">
300
300
<p><code class="literal">g_value_array_free</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
301
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-unref"><code class="function">g_array_unref()</code></a> instead.</p>
 
301
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-unref"><code class="function">g_array_unref()</code></a> instead.</p>
302
302
</div>
303
303
<p>Free a <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> including its contents.</p>
304
304
<div class="refsect3">
325
325
                      <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
326
326
<div class="warning">
327
327
<p><code class="literal">g_value_array_append</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
328
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-append-val"><code class="function">g_array_append_val()</code></a> instead.</p>
 
328
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-append-val"><code class="function">g_array_append_val()</code></a> instead.</p>
329
329
</div>
330
330
<p>Insert a copy of <em class="parameter"><code>value</code></em>
331
331
 as last element of <em class="parameter"><code>value_array</code></em>
332
332
. If <em class="parameter"><code>value</code></em>
333
333
 is
334
 
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is appended.</p>
 
334
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is appended.</p>
335
335
<div class="refsect3">
336
336
<a name="id-1.4.14.7.6.6"></a><h4>Parameters</h4>
337
337
<div class="informaltable"><table width="100%" border="0">
348
348
</tr>
349
349
<tr>
350
350
<td class="parameter_name"><p>value</p></td>
351
 
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
351
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
352
352
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
353
353
</tr>
354
354
</tbody>
369
369
                       <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
370
370
<div class="warning">
371
371
<p><code class="literal">g_value_array_prepend</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
372
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-prepend-val"><code class="function">g_array_prepend_val()</code></a> instead.</p>
 
372
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-prepend-val"><code class="function">g_array_prepend_val()</code></a> instead.</p>
373
373
</div>
374
374
<p>Insert a copy of <em class="parameter"><code>value</code></em>
375
375
 as first element of <em class="parameter"><code>value_array</code></em>
376
376
. If <em class="parameter"><code>value</code></em>
377
377
 is
378
 
<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is prepended.</p>
 
378
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is prepended.</p>
379
379
<div class="refsect3">
380
380
<a name="id-1.4.14.7.7.6"></a><h4>Parameters</h4>
381
381
<div class="informaltable"><table width="100%" border="0">
392
392
</tr>
393
393
<tr>
394
394
<td class="parameter_name"><p>value</p></td>
395
 
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
395
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
396
396
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
397
397
</tr>
398
398
</tbody>
410
410
<a name="g-value-array-insert"></a><h3>g_value_array_insert ()</h3>
411
411
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="returnvalue">GValueArray</span></a> *
412
412
g_value_array_insert (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>,
413
 
                      <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
 
413
                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>,
414
414
                      <em class="parameter"><code>const <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
415
415
<div class="warning">
416
416
<p><code class="literal">g_value_array_insert</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
417
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-insert-val"><code class="function">g_array_insert_val()</code></a> instead.</p>
 
417
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-insert-val"><code class="function">g_array_insert_val()</code></a> instead.</p>
418
418
</div>
419
419
<p>Insert a copy of <em class="parameter"><code>value</code></em>
420
420
 at specified position into <em class="parameter"><code>value_array</code></em>
421
421
. If <em class="parameter"><code>value</code></em>
422
422
 
423
 
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is inserted.</p>
 
423
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, an uninitialized value is inserted.</p>
424
424
<div class="refsect3">
425
425
<a name="id-1.4.14.7.8.6"></a><h4>Parameters</h4>
426
426
<div class="informaltable"><table width="100%" border="0">
442
442
</tr>
443
443
<tr>
444
444
<td class="parameter_name"><p>value</p></td>
445
 
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
 
445
<td class="parameter_description"><p> <a class="link" href="gobject-Generic-values.html#GValue" title="GValue"><span class="type">GValue</span></a> to copy into <a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
446
446
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
447
447
</tr>
448
448
</tbody>
460
460
<a name="g-value-array-remove"></a><h3>g_value_array_remove ()</h3>
461
461
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="returnvalue">GValueArray</span></a> *
462
462
g_value_array_remove (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>,
463
 
                      <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
 
463
                      <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
464
464
<div class="warning">
465
465
<p><code class="literal">g_value_array_remove</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
466
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-remove-index"><code class="function">g_array_remove_index()</code></a> instead.</p>
 
466
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-remove-index"><code class="function">g_array_remove_index()</code></a> instead.</p>
467
467
</div>
468
468
<p>Remove the value at position <em class="parameter"><code>index_</code></em>
469
469
 from <em class="parameter"><code>value_array</code></em>
504
504
<a name="g-value-array-sort"></a><h3>g_value_array_sort ()</h3>
505
505
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="returnvalue">GValueArray</span></a> *
506
506
g_value_array_sort (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>,
507
 
                    <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a> compare_func</code></em>);</pre>
 
507
                    <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a> compare_func</code></em>);</pre>
508
508
<div class="warning">
509
509
<p><code class="literal">g_value_array_sort</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
510
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-sort"><code class="function">g_array_sort()</code></a>.</p>
 
510
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-sort"><code class="function">g_array_sort()</code></a>.</p>
511
511
</div>
512
512
<p>Sort <em class="parameter"><code>value_array</code></em>
513
513
 using <em class="parameter"><code>compare_func</code></em>
514
514
 to compare the elements according to
515
 
the semantics of <a href="../glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a>.</p>
 
515
the semantics of <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a>.</p>
516
516
<p>The current implementation uses the same sorting algorithm as standard
517
517
C <code class="function">qsort()</code> function.</p>
518
518
<div class="refsect3">
549
549
<a name="g-value-array-sort-with-data"></a><h3>g_value_array_sort_with_data ()</h3>
550
550
<pre class="programlisting"><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="returnvalue">GValueArray</span></a> *
551
551
g_value_array_sort_with_data (<em class="parameter"><code><a class="link" href="gobject-Value-arrays.html#GValueArray" title="struct GValueArray"><span class="type">GValueArray</span></a> *value_array</code></em>,
552
 
                              <em class="parameter"><code><a href="../glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> compare_func</code></em>,
553
 
                              <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
552
                              <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a> compare_func</code></em>,
 
553
                              <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
554
554
<div class="warning">
555
555
<p><code class="literal">g_value_array_sort_with_data</code> has been deprecated since version 2.32 and should not be used in newly-written code.</p>
556
 
<p>Use <a href="../glib/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="../glib/glib-Arrays.html#g-array-sort-with-data"><code class="function">g_array_sort_with_data()</code></a>.</p>
 
556
<p>Use <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#GArray"><span class="type">GArray</span></a> and <a href="http://library.gnome.org/devel/glib/unstable/glib-Arrays.html#g-array-sort-with-data"><code class="function">g_array_sort_with_data()</code></a>.</p>
557
557
</div>
558
558
<p>Sort <em class="parameter"><code>value_array</code></em>
559
559
 using <em class="parameter"><code>compare_func</code></em>
560
560
 to compare the elements according
561
 
to the semantics of <a href="../glib/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a>.</p>
 
561
to the semantics of <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GCompareDataFunc"><span class="type">GCompareDataFunc</span></a>.</p>
562
562
<p>The current implementation uses the same sorting algorithm as standard
563
563
C <code class="function">qsort()</code> function.</p>
564
564
<p>Rename to: g_value_array_sort</p>
618
618
</colgroup>
619
619
<tbody>
620
620
<tr>
621
 
<td class="struct_member_name"><p><a href="../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>;</p></td>
 
621
<td class="struct_member_name"><p><a href="http://library.gnome.org/devel/glib/unstable/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>;</p></td>
622
622
<td class="struct_member_description"><p>number of values contained in the array</p></td>
623
623
<td class="struct_member_annotations"> </td>
624
624
</tr>