Perl

Count the Messages in a multipart/digest Email

Demonstrates the read-only Chilkat Email.NumDigests property, which is the number of message/rfc822 parts contained within a multipart/digest enclosure. If no such enclosure exists, the value is 0. Digest indexes are zero-based; use GetDigestEmail to retrieve an individual bundled message as its own Email object. This example loads a digest email and lists each message's subject.

Background: A multipart/digest is a way to package many separate emails inside one carrier message — historically used by mailing lists to send a single daily "digest" containing all of that day's posts. Each bundled item is a complete message/rfc822 email with its own headers and body. This differs from NumAttachedMessages, which counts nested messages attached to an ordinary email rather than the members of a digest enclosure.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# Demonstrates the read-only Email.NumDigests property, which is the number of
# message/rfc822 parts contained within a multipart/digest enclosure.  If there is no
# multipart/digest enclosure, the value is 0.  Digest indexes are zero-based.

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

# Load a multipart/digest email (a single email that bundles many messages).
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: Paths such as "qa_data/..." are relative local filesystem paths,
# relative to the current working directory of the running application.