Top |
GimpValueArray * | gimp_value_array_new () |
GimpValueArray * | gimp_value_array_ref () |
void | gimp_value_array_unref () |
gint | gimp_value_array_length () |
GValue * | gimp_value_array_index () |
GimpValueArray * | gimp_value_array_prepend () |
GimpValueArray * | gimp_value_array_append () |
GimpValueArray * | gimp_value_array_insert () |
GimpValueArray * | gimp_value_array_remove () |
void | gimp_value_array_truncate () |
GParamSpec * | gimp_param_spec_value_array () |
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
);
typedef struct _GimpValueArray GimpValueArray;
A GimpValueArray contains an array of GValue elements.
Since: 2.10