Perl

Get an Attachment's Bytes into a BinData

Demonstrates the Chilkat Email.GetAttachmentBd method, which copies an attachment's binary data into a BinData object. The first attachment is at index 0. This example adds an attachment and copies its bytes into a BinData, printing the byte count.

Background: This is the safe, binary way to extract an attachment — the counterpart to the text-oriented GetAttachmentString. Because attachments are often binary (PDFs, images, archives), copying the raw bytes into a BinData preserves them exactly, ready to write to a file, hash, or pass to another API without any charset conversion that could corrupt the data.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# Demonstrates the GetAttachmentBd method, which copies an attachment's binary data into a
# BinData object.  The first attachment is at index 0.

my $email = Chilkat2::Email->new;
$email->Subject('GetAttachmentBd example');

$email->AddStringAttachment('notes.txt', 'Some notes stored in the attachment.');

# Copy the first attachment's binary data into a BinData object.
my $bd = Chilkat2::BinData->new;
my $success = $email->GetAttachmentBd(0, $bd);
if (!$success) {
    print $email->LastErrorText, "\n";
    exit;
}

print 'Attachment size (bytes) = ', $bd->NumBytes, "\n";