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>

Copyright (c) 2002-2003 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.