Objective-C

Expunge Deleted Messages from a Mailbox

Demonstrates the Chilkat Imap.Expunge method, which permanently removes all messages marked with the \Deleted flag from the currently selected mailbox. The mailbox remains selected. This example marks a message deleted with SetFlag and then expunges.

Background: IMAP deletion is two-phase, much like POP3. First a message is marked with the \Deleted flag (it still exists, just tagged); then EXPUNGE permanently removes every flagged message and renumbers the rest. Splitting the two steps lets a client mark several messages and remove them together, or unmark (undelete) before committing. Expunge keeps the mailbox selected; ExpungeAndClose does the same and then closes it.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoImap.h>

BOOL success = NO;

//  Demonstrates the Imap.Expunge method, which permanently removes all messages marked with
//  the \Deleted flag from the currently selected mailbox.  The mailbox remains selected.

CkoImap *imap = [[CkoImap alloc] init];

imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];

success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

success = [imap Login: @"user@example.com" password: @"myPassword"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Select the mailbox to operate on.
success = [imap SelectMailbox: @"Inbox"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Mark message (sequence number 1) with the \Deleted flag.  The 4th argument (1) sets the
//  flag; the 2nd argument (false) means the id is a sequence number, not a UID.
success = [imap SetFlag: 1 bUid: NO flagName: @"\Deleted" value: [NSNumber numberWithInt: 1]];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  Permanently remove all \Deleted messages from the selected mailbox.
success = [imap Expunge];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

NSLog(@"%@",@"Expunged the deleted messages.");

success = [imap Disconnect];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}