PEAR Manual
This manual is provided as a courtesy. It is not an official source. Please check pear.php.net for updated information.
require_once 'Mail/RFC822.php';
array parseAddressList ([string $address = '', string [$defaultDomain = 'localhost'] [, boolean $nestGroups = FALSE [, boolean $validate = FALSE]]])
array parseAddressList
Extracts the given addresses into there parts.
string $address - the address(es) to validate
string $defaultDomain - the default domain to use in case of absence in the given email address.
boolean $nestGroups - whether to return the structure with groups nested for easier viewing.
boolean $validate - whether to validate atoms. Turn this off if you need to run addresses through before encoding the personal names, for instance.
array - a nested array of anonymous objects.
If $nestGroups set to FALSE, you can jump over the next paragraph.
Every array entry contains an object per group. This object has two attributes:
The addresses array consists of an array of anonymous objects for each address. This object comes with the following attributes:
Table 45-1. Possible PEAR_Error values
This function can be called statically.
This class checks the string only. It does not check for the existence of an email address.
Example 45-1. Extract some addresses
<?php $address = 'My group: "Richard" <richard@localhost>;, ted@example.com (A comment)'; $addresses = Mail_RFC822::parseAddressList($address, 'phpguru.org', TRUE); print_r($addresses); ?>