Xbase++

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oEmail
LOCAL oBd

nSuccess := 0

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

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "GetAttachmentBd example"

oEmail:AddStringAttachment("notes.txt", "Some notes stored in the attachment.")

//  Copy the first attachment's binary data into a BinData object.
oBd := CreateObject("Chilkat.BinData")
nSuccess := oEmail:GetAttachmentBd(0, oBd)
IF (nSuccess == 0)
    ? oEmail:LastErrorText
    oEmail:destroy()
    oBd:destroy()
    RETURN
ENDIF

? "Attachment size (bytes) = " + Str(oBd:NumBytes)

oEmail:destroy()
oBd:destroy()