Lua

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 Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- 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).

local email = chilkat.Email.new()
email.subject = "Attach from BinData"
email.body = "Please see the attached file."

-- Load a file into a BinData object, then attach it.
local bd = chilkat.BinData.new()
local success = bd:load_file("qa_data/attachments/report.pdf")
if not success then
    print(bd.last_error_text)
    return
end

success = email:add_attachment_bd("report.pdf", bd, "application/pdf")
if not success then
    print(email.last_error_text)
    return
end

print("NumAttachments = " .. email.num_attachments)

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