|  |  |  | GMime 2.6 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
GMimeParam; GMimeParam * g_mime_param_new (const char *name,const char *value); GMimeParam * g_mime_param_new_from_string (const char *str); void g_mime_param_destroy (GMimeParam *param); const GMimeParam * g_mime_param_next (const GMimeParam *param); const char * g_mime_param_get_name (const GMimeParam *param); const char * g_mime_param_get_value (const 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 (const GMimeParam *param,gboolean fold,GString *str);
A GMimeParam is a parameter name/value pair as found on MIME header fields such as Content-Type and Content-Disposition.
typedef struct {
	GMimeParam *next;
	char *name;
	char *value;
} GMimeParam;
A parameter name/value pair as used for some Content header fields.
| GMimeParam * | Pointer to the next param. | 
| Parameter name. | |
| Parameter value. | 
GMimeParam * g_mime_param_new (const char *name,const char *value);
Creates a new GMimeParam node with name name and value value.
| 
 | parameter name | 
| 
 | parameter value | 
| Returns : | a new paramter structure. | 
GMimeParam *        g_mime_param_new_from_string        (const char *str);
Creates a parameter list based on the input string.
| 
 | input string | 
| Returns : | a GMimeParam structure based on string. | 
void                g_mime_param_destroy                (GMimeParam *param);
Releases all memory used by this mime param back to the Operating System.
| 
 | Mime param list to destroy | 
const GMimeParam *  g_mime_param_next                   (const GMimeParam *param);
Gets the next GMimeParam node in the list.
| 
 | a GMimeParam node | 
| Returns : | the next GMimeParam node in the list. | 
const char *        g_mime_param_get_name               (const GMimeParam *param);
Gets the name of the parameter.
| 
 | a GMimeParam | 
| Returns : | the name of the parameter. | 
const char *        g_mime_param_get_value              (const GMimeParam *param);
Gets the value of the parameter.
| 
 | a GMimeParam | 
| Returns : | the value of the parameter. | 
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.
| 
 | param list | 
| 
 | new param name | 
| 
 | new param value | 
| Returns : | a param list with the new param of name nameand valuevalueappended to the list of paramsparams. | 
GMimeParam * g_mime_param_append_param (GMimeParam *params,GMimeParam *param);
Appends param to the param list params.
| 
 | param list | 
| 
 | param to append | 
| Returns : | a param list with the new param paramappended to the list
of paramsparams. | 
void g_mime_param_write_to_string (const GMimeParam *param,gboolean fold,GString *str);
Assumes the output string contains only the Content-* header and it's immediate value.
Writes the params out to the string string.
| 
 | MIME Param list | 
| 
 | specifies whether or not to fold headers | 
| 
 | output string |