Lua

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 Lua Downloads

Download Chilkat for Lua

Lua

local chilkat = require("chilkat")

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

local email = chilkat.Email.new()
email.subject = "Multiple To example"
email.from = "alice@example.com"

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

print("NumTo = " .. email.num_to)