Perl

Get a Digest Message as an Email Object

Demonstrates the Chilkat Email.GetDigestEmail method, which copies the Nth digest email contained within a multipart/digest into another Email object. The first digest is at index 0; the NumDigests property gives the count. This example loads a digest email and lists each bundled message's subject.

Background: A multipart/digest packs many separate emails into one carrier message — historically used by mailing lists to send a single daily bundle of that day's posts. GetDigestEmail unpacks each member into a full Email object so it can be read or processed individually. This differs from GetAttachedEmail, which extracts messages attached to an ordinary email rather than the members of a digest.

Chilkat Perl Downloads

Download Chilkat for Perl

Perl

use chilkat();

$success = 0;

#  Demonstrates the GetDigestEmail method, which copies the Nth digest email contained
#  within a multipart/digest into another Email object.  The first digest is at index 0;
#  use the NumDigests property for the count.

$email = chilkat::CkEmail->new();

$success = $email->LoadEml("qa_data/eml/digest.eml");
if ($success == 0) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

$n = $email->get_NumDigests();
print "NumDigests = " . $n . "\r\n";

#  Retrieve each bundled message as its own Email object.
$digestEmail = chilkat::CkEmail->new();

for ($i = 0; $i <= $n - 1; $i++) {
    $success = $email->GetDigestEmail($i,$digestEmail);
    print "Digest " . $i . " subject: " . $digestEmail->subject() . "\r\n";
}

#  Note: The path "qa_data/..." is a relative local filesystem path,
#  relative to the current working directory of the running application.