(Perl) 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 Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux

use chilkat();

$mailman = chilkat::CkMailMan->new();

# ...
# ...

$msgnum = 123;

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

# emailObj is a Email
$emailObj = $mailman->FetchByMsgnum($msgnum);
if ($mailman->get_LastMethodSuccess() == 0) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

# ...
# ...

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

$headerOnly = 0;
# Irrelevant because we are not downloading headers-only.
$numBodyLines = 0;

$emailOut = chilkat::CkEmail->new();
$success = $mailman->FetchOne($headerOnly,$numBodyLines,$msgnum,$emailOut);
if ($success == 0) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}