GMimeContentDisposition

GMimeContentDisposition — Content-Disposition fields

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── 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.

Parameters

disposition

a GMimeContentDisposition object

 

attribute

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 value of the parameter attribute , or NULL on fail.

Parameters

disposition

a GMimeContentDisposition object

 

attribute

parameter name

 

Returns

the value of the parameter of name attribute .


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;

A data structure representing a Content-Disposition.

Members