Unicode C

Count the To Recipients of an Email

Demonstrates the read-only Chilkat Email.NumTo property, which is the number of direct "To" recipients. To-recipient indexes are zero-based and can be inspected with GetTo, GetToAddr, and GetToName. This example adds three To recipients and prints the count.

Background: The To header lists the message's primary recipients — the people the email is directly addressed to and expected to act on it. A single email can have any number of To addresses, and each is stored as a display name plus an email address. Together with NumCC and NumBcc, this property lets you inspect the full recipient set of a message.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;

    //  Demonstrates the read-only Email.NumTo property, which is the number of direct
    //  "To" recipients.  To-recipient indexes are zero-based.

    email = CkEmailW_Create();

    CkEmailW_AddTo(email,L"Joe",L"joe@example.com");
    CkEmailW_AddTo(email,L"Jane",L"jane@example.com");
    CkEmailW_AddTo(email,L"Bob",L"bob@example.com");

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


    CkEmailW_Dispose(email);

    }