Objective-C

Clear an Email Object

Demonstrates the Chilkat Email.Clear method, which removes the current message content — recipients, headers, body representations, attachments, related items, and embedded messages — leaving an empty email object. This example builds a message with a recipient and attachment, clears it, and prints the counts before and after.

Background: Reusing a single Email object across many operations is efficient, but leftover state from a previous message could leak into the next. Clear resets the object completely, giving you a clean slate — the safe way to start a fresh message without allocating a new object.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoEmail.h>

//  Demonstrates the Clear method, which removes the current message content, including
//  recipients, headers, body representations, attachments, related items, and embedded
//  messages -- leaving an empty email object.

CkoEmail *email = [[CkoEmail alloc] init];
email.Subject = @"A message";
email.Body = @"Some body text.";
[email AddTo: @"Bob" emailAddress: @"bob@example.com"];
[email AddStringAttachment: @"notes.txt" str: @"Some notes."];

NSLog(@"%@%d",@"NumTo before clear = ",[email.NumTo intValue]);
NSLog(@"%@%d",@"NumAttachments before clear = ",[email.NumAttachments intValue]);

//  Remove all content, resetting the email object.
[email Clear];

NSLog(@"%@%d",@"NumTo after clear = ",[email.NumTo intValue]);
NSLog(@"%@%d",@"NumAttachments after clear = ",[email.NumAttachments intValue]);