gobject/org.gtkkn.bindings.gobject/ValueArray

ValueArray

class ValueArray(val gobjectValueArrayPointer: <Error class: unknown class><<Error class: unknown class>>)(source)

⚠️ Deprecated ⚠️

This is deprecated since version 2.32.

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

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

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:

GValueArray *array = g_value_array_new (10);

can be replaced by:

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

Constructors

ValueArray

constructor(nPrealloced: <Error class: unknown class>)

This is deprecated since version 2.32.

constructor()

Allocate a new ValueArray.

constructor(scope: <Error class: unknown class>)

Allocate a new ValueArray using the provided AutofreeScope.

constructor(nValues: <Error class: unknown class>, values: Value?)

Allocate a new ValueArray.

constructor(nValues: <Error class: unknown class>, values: Value?, scope: <Error class: unknown class>)

Allocate a new ValueArray using the provided AutofreeScope.

constructor(gobjectValueArrayPointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion

Properties

gobjectValueArrayPointer

val gobjectValueArrayPointer: <Error class: unknown class><<Error class: unknown class>>

nValues

var nValues: <Error class: unknown class>

number of values contained in the array

values

var values: Value?

array of values

Functions

append

fun append(value: Value? = null): ValueArray

This is deprecated since version 2.32.

copy

fun copy(): ValueArray

This is deprecated since version 2.32.

free

fun free()

This is deprecated since version 2.32.

getNth

fun getNth(index: <Error class: unknown class>): Value

This is deprecated since version 2.32.

insert

fun insert(index: <Error class: unknown class>, value: Value? = null): ValueArray

This is deprecated since version 2.32.

prepend

fun prepend(value: Value? = null): ValueArray

This is deprecated since version 2.32.

remove

fun remove(index: <Error class: unknown class>): ValueArray

This is deprecated since version 2.32.

sort

fun sort(compareFunc: <Error class: unknown class>): ValueArray

This is deprecated since version 2.32.

toString

open override fun toString(): String