PEAR マニュアル
前のページ次のページ

Mail_RFC822::parseAddressList()

Mail_RFC822::parseAddressList() -- メールアドレスの一覧から各部分を展開する

概要

require_once 'Mail/RFC822.php';

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

説明

指定したアドレスを各部分に展開します。

パラメータ

返り値

array - 入れ子状の配列、あるいは無名オブジェクトの配列を返します。

$nestGroups が FALSE の場合は、 次の段落を読み飛ばしてください。

配列のエントリはグループ単位のオブジェクトとなっています。 このオブジェクトは二つの属性を持っています。

groupname - グループの名前。
addresses - グループ内のすべてのアドレスの配列。

配列 addresses は、 各アドレスを表す無名オブジェクトの配列です。 このオブジェクトは次の属性を持っています。

personal - アドレスの所有者名。
comment - アドレスについてのコメントを保持する配列。
mailbox - メールボックスの名前。@ の前の部分。
host - サーバの名前。@ の後の部分。

例外・エラー

表 52-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
NULL すべて 指定した文字列は RFC822 に準拠していません。 エラーの内容がエラーコードに含まれます。

注意

この関数は、スタティックにコールする ことができます。

警告

このクラスがチェックするのは文字列だけです。 そのアドレスが実際に存在するかどうかはチェックしません。

例

例 52-1アドレスの展開

<?php
$address = 'My group: "Richard" <richard@localhost>;, ted@example.com (A comment)';

$addresses = Mail_RFC822::parseAddressList($address, 'phpguru.org', TRUE);
print_r($addresses);
?>

前のページホーム次のページ
RFC822 - 導入上に戻るMail_IMAP