Add Multiple To Recipients at Once

See more Email Object Examples

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

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;

    //  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>");

    printf("NumTo = %d\n",CkEmail_getNumTo(email));


    CkEmail_Dispose(email);

    }