| GMime Reference Manual | ||||
|---|---|---|---|---|
GMimeContentType;
GMimeContentType* g_mime_content_type_new (const char *type,
const char *subtype);
GMimeContentType* g_mime_content_type_new_from_string (const char *string);
void g_mime_content_type_destroy (GMimeContentType *mime_type);
char* g_mime_content_type_to_string (const GMimeContentType *mime_type);
gboolean g_mime_content_type_is_type (const GMimeContentType *mime_type,
const char *type,
const char *subtype);
void g_mime_content_type_set_parameter (GMimeContentType *mime_type,
const char *attribute,
const char *value);
const char* g_mime_content_type_get_parameter (const GMimeContentType *mime_type,
const char *attribute);
typedef struct {
char *type;
char *subtype;
GMimeParam *params;
GHashTable *param_hash;
} GMimeContentType;
GMimeContentType* g_mime_content_type_new (const char *type, const char *subtype);
Creates a Content-Type object with type type and subtype subtype.
type : |
MIME type (or NULL for "text") |
subtype : |
MIME subtype (or NULL for "plain") |
| Returns : | a new MIME Content-Type object. |
GMimeContentType* g_mime_content_type_new_from_string (const char *string);
Constructs a new Content-Type object based on the input string.
string : |
input string containing a content-type (and params) |
| Returns : | a new MIME Content-Type based on the input string. |
void g_mime_content_type_destroy (GMimeContentType *mime_type);
Destroys the given MIME Content-Type object.
mime_type : |
MIME Content-Type object to destroy |
char* g_mime_content_type_to_string (const GMimeContentType *mime_type);
Allocates a string buffer containing the type and subtype defined
by the mime_type.
mime_type : |
MIME Content-Type |
| Returns : | an allocated string containing the type and subtype of the content-type in the format: type/subtype. |
gboolean g_mime_content_type_is_type (const GMimeContentType *mime_type, const char *type, const char *subtype);
Compares the given type and subtype with that of the given mime type object.
mime_type : |
MIME Content-Type |
type : |
MIME type to compare against |
subtype : |
MIME subtype to compare against |
| Returns : | TRUE if the MIME types match or FALSE otherwise. You may
use "*" in place of type and/or subtype as a wilcard.
|
void g_mime_content_type_set_parameter (GMimeContentType *mime_type, const char *attribute, const char *value);
Sets a parameter on the Content-Type.
mime_type : |
MIME Content-Type |
attribute : |
parameter name (aka attribute) |
value : |
parameter value |
const char* g_mime_content_type_get_parameter (const GMimeContentType *mime_type, const char *attribute);
Gets the parameter value specified by attribute if it's available.
mime_type : |
MIME Content-Type |
attribute : |
parameter name (aka attribute) |
| Returns : | a const pointer to the paramer value specified by
attribute or NULL on fail.
|