Lua

Get a Digest Message as an Email Object

Demonstrates the Chilkat Email.GetDigestEmail method, which copies the Nth digest email contained within a multipart/digest into another Email object. The first digest is at index 0; the NumDigests property gives the count. This example loads a digest email and lists each bundled message's subject.

Background: A multipart/digest packs many separate emails into one carrier message — historically used by mailing lists to send a single daily bundle of that day's posts. GetDigestEmail unpacks each member into a full Email object so it can be read or processed individually. This differs from GetAttachedEmail, which extracts messages attached to an ordinary email rather than the members of a digest.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the GetDigestEmail method, which copies the Nth digest email contained
-- within a multipart/digest into another Email object.  The first digest is at index 0;
-- use the NumDigests property for the count.

local email = chilkat.Email.new()

local success = email:load_eml("qa_data/eml/digest.eml")
if not success then
    print(email.last_error_text)
    return
end

local n = email.num_digests
print("NumDigests = " .. n)

-- Retrieve each bundled message as its own Email object.
local digestEmail = chilkat.Email.new()
for i = 0, n - 1 do
    success = email:get_digest_email(i, digestEmail)
    print("Digest " .. i .. " subject: " .. digestEmail.subject)
end

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