### Struct

# Gimp ValueArray

since: 2.10

#### Description [src]

    struct GimpValueArray {
      /* No available fields */
    }

The prime purpose of a `GimpValueArray` is for it to be used as an object property that holds an array of values. A `GimpValueArray` wraps an array of `GValue` elements in order for it to be used as a boxed type through `GIMP_TYPE_VALUE_ARRAY`.

Available since: 2.10

#### Constructors

###### gimp_value_array_new

Allocate and initialize a new `GimpValueArray`, optionally preserve space for `n_prealloced` elements. New arrays always contain 0 elements, regardless of the value of `n_prealloced`.

since: 2.10

###### gimp_value_array_new_from_types

Allocate and initialize a new `GimpValueArray`, and fill it with values that are given as a list of (`GType`, value) pairs, terminated by #G_TYPE_NONE.

since: 3.0

###### gimp_value_array_new_from_types_valist

Allocate and initialize a new `GimpValueArray`, and fill it with `va_args` given in the order as passed to gimp_value_array_new_from_types().

since: 3.0

###### gimp_value_array_new_from_values

Allocate and initialize a new `GimpValueArray`, and fill it with the given `GValues`. When no `GValues` are given, returns empty `GimpValueArray`.

since: 3.0

#### Instance methods

###### gimp_value_array_append

Insert a copy of `value` as last element of `value_array`. If `value` is `NULL`, an uninitialized value is appended.

since: 2.10

###### gimp_value_array_copy

Return an exact copy of a `GimpValueArray` by duplicating all its values.

since: 3.0

###### gimp_value_array_get_color_array

Return a pointer to the value at `index` contained in `value_array`. This value is supposed to be a `GimpColorArray`.

since: 3.0

###### gimp_value_array_get_core_object_array

Return a pointer to the value at `index` contained in `value_array`. This value is supposed to be a `GimpCoreObjectArray`.

since: 3.0

###### gimp_value_array_index

Return a pointer to the value at `index` contained in `value_array`.

since: 2.10

###### gimp_value_array_insert

Insert a copy of `value` at specified position into `value_array`. If `value` is `NULL`, an uninitialized value is inserted.

since: 2.10

###### gimp_value_array_length

No description available.

###### gimp_value_array_prepend

Insert a copy of `value` as first element of `value_array`. If `value` is `NULL`, an uninitialized value is prepended.

since: 2.10

###### gimp_value_array_ref

Adds a reference to a `GimpValueArray`.

since: 2.10

###### gimp_value_array_remove

Remove the value at position `index` from `value_array`.

since: 2.10

###### gimp_value_array_truncate

No description available.

###### gimp_value_array_unref

Unref a `GimpValueArray`. If the reference count drops to zero, the array including its contents are freed.

since: 2.10