PureBasic

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 PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkMime.pb"

Procedure ChilkatExample()

    success.i = 0

    mime.i = CkMime::ckCreate()
    If mime.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkMime::ckLoadMimeFile(mime,"qa_data/multipart_message.eml")
    If success = 0
        Debug CkMime::ckLastErrorText(mime)
        CkMime::ckDispose(mime)
        ProcedureReturn
    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.i = CkMime::ckNumParts(mime)
    Debug "Number of parts: " + Str(n)

    part.i = CkMime::ckCreate()
    If part.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    i.i
    For i = 0 To n - 1
        success = CkMime::ckPartAt(mime,i,part)
        If success = 0
            Debug CkMime::ckLastErrorText(mime)
            CkMime::ckDispose(mime)
            CkMime::ckDispose(part)
            ProcedureReturn
        EndIf

        Debug "Part " + Str(i) + " Content-Type: " + CkMime::ckContentType(part)
    Next


    CkMime::ckDispose(mime)
    CkMime::ckDispose(part)


    ProcedureReturn
EndProcedure