PureBasic

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

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

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

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Multiple To example")
    CkEmail::setCkFrom(email, "alice@example.com")

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

    Debug "NumTo = " + Str(CkEmail::ckNumTo(email))


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure