NAME

Mail::Field::AddrList - object representation of e-mail address lists

DESCRIPTION

Don't use this class directly! Instead ask Mail::Field for new instances based on the field name!

SYNOPSIS

use Mail::Field::AddrList;

$to = Mail::Field->new('To');
$from = Mail::Field->new('From', 'poe@daimi.aau.dk (Peter Orbaek)');

$from->create('foo@bar.com' => 'Mr. Foo', poe => 'Peter');
$from->parse('foo@bar.com (Mr Foo), Peter Orbaek <poe>');

# make a RFC822 header string
print $from->stringify(),"\n";

# extract e-mail addresses and names
@addresses = $from->addresses();
@names = $from->names();

# adjoin a new address to the list
$from->set_address('foo@bar.com', 'Mr. Foo');

NOTES

Defines parsing and formatting according to RFC822, of the following fields: To, From, Cc, Reply-To and Sender.

AUTHOR

Peter Orbaek <poe@cit.dk> 26-Feb-97 Modified by Graham Barr <gbarr@pobox.com> Maintained by Mark Overmeer <mailtools@overmeer.net>