Xbase++

Get a Cc Recipient's Name Only

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

Background: A recipient combines a display name with an address, such as Jane Doe <jane@example.com>. GetCcName returns just the Jane Doe portion, which is handy for showing a friendly label in a UI. The name is optional free-form text, so it may be empty — when it is, fall back to the address from GetCcAddr.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL oEmail
LOCAL n
LOCAL i

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

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

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

n := oEmail:NumCC

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

oEmail:destroy()