Tcl

Get a Digest Message as an Email Object

Demonstrates the Chilkat Email.GetDigestEmail method, which copies the Nth digest email contained within a multipart/digest into another Email object. The first digest is at index 0; the NumDigests property gives the count. This example loads a digest email and lists each bundled message's subject.

Background: A multipart/digest packs many separate emails into one carrier message — historically used by mailing lists to send a single daily bundle of that day's posts. GetDigestEmail unpacks each member into a full Email object so it can be read or processed individually. This differs from GetAttachedEmail, which extracts messages attached to an ordinary email rather than the members of a digest.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the GetDigestEmail method, which copies the Nth digest email contained
#  within a multipart/digest into another Email object.  The first digest is at index 0;
#  use the NumDigests property for the count.

set email [new_CkEmail]

set success [CkEmail_LoadEml $email "qa_data/eml/digest.eml"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

set n [CkEmail_get_NumDigests $email]
puts "NumDigests = $n"

#  Retrieve each bundled message as its own Email object.
set digestEmail [new_CkEmail]

for {set i 0} {$i <= [expr $n - 1]} {incr i} {
    set success [CkEmail_GetDigestEmail $email $i $digestEmail]
    puts "Digest $i subject: [CkEmail_subject $digestEmail]"
}

#  Note: The path "qa_data/..." is a relative local filesystem path,
#  relative to the current working directory of the running application.

delete_CkEmail $email
delete_CkEmail $digestEmail