aboutsummaryrefslogblamecommitdiffstats
path: root/camel/gmime-content-field.c
blob: e37c319b555d61ec3ff6cba3703b7da0774d3c35 (plain) (tree)






















                                                                           
                   
                                
                        
                      
 
 
 














                                                                  
 
                               
 
                                           

                               
                                                                      
        
                   


  











                                                                                    
     
                                                                                                                

                                  

                             




                                                                                     
                          
                               




                                                                          


 








                                                                 


                                                                    



                                                       
                                                   
                                         
                                                   
                                          
        


   
                                                                      
                                      
                      



    
                                                                                           
 
                                   
                                                                    


                                                                                                 

                                          
                                                                                           
                                                         

         
 
        

                                                                    
                         

                                              
                                                   








                                                                             
                                                                                           
 


                        

                                        

                           
                                                                                  

                               









                                                                            
        


                          
                         
                                               



                                                          



                                                 
                                                                



                                              





                                                         


                                                                                


                    







                                                               
                                                                                   

                                  
                                                        
                                                                 




                                                                                                    


                                                
 

















                                                                                
 
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/* mime-content_field.c : mime content type field utilities  */

/* 
 *
 * Copyright (C) 1999 Bertrand Guiheneuf <Bertrand.Guiheneuf@inria.fr> .
 *
 * 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
 */

#include <config.h>
#include "gmime-content-field.h"
/* #include "-util.h" */
#include "camel-log.h"

/

/**
 * gmime_content_field_new: Creates a new GMimeContentField object
 * @type: mime type
 * @subtype: mime subtype 
 * 
 * Creates a GMimeContentField object and initialize it with
 * a mime type and a mime subtype. For example, 
 * gmime_content_field_new ("application", "postcript");
 * will create a content field with complete mime type 
 * "application/postscript"
 * 
 * Return value: The newly created GMimeContentField object
 **/
void
gmime_content_field_new (const gchar *type, const gchar *subtype)
{
    GMimeContentField *ctf;

    ctf = g_new (GMimeContentField, 1);
    ctf->type = type;
    ctf->subtype = subtype;
    ctf->parameters =  g_hash_table_new (g_str_hash, g_str_equal);
    
    return ctf;
} 


/**
 * gmime_content_field_set_parameter: set a parameter for a GMimeContentField object
 * @content_field: content field
 * @attribute: parameter name 
 * @value: paramteter value
 * 
 * set a parameter (called attribute in RFC 2045) of a content field. Meaningfull
 * or valid parameters name depend on the content type object. For example, 
 * gmime_content_field_set_parameter (cf, "charset", "us-ascii");
 * will make sense for a "text/plain" content field but not for a 
 * "image/gif". This routine does not check parameter validuty.
 **/
void 
gmime_content_field_set_parameter (GMimeContentField *content_field, const gchar *attribute, const gchar *value)
{
    gboolean attribute_exists;
    gchar *old_attribute;
    gchar *old_value;

    attribute_exists = g_hash_table_lookup_extended (content_field->parameters, 
                             attribute, 
                             (gpointer *) &old_attribute,
                             (gpointer *) &old_value);
    /** CHECK THAT **/
    if (attribute_exists) {
        g_string_free (old_value, TRUE);
        g_string_free (old_attribute, TRUE);
    } 
        
    g_hash_table_insert (content_field->parameters, attribute, value);
}


/**
 * _print_parameter: print a parameter/value pair to a stream as 
 * described in RFC 2045
 * @name: name of the parameter
 * @value: value of the parameter
 * @user_data: CamelStream object to write the text to.
 * 
 * 
 **/
static void
_print_parameter (gpointer name, gpointer value, gpointer user_data)
{
    CamelStream *stream = (CamelStream *)user_data;
    
    camel_stream_write_strings (stream, 
                    "; \n    ", 
                    (gchar *)name, 
                    "=", 
                    (gchar *)value,
                    NULL);
    
}

/**
 * gmime_content_field_write_to: write a mime content type to a stream
 * @content_field: content type object
 * @stream: the stream
 * 
 * 
 **/
void
gmime_content_field_write_to_stream (GMimeContentField *content_field, CamelStream *stream)
{
    if (!content_field) return;
    if ((content_field->type) && ((content_field->type)->str)) {
        camel_stream_write_strings (stream, "Content-Type: ", content_field->type, NULL);
        if (content_field->subtype) {
            camel_stream_write_strings (stream, "/", content_field->subtype, NULL);
        }
        /* print all parameters */
        g_hash_table_foreach (content_field->parameters, _print_parameter, stream);
        camel_stream_write_string (stream, "\n");
    }
}

gchar * 
gmime_content_field_get_mime_type (GMimeContentField *content_field)
{
    gchar *mime_type;

    if (!content_field->type) return NULL;
    mime_type = g_strdup (content_field->type);
    if (content_field->subtype) {
        g_string_append_c (mime_type, '/');
        g_string_append_g_string (mime_type, content_field->subtype);
    }
    return mime_type;
}


void
gmime_content_field_construct_from_string (GMimeContentField *content_field, gchar *string)
{
    gint first, len;
    gchar *str;
    gint i=0;
    gchar *type, *subtype;
    gchar *param_name, *param_value;
    gboolean param_end;
    
    CAMEL_LOG (TRACE, "Entering gmime_content_field_construct_from_string\n");
    g_assert (string);
    g_assert (string->str);
    g_assert (content_field);
 
    if (content_field->type) {
        CAMEL_LOG (FULL_DEBUG, "Freeing old mime type string\n");
        g_string_free (content_field->type, FALSE);
    }
    if (content_field->subtype) {
        CAMEL_LOG (FULL_DEBUG, "Freeing old mime type substring\n");
        g_string_free (content_field->subtype, FALSE);
    }
    
    str = string->str;
    first = 0;
    len = string->len;
    if (!len) return;
    CAMEL_LOG (TRACE, "All checks done\n");

    /* find the type */
    while ( (i<len) && (!strchr ("/;", str[i])) ) i++;
    
    if (i == 0) return;
    
    type = g_string_new (g_strndup (str, i));
    content_field->type = type;
    CAMEL_LOG (TRACE, "Found mime type : %s\n", type->str); 
    if (i == len) {
        content_field->subtype = NULL;
        return;
    }
    
    first = i+1;
    /* find the subtype, if any */
    if (str[i++] == '/') {
        while ( (i<len) && (str[i] != ';') ) i++;
        if (i != first) {
            subtype = g_string_new (g_strndup (str+first, i-first));
            content_field->subtype = subtype;
            if (i == len) return;
        }
    }
    first = i+1;

    /* parse parameters list */
    param_end = FALSE;
    do {
        while ( (i<len) && (str[i] != '=') ) i++;
        if ((i == len) || (i==first)) param_end = TRUE;
        else {
            /* we have found parameter name */
            param_name = g_string_new (g_strndup (str+first, i-first));
            i++;
            first = i;
            /* Let's find parameter value */
            while ( (i<len) && (str[i] != ';') ) i++;
            if (i != first) param_value = g_string_new (g_strndup (str+first, i-first));
            else param_value = g_string_new ("");
            gmime_content_field_set_parameter (content_field, param_name, param_value);
            i++;
            first = i;
        }
    } while ((!param_end) && (first < len));


}


static void
_free_parameter (gpointer name, gpointer value, gpointer user_data)
{
    g_string_free (name, FALSE);
    g_string_free (value, FALSE);
}

void 
gmime_content_field_free (GMimeContentField *content_field)
{
    g_hash_table_foreach (content_field->parameters, _free_parameter, NULL);
    g_string_free (content_field->type, FALSE);
    g_string_free (content_field->subtype, FALSE);
    g_hash_table_destroy (content_field->parameters);
    g_free (content_field);
}