Download POP3 Email using UIDLs

Demonstrates how to download POP3 email by first getting the complete set of UIDLs and then downloading email by calling FetchEmail for each UIDL. This is equivalent to calling CopyMail, except your application can process each email as it arrives instead of waiting for the entire bundle to be downloaded. Also, it's better protection against potential out-of-memory issues if your mailbox has a very large number of messages. There is no performance difference between fetching emails individually vs. calling CopyMail.

Download Chilkat Ruby Library

require 'chilkat'

#  The mailman object is used for receiving (POP3)
#  and sending (SMTP) email.
mailman = Chilkat::CkMailMan.new()

#  Any string argument automatically begins the 30-day trial.
success = mailman.UnlockComponent("30-day trial")
if (success != true)
    print "Component unlock failed" + "\n"
    exit
end

#  Set the POP3 server's hostname
mailman.put_MailHost("mail.chilkatsoft.com")

#  Set the POP3 login/password.
mailman.put_PopUsername("myLogin")
mailman.put_PopPassword("myPassword")

# sa is a CkStringArray
sa = mailman.GetUidls()
if (sa == nil )
    print mailman.lastErrorText() + "\n";
    exit
end

n = sa.get_Count()

for i in 0 .. n - 1

    uidl = sa.getString(i)

    # email is a CkEmail
    email = mailman.FetchEmail(uidl)
    if (email == nil )
        print mailman.lastErrorText() + "\n";
        break
    end

    print email.ck_from() + "\n";
    print email.subject() + "\r\n" + "\n";

end

mailman.Pop3EndSession()