Perl

Save a Related Item to Disk

Demonstrates the Chilkat Email.SaveRelatedItem method, which saves the related item at a given zero-based index to a directory. If the directory or any of its components do not exist, Chilkat creates them. This example adds a related style sheet and saves it.

Background: Related items are the inline resources (images, style sheets) an HTML email carries in its multipart/related enclosure. SaveRelatedItem writes one of them out as a file — a building block for tasks like extracting a specific embedded image, or manually unpacking a message when you want finer control than the all-in-one UnpackHtml / AspUnpack methods provide.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# Demonstrates the SaveRelatedItem method, which saves the related item at a given
# zero-based index to a directory.  If the directory (or any of its components) does not
# exist, Chilkat creates it.

my $email = Chilkat2::Email->new;
$email->Subject('Save a related item');

# Set an HTML body that references a related style sheet by name.
$email->SetHtmlBody('<html><head><link rel="stylesheet" href="styles.css"/></head><body>Styled.</body></html>');
$email->AddRelatedString2('styles.css', 'body { color: navy; }', 'utf-8');

# Save the related item at index 0 into the specified directory.
my $success = $email->SaveRelatedItem(0, 'qa_output/related');
if (!$success) {
    print $email->LastErrorText, "\n";
    exit;
}

print "Saved related item 0.\n";

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