Ruby Requires Chilkat v11.0.0+

Fetch Single Email by UID or Sequence Number

Assuming the UID is known, download a single email by UID from an IMAP mail server. Ruby

require 'chilkat'

success = false

#  This example requires the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

imap = Chilkat::CkImap.new()

#  Connect to an IMAP server.
#  Use TLS
imap.put_Ssl(true)
imap.put_Port(993)
success = imap.Connect("imap.example.com")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

#  Login
success = imap.Login("***","***")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

#  Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

email = Chilkat::CkEmail.new()

uid = 2014
isUid = true

success = imap.FetchEmail(false,uid,isUid,email)
if (success == false)
    print imap.lastErrorText() + "\n";
    exit
end

#  Display the From and Subject
print email.fromAddress() + "\n";
print email.subject() + "\n";

#  Display the Body property, which is the default body.
#  If an email has an HTML body, the Body property contains
#  the HTML source.  Otherwise it contains the plain-text
#  body.
print "---- EMAIL BODY ----" + "\n";
print email.body() + "\n";
print "--------------------" + "\n";

#  Display the recipients:

for j in 0 .. email.get_NumTo() - 1
    print email.getToName(j) + ", " + email.getToAddr(j) + "\n";
end
for j in 0 .. email.get_NumCC() - 1
    print email.getCcName(j) + ", " + email.getCcAddr(j) + "\n";
end

#  Show the total size of the email, including body and attachments:
print email.get_Size().to_s() + "\n";

#  When a full email is downloaded, we would use the
#  email.NumAttachments property in conjunction with the
#  email.GetMailAttach* methods.
#  However, when an email object contains only the header,
#  we need to access the attachment info differently:
numAttach = imap.GetMailNumAttach(email)
print numAttach.to_s() + "\n";

for j in 0 .. numAttach - 1
    print imap.getMailAttachFilename(email,j) + "\n";
    attachSize = imap.GetMailAttachSize(email,j)
    print "    size = " + attachSize.to_s() + " bytes" + "\n";
end

print "--" + "\n";

#  Disconnect from the IMAP server.
success = imap.Disconnect()