e_contact_new ()

EContact *
e_contact_new (void);

Creates a new, blank EContact.

e_contact_new_from_vcard ()

EContact *
e_contact_new_from_vcard (const gchar *vcard);

Creates a new EContact based on a vcard.

e_contact_new_from_vcard_with_uid ()

EContact *
e_contact_new_from_vcard_with_uid (const gchar *vcard,
                                   const gchar *uid);

Creates a new EContact based on a vcard and a predefined UID.

Since: 3.4

e_contact_duplicate ()

EContact *
e_contact_duplicate (EContact *contact);

Creates a copy of contact .

e_contact_convert ()

EContact *
e_contact_convert (EContact *self,
                   EVCardVersion to_version);

Converts the self into the vCard version to_version and returns a converted copy of the self . When the to_version matches the version of the self , then does nothing and returns NULL.

Since: 3.60

e_contact_get ()

gpointer
e_contact_get (EContact *contact,
               EContactField field_id);

Gets the value of contact 's field specified by field_id .

e_contact_get_const ()

gconstpointer
e_contact_get_const (EContact *contact,
                     EContactField field_id);

Gets the value of contact 's field specified by field_id , caching the result so it can be freed later. Use e_contact_field_is_string() to check whether the field can be used here.

e_contact_set ()

void
e_contact_set (EContact *contact,
               EContactField field_id,
               gconstpointer value);

Sets the value of contact 's field specified by field_id to value .

e_contact_date_new ()

EContactDate *
e_contact_date_new (void);

Creates a new EContactDate struct.

e_contact_date_from_string ()

EContactDate *
e_contact_date_from_string (const gchar *str);

Creates a new EContactDate based on str .

e_contact_date_to_string ()

gchar *
e_contact_date_to_string (EContactDate *dt,
                          EVCardVersion for_version);

Generates a date string in the format YYYY-MM-DD based on the values of dt .

Since: 3.60

e_contact_date_equal ()

gboolean
e_contact_date_equal (EContactDate *dt1,
                      EContactDate *dt2);

Checks if dt1 and dt2 are the same date.

e_contact_date_free ()

void
e_contact_date_free (EContactDate *date);

Frees the date struct and its contents.

e_contact_date_time_new ()

EContactDateTime *
e_contact_date_time_new (void);

Creates a new EContactDateTime struct with unset date and time.

Since: 3.60

e_contact_date_time_from_string ()

EContactDateTime *
e_contact_date_time_from_string (const gchar *str,
                                 EContactDateTimeFlags flags);

Creates a new EContactDateTime based on str .

Since: 3.60

e_contact_date_time_to_string ()

gchar *
e_contact_date_time_to_string (const EContactDateTime *self,
                               EVCardVersion for_version,
                               EContactDateTimeFlags flags);

Generates a date/time string in the for_version format used by vCard standard, omitting unset values of the self . Free the returned string with g_free(), when no longer needed.

Since: 3.60

e_contact_date_time_equal ()

gboolean
e_contact_date_time_equal (const EContactDateTime *dt1,
                           const EContactDateTime *dt2);

Checks if dt1 and dt2 are the same date time.

Since: 3.60

e_contact_date_time_has_date ()

gboolean
e_contact_date_time_has_date (const EContactDateTime *self);

Checks whether the self has set at least one of the date members.

Since: 3.60

e_contact_date_time_has_time ()

gboolean
e_contact_date_time_has_time (const EContactDateTime *self);

Checks whether the self has set at least one of the time members.

Since: 3.60

e_contact_date_time_free ()

void
e_contact_date_time_free (EContactDateTime *self);

Frees the self struct and its content.

Since: 3.60

e_contact_name_new ()

EContactName *
e_contact_name_new (void);

Creates a new EContactName struct.

e_contact_name_to_string ()

gchar *
e_contact_name_to_string (const EContactName *name);

Generates a string representation of name .

e_contact_name_from_string ()

EContactName *
e_contact_name_from_string (const gchar *name_str);

Creates a new EContactName based on the parsed name_str .

e_contact_name_copy ()

EContactName *
e_contact_name_copy (EContactName *n);

Creates a copy of n .

e_contact_name_free ()

void
e_contact_name_free (EContactName *name);

Frees name and its contents.

e_contact_photo_new ()

EContactPhoto *
e_contact_photo_new (void);

Creates a new EContactPhoto struct.

Since: 3.2

e_contact_photo_free ()

void
e_contact_photo_free (EContactPhoto *photo);

Frees the photo struct and its contents.

e_contact_photo_copy ()

EContactPhoto *
e_contact_photo_copy (EContactPhoto *photo);

Creates a copy of photo .

Since: 3.8

e_contact_photo_get_inlined ()

const guchar *
e_contact_photo_get_inlined (EContactPhoto *photo,
                             gsize *len);

Gets the photo 's data.

Since: 3.2

e_contact_photo_set_inlined ()

void
e_contact_photo_set_inlined (EContactPhoto *photo,
                             const guchar *data,
                             gsize len);

Sets the photo 's inlined data.

Since: 3.2

e_contact_photo_get_mime_type ()

const gchar *
e_contact_photo_get_mime_type (EContactPhoto *photo);

Gets the photo 's mime type.

Since: 3.2

e_contact_photo_set_mime_type ()

void
e_contact_photo_set_mime_type (EContactPhoto *photo,
                               const gchar *mime_type);

Sets the photo 's mime type.

Since: 3.2

e_contact_photo_get_uri ()

const gchar *
e_contact_photo_get_uri (EContactPhoto *photo);

Gets the photo 's URI.

Since: 3.2

e_contact_photo_set_uri ()

void
e_contact_photo_set_uri (EContactPhoto *photo,
                         const gchar *uri);

Sets the photo 's URI.

Since: 3.2

e_contact_inline_local_photos ()

gboolean
e_contact_inline_local_photos (EContact *contact,
                               GError **error);

Tries to modify any EContactPhoto fields which are stored on the local file system as type E_CONTACT_PHOTO_TYPE_URI to be inlined and stored as E_CONTACT_PHOTO_TYPE_INLINED instead.

Since: 3.4

e_contact_geo_new ()

EContactGeo *
e_contact_geo_new (void);

Creates an EContactGeo struct with all coordinates set to 0.

Since: 3.8

e_contact_geo_from_string ()

EContactGeo *
e_contact_geo_from_string (const gchar *latitude,
                           const gchar *longitude);

Creates a new EContactGeo, which has set latitude and longitude from the provided strings.

Since: 3.60

e_contact_geo_to_string ()

gboolean
e_contact_geo_to_string (const EContactGeo *self,
                         gchar **out_latitude,
                         gchar **out_longitude);

Converts latitude and longitude of the self into string. Free the returned strings with g_free(), when no longer needed.

Note: the numbers are converted up to 6 digits after the decimal point.

Since: 3.60

e_contact_geo_free ()

void
e_contact_geo_free (EContactGeo *geo);

Frees the geo struct and its contents.

Since: 1.12

e_contact_cert_new ()

EContactCert *
e_contact_cert_new (void);

Creates an EContactCert struct with all values set to 0.

Since: 3.8

e_contact_cert_free ()

void
e_contact_cert_free (EContactCert *cert);

Frees the cert struct and its contents.

e_contact_cert_from_attr ()

EContactCert *
e_contact_cert_from_attr (EVCardAttribute *source);

Creates a new EContactCert structure with the information from the source attribute. Returns NULL, when the information in the source could not be stored in the structure (for example when the KEY attribute is a URI to some server).

Since: 3.60

e_contact_cert_write_attr ()

void
e_contact_cert_write_attr (EContactCert *self,
                           EVCardVersion to_version,
                           EVCardAttribute *destination);

Populates the destination with the data from the self , using format suitable to to_version vCard version. The function does nothing when the self is an empty structure. The destination is supposed to be a KEY attribute.

Since: 3.60

e_contact_address_new ()

EContactAddress *
e_contact_address_new (void);

Creates a new EContactAddress struct.

Since: 3.2

e_contact_address_free ()

void
e_contact_address_free (EContactAddress *address);

Frees the address struct and its contents.

e_contact_address_clear ()

void
e_contact_address_clear (EContactAddress *self);

Frees all the members of the self , but unlike e_contact_address_free(), it does not free the self itself.

Since: 3.60

e_contact_address_read_attr ()

void
e_contact_address_read_attr (EContactAddress *self,
                             EVCardAttribute *source);

Populates self from the source attribute.

Since: 3.60

e_contact_address_write_attr ()

void
e_contact_address_write_attr (EContactAddress *self,
                              EVCardAttribute *destination);

Populates ADR attribute destination with the data from the self .

Since: 3.60

e_contact_attr_list_copy ()

GList *
e_contact_attr_list_copy (GList *list);

Copies a list of allocated strings, specifically for the EContactAttrList boxed type used for multi valued contact fields.

Since: 3.8

e_contact_attr_list_free ()

void
e_contact_attr_list_free (GList *list);

Frees a list of allocated strings, specifically for the EContactAttrList boxed type used for multi valued contact fields.

Since: 3.8

e_contact_gender_sex_to_string ()

const gchar *
e_contact_gender_sex_to_string (EContactGenderSex sex);

Converts the sex into a string, as used by the vCard 4.0 standard.

Since: 3.60

e_contact_gender_sex_from_string ()

EContactGenderSex
e_contact_gender_sex_from_string (const gchar *string);

Converts a string into an EContactGenderSex. Unrecognized values are returned as E_CONTACT_GENDER_SEX_NOT_SET.

Since: 3.60

e_contact_gender_new ()

EContactGender *
e_contact_gender_new (void);

Creates a new empty EContactGender structure. Free it with e_contact_gender_free() when no longer needed.

Since: 3.60

e_contact_gender_copy ()

EContactGender *
e_contact_gender_copy (EContactGender *self);

Creates a copy of the self . Returns NULL when self is NULL. Free it with e_contact_gender_free(), when no longer needed.

Since: 3.60

e_contact_gender_free ()

void
e_contact_gender_free (EContactGender *self);

Frees the self . Does nothing, when self is NULL.

Since: 3.60

e_contact_field_type ()

GType
e_contact_field_type (EContactField field_id);

Gets the GType used for this contact field, this indicates what kind of value can be passed to e_contact_set().

Since: 3.8

e_contact_field_name ()

const gchar *
e_contact_field_name (EContactField field_id);

Gets the string representation of field_id .

e_contact_pretty_name ()

const gchar *
e_contact_pretty_name (EContactField field_id);

Gets a human-readable, translated string representation of field_id .

e_contact_vcard_attribute ()

const gchar *
e_contact_vcard_attribute (EContactField field_id);

Gets the vcard attribute corresponding to field_id , as a string.

e_contact_vcard_attribute_fallback ()

const gchar *
e_contact_vcard_attribute_fallback (EContactField field_id);

Gets the vCard attribute name corresponding to field_id , which is used to hold vCard attributes in an earlier versions of the vCard standard than in which the attribute had been added for.

Not every attribute has it set, thus a NULL is a valid return value.

Since: 3.60

e_contact_field_is_string ()

gboolean
e_contact_field_is_string (EContactField field_id);

Returns whether the field_id is of a string type, thus it can be used with e_contact_get_const().

Since: 3.16

e_contact_field_id ()

EContactField
e_contact_field_id (const gchar *field_name);

Gets the EContactField corresponding to the field_name .

e_contact_field_id_from_vcard ()

EContactField
e_contact_field_id_from_vcard (const gchar *vcard_field);

Gets the EContactField corresponding to the vcard_field .

Since: 2.26

e_contact_impp_scheme_to_field ()

EContactField
e_contact_impp_scheme_to_field (const gchar *scheme,
                                guint *out_scheme_len);

Tries to find one of the predefined EContactField for the scheme , which can be either the scheme itself, like "icq:", or a scheme with the value, like "icq:1234". The out_scheme_len can be used to return how many letters from the beginning of the scheme can be skipped to get to the actual value. Returns value E_CONTACT_FIELD_LAST means no matching EContactField was found for the scheme . The E_CONTACT_IMPP is never returned, then the scheme can be a valid scheme, only the EContactField does not have a mapping for it.

Since: 3.60

e_contact_impp_field_to_scheme ()

const gchar *
e_contact_impp_field_to_scheme (EContactField field);

Gets a scheme (like "icq:") for the corresponding IM field .

Since: 3.60

enum EContactField

EContactGeo

typedef struct {
	gdouble latitude;
	gdouble longitude;
} EContactGeo;

Since: 1.12

enum EContactPhotoType

enum EContactGenderSex