2 * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 2001 Match Grun
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 * Definitions necessary to access vCard files. vCard files are used
22 * by GnomeCard for addressbook, and Netscape for sending business
23 * card information. Refer to RFC2426 for more information.
33 #include "addrcache.h"
35 #define VCARDBUFSIZE 1024
37 #define VCARD_TAG_START "begin"
38 #define VCARD_TAG_END "end"
39 #define VCARD_NAME "vcard"
41 #define VCARD_TAG_FULLNAME "fn"
42 #define VCARD_TAG_NAME "n"
43 #define VCARD_TAG_EMAIL "email"
44 #define VCARD_TAG_UID "uid"
46 #define VCARD_TYPE_QP "quoted-printable"
48 #define VCARD_SEP_TAG ':'
49 #define VCARD_SEP_TYPE ';'
52 // Typical vCard entry:
56 // N:Rose;Axle;D;Ms;Jnr
57 // REV:2001-04-22T03:52:05
58 // ADR;HOME:;;777 Lexington Avenue;Denver;CO;80299;USA
59 // ADR;POSTAL:P O Box 777;;;Denver;CO;80298;Usa
60 // TEL;HOME:303-555-1234
61 // EMAIL;AOL:axlerose@aol.com
62 // EMAIL;INTERNET:axlerose@netscape.net
65 // URL:http://www.axlerose.com
70 typedef struct _VCardFile VCardFile;
75 gchar buffer[ VCARDBUFSIZE ];
77 AddressCache *addressCache;
82 // Function prototypes
83 VCardFile *vcard_create ( void );
84 VCardFile *vcard_create_path ( const gchar *path );
85 void vcard_set_name ( VCardFile* cardFile, const gchar *value );
86 void vcard_set_file ( VCardFile* cardFile, const gchar *value );
87 void vcard_set_modified ( VCardFile *vcardFile, const gboolean value );
88 void vcard_set_accessed ( VCardFile *vcardFile, const gboolean value );
89 gboolean vcard_get_modified ( VCardFile *vcardFile );
90 gboolean vcard_get_accessed ( VCardFile *vcardFile );
91 gboolean vcard_get_read_flag ( VCardFile *vcardFile );
92 gint vcard_get_status ( VCardFile *cardFile );
93 ItemFolder *vcard_get_root_folder ( VCardFile *cardFile );
94 gchar *vcard_get_name ( VCardFile *cardFile );
95 void vcard_free ( VCardFile *cardFile );
96 void vcard_force_refresh ( VCardFile *cardFile );
97 gint vcard_read_data ( VCardFile *cardFile );
98 GList *vcard_get_list_person ( VCardFile *cardFile );
99 GList *vcard_get_list_folder ( VCardFile *cardFile );
100 GList *vcard_get_all_persons ( VCardFile *cardFile );
101 gboolean vcard_validate ( const VCardFile *cardFile );
102 gchar *vcard_find_gnomecard ( void );
103 gint vcard_test_read_file ( const gchar *fileSpec );
105 #endif /* __VCARD_H__ */