Xbase++

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail

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

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Multiple To example"
oEmail:From := "alice@example.com"

//  Add several To recipients at once.  Each entry may include a display name.
oEmail:AddMultipleTo("Joe <joe@example.com>, jane@example.com, Bob <bob@example.com>")

? "NumTo = " + Str(oEmail:NumTo)

oEmail:destroy()