PEAR Manual
Prev		Next

Mail_RFC822::parseAddressList()

Mail_RFC822::parseAddressList() -- extract the parts of EMail addresse

Synopsis

require_once 'Mail/RFC822.php';

array parseAddressList ([string $address = '', string [$defaultDomain = 'localhost'] [, boolean $nestGroups = FALSE [, boolean $validate = FALSE]]])

Description

Extracts the given addresses into there parts.

Parameter

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.

Return value

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:

groupname - the name of the group

addresses - an array of all addresses of a group

The addresses array consists of an array of anonymous objects for each address. This object comes with the following attributes:

personal - the name of the address owner

comment - an array, an entry for each comment per address

mailbox - the name of the mailbox, the part before the @

host - the name of the server, the part after the @

Throws

Table 31-1. Possible PEAR_Error values

Error code	Error message	Reason	Solution
`NULL`	every	The given address string is not RFC822 compliant	The error code contains a description of the error.

Note

This function can be called statically.

Warning

This class checks the string only. It does not check for the existence of an email address.

Example

Example 31-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); ?>

Prev	Home	Next
RFC822 - Introduction	Up	Mail_IMAP

Who's Online
Guest Users: 13

Free Sample Chapters
	Deliver First Class Web Sites: 101 Essential Checklists Want to learn how to make your web sites usable and accessible? Want to ensure that your sites meet current best practice, without spending hours trawling through incomprehensible specifications and recommendations from dozens of different books, research papers, and web sites? Want to make sure that the sites you build are "right the first time," requiring no costly redevelopments?
More Sample Chapters

PHP General