Lua

Attach a File to an Email

Demonstrates the Chilkat Email.AddFileAttachment method, which attaches a file read from the filesystem. It returns the content type Chilkat assigned to the attachment (inferred from the file extension). This example attaches a PDF and prints its detected content type.

Background: Each attachment carries a Content-Type (MIME type) such as application/pdf or image/png that tells the receiving client how to handle it. Chilkat gets this from the file's extension. Because attachment bytes are binary, they are Base64-encoded for transport, which is handled automatically — you simply point AddFileAttachment at a path and the file is read, encoded, and packaged into the message.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the AddFileAttachment method, which attaches a file read from the
-- filesystem.  It returns the content type Chilkat assigned to the attachment (based on
-- the file extension), or returns failure if the file could not be read.

local email = chilkat.Email.new()
email.subject = "Email with a file attachment"
email.body = "Please see the attached file."

-- Attach a file.  The return value is the auto-detected content type.
local contentType = email:add_file_attachment("qa_data/attachments/report.pdf")
if not email.last_method_success then
    print(email.last_error_text)
    return
end

print("Attached content type = " .. contentType)
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.