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

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

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

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"Multiple To example");
    CkEmailW_putFrom(email,L"alice@example.com");

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

    wprintf(L"NumTo = %d\n",CkEmailW_getNumTo(email));


    CkEmailW_Dispose(email);

    }