claws-mail/src/vcard.h

/*
 * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
 * Copyright (C) 2001 Match Grun
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

/*
 * Definitions necessary to access VCard files. VCard files are used
 * by GnomeCard for addressbook, and Netscape for sending business
 * card information. Refer to RFC2426 for more information.
 */

#ifndef __VCARD_H__
#define __VCARD_H__

#include <stdio.h>
#include <glib.h>

#include "addritem.h"
#include "addrcache.h"

#define VCARDBUFSIZE       1024

#define	VCARD_TAG_START    "begin"
#define	VCARD_TAG_END      "end"
#define	VCARD_NAME         "vcard"

#define	VCARD_TAG_FULLNAME "fn"
#define VCARD_TAG_NAME     "n"
#define	VCARD_TAG_EMAIL    "email"
#define VCARD_TAG_UID      "uid"

#define VCARD_TYPE_QP      "quoted-printable"

#define	VCARD_SEP_TAG      ':'
#define	VCARD_SEP_TYPE     ';'

/*
// Typical VCard entry:
//
// BEGIN:VCARD
// FN:Axle Rose
// N:Rose;Axle;D;Ms;Jnr
// REV:2001-04-22T03:52:05
// ADR;HOME:;;777 Lexington Avenue;Denver;CO;80299;USA
// ADR;POSTAL:P O Box 777;;;Denver;CO;80298;Usa
// TEL;HOME:303-555-1234
// EMAIL;AOL:axlerose@aol.com
// EMAIL;INTERNET:axlerose@netscape.net
// TITLE:Janitor
// ORG:The Company
// URL:http://www.axlerose.com
// END:VCARD
*/

// VCard object
typedef struct _VCardFile VCardFile;
struct _VCardFile {
	gchar        *name;
	FILE         *file;
	gchar        *path;
	gchar        buffer[ VCARDBUFSIZE ];
	gchar        *bufptr;
	AddressCache *addressCache;
	gint         retVal;
	gboolean     accessFlag;
};

// Function prototypes
VCardFile *vcard_create			( void );
VCardFile *vcard_create_path		( const gchar *path );
void vcard_set_name			( VCardFile* cardFile, const gchar *value );
void vcard_set_file			( VCardFile* cardFile, const gchar *value );
void vcard_set_modified			( VCardFile *vcardFile, const gboolean value );
void vcard_set_accessed			( VCardFile *vcardFile, const gboolean value );
gboolean vcard_get_modified		( VCardFile *vcardFile );
gboolean vcard_get_accessed		( VCardFile *vcardFile );
gboolean vcard_get_read_flag		( VCardFile *vcardFile );
gint vcard_get_status			( VCardFile *cardFile );
ItemFolder *vcard_get_root_folder	( VCardFile *cardFile );
gchar *vcard_get_name			( VCardFile *cardFile );
void vcard_free				( VCardFile *cardFile );
void vcard_force_refresh		( VCardFile *cardFile );
gint vcard_read_data			( VCardFile *cardFile );
GList *vcard_get_list_person		( VCardFile *cardFile );
GList *vcard_get_list_folder		( VCardFile *cardFile );
GList *vcard_get_all_persons		( VCardFile *cardFile );
gboolean vcard_validate			( const VCardFile *cardFile );
gchar *vcard_find_gnomecard		( void );
gint vcard_test_read_file		( const gchar *fileSpec );

#endif /* __VCARD_H__ */