GMimeContentDisposition

## GMimeContentDisposition GMimeContentDisposition — Content-Disposition fields |

## Functions

GMimeContentDisposition * | g_mime_content_disposition_new ()
GMimeContentDisposition * | g_mime_content_disposition_new_from_string ()
void | g_mime_content_disposition_set_disposition ()
const char * | g_mime_content_disposition_get_disposition ()
const GMimeParam * | g_mime_content_disposition_get_params ()
void | g_mime_content_disposition_set_params ()
void | g_mime_content_disposition_set_parameter ()
const char * | g_mime_content_disposition_get_parameter ()
char * | g_mime_content_disposition_to_string ()

## Types and Values

#define | GMIME_DISPOSITION_ATTACHMENT
#define | GMIME_DISPOSITION_INLINE
struct | GMimeContentDisposition

## Description

A GMimeContentDisposition represents the pre-parsed contents of a Content-Disposition header field.

## Functions

### g_mime_content_disposition_new ()

    GMimeContentDisposition *
    g_mime_content_disposition_new (void);

Creates a new GMimeContentDisposition object.

#### Returns

a new GMimeContentDisposition object.

### g_mime_content_disposition_new_from_string ()

    GMimeContentDisposition *
    g_mime_content_disposition_new_from_string
                                   (const char *str);

Creates a new GMimeContentDisposition object.

#### Parameters

str | Content-Disposition field value or `NULL` |

#### Returns

a new GMimeContentDisposition object.

### g_mime_content_disposition_set_disposition ()

    void
    g_mime_content_disposition_set_disposition
                                   (GMimeContentDisposition *disposition,
                                    const char *value);

Sets the disposition to `value` which may be one of GMIME_DISPOSITION_ATTACHMENT or GMIME_DISPOSITION_INLINE or, by your choice, any other string which would indicate how the MIME part should be displayed by the MUA.

#### Parameters

disposition | a GMimeContentDisposition object |
value | disposition value |

### g_mime_content_disposition_get_disposition ()

    const char *
    g_mime_content_disposition_get_disposition
                                   (GMimeContentDisposition *disposition);

Gets the disposition or `NULL` on fail.

#### Parameters

disposition | a GMimeContentDisposition object |

#### Returns

the disposition string which is probably one of GMIME_DISPOSITION_ATTACHMENT or GMIME_DISPOSITION_INLINE.

### g_mime_content_disposition_get_params ()

    const GMimeParam *
    g_mime_content_disposition_get_params (GMimeContentDisposition *disposition);

Gets the Content-Disposition parameter list.

#### Parameters

disposition | a GMimeContentDisposition object |

#### Returns

the list of GMimeParam's set on `disposition` .

### g_mime_content_disposition_set_params ()

    void
    g_mime_content_disposition_set_params (GMimeContentDisposition *disposition,
                                           GMimeParam *params);

Sets the Content-Disposition's parameter list.

#### Parameters

disposition | a GMimeContentDisposition object |
params | a list of GMimeParam objects |

### g_mime_content_disposition_set_parameter ()

    void
    g_mime_content_disposition_set_parameter
                                   (GMimeContentDisposition *disposition,
                                    const char *attribute,
                                    const char *value);

Sets a parameter on the Content-Disposition.

Note: The `name` should be in US-ASCII while the `value` should be in UTF-8.

#### Parameters

disposition | a GMimeContentDisposition object |
name | parameter name |
value | parameter value |

### g_mime_content_disposition_get_parameter ()

    const char *
    g_mime_content_disposition_get_parameter
                                   (GMimeContentDisposition *disposition,
                                    const char *attribute);

Gets the parameter value specified by `name` if it's available.

#### Parameters

disposition | a GMimeContentDisposition object |
name | parameter name |

#### Returns

the value of the requested parameter or `NULL` if the parameter is not set. If the parameter is set, the returned string will be in UTF-8.

### g_mime_content_disposition_to_string ()

    char *
    g_mime_content_disposition_to_string (GMimeContentDisposition *disposition,
                                          gboolean fold);

Allocates a string buffer containing the Content-Disposition header represented by the disposition object `disposition` .

#### Parameters

disposition | a GMimeContentDisposition object |
fold | fold header if needed |

#### Returns

a string containing the disposition header

## Types and Values

### GMIME_DISPOSITION_ATTACHMENT

    #define GMIME_DISPOSITION_ATTACHMENT "attachment"

Standard attachment disposition.

### GMIME_DISPOSITION_INLINE

    #define GMIME_DISPOSITION_INLINE     "inline"

Standard inline disposition.

### struct GMimeContentDisposition

    struct GMimeContentDisposition {
    	GObject parent_object;

    	GHashTable *param_hash;
    	GMimeParam *params;

    	gpointer priv;

    	char *disposition;
    };

A data structure representing a Content-Disposition.

#### Members

GObject `parent_object`; | parent GObject |
GHashTable *`param_hash`; | parameter hash table keyed by param name |
GMimeParam *`params`; | a GMimeParam list |
gpointer `priv`; |  |
char *`disposition`; | disposition |