Method
EBookContactsVCardget_attribute
Declaration [src]
EVCardAttribute*
e_vcard_get_attribute (
EVCard* evc,
const gchar* name
)
Description [src]
Get the attribute name from evc. The EVCardAttribute is owned by
evcard and should not be freed. If the attribute does not exist, NULL is returned.
name. To get other attributes of that name (for example, other TEL attributes if a contact has multiple telephone
numbers), use e_vcard_get_attributes() and iterate over the list searching
for matching attributes.EVCard, so should not
be called often. If extracting a large number of attributes from a vCard, it
is more efficient to iterate once over the list returned by
e_vcard_get_attributes().
Parameters
name-
Type:
const gchar*The name of the attribute to get.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string.
Return value
Type: EVCardAttribute
An EVCardAttribute if found, or NULL.
| The returned data is owned by the instance. |
The return value can be NULL. |