| Top |  |  |  |  | 
The prime purpose of a GValueArray is for it to be used as an
object property that holds an array of values. A GValueArray wraps
an array of GValue elements in order for it to be used as a boxed
type through G_TYPE_VALUE_ARRAY.
GValueArray is deprecated in favour of GArray since GLib 2.32. It
is possible to create a GArray that behaves like a GValueArray by
using the size of GValue as the element size, and by setting
g_value_unset() as the clear function using g_array_set_clear_func(),
for instance, the following code:
| 1 | GValueArray *array = g_value_array_new (10); | 
can be replaced by:
| 1 2 | GArray *array = g_array_sized_new (FALSE, TRUE, sizeof (GValue), 10); g_array_set_clear_func (array, (GDestroyNotify) g_value_unset); | 
GValue * g_value_array_get_nth (GValueArray *value_array,guint index_);
g_value_array_get_nth has been deprecated since version 2.32 and should not be used in newly-written code.
Use g_array_index() instead.
Return a pointer to the value at index_
 containd in value_array
.
GValueArray *
g_value_array_new (guint n_prealloced);
g_value_array_new has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_sized_new() instead.
Allocate and initialize a new GValueArray, optionally preserve space
for n_prealloced
 elements. New arrays always contain 0 elements,
regardless of the value of n_prealloced
.
GValueArray *
g_value_array_copy (const GValueArray *value_array);
g_value_array_copy has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_ref() instead.
Construct an exact copy of a GValueArray by duplicating all its contents.
void
g_value_array_free (GValueArray *value_array);
g_value_array_free has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_unref() instead.
Free a GValueArray including its contents.
GValueArray * g_value_array_append (GValueArray *value_array,const GValue *value);
g_value_array_append has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_append_val() instead.
Insert a copy of value
 as last element of value_array
. If value
 is
NULL, an uninitialized value is appended.
| value_array | GValueArray to add an element to | |
| value |  GValue to copy into GValueArray, or  | [allow-none] | 
GValueArray * g_value_array_prepend (GValueArray *value_array,const GValue *value);
g_value_array_prepend has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_prepend_val() instead.
Insert a copy of value
 as first element of value_array
. If value
 is
NULL, an uninitialized value is prepended.
| value_array | GValueArray to add an element to | |
| value |  GValue to copy into GValueArray, or  | [allow-none] | 
GValueArray * g_value_array_insert (GValueArray *value_array,guint index_,const GValue *value);
g_value_array_insert has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_insert_val() instead.
Insert a copy of value
 at specified position into value_array
. If value
is NULL, an uninitialized value is inserted.
| value_array | GValueArray to add an element to | |
| index_ | insertion position, must be <= value_array->n_values | |
| value |  GValue to copy into GValueArray, or  | [allow-none] | 
GValueArray * g_value_array_remove (GValueArray *value_array,guint index_);
g_value_array_remove has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_remove_index() instead.
Remove the value at position index_
 from value_array
.
| value_array | GValueArray to remove an element from | |
| index_ | position of value to remove, which must be less than
 | 
GValueArray * g_value_array_sort (GValueArray *value_array,GCompareFunc compare_func);
g_value_array_sort has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_sort().
Sort value_array
 using compare_func
 to compare the elements according to
the semantics of GCompareFunc.
The current implementation uses the same sorting algorithm as standard
C qsort() function.
GValueArray * g_value_array_sort_with_data (GValueArray *value_array,GCompareDataFunc compare_func,gpointer user_data);
g_value_array_sort_with_data has been deprecated since version 2.32 and should not be used in newly-written code.
Use GArray and g_array_sort_with_data().
Sort value_array
 using compare_func
 to compare the elements according
to the semantics of GCompareDataFunc.
The current implementation uses the same sorting algorithm as standard
C qsort() function.
Rename to: g_value_array_sort
| value_array | GValueArray to sort | |
| compare_func | function to compare elements. | [scope call] | 
| user_data |  extra data argument provided for  | [closure] | 
struct GValueArray {
  guint   n_values;
  GValue *values;
};
A GValueArray contains an array of GValue elements.