Struct
GimpValueArray
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_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_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_unref
Unref a GimpValueArray
. If the reference count drops to zero, the
array including its contents are freed.
since: 2.10