Xbase++

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail
LOCAL n
LOCAL 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.

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "GetToName example"

oEmail:AddTo("Joe Smith", "joe@example.com")
oEmail:AddTo("Jane Doe", "jane@example.com")

n := oEmail:NumTo

FOR i := 0 TO n - 1
    ? "To " + Str(i) + " name: " + oEmail:GetToName(i)
NEXT

oEmail:destroy()