Determine the Number of Unseen Email Messages

Demonstrates how to determine how many unseen messages exist in an email account on an IMAP server.

Download Chilkat Ruby Library

require 'chilkat'

imap = Chilkat::CkImap.new()

#  Anything unlocks the component and begins a fully-functional 30-day trial.
success = imap.UnlockComponent("Anything for 30-day trial")
if (success != true)
    print imap.lastErrorText() + "\n"
    exit
end

#  Connect to an IMAP server.
success = imap.Connect("mail.chilkatsoft.com")
if (success != true)
    print imap.lastErrorText() + "\n"
    exit
end

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

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

#  After selecting the mailbox. the total number of emails
#  is immediately available:
totalNum = imap.get_NumMessages()
print totalNum.to_s() + "\n";

#  To determine the number of unseen messages, a call
#  to Search is required, which returns the set of UIDs
#  of all unseen messages.

#  We can choose to fetch UIDs or sequence numbers.
fetchUids = true

messageSet = imap.Search("UNSEEN",fetchUids)
if (messageSet == nil )
    print imap.lastErrorText() + "\n"
    exit
end

numUnseen = messageSet.get_Count()
print numUnseen.to_s() + "\n";

print "UIDs ----" + "\n";

#  Display the UIDs

for i in 0 .. messageSet.get_Count() - 1
    msgId = messageSet.GetId(i)
    print msgId.to_s() + "\n";
end

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