Lua

Fetch an IMAP Message's MIME into a BinData

Demonstrates the Chilkat Imap.FetchSingleBd method, which downloads one message's MIME bytes into a BinData object. If the second argument (bUid) is true, the first argument is a UID; otherwise it is a sequence number. This example downloads message 1's MIME into a BinData and prints the byte count.

Background: This is the binary counterpart to FetchSingleAsMime (which returns a string). A BinData holds raw bytes, so it preserves the message exactly — the right choice when you plan to write the MIME straight to a file, hash it, or hand it to an API expecting a byte buffer, with no charset conversion that could alter binary content.

Chilkat Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

-- Demonstrates the Imap.FetchSingleBd method, which downloads one message's MIME bytes into a
-- BinData object.  If the 2nd argument (bUid) is true, the 1st argument is a UID; otherwise
-- it is a sequence number.

local imap = chilkat.Imap.new()

imap.ssl = true
imap.port = 993

local success = imap:connect("imap.example.com")
if not success then
    print(imap.last_error_text)
    return
end

success = imap:login("user@example.com", "myPassword")
if not success then
    print(imap.last_error_text)
    return
end

success = imap:select_mailbox("Inbox")
if not success then
    print(imap.last_error_text)
    return
end

-- Download message sequence number 1's MIME bytes into a BinData.  bUid = false.
local bdMime = chilkat.BinData.new()
success = imap:fetch_single_bd(1, false, bdMime)
if not success then
    print(imap.last_error_text)
    return
end

print("MIME size (bytes) = " .. bdMime.num_bytes)

success = imap:disconnect()
if not success then
    print(imap.last_error_text)
    return
end