Objective-C

Append a MIME Message to an IMAP Mailbox

Demonstrates the Chilkat Imap.AppendMime method, which uploads a complete RFC 822/MIME message to a mailbox. The first argument is the destination mailbox name and the second is the MIME text. This example obtains the MIME from an Email object and uploads it to Drafts.

Background: Use AppendMime when you already hold a message's raw source — a .eml file, a message you assembled, or one you received. Chilkat sends the text exactly as supplied, without normalizing line endings or re-encoding headers, so every header and MIME boundary is preserved verbatim. The supplied text must be plain text (no raw non-text binary bytes).

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

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

BOOL success = NO;

//  Demonstrates the Imap.AppendMime method, which uploads a complete MIME message to a mailbox.
//  The 1st argument is the destination mailbox name and the 2nd is the MIME text.

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;
}

//  Build the email to be uploaded.
CkoEmail *email = [[CkoEmail alloc] init];
email.Subject = @"Meeting agenda";
email.From = @"Alice <alice@example.com>";
success = [email AddTo: @"Bob" emailAddress: @"bob@example.com"];
email.Body = @"Let's meet at 10am to review the agenda.";

//  Obtain the MIME text to upload.  Here it is generated from the Email, but it could equally
//  be read from a .eml file.
NSString *mimeText = [email GetMime];
if (email.LastMethodSuccess == NO) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

//  Append (upload) the MIME to the "Drafts" mailbox.
success = [imap AppendMime: @"Drafts" mimeText: mimeText];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

NSLog(@"%@%d",@"Appended UID: ",[imap.AppendUid intValue]);

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