Function

Soup-3.0Soupform_decode_multipart

  • 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 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 form_decode in the returned GLib.HashTable.

    You may pass null for filename, content_type and/or file if you do not care about those fields. 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 GLib.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 Multipart.new_from_message and Multipart.get_part.

    Parameters

    Returns [GLib.HashTable<string, string>, string, string, GLib.Bytes]

    a hash table containing the name/value pairs (other than file_control_name) from msg, which you can free with GLib.HashTable.destroy. On error, it will return null.