(Objective-C) IMAP Download All Email One at a Time

Demonstrates how to download every email in an IMAP mailbox one at a time as a MIME string or as an email object. (The MIME contains the full contents of the email including all attachments.)

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoImap.h>
#import <NSString.h>
#import <CkoEmail.h>

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

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

// Connect to an IMAP server.
// Use TLS
imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];
BOOL success = [imap Connect: @"imap.someMailServer.com"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Login
success = [imap Login: @"myLogin" password: @"myPassword"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Select an IMAP mailbox
success = [imap SelectMailbox: @"Inbox"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Once the mailbox is selected, the NumMessages property
// will contain the number of messages in the mailbox.
// You may loop from 1 to NumMessages to
// fetch each message by sequence number.

BOOL bUid = NO;
NSString *mimeStr = 0;
int i;
int n = [imap.NumMessages intValue];
for (i = 1; i <= n; i++) {

    // Download the email by sequence number.
    mimeStr = [imap FetchSingleAsMime: [NSNumber numberWithInt: i] bUid: bUid];

    // ... your application may process each MIME string...
}

// An alternative is to download each email in the form of an
// email object, like this:
CkoEmail *email = 0;
for (i = 1; i <= n; i++) {

    // Download the email by sequence number.
    email = [imap FetchSingle: [NSNumber numberWithInt: i] bUid: bUid];

    // ... your application may process the email object...

}

// Disconnect from the IMAP server.
success = [imap Disconnect];