Tcl

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

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

set mime [new_CkMime]

set success [CkMime_LoadMimeFile $mime "qa_data/multipart_message.eml"]
if {$success == 0} then {
    puts [CkMime_lastErrorText $mime]
    delete_CkMime $mime
    exit
}

#  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.
set n [CkMime_get_NumParts $mime]
puts "Number of parts: $n"

set part [new_CkMime]

for {set i 0} {$i <= [expr $n - 1]} {incr i} {
    set success [CkMime_PartAt $mime $i $part]
    if {$success == 0} then {
        puts [CkMime_lastErrorText $mime]
        delete_CkMime $mime
        delete_CkMime $part
        exit
    }

    puts "Part $i Content-Type: [CkMime_contentType $part]"
}

delete_CkMime $mime
delete_CkMime $part