path: root/camel/camel-address.c

/*
 *  Copyright (C) 2000 Helix Code Inc.
 *
 *  Authors: Michael Zucchi <notzed@helixcode.com>
 *
 *  This program is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Library 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 Library General Public License for more details.
 *
 *  You should have received a copy of the GNU Library General Public
 *  License along with this program; if not, write to the Free Software
 *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#include "camel-address.h"


static void camel_address_class_init (CamelAddressClass *klass);
static void camel_address_init       (CamelAddress *obj);
static void camel_address_finalise   (GtkObject *obj);

static CamelObjectClass *camel_address_parent;

enum SIGNALS {
    LAST_SIGNAL
};

static guint signals[LAST_SIGNAL] = { 0 };

guint
camel_address_get_type (void)
{
    static guint type = 0;
    
    if (!type) {
        GtkTypeInfo type_info = {
            "CamelAddress",
            sizeof (CamelAddress),
            sizeof (CamelAddressClass),
            (GtkClassInitFunc) camel_address_class_init,
            (GtkObjectInitFunc) camel_address_init,
            (GtkArgSetFunc) NULL,
            (GtkArgGetFunc) NULL
        };
        
        type = gtk_type_unique (camel_object_get_type (), &type_info);
    }
    
    return type;
}

static void
camel_address_class_init (CamelAddressClass *klass)
{
    GtkObjectClass *object_class = (GtkObjectClass *) klass;
    
    camel_address_parent = gtk_type_class (camel_object_get_type ());

    object_class->finalize = camel_address_finalise;

    gtk_object_class_add_signals (object_class, signals, LAST_SIGNAL);
}

static void
camel_address_init (CamelAddress *obj)
{
    obj->addresses = g_ptr_array_new();
}

static void
camel_address_finalise (GtkObject *obj)
{
    camel_address_remove((CamelAddress *)obj, -1);

    ((GtkObjectClass *)(camel_address_parent))->finalize((GtkObject *)obj);
}

/**
 * camel_address_new:
 *
 * Create a new CamelAddress object.
 * 
 * Return value: A new CamelAddress widget.
 **/
CamelAddress *
camel_address_new (void)
{
    CamelAddress *new = CAMEL_ADDRESS ( gtk_type_new (camel_address_get_type ()));
    return new;
}


/**
 * camel_address_decode:
 * @a: An address.
 * @raw: Raw address description.
 * 
 * Construct a new address from a raw address field.
 * 
 * Return value: Returns the number of addresses found,
 * or -1 if the addresses could not be parsed fully.
 **/
int
camel_address_decode    (CamelAddress *a, const char *raw)
{
    g_return_val_if_fail(IS_CAMEL_ADDRESS(a), -1);

    return ((CamelAddressClass *)((GtkObject *)a)->klass)->decode(a, raw);
}

/**
 * camel_address_encode:
 * @a: 
 * 
 * Encode an address in a format suitable for a raw header.
 * 
 * Return value: The encoded address.
 **/
char *
camel_address_encode    (CamelAddress *a)
{
    g_return_val_if_fail(IS_CAMEL_ADDRESS(a), NULL);

    return ((CamelAddressClass *)((GtkObject *)a)->klass)->encode(a);
}

/**
 * camel_address_remove:
 * @a: 
 * @index: The address to remove, use -1 to remove all address.
 * 
 * Remove an address by index, or all addresses.
 **/
void
camel_address_remove    (CamelAddress *a, int index)
{
    g_return_if_fail(IS_CAMEL_ADDRESS(a));

    if (index == -1) {
        for (index=a->addresses->len; index>-1; index--)
            ((CamelAddressClass *)((GtkObject *)a)->klass)->remove(a, index);
    } else {
        ((CamelAddressClass *)((GtkObject *)a)->klass)->remove(a, index);
    }
}