Camel.NameValueArray
Description: Reference for Camel.NameValueArray

### Struct

# CamelNameValueArray

since: 3.24

#### Description

    struct CamelNameValueArray {
      /* No available fields */
    }

No description available.

Available since: 3.24

#### Constructors

###### camel_name_value_array_new

Creates a new `CamelNameValueArray`. The returned pointer should be freed with `camel_name_value_array_free()` when no longer needed.

since: 3.24

###### camel_name_value_array_new_sized

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.

since: 3.24

#### Instance methods

###### camel_name_value_array_append

Appends a new element of the name `name` and the value `value` at the end of `array`.

since: 3.24

###### camel_name_value_array_clear

Removes all elements of the `array`.

since: 3.24

###### camel_name_value_array_copy

Creates a new copy of the `array`. The returned pointer should be freed with `camel_name_value_array_free()` when no longer needed.

since: 3.24

###### camel_name_value_array_equal

Compares content of the two `CamelNameValueArray` and returns whether they equal. Note this is an expensive operation for large arrays.

since: 3.24

###### camel_name_value_array_free

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`, then does nothing.

since: 3.24

###### camel_name_value_array_get

Returns the name and the value of the element at index `index`. Either of the `out_name` and `out_value` can be `NULL`, to not return that part.

since: 3.24

###### camel_name_value_array_get_length

No description available.

since: 3.24

###### camel_name_value_array_get_name

Returns the name of the element at index `index`.

since: 3.24

###### camel_name_value_array_get_named

Returns the value of the first element named `name`, or `NULL` when there is no element of such `name` in the `array`. The `compare_type` determines how to compare the names.

since: 3.24

###### camel_name_value_array_get_value

Returns the value of the element at index `index`.

since: 3.24

###### camel_name_value_array_remove

Removes element at index `index`.

since: 3.24

###### camel_name_value_array_remove_named

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`, then every elements with the `name` are removed, otherwise only the first occurrence is removed.

since: 3.24

###### camel_name_value_array_set

Sets both the `name` and the `value` of the element at index `index`.

since: 3.24

###### camel_name_value_array_set_name

Sets the `name` of the element at index `index`.

since: 3.24

###### camel_name_value_array_set_named

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

###### camel_name_value_array_set_value

Sets the `value` of the element at index `index`.

since: 3.24