Perl

Convert a MIME Entity to multipart/alternative

Demonstrates the Chilkat Mime.ConvertToMultipartAlt method, which wraps the current entity in a new outer multipart/alternative, making the original the first child. It takes no arguments.

Note: The file paths are relative to the application's current working directory. Absolute paths may also be used. Supply the paths appropriate to your own environment.

Background: Use this to add an alternate rendering to an existing message — for example, promoting a plain-text message so an HTML version can be added alongside it. The original content becomes the first (least-preferred) alternative, and you append the richer representation after it. As with the mixed conversion, message-level headers move to the new outer entity.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

my $mime = Chilkat2::Mime->new;
my $success = $mime->LoadMimeFile('qa_data/message.eml');
if (!$success) {
    print $mime->LastErrorText, "\n";
    exit;
}

# Wrap the current entity in a new outer multipart/alternative entity.  The original entity
# becomes the first child, ready for an alternate representation to be added.
$success = $mime->ConvertToMultipartAlt();
if (!$success) {
    print $mime->LastErrorText, "\n";
    exit;
}

# Add an alternative representation of the same content.
my $htmlPart = Chilkat2::Mime->new;
$success = $htmlPart->SetBodyFromHtml('<html><body>HTML alternative.</body></html>');
if (!$success) {
    print $htmlPart->LastErrorText, "\n";
    exit;
}

$success = $mime->AppendPart($htmlPart);
if (!$success) {
    print $mime->LastErrorText, "\n";
    exit;
}

print 'Number of parts: ', $mime->NumParts, "\n";