Details
enum MIMEDirVCardKeyType
typedef enum {
MIMEDIR_VCARD_KEY_UNKNOWN, /* Key type is not known */
MIMEDIR_VCARD_KEY_X509, /* Key is a X.509 key */
MIMEDIR_VCARD_KEY_PGP /* Key is a PGP/GnuPG key */
} MIMEDirVCardKeyType; |
The type of a public key that is associated with the vCard.
MIMEDIR_VCARD_TIMEZONE_MAX
#define MIMEDIR_VCARD_TIMEZONE_MAX (+23 * 60 + 59) |
Maximum valid value for the timezone parameter.
MIMEDIR_VCARD_TIMEZONE_MIN
#define MIMEDIR_VCARD_TIMEZONE_MIN (-23 * 60 + 59) |
Minimum valid value for the timezone parameter.
MIMEDIR_VCARD_LATITUDE_MAX
#define MIMEDIR_VCARD_LATITUDE_MAX (+90.0) |
Maximum valid value for the latitude parameter.
MIMEDIR_VCARD_LATITUDE_MIN
#define MIMEDIR_VCARD_LATITUDE_MIN (-90.0) |
Minimum valid value for the latitude parameter.
MIMEDIR_VCARD_LONGITUDE_MAX
#define MIMEDIR_VCARD_LONGITUDE_MAX (+180.0) |
Maximum valid value for the longitude parameter.
MIMEDIR_VCARD_LONGITUDE_MIN
#define MIMEDIR_VCARD_LONGITUDE_MIN (-180.0) |
Minimum valid value for the longitude parameter.
struct MIMEDirVCard
struct MIMEDirVCard
{
GObject parent;
MIMEDirVCardPriv *priv;
}; |
The MIMEDirVCard struct contains private data only, and
should be accessed using the functions below.
mimedir_vcard_read_list ()
Reads a list of vCards from the supplied file and returns it. error
will be set if an error occurs. You should free the returned list with
mimedir_vcard_free_list().
mimedir_vcard_read_list_from_channel ()
Reads a list of vCards from the supplied I/O channel and returns it. error
will be set if an error occurs. You should free the returned list with
mimedir_vcard_free_list().
mimedir_vcard_write_list ()
Saves a list of vCard to a file.
mimedir_vcard_write_list_to_channel ()
Saves a list of vCard to an I/O channel.
mimedir_vcard_new ()
Creates a new (empty) vCard object.
mimedir_vcard_new_from_channel ()
Create a new vCard object and fills it with data retrieved from the
supplied I/O channel. If an error occurs during the read, error
will be set and NULL will be returned.
mimedir_vcard_read_from_channel ()
Clears the supplied vCard object and re-initializes it with data read
from the supplied I/O channel. If an error occurs during the read,
error will be set and FALSE will be returned. Otherwise, TRUE is
returned.
mimedir_vcard_write_to_channel ()
Saves the vCard object to the supplied I/O channel. If an error occurs
during the write, error will be set and FALSE will be returned.
Otherwise, TRUE is returned.
mimedir_vcard_write_to_buffer ()
Saves the vCard object to a newly allocated memory buffer. You should
free the returned buffer with g_free().
mimedir_vcard_append_address ()
Appends the supplied address object to the vCard.
mimedir_vcard_remove_address ()
Removes the supplied address to the vCard.
mimedir_vcard_append_email ()
Appends the supplied e-mail address to the vCard.
mimedir_vcard_remove_email ()
Removes the supplied e-mail address from the vCard.
mimedir_vcard_append_phone ()
Appends the supplied telephone number to the vCard.
mimedir_vcard_remove_phone ()
Removes the supplied telephone number from the vCard.
mimedir_vcard_get_preferred_address ()
Returns the preferred address of the supplied vCard object. If no address
has the preferred flag set, the first address of the address list is
returned. If the address list is empty, NULL is returned.
mimedir_vcard_get_preferred_email ()
Returns the preferred email address of the supplied vCard object. If no
email address has the preferred flag set, the first email address of the
email address list is returned. If the email address list is empty, NULL
is returned.
mimedir_vcard_get_preferred_phone ()
Returns the preferred phone number of the supplied vCard object. If no
phone number has the preferred flag set, the first phone number of the
phone number list is returned. If the phone number list is empty, NULL
is returned.
mimedir_vcard_get_as_string ()
Returns the contents of the vCard object as a multi-line human-readable
string. It is not guaranteed that this string is of a particular
format or contains all information from the vCard object. Nevertheless,
it will contain all vital information. You should free the returned
string with g_free().