ValueArray

ValueArray

Object Hierarchy:

Description:

[ CCode ( copy_function = "g_value_array_copy" , free_function = "g_value_array_free" , type_id = "G_TYPE_VALUE_ARRAY" ) ]
[ Compact ]
[ Version ( deprecated = true , deprecated_since = "2.32" ) ]
public class ValueArray

Warning: ValueArray is deprecated since 2.32.

A `GValueArray` is a container structure to hold an array of generic values.

Note:

Use `GArray` instead, if possible for the given use case, as described above.

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 [method@GObject.Value.unset] as the clear function using [ func@GLib.Array.set_clear_func], for instance, the following code:

```c GValueArray *array = g_value_array_new (10); ```

can be replaced by:

```c GArray *array = g_array_sized_new (FALSE, TRUE, sizeof (GValue), 10); g_array_set_clear_func (array, (GDestroyNotify) g_value_unset); ```

Namespace: GLib

Package: gobject-2.0

Content:

Creation methods:

public ValueArray (uint n_prealloced)
Allocate and initialize a new ValueArray, optionally preserve space for n_prealloced elements.

Methods:

public void append (Value value)
Insert a copy of value as last element of this.
public ValueArray copy ()
Construct an exact copy of a ValueArray by duplicating all its contents.
public unowned Value? get_nth (uint index_)
Return a pointer to the value at index_ contained in this.
public void insert (uint index_, Value value)
Insert a copy of value at specified position into this.
public void prepend (Value value)
Insert a copy of value as first element of this.
public void remove (uint index_)
Remove the value at position index_ from this.
public void sort (CompareFunc<Value?> compare_func)
Sort this using compare_func to compare the elements according to the semantics of SearchFunc .
public void sort_with_data (CompareDataFunc<Value?> compare_func)
Sort this using compare_func to compare the elements according to the semantics of CompareDataFunc.

Fields:

public uint n_values
public Value[] values