## gmime-param

gmime-param —

## Synopsis

    struct      GMimeParam;
    GMimeParam* g_mime_param_new                (const char *name,
                                                 const char *value);
    GMimeParam* g_mime_param_new_from_string    (const char *string);
    void        g_mime_param_destroy            (GMimeParam *param);
    GMimeParam* g_mime_param_append             (GMimeParam *params,
                                                 const char *name,
                                                 const char *value);
    GMimeParam* g_mime_param_append_param       (GMimeParam *params,
                                                 GMimeParam *param);
    void        g_mime_param_write_to_string    (GMimeParam *param,
                                                 gboolean fold,
                                                 GString *string);

## Description

## Details

### struct GMimeParam

    struct GMimeParam {

    	struct _GMimeParam *next;
    	char *name;
    	char *value;
    };

### g_mime_param_new ()

    GMimeParam* g_mime_param_new                (const char *name,
                                                 const char *value);

Creates a new GMimeParam node with name `name` and value `value`.

`name` : | parameter name
`value` : | parameter value
Returns : | a new paramter structure.

### g_mime_param_new_from_string ()

    GMimeParam* g_mime_param_new_from_string    (const char *string);

Creates a parameter list based on the input string.

`string` : | input string
Returns : | a GMimeParam structure based on `string`.

### g_mime_param_destroy ()

    void        g_mime_param_destroy            (GMimeParam *param);

Releases all memory used by this mime param back to the Operating System.

`param` : | Mime param list to destroy

### g_mime_param_append ()

    GMimeParam* g_mime_param_append             (GMimeParam *params,
                                                 const char *name,
                                                 const char *value);

Appends a new parameter with name `name` and value `value` to the parameter list `params`.

`params` : | param list
`name` : | new param name
`value` : | new param value
Returns : | a param list with the new param of name `name` and value `value` appended to the list of params `params`.

### g_mime_param_append_param ()

    GMimeParam* g_mime_param_append_param       (GMimeParam *params,
                                                 GMimeParam *param);

Appends `param` to the param list `params`.

`params` : | param list
`param` : | param to append
Returns : | a param list with the new param `param` appended to the list of params `params`.

### g_mime_param_write_to_string ()

    void        g_mime_param_write_to_string    (GMimeParam *param,
                                                 gboolean fold,
                                                 GString *string);

Assumes the output string contains only the Content-* header and it's immediate value.

Writes the params out to the string `string`.

`param` : | MIME Param list
`fold` : | specifies whether or not to fold headers
`string` : | output string