Tcl

Download the Full Version of a Partial Email

Demonstrates the Chilkat MailMan.FetchFull method, which downloads the complete version of a header-only or partial Email and stores it in a second Email. The full result includes the complete body and any attachments, and the partial email must retain its UIDL. This example previews message 1 (headers only) and then downloads it in full.

Background: A common pattern is to download headers first — cheap and fast — show the user a message list, and only pull the full content when a message is actually opened. FetchFull completes that "download on demand" flow: given a partial email (which carries its UIDL), it fetches the rest from the server. This keeps bandwidth and latency low when browsing a large mailbox.

Chilkat Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 0

#  Demonstrates the MailMan.FetchFull method, which downloads the complete version of a
#  header-only or partial Email and stores it in a second Email.  The full result includes
#  the complete body and any attachments.  The partial email must retain its UIDL.

set mailman [new_CkMailMan]

#  Configure the POP3 server connection.
CkMailMan_put_MailHost $mailman "pop.example.com"
CkMailMan_put_MailPort $mailman 995
CkMailMan_put_PopSsl $mailman 1
CkMailMan_put_PopUsername $mailman "user@example.com"
CkMailMan_put_PopPassword $mailman "myPassword"

#  First fetch message 1 as headers only (a fast preview).  headerOnly=cktrue.
set partialEmail [new_CkEmail]

set success [CkMailMan_FetchOne $mailman 1 0 1 $partialEmail]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $partialEmail
    exit
}

puts "Preview subject: [CkEmail_subject $partialEmail]"

#  Now download the complete message (body and attachments).
set fullEmail [new_CkEmail]

set success [CkMailMan_FetchFull $mailman $partialEmail $fullEmail]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $partialEmail
    delete_CkEmail $fullEmail
    exit
}

puts "Full email NumAttachments: [CkEmail_get_NumAttachments $fullEmail]"

#  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
#  connects and authenticates -- using the property settings above -- whenever a server
#  operation requires it.  Calling the explicit connect/authenticate methods can still be
#  helpful to determine whether a failure occurs while connecting or while authenticating.

delete_CkMailMan $mailman
delete_CkEmail $partialEmail
delete_CkEmail $fullEmail