Tcl

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

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

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

set email [new_CkEmail]

CkEmail_put_Subject $email "GetToName example"

CkEmail_AddTo $email "Joe Smith" "joe@example.com"
CkEmail_AddTo $email "Jane Doe" "jane@example.com"

set n [CkEmail_get_NumTo $email]

for {set i 0} {$i <= [expr $n - 1]} {incr i} {
    puts "To $i name: [CkEmail_getToName $email $i]"
}

delete_CkEmail $email