The MIME Directory Library (or libmimedir in short) is a versatile shared library for parsing and writing MIME Directory Information as described in [MIMEDIR]. Additionally, it contains classes for handling vCard (see [VCARD]) and iCalendar (see [ICAL]) files. Libmimedir is based on the GObject system and makes heavy use of its property system. Nearly all attributes of vCards or iCalendar components are accessible as properties, while some convenience access functions are provided. Please see the API description for more information. The core of libmimedir consists of two classes: MIMEDirAttribute and MIMEDirProfile. Each profile represents a collection of attributes that together form a directory entry. The classes MIMEDirVCard and MIMEDirVCal are built on top of MIMEDirProfile. These classes use MIMEDirProfile to parse an supplied file and interpret its contents as either a vCard or an iCalendar file. They can also write these file types. The following program will read a vCard file, iterate over all vCards and print the name of all cards: #include <stdio.h> #include <glib.h> #include <mimedir/mimedir.h> int main (int argc, char *argv[]) { GError *error = NULL; GList *list, *node; if (argc != 2) { fprintf (stderr, "Usage: %s FILENAME\n", argv[0]); return 1; } mimedir_init (); list = mimedir_vcard_read_list (argv[1], &error); if (error) { fprintf (stderr, "Error while reading %s: %s\n", argv[1], error->message); return 1; } for (node = list; node != NULL; node = g_list_next (node)) { MIMEDirVCard *vcard; gchar *name; vcard = MIMEDIR_VCARD (node->data); g_object_get (G_OBJECT (vcard), "name", &name, NULL); printf ("%s\n", name); } mimedir_vcard_free_list (list); return 0; } The current vCard and iCalendar standards ([VCARD, ICAL]) suggest the use of UTF-8 ([UTF-8]) as default encoding for vCard and iCalendar files. Since UTF-8 is the only portable way to store internationalized files, it is used by default by Libmimedir when files are saved. On loading, an UTF-8 encoding is assumed, if the encoding is not settable in the loading function. (The various load_from_channel functions define the encoding implicitly through the channel's encoding.) If the input is not in UTF-8, a conversion error will be returned. The two functions mimedir_vcard_read_list() and mimedir_vcal_read_list() are special cases; they open a file, first assuming it is in UTF-8 encoding. If the file contains invalid UTF-8 sequences, a second try is employed, using the current locale. If this fails, too, a third and final try is made, assuming the file is in ISO-8859-15 (aka ISO Latin 9) encoding.