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

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

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

my $email = Chilkat2::Email->new;
$email->Subject('GetToName example');

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

my $n = $email->NumTo;
for my $i (0 .. $n - 1) {
    print 'To ', $i, ' name: ', $email->GetToName($i), "\n";
}