C++

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

Download Chilkat for C++

C++

#include <CkEmail.h>

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

    CkEmail email;
    email.put_Subject("Multiple To example");
    email.put_From("alice@example.com");

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

    std::cout << "NumTo = " << email.get_NumTo() << "\r\n";
    }