Perl

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

Download Chilkat for Perl

Perl

use chilkat();

#  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 = chilkat::CkEmail->new();
$email->put_Subject("GetToName example");

$email->AddTo("Joe Smith",'joe@example.com');
$email->AddTo("Jane Doe",'jane@example.com');

$n = $email->get_NumTo();

for ($i = 0; $i <= $n - 1; $i++) {
    print "To " . $i . " name: " . $email->getToName($i) . "\r\n";
}