Description
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:
can be replaced by:
Functions
g_value_array_get_nth ()
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
.
Returns
pointer to a value at index_
in value_array
.
[transfer none]
g_value_array_new ()
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
.
g_value_array_copy ()
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.
Returns
Newly allocated copy of GValueArray.
[transfer full]
g_value_array_free ()
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.
[skip]
g_value_array_append ()
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.
Returns
the GValueArray passed in as value_array
.
[transfer none]
g_value_array_prepend ()
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.
Returns
the GValueArray passed in as value_array
.
[transfer none]
g_value_array_insert ()
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.
Returns
the GValueArray passed in as value_array
.
[transfer none]
g_value_array_remove ()
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
.
Returns
the GValueArray passed in as value_array
.
[transfer none]
g_value_array_sort ()
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.
Returns
the GValueArray passed in as value_array
.
[transfer none]
g_value_array_sort_with_data ()
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]
Returns
the GValueArray passed in as value_array
.
[transfer none]