| Top |  |  |  |  | 
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.
GimpValueArray *
gimp_value_array_new (gint n_prealloced);
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
GimpValueArray *
gimp_value_array_ref (GimpValueArray *value_array);
Adds a reference to a GimpValueArray.
Since: 2.10
void
gimp_value_array_unref (GimpValueArray *value_array);
Unref a GimpValueArray. If the reference count drops to zero, the array including its contents are freed.
Since: 2.10
GValue * gimp_value_array_index (const GimpValueArray *value_array,gint index);
Return a pointer to the value at index
 contained in value_array
.
Since: 2.10
GimpValueArray * gimp_value_array_prepend (GimpValueArray *value_array,const GValue *value);
Insert a copy of value
 as first element of value_array
. If value
 is
NULL, an uninitialized value is prepended.
| value_array | GimpValueArray to add an element to | |
| value | GValue to copy into GimpValueArray, or  | [allow-none] | 
Since: 2.10
GimpValueArray * gimp_value_array_append (GimpValueArray *value_array,const GValue *value);
Insert a copy of value
 as last element of value_array
. If value
 is
NULL, an uninitialized value is appended.
| value_array | GimpValueArray to add an element to | |
| value | GValue to copy into GimpValueArray, or  | [allow-none] | 
Since: 2.10
GimpValueArray * gimp_value_array_insert (GimpValueArray *value_array,gint index,const GValue *value);
Insert a copy of value
 at specified position into value_array
. If value
is NULL, an uninitialized value is inserted.
| value_array | GimpValueArray to add an element to | |
| index | insertion position, must be <=  | |
| value | GValue to copy into GimpValueArray, or  | [allow-none] | 
Since: 2.10
GimpValueArray * gimp_value_array_remove (GimpValueArray *value_array,gint index);
Remove the value at position index
 from value_array
.
| value_array | GimpValueArray to remove an element from | |
| index | position of value to remove, which must be less than
 | 
Since: 2.10
void gimp_value_array_truncate (GimpValueArray *value_array,gint n_values);
GParamSpec * gimp_param_spec_value_array (const gchar *name,const gchar *nick,const gchar *blurb,GParamSpec *element_spec,GParamFlags flags);
typedef struct _GimpValueArray GimpValueArray;
A GimpValueArray contains an array of GValue elements.
Since: 2.10