Tcl

Count the Report Parts in a multipart/report Email

Demonstrates the read-only Chilkat Email.NumReports property, which is the number of report parts in a multipart/report email. A part is counted as a report when its Content-Type is message/* (except message/rfc822) or text/rfc822-headers. Use GetReport to retrieve the body of each report part; indexes are zero-based. This example loads a report email and prints each report part.

Background: When a message can't be delivered, the mail system usually sends back a bounce known as a Delivery Status Notification (DSN). DSNs use the multipart/report structure, which bundles several parts: a human-readable explanation, a machine-readable message/delivery-status part describing exactly what happened (recipient, status code, failing server), and often the original message's headers. Reading these report parts lets a program automatically detect and process bounces.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the read-only Email.NumReports property, which is the number of report
#  parts in a multipart/report email (for example, a Delivery Status Notification).
#  Use GetReport to retrieve the body of each report part.  Indexes are zero-based.

set email [new_CkEmail]

#  Load a multipart/report email (such as a bounce / DSN message).
set success [CkEmail_LoadEml $email "qa_data/eml/dsn_bounce.eml"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

set n [CkEmail_get_NumReports $email]
puts "NumReports = $n"

for {set i 0} {$i <= [expr $n - 1]} {incr i} {
    puts "---- Report $i ----"
    puts [CkEmail_getReport $email $i]
}

delete_CkEmail $email