Function
Soupform_decode_multipart
Declaration [src]
GHashTable*
soup_form_decode_multipart (
SoupMultipart* multipart,
const char* file_control_name,
char** filename,
char** content_type,
GBytes** file
)
Description [src]
Decodes the “multipart/form-data” request in multipart.
this is a convenience method for the case when you have a single file upload
control in a form. (Or when you don’t have any file upload controls, but are
still using “multipart/form-data” anyway.) Pass the name of the file upload
control in file_control_name, and soup_form_decode_multipart() will extract
the uploaded file data into filename, content_type, and file. All of the
other form control data will be returned (as strings, as with
soup_form_decode() in the returned GHashTable.
You may pass NULL for filename, content_type and/or file if you do not
care about those fields. soup_form_decode_multipart() may also
return NULL in those fields if the client did not provide that
information. You must free the returned filename and content-type
with g_free(), and the returned file data with Glib.Bytes.unref.
If you have a form with more than one file upload control, you will
need to decode it manually, using soup_multipart_new_from_message()
and soup_multipart_get_part().
Parameters
multipart |
SoupMultipart |
A |
|
| The data is owned by the caller of the function. | |
file_control_name |
const char* |
The name of the HTML file upload control. |
|
The argument can be NULL. | |
| The data is owned by the caller of the function. | |
| The value is a NUL terminated UTF-8 string. | |
filename |
char** |
Return location for the name of the uploaded file. |
|
| The argument will be set by the function. | |
The argument can be NULL. | |
| The called function takes ownership of the data, and is responsible for freeing it. | |
| The value is a NUL terminated UTF-8 string. | |
content_type |
char** |
Return location for the MIME type of the uploaded file. |
|
| The argument will be set by the function. | |
The argument can be NULL. | |
| The called function takes ownership of the data, and is responsible for freeing it. | |
| The value is a NUL terminated UTF-8 string. | |
file |
GBytes |
Return location for the uploaded file data. |
|
| The argument will be set by the function. | |
The argument can be NULL. | |
| The called function takes ownership of the data, and is responsible for freeing it. |
Return value
| Returns: | GHashTable |
a hash table containing the name/value pairs (other than
|
|
| The caller of the function takes ownership of the data container, but not the data inside it. | |
The return value can be NULL. |