Determine the Number of Unseen Email Messages

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

Downloads for Windows/Linux and Install Instructions

require 'rubygems'
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 is a CkMessageSet
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()