Lua

Get the Filename of an Attached Message

Demonstrates the Chilkat Email.GetAttachedMessageFilename method, which returns the filename of the Nth attached (embedded) email. The filename is the filename attribute of the attached message's Content-Disposition header, and the index is zero-based. This example attaches an email and reads the attached message's filename.

Background: When an email forwards another message as an attachment, the nested message is a message/rfc822 part — a complete email tucked inside the carrier. Mail clients often give that part a filename (like forwarded.eml) via its Content-Disposition header so it can be saved to disk. This method reads that filename directly. Attached messages are counted separately from ordinary attachments (see NumAttachedMessages).

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the GetAttachedMessageFilename method, which returns the filename of the
-- Nth attached (embedded) email.  The filename is the "filename" attribute of the
-- attached message's Content-Disposition header.  The index is zero-based.

-- Build an inner email to attach.
local innerEmail = chilkat.Email.new()
innerEmail.subject = "Embedded message"
innerEmail.from = "alice@example.com"
innerEmail:add_to("Bob", "bob@example.com")

-- Attach it to an outer email as a message/rfc822 part.
local email = chilkat.Email.new()
email.subject = "Has an attached message"
local success = email:attach_email(innerEmail)
if not success then
    print(email.last_error_text)
    return
end

-- Get the filename of the first attached message (index 0).
local fname = email:get_attached_message_filename(0)
print("Attached message filename: " .. fname)