Xbase++

Access a Part in a Multipart MIME Entity

Demonstrates the Chilkat Mime.PartAt method, which provides live access to the direct child at a zero-based index. The first argument is the index and the second is a Mime object that will reference the child. Modifying it modifies the child stored in the parent tree.

Note: The file paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: This is how you reach into a multipart message to inspect or edit an individual part — read a part's Content-Type, extract an attachment's body, or change a part in place. The key point is that the returned Mime is a live reference, not a copy, so edits to it flow back into the parent tree. Loop from 0 to NumParts - 1 to visit every direct child.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oMime
LOCAL n
LOCAL oPart
LOCAL i

nSuccess := 0

oMime := CreateObject("Chilkat.Mime")
nSuccess := oMime:LoadMimeFile("qa_data/multipart_message.eml")
IF (nSuccess == 0)
    ? oMime:LastErrorText
    oMime:destroy()
    RETURN
ENDIF

//  PartAt provides LIVE access to a direct child part.  The 1st argument is the zero-based index
//  and the 2nd is a Mime object that will reference the child.  Modifying it modifies the child in
//  the parent tree.
n := oMime:NumParts
? "Number of parts: " + Str(n)

oPart := CreateObject("Chilkat.Mime")

FOR i := 0 TO n - 1
    nSuccess := oMime:PartAt(i, oPart)
    IF (nSuccess == 0)
        ? oMime:LastErrorText
        oMime:destroy()
        oPart:destroy()
        RETURN
    ENDIF

    ? "Part " + Str(i) + " Content-Type: " + oPart:ContentType
NEXT

oMime:destroy()
oPart:destroy()