GskMimeMultipartDecoder read Content-Type multipart/*. This code implements the MIME multipart encapsulation format, which is defined in "RFC 2046, Section 5: MIME MultipartDecoder Media Types". This format is often encountered parsing form data from webpages. Function to invoke when a new piece is available. @multipart_decoder: the decoder which can be read from. @Returns: whether to continue being notified of the availability of un-retrieved pieces. Multipart pieces may be streaming or a memory buffer. This gives the user control over which format to use. (Note: currently #GSK_MIME_MULTIPART_DECODER_MODE_DEFAULT acts like #GSK_MIME_MULTIPART_DECODER_MODE_ALWAYS_STREAM.) @GSK_MIME_MULTIPART_DECODER_MODE_DEFAULT: The pieces may be either streaming, or pure memory, whichever is easier. @GSK_MIME_MULTIPART_DECODER_MODE_ALWAYS_MEMORY: The pieces must be memory slabs. They will not be available until all there data has been received and parsed. @GSK_MIME_MULTIPART_DECODER_MODE_ALWAYS_STREAM: The pieces must be streams, even if that means allocating a stream for just a few bytes. This is can be slightly inconvenient. @base_class: @set_poll_new_part: @shutdown_new_part: @base_instance: @type: @start: @start_info: @kv_pairs: @Returns: @decoder: @mode: @decoder: @Returns: Get notification when a MIME piece is available. @multipart_decoder: the decoder to watch. @func: function to invoke when a piece is available. (It will be invoked repeatedly until all the pieces have been dequeued) @shutdown: function to invoke when no more pieces will ever be available. @data: data to pass to @func, @shutdown and @destroy. @destroy: data to call when the trap is destroyed. Untrap the new-piece-available hook. Its destroy method will be run. @multipart_decoder: the decoder to stop watching. Stop notifying about new MIME piece availability, if we are currently notifying. Invocations to this function may be stacked; it is undone with gsk_mime_multipart_decoder_unblock(). @multipart_decoder: the #GskMimeMultipartDecoder to watch. Resume notifying about new MIME piece availability, if we are currently notifying and if this is the last blocker. It undones one invocation of gsk_mime_multipart_decoder_block(). @multipart_decoder: the #GskMimeMultipartDecoder to stop watching.