EBookContacts.VCardAttribute
Description: Reference for EBookContacts.VCardAttribute

### Struct

# EBookContactsVCardAttribute

#### Description

    struct EVCardAttribute {
      /* No available fields */
    }

No description available.

#### Constructors

###### e_vcard_attribute_new

Creates a new `EVCardAttribute` with the specified group and attribute names. The `attr_group` may be `NULL` or the empty string if no group is needed.

#### Instance methods

###### e_vcard_attribute_add_param

Prepends `param` to `attr`‘s list of parameters. This takes ownership of `param` (and all its values).

###### e_vcard_attribute_add_param_with_value

Appends `value` to `param`, then prepends `param` to `attr`. This takes ownership of `param`, but not of `value`.

###### e_vcard_attribute_add_param_with_values

Appends the list of values to `param`, then prepends `param` to `attr`. This takes ownership of `param`, but not of the list of values.

###### e_vcard_attribute_add_value

Appends `value` to `attr`‘s list of values.

###### e_vcard_attribute_add_value_decoded

Encodes `value` according to the encoding used for `attr`, and appends it to `attr`‘s list of values.

###### e_vcard_attribute_add_value_take

Appends `value` to `attr`‘s list of values, assuming ownership of the `value`.

since: 3.60

###### e_vcard_attribute_add_values

Appends a list of values to `attr`.

###### e_vcard_attribute_copy

Makes a copy of `attr`.

###### e_vcard_attribute_free

Frees an attribute, its values and its parameters.

###### e_vcard_attribute_get_group

Gets the group name of `attr`.

###### e_vcard_attribute_get_n_values

Gets how many values the `attr` holds.

since: 3.60

###### e_vcard_attribute_get_name

Gets the name of `attr`.

###### e_vcard_attribute_get_nth_value

Gets the value at index `index` (counting from zero), of the `attr`. The value is owned by the `attr` and is valid until the `attr` changes or is freed. The `index` can be out of bounds, then a `NULL` is returned. Use `e_vcard_attribute_get_n_values`() to check how many values the `attr` has stored.

since: 3.60

###### e_vcard_attribute_get_param

Gets the list of values for the paramater `name` from `attr`. The list and its contents are owned by `attr`, and must not be freed. If no parameter with the given `name` exists, `NULL` is returned.

###### e_vcard_attribute_get_params

Gets the list of parameters (of type `EVCardAttributeParam`) from `attr`. The list and its contents are owned by `attr`, and must not be freed.

###### e_vcard_attribute_get_value

Gets the value of a single-valued `EVCardAttribute`, `attr`.

###### e_vcard_attribute_get_value_decoded

Gets the value of a single-valued `EVCardAttribute`, `attr`, decoding it if necessary according to the encoding given in the vCard’s `ENCODING` attribute.

###### e_vcard_attribute_get_values

Gets the ordered list of values from `attr`. The list and its contents are owned by `attr`, and must not be freed.

###### e_vcard_attribute_get_values_decoded

Gets the ordered list of values from `attr`, decoding them if necessary according to the encoding given in the vCard’s `ENCODING` attribute. The list and its contents are owned by `attr`, and must not be freed.

###### e_vcard_attribute_has_type

Checks if `attr` has an `EVCardAttributeParam` with name `EVC_TYPE` and `typestr` as one of its values.

###### e_vcard_attribute_is_single_valued

Checks if `attr` has a single value.

###### e_vcard_attribute_remove_param

Removes and frees parameter `param_name` from the attribute `attr`. Parameter names are guaranteed to be unique, so `attr` is guaranteed to have no parameters named `param_name` after this function returns.

since: 1.12

###### e_vcard_attribute_remove_param_value

Removes the value `s` from the parameter `param_name` on the attribute `attr`. If `s` was the only value for parameter `param_name`, that parameter is removed entirely from `attr` and freed.

###### e_vcard_attribute_remove_params

Removes and frees all parameters from `attr`.

###### e_vcard_attribute_remove_value

Removes value `s` from the value list in `attr`. The value `s` is not freed.

###### e_vcard_attribute_remove_values

Removes and frees all values from `attr`.