Tcl

Count the Messages in a multipart/digest Email

Demonstrates the read-only Chilkat Email.NumDigests property, which is the number of message/rfc822 parts contained within a multipart/digest enclosure. If no such enclosure exists, the value is 0. Digest indexes are zero-based; use GetDigestEmail to retrieve an individual bundled message as its own Email object. This example loads a digest email and lists each message's subject.

Background: A multipart/digest is a way to package many separate emails inside one carrier message — historically used by mailing lists to send a single daily "digest" containing all of that day's posts. Each bundled item is a complete message/rfc822 email with its own headers and body. This differs from NumAttachedMessages, which counts nested messages attached to an ordinary email rather than the members of a digest enclosure.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the read-only Email.NumDigests property, which is the number of
#  message/rfc822 parts contained within a multipart/digest enclosure.  If there is no
#  multipart/digest enclosure, the value is 0.  Digest indexes are zero-based.

set email [new_CkEmail]

#  Load a multipart/digest email (a single email that bundles many messages).
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: Paths such as "qa_data/..." are relative local filesystem paths,
#  relative to the current working directory of the running application.

delete_CkEmail $email
delete_CkEmail $digestEmail