Delphi DLL

Add Multiple To Recipients at Once

Demonstrates the Chilkat Email.AddMultipleTo method, which parses a comma-separated list of mailbox addresses and appends them all to the direct-recipient (To) list. Each entry may include a display name (e.g. Joe <joe@example.com>). This example adds three To recipients in a single call.

Background: The To header holds a message's primary recipients, and email allows any number of them as a comma-separated list. AddMultipleTo parses that standard syntax — accepting both bare addresses and named forms — so when your recipients arrive as one string (from a form field, database column, or config value) you can populate the whole To list in one step instead of calling AddTo per recipient.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
email: HCkEmail;

begin
//  Demonstrates the AddMultipleTo method, which parses a comma-separated list of
//  addresses and appends them all to the direct-recipient (To) list.

email := CkEmail_Create();
CkEmail_putSubject(email,'Multiple To example');
CkEmail_putFrom(email,'alice@example.com');

//  Add several To recipients at once.  Each entry may include a display name.
CkEmail_AddMultipleTo(email,'Joe <joe@example.com>, jane@example.com, Bob <bob@example.com>');

Memo1.Lines.Add('NumTo = ' + IntToStr(CkEmail_getNumTo(email)));

CkEmail_Dispose(email);