Top | ![]() |
![]() |
![]() |
![]() |
CamelNameValueArray * | camel_name_value_array_new () |
CamelNameValueArray * | camel_name_value_array_new_sized () |
CamelNameValueArray * | camel_name_value_array_copy () |
|
camel_name_value_array_free () |
|
camel_name_value_array_get_length () |
|
camel_name_value_array_get () |
const |
camel_name_value_array_get_named () |
const |
camel_name_value_array_get_name () |
const |
camel_name_value_array_get_value () |
|
camel_name_value_array_append () |
|
camel_name_value_array_set () |
|
camel_name_value_array_set_name () |
|
camel_name_value_array_set_value () |
|
camel_name_value_array_set_named () |
|
camel_name_value_array_remove () |
|
camel_name_value_array_remove_named () |
|
camel_name_value_array_clear () |
|
camel_name_value_array_equal () |
CamelNameValueArray *
camel_name_value_array_new (void
);
Creates a new CamelNameValueArray. The returned pointer should be freed
with camel_name_value_array_free()
when no longer needed.
A new CamelNameValueArray.
See: camel_name_value_array_new_sized, camel_name_value_array_copy.
[transfer full]
Since: 3.24
CamelNameValueArray *
camel_name_value_array_new_sized (guint reserve_size
);
Creates a new CamelNameValueArray, which has reserved reserve_size
elements. This value doesn't influence the camel_name_value_array_get_length()
,
which returns zero on the array returned from this function. The returned
pointer should be freed with camel_name_value_array_free()
when no longer needed.
A new CamelNameValueArray.
See: camel_name_value_array_new, camel_name_value_array_copy.
[transfer full]
Since: 3.24
CamelNameValueArray *
camel_name_value_array_copy (const CamelNameValueArray *array
);
Creates a new copy of the array
. The returned pointer should be freed
with camel_name_value_array_free()
when no longer needed.
A new copy of the array
.
See: camel_name_value_array_new, camel_name_value_array_new_sized.
[transfer full]
Since: 3.24
void camel_name_value_array_free (CamelNameValueArray *array
);
Frees the array
, previously allocated by camel_name_value_array_new()
,
camel_name_value_array_new_sized()
or camel_name_value_array_copy()
.
If the array
is NULL
Since: 3.24
guint camel_name_value_array_get_length (const CamelNameValueArray *array
);
Since: 3.24
gboolean camel_name_value_array_get (const CamelNameValueArray *array
,,
guint indexconst
,gchar **out_nameconst
);gchar **out_value
Returns the name and the value of the element at index index
. Either
of the out_name
and out_value
can be NULL
array |
||
index |
an index |
|
out_name |
A place to store the name of the element, or |
[out][nullable] |
out_value |
A place to store the value of the element, or |
[out][nullable] |
TRUE
FALSE
See: camel_name_value_array_get_name, camel_name_value_array_get_value, camel_name_value_array_get_named
Since: 3.24
constgchar * camel_name_value_array_get_named (const CamelNameValueArray *array
,CamelCompareType compare_type
,const
);gchar *name
Returns the value of the first element named name
, or NULL
name
in the array
. The compare_type
determines
how to compare the names.
Value of the first element named name
, or NULL
See: camel_name_value_array_get, camel_name_value_array_get_name.
[transfer none][nullable]
Since: 3.24
constgchar * camel_name_value_array_get_name (const CamelNameValueArray *array
,);
guint index
Returns the name of the element at index index
.
Name of the element at the given index
,
or NULL
See: camel_name_value_array_get, camel_name_value_array_get_value.
[transfer none][nullable]
Since: 3.24
constgchar * camel_name_value_array_get_value (const CamelNameValueArray *array
,);
guint index
Returns the value of the element at index index
.
Value of the element at the given index
,
or NULL
See: camel_name_value_array_get, camel_name_value_array_get_name.
[transfer none][nullable]
Since: 3.24
void camel_name_value_array_append (CamelNameValueArray *array
,const
,gchar *nameconst
);gchar *value
Appends a new element of the name name
and the value value
at the end of array
.
See: camel_name_value_array_set_named
Since: 3.24
gboolean camel_name_value_array_set (CamelNameValueArray *array
,,
guint indexconst
,gchar *nameconst
);gchar *value
Sets both the name
and the value
of the element at index index
.
Whether the array
changed.
See: camel_name_value_array_append, camel_name_value_array_set_name, camel_name_value_array_set_value
Since: 3.24
gboolean camel_name_value_array_set_name (CamelNameValueArray *array
,,
guint indexconst
);gchar *name
Sets the name
of the element at index index
.
Whether the array
changed.
See: camel_name_value_array_set, camel_name_value_array_set_value
Since: 3.24
gboolean camel_name_value_array_set_value (CamelNameValueArray *array
,,
guint indexconst
);gchar *value
Sets the value
of the element at index index
.
Since: 3.24
gboolean camel_name_value_array_set_named (CamelNameValueArray *array
,CamelCompareType compare_type
,const
,gchar *nameconst
);gchar *value
Finds an element named name
and sets its value to value
, or appends
a new element, in case no such named element exists in the array
yet.
In case there are more elements named with name
only the first
occurrence is changed. The compare_type
determines how to compare
the names.
Since: 3.24
gboolean camel_name_value_array_remove (CamelNameValueArray *array
,);
guint index
Removes element at index index
.
Since: 3.24
guint camel_name_value_array_remove_named (CamelNameValueArray *array
,CamelCompareType compare_type
,const
,gchar *name);
gboolean all_occurrences
Removes elements of the array
with the given name
.
The compare_type
determines hot to compare the names.
If the all_occurrences
is set to TRUE
name
are removed, otherwise only the first occurrence is removed.
array |
||
compare_type |
a compare type, one of CamelCompareType |
|
name |
a name to remove |
|
all_occurrences |
whether to remove all occurrences of the |
Since: 3.24
void camel_name_value_array_clear (CamelNameValueArray *array
);
Removes all elements of the array
.
Since: 3.24
gboolean camel_name_value_array_equal (const CamelNameValueArray *array_a
,const CamelNameValueArray *array_b
,CamelCompareType compare_type
);
Compares content of the two CamelNameValueArray and returns whether they equal. Note this is an expensive operation for large arrays.
array_a |
the first CamelNameValueArray. |
[nullable] |
array_b |
the second CamelNameValueArray. |
[nullable] |
compare_type |
a compare type, one of CamelCompareType |
Since: 3.24