OW3.$splitmultipart()

Function group Execute on client Platform(s)
OW3 NO All

Syntax

OW3.$splitmultipart(cContentType, xContent, &lMIMEList [,iDefCharSet=kUniTypeUTF8, &cErrorText])

Description

Splits MIME-encoded multi-part xContent into lMIMEList. cContentType must include a boundary parameter. Returns true if successful. The parameters are:

Parameter Description
cContentType The content type header (must contain a boundary parameter)
xContent The binary content to split
lMIMEList Receives the MIME list created by splitting the MIME content. See the documentation for the MailSplit command to see how a MIME list is structured; however note that the charset in the OW3 MIME list is a kUniType... constant
iDefCharSet The default character set used to convert character data when there is no charset specified for a MIME text body part. A kUniType... constant (not Character/Auto/Binary)
&cErrorText If supplied, receives text describing the error that caused $splitmultipart to return false

The MIME list (for this call and for the other OW3 calls that generate a MIME list) now contains an additional column named bodypartheaders. This is a row containing a column for each non-empty header present for the body part. In addition, it has a column named "name" which contains the content-disposition header name parameter. All header names are normalized in the same way as those passed to RESTful services, that is, lower-case with any - characters removed.