(Objective-C) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

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

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

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

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

// 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: @"****" password: @"****"];
if (success != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

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

CkoMessageSet *messageSet = 0;
// We can choose to fetch UIDs or sequence numbers.
BOOL fetchUids = YES;
// Get the message IDs of all the emails in the mailbox
messageSet = [imap Search: @"ALL" bUid: fetchUids];
if (imap.LastMethodSuccess != YES) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

// When downloading headers, each email object contains
// (obviously) the headers, but the body will be missing.
// Also, attachments will not be included.  However, it is
// possible to get information about the attachments
// as well as the complete size of the email.
CkoEmailBundle *bundle = 0;
bundle = [imap FetchHeaders: messageSet];
if (imap.LastMethodSuccess != YES) {

    NSLog(@"%@",imap.LastErrorText);
    return;
}

// Loop over the email objects and display information
// about each:
int i;
for (i = 0; i <= [bundle.MessageCount intValue] - 1; i++) {
    CkoEmail *email = 0;
    email = [bundle GetEmail: [NSNumber numberWithInt: i]];

    // Display the From and Subject
    NSLog(@"%@",email.From);
    NSLog(@"%@",email.Subject);

    // Display the recipients:
    int j;
    NSString *name = 0;
    NSString *addr = 0;
    for (j = 0; j <= [email.NumTo intValue] - 1; j++) {
        name = [email GetToName: [NSNumber numberWithInt: j]];
        addr = [email GetToAddr: [NSNumber numberWithInt: j]];
        NSLog(@"%@%@%@",name,@", ",addr);
    }

    for (j = 0; j <= [email.NumCC intValue] - 1; j++) {
        name = [email GetCcName: [NSNumber numberWithInt: j]];
        addr = [email GetCcAddr: [NSNumber numberWithInt: j]];
        NSLog(@"%@%@%@",name,@", ",addr);
    }

    // Show the total size of the email, including body and attachments:
    NSLog(@"%d",[email.Size intValue]);

    // When a full email is downloaded, we would use the
    // email.NumAttachments property in conjunction with the
    // email.GetMailAttach* methods.
    // However, when an email object contains only the header,
    // we need to access the attachment info differently:
    int numAttach = [[imap GetMailNumAttach: email] intValue];
    for (j = 0; j <= numAttach - 1; j++) {
        NSLog(@"%@",[imap GetMailAttachFilename: email attachIndex: [NSNumber numberWithInt: j]]);
        int attachSize = [[imap GetMailAttachSize: email attachIndex: [NSNumber numberWithInt: j]] intValue];
        NSLog(@"%@%d%@",@"    size = ",attachSize,@" bytes");
    }

    NSLog(@"%@",@"--");

}

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