(Tcl) Transition from MailMan.FetchByMsgnum to MailMan.FetchOne

Provides instructions for replacing deprecated FetchByMsgnum method calls with FetchOne.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

set mailman [new_CkMailMan]

# ...
# ...

set msgnum 123

# ------------------------------------------------------------------------
# The FetchByMsgnum method is deprecated:

# emailObj is a CkEmail
set emailObj [CkMailMan_FetchByMsgnum $mailman $msgnum]
if {[CkMailMan_get_LastMethodSuccess $mailman] == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    exit
}

# ...
# ...

delete_CkEmail $emailObj

# ------------------------------------------------------------------------
# Do the equivalent using FetchOne.
# Your application creates a new, empty Email object which is passed 
# in the last argument and filled upon success.

set headerOnly 0
# Irrelevant because we are not downloading headers-only.
set numBodyLines 0

set emailOut [new_CkEmail]

set success [CkMailMan_FetchOne $mailman $headerOnly $numBodyLines $msgnum $emailOut]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    delete_CkEmail $emailOut
    exit
}


delete_CkMailMan $mailman
delete_CkEmail $emailOut