@Name

Address @Name(Field field)

説明

引数で指定されたフィールドをアドレスリストとしてパースし、含まれている名前のリストを返します。フィールドがアドレスを指定するフィールドでなかった場合やパースに失敗した場合には空のリストを返します。

パースされた各アドレスに対して名前が指定されている場合にはその名前を、指定されていない場合にはアドレスを返します。グループアドレスの場合には、グループの名前を返します。

たとえば、

To: test1@example.org,
 Test2 <test2@example.org>,
 Test3: test3@example.org, Test4 <test4@example.org>;

というヘッダを含むメッセージに対して、@Name(To)を適用すると、test1@example.org, Test2, Test3を含む名前のリストが返されます。

引数

Field field
名前のリストを取得するフィールド

エラー

条件

なし

# Toで指定された名前のリストを取得
@Name(To)