Perl

Add an Attachment from a BinData Object

Demonstrates the Chilkat Email.AddAttachmentBd method, which adds an attachment using the contents of a BinData object. The first argument is the attachment filename, the second is the BinData, and the third is the content type — if empty, it is inferred from the filename extension. This example loads a PDF into a BinData and attaches it.

Background: BinData is Chilkat's container for raw binary data. Attaching from a BinData is the right approach when the file's bytes are already in memory — generated on the fly, downloaded, or read from a database — rather than sitting on disk (which would use AddFileAttachment). Chilkat Base64-encodes the bytes into the message automatically.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# Demonstrates the AddAttachmentBd method, which adds an attachment using the contents of a
# BinData object.  The first argument is the attachment filename, the second is the BinData
# object, and the third is the content type (inferred from the filename extension if empty).

my $email = Chilkat2::Email->new;
$email->Subject('Attach from BinData');
$email->Body('Please see the attached file.');

# Load a file into a BinData object, then attach it.
my $bd = Chilkat2::BinData->new;
my $success = $bd->LoadFile('qa_data/attachments/report.pdf');
if (!$success) {
    print $bd->LastErrorText, "\n";
    exit;
}

$success = $email->AddAttachmentBd('report.pdf', $bd, 'application/pdf');
if (!$success) {
    print $email->LastErrorText, "\n";
    exit;
}

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

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