(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.)

Note: This example requires Chilkat v11.0.0 or greater.

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

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

BOOL success = NO;

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];
success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

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

// Select an IMAP mailbox
success = [imap SelectMailbox: @"Inbox"];
if (success == NO) {
    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: 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 = [[CkoEmail alloc] init];
for (i = 1; i <= n; i++) {

    // Download the email by sequence number.
    success = [imap FetchEmail: NO msgId: i bUid: bUid email: email];

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

}

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