Perl Requires Chilkat v11.0.0+

Move Selected Emails to another Mailbox Folder

See more IMAP Examples

Downloads emails one by one in a selected mailbox, decides which emails are to be moved, and then moves the set of messages to another mailbox folder. Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

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

my $imap = Chilkat2::Imap->new;

# Connect to an IMAP server.
# Use TLS
$imap->Ssl(1);
$imap->Port(993);
my $success = $imap->Connect('imap.example.com');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Login
$success = $imap->Login('myLogin', 'myPassword');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Select an IMAP mailbox
$success = $imap->SelectMailbox('Inbox');
if (!$success) {
    print $imap->LastErrorText, "\n";
    exit;
}

# Normally, when an email is downloaded, its "Seen" flag is automatically set.
# We don't want our program to be interfering with the "Seen" flags.
# To do this, set the PeekMode to 1.
$imap->PeekMode(1);

# After selecting the mailbox, the NumMessages property
# will contain the number of emails in the mailbox.
# When sequence numbers (not UIDs) are used to reference emails,
# they range from 1 to N, where N is the number of messages in the mailbox.
# This example will download the headers by sequence numbers.
my $numEmails = $imap->NumMessages;

my $mset = Chilkat2::MessageSet->new;

# Indicate that mset contains sequence numbers, not UIDs.
$mset->HasUids(0);

# Fetch each email and decide for each if it is to be moved
# to a particular other mailbox.  If so, we'll add the sequence number to
# the mset, and then move all emails in the mset to the other mailbox.
my $email = Chilkat2::Email->new;
my $i = 0;
while ($i < $numEmails) {
    # Fetch the email by sequence number.
    $success = $imap->FetchEmail(0, $i + 1, 0, $email);
    if (!$success) {
        print $imap->LastErrorText, "\n";
        exit;
    }

    # If it is decided to move the email, add the sequence number to mset, like this:
    $mset->InsertId($i + 1);
}

# If there are emails in mset to be moved, then do it..
if ($mset->Count > 0) {
    my $destFolder = 'Inbox/SomeOtherFolder';
    # Assuming your IMAP server supports the feature that allows for messages to be moved to another folder...
    $success = $imap->MoveMessages($mset, $destFolder);
    if (!$success) {
        print $imap->LastErrorText, "\n";
        exit;
    }
}

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