PEAR Справочное руководство
Пред. След.

Mail_RFC822::parseAddressList()

Mail_RFC822::parseAddressList() -- extract the parts of a list of email addresses

Synopsis

require_once 'Mail/RFC822.php';

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

Описание

Extracts the given addresses into their parts.

Параметр

Возвращаемое значение

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

Таблица 48-1. Возможные значения PEAR_Error

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.

Заметка

Эта функция может быть вызвана статически.

Внимание

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

Пример

Пример 48-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);
?>

Пред. Начало След.
RFC822 - Introduction Уровень выше Mail_Mime
    Поддержать сайт на родительском проекте КГБ