Objective-C

Clear the To Recipients of an Email

Demonstrates the Chilkat Email.ClearTo method, which clears the list of direct (To) recipients. It changes only the current in-memory email object and does not affect messages already sent. This example adds two To recipients, clears them, and prints the count before and after.

Background: The To list holds a message's primary recipients. When reusing one Email object as a template across multiple sends, ClearTo wipes just that list so each send addresses the right people, without disturbing the subject, body, or attachments. It pairs with ClearCC and ClearBcc for full control over the recipient lists.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoEmail.h>

//  Demonstrates the ClearTo method, which clears the list of direct (To) recipients.
//  This changes only the current email object.

CkoEmail *email = [[CkoEmail alloc] init];

[email AddTo: @"Joe" emailAddress: @"joe@example.com"];
[email AddTo: @"Jane" emailAddress: @"jane@example.com"];
NSLog(@"%@%d",@"NumTo before clear = ",[email.NumTo intValue]);

//  Remove all To recipients.
[email ClearTo];

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