/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* Authors: Jeffrey Stedfast <fejj@helixcode.com>
*
* Copyright 2000 Helix Code, Inc. (www.helixcode.com)
*
* 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 Street #330, Boston, MA 02111-1307, USA.
*
*/
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include <stdio.h>
#include <string.h>
#include <ctype.h>
#include "gmime-content-type.h"
#define d(x)
static int
param_equal (gconstpointer v, gconstpointer v2)
{
return strcasecmp ((const char *) v, (const char *) v2) == 0;
}
static guint
param_hash (gconstpointer key)
{
const char *p = key;
guint h = tolower (*p);
if (h)
for (p += 1; *p != '\0'; p++)
h = (h << 5) - h + tolower (*p);
return h;
}
/**
* g_mime_content_type_new:
* @type: MIME type (or NULL for "text")
* @subtype: MIME subtype (or NULL for "plain")
*
* Creates a Content-Type object with type @type and subtype @subtype.
*
* Returns a new MIME Content-Type object.
**/
GMimeContentType *
g_mime_content_type_new (const char *type, const char *subtype)
{
GMimeContentType *mime_type;
mime_type = g_new0 (GMimeContentType, 1);
if (type && *type && subtype && *subtype) {
mime_type->type = g_strdup (type);
mime_type->subtype = g_strdup (subtype);
} else {
if (type && *type) {
mime_type->type = g_strdup (type);
if (!g_strcasecmp (type, "text")) {
mime_type->subtype = g_strdup ("plain");
} else if (!g_strcasecmp (type, "multipart")) {
mime_type->subtype = g_strdup ("mixed");
} else {
g_free (mime_type->type);
mime_type->type = g_strdup ("application");
mime_type->subtype = g_strdup ("octet-stream");
}
} else {
mime_type->type = g_strdup ("application");
mime_type->subtype = g_strdup ("octet-stream");
}
g_warning ("Invalid or incomplete type: %s%s%s: defaulting to %s/%s",
type ? type : "", subtype ? "/" : "", subtype ? subtype : "",
mime_type->type, mime_type->subtype);
}
return mime_type;
}
/**
* g_mime_content_type_new_from_string:
* @string: input string containing a content-type (and params)
*
* Constructs a new Content-Type object based on the input string.
*
* Returns a new MIME Content-Type based on the input string.
**/
GMimeContentType *
g_mime_content_type_new_from_string (const char *string)
{
GMimeContentType *mime_type;
char *type = NULL, *subtype = NULL;
register char *inptr;
g_return_val_if_fail (string != NULL, NULL);
/* get the type */
type = (char *) string;
for (inptr = type; *inptr && *inptr != '/' && *inptr != ';'; inptr++);
type = g_strndup (type, (unsigned) (inptr - type));
g_strstrip (type);
/* get the subtype */
if (*inptr != ';') {
inptr++;
for (subtype = inptr; *inptr && *inptr != ';'; inptr++);
subtype = g_strndup (subtype, (unsigned) (inptr - subtype));
g_strstrip (subtype);
}
mime_type = g_mime_content_type_new (type, subtype);
g_free (type);
g_free (subtype);
if (*inptr++ == ';' && *inptr) {
GMimeParam *p;
mime_type->params = g_mime_param_new_from_string (inptr);
p = mime_type->params;
if (p != NULL) {
mime_type->param_hash = g_hash_table_new (param_hash, param_equal);
while (p) {
g_hash_table_insert (mime_type->param_hash, p->name, p);
p = p->next;
}
}
}
return mime_type;
}
/**
* g_mime_content_type_destroy: Destroy a MIME Content-Type object
* @mime_type: MIME Content-Type object to destroy
*
* Destroys the given MIME Content-Type object.
**/
void
g_mime_content_type_destroy (GMimeContentType *mime_type)
{
g_return_if_fail (mime_type != NULL);
g_free (mime_type->type);
g_free (mime_type->subtype);
if (mime_type->param_hash)
g_hash_table_destroy (mime_type->param_hash);
g_mime_param_destroy (mime_type->params);
g_free (mime_type);
}
/**
* g_mime_content_type_to_string:
* @mime_type: MIME Content-Type
*
* Allocates a string buffer containing the type and subtype defined
* by the @mime_type.
*
* Returns an allocated string containing the type and subtype of the
* content-type in the format: type/subtype.
**/
char *
g_mime_content_type_to_string (const GMimeContentType *mime_type)
{
char *string;
g_return_val_if_fail (mime_type != NULL, NULL);
/* type and subtype should never be NULL, but check anyway */
string = g_strdup_printf ("%s/%s", mime_type->type ? mime_type->type : "text",
mime_type->subtype ? mime_type->subtype : "plain");
return string;
}
/**
* g_mime_content_type_is_type:
* @mime_type: MIME Content-Type
* @type: MIME type to compare against
* @subtype: MIME subtype to compare against
*
* Compares the given type and subtype with that of the given mime
* type object.
*
* Returns TRUE if the MIME types match or FALSE otherwise. You may
* use "*" in place of @type and/or @subtype as a wilcard.
**/
gboolean
g_mime_content_type_is_type (const GMimeContentType *mime_type, const char *type, const char *subtype)
{
g_return_val_if_fail (mime_type != NULL, FALSE);
g_return_val_if_fail (mime_type->type != NULL, FALSE);
g_return_val_if_fail (mime_type->subtype != NULL, FALSE);
g_return_val_if_fail (type != NULL, FALSE);
g_return_val_if_fail (subtype != NULL, FALSE);
if (!strcasecmp (mime_type->type, type)) {
if (!strcmp (subtype, "*")) {
/* special case */
return TRUE;
} else {
if (!strcasecmp (mime_type->subtype, subtype))
return TRUE;
else
return FALSE;
}
}
return FALSE;
}
/**
* g_mime_content_type_add_parameter:
* @mime_type: MIME Content-Type
* @attribute: parameter name (aka attribute)
* @value: parameter value
*
* Adds a parameter to the Content-Type.
**/
void
g_mime_content_type_add_parameter (GMimeContentType *mime_type, const char *attribute, const char *value)
{
GMimeParam *param = NULL;
g_return_if_fail (mime_type != NULL);
g_return_if_fail (attribute != NULL);
g_return_if_fail (value != NULL);
if (mime_type->params) {
param = g_hash_table_lookup (mime_type->param_hash, attribute);
if (param) {
g_free (param->value);
param->value = g_strdup (value);
}
} else {
/* hash table may not be initialized */
if (!mime_type->param_hash)
mime_type->param_hash = g_hash_table_new (param_hash, param_equal);
}
if (param == NULL) {
param = g_mime_param_new (attribute, value);
mime_type->params = g_mime_param_append_param (mime_type->params, param);
g_hash_table_insert (mime_type->param_hash, param->name, param);
}
}
/**
* g_mime_content_type_get_parameter:
* @mime_type: MIME Content-Type
* @attribute: parameter name (aka attribute)
*
* Gets the parameter value specified by @attribute if it's available.
*
* Returns a const pointer to the paramer value specified by
* @attribute or %NULL on fail.
**/
const char *
g_mime_content_type_get_parameter (const GMimeContentType *mime_type, const char *attribute)
{
GMimeParam *param;
g_return_val_if_fail (mime_type != NULL, NULL);
g_return_val_if_fail (attribute != NULL, NULL);
if (!mime_type->param_hash)
return NULL;
param = g_hash_table_lookup (mime_type->param_hash, attribute);
if (param)
return param->value;
else
return NULL;
}
syntax highlighted by Code2HTML, v. 0.9.1