Unicode C

Get a To Recipient's Name Only

Demonstrates the Chilkat Email.GetToName method, which returns only the friendly-name part (not the address) of the Nth To recipient. The index is zero-based. This example adds two To recipients and prints each one's display name.

Background: The display name is the human-friendly label attached to an address, like Joe Smith for joe@example.com. It is optional and purely cosmetic but useful for presentation. GetToName returns just that name; if a recipient was added without one, the result is empty, in which case fall back to GetToAddr.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    HCkEmailW email;
    int n;
    int i;

    //  Demonstrates the GetToName method, which returns only the friendly-name part (not the
    //  address) of the Nth To recipient.  The index is zero-based.

    email = CkEmailW_Create();
    CkEmailW_putSubject(email,L"GetToName example");

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

    n = CkEmailW_getNumTo(email);

    for (i = 0; i <= n - 1; i++) {
        wprintf(L"To %d name: %s\n",i,CkEmailW_getToName(email,i));
    }



    CkEmailW_Dispose(email);

    }