(Perl) Determine the Number of Unseen Email Messages

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

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# 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(1);
$imap->put_Port(993);
$success = $imap->Connect("imap.someMailServer.com");
if ($success != 1) {
    print $imap->lastErrorText() . "\r\n";
    exit;
}

# Login
$success = $imap->Login("***","***");
if ($success != 1) {
    print $imap->lastErrorText() . "\r\n";
    exit;
}

# Select an IMAP mailbox
$success = $imap->SelectMailbox("Inbox");
if ($success != 1) {
    print $imap->lastErrorText() . "\r\n";
    exit;
}

# After selecting the mailbox. the total number of emails
# is immediately available:
$totalNum = $imap->get_NumMessages();
print "Num messages = " . $totalNum . "\r\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 = 1;

# messageSet is a MessageSet
$messageSet = $imap->Search("UNSEEN",$fetchUids);
if ($imap->get_LastMethodSuccess() == 0) {
    print $imap->lastErrorText() . "\r\n";
    exit;
}

$numUnseen = $messageSet->get_Count();
print $numUnseen . "\r\n";

print "UIDs ----" . "\r\n";

# Display the UIDs
$i = 0;

while ($i < $messageSet->get_Count()) {
    $msgId = $messageSet->GetId($i);
    print $msgId . "\r\n";
    $i = $i + 1;
}

# Disconnect from the IMAP server.
$success = $imap->Disconnect();