# phpman > perldoc > Mail::Field::AddrList ## NAME [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown) - object representation of e-mail address lists ## INHERITANCE [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown) is a [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) ## SYNOPSIS use [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown); $to = [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)->new('To'); $from = [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)->new('From', ' (Peter Orbaek)'); $from->create('' => 'Mr. Foo', poe => 'Peter'); $from->parse(' (Mr Foo), Peter Orbaek '); # make a RFC822 header string print $from->stringify(),"\n"; # extract e-mail addresses and names @addresses = $from->addresses(); # strings @names = $from->names(); # strings @addr = $from->addr_list(); # [Mail::Address](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AAddress/markdown) objects (v2.00) # adjoin a new address to the list $from->set_address('', 'Mr. Foo'); ## DESCRIPTION Defines parsing and formatting of address field, for the following fields: "To", "From", "Cc", "Reply-To", and "Sender". All the normally used features of the address field specification of RFC2822 are implemented, but some complex (and therefore hardly ever used) constructs will not be understood. Use [Mail::Message::Field::Full](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMessage%3A%3AField%3A%3AFull/markdown) in MailBox if you need full RFC compliance. Extends "DESCRIPTION" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). ## METHODS Extends "METHODS" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). ### Constructors Extends "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown)->combine($fields) Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown)->extract( $tag, $head [, $index ] ) Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown)->new( $tag [, STRING | %options] ) Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) "Fake" constructors Extends ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). $obj->create(%options) Inherited, see ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) $obj->parse() Inherited, see ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) ### Accessors Extends "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). $obj->set(%options) Inherited, see "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) $obj->stringify() Inherited, see "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) $obj->tag() [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown)->tag() Inherited, see "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) ### Smart accessors Extends "Smart accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). $obj->addr_list() Returns the collected [Mail::Address](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AAddress/markdown) objects. $obj->addresses() Returns a list if email addresses, found in the field content. $obj->names() Returns a list of nicely formatted named, for each of the addresses found in the content. $obj->set_address($email, $name) Add/replace an $email address to the field. $obj->text( [STRING] ) Inherited, see "Smart accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) ## DETAILS Extends "DETAILS" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown). ## DIAGNOSTICS Error: Undefined subroutine called [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) objects use autoloading to compile new functionality. Apparently, the method called is not implemented for the specific class of the field object. ## SEE ALSO This module is part of the MailTools distribution, . ## AUTHORS The MailTools bundle was developed by Graham Barr. Later, Mark Overmeer took over maintenance without commitment to further development. [Mail::Cap](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ACap/markdown) by Gisle Aas <>. [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown) by Peter Orbaek <>. [Mail::Mailer](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer/markdown) and [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown) by Tim Bunce <>. For other contributors see ChangeLog. ## LICENSE Copyrights 1995-2000 Graham Barr <> and 2001-2017 Mark Overmeer <>. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See