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

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# 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.

my $email = Chilkat2::Email->new;

my $success = $email->LoadEml('qa_data/eml/digest.eml');
if (!$success) {
    print $email->LastErrorText, "\n";
    exit;
}

my $n = $email->NumDigests;
print 'NumDigests = ', $n, "\n";

# Retrieve each bundled message as its own Email object.
my $digestEmail = Chilkat2::Email->new;
for my $i (0 .. $n - 1) {
    $success = $email->GetDigestEmail($i, $digestEmail);
    print 'Digest ', $i, ' subject: ', $digestEmail->Subject, "\n";
}

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