Mail::Message::Field::Address3pm

Usage

  my $addr = Mail::Message::Field::Address->new(...);
  my $ui   = User::Identity->new(...);
  my $addr = Mail::Message::Field::Address->coerce($ui);
  my $mi   = Mail::Identity->new(...);
  my $addr = Mail::Message::Field::Address->coerce($mi);
  print $addr->address;
  print $addr->fullName;   # possibly unicode!
  print $addr->domain;

Inheritance

 Mail::Message::Field::Address
   is a Mail::Identity
   is a User::Identity::Item

Overview

Many header fields can contain e-mail addresses. Each e-mail address can be represented by an object of this class. These objects will handle interpretation and character set encoding and decoding for you.

Extends "DESCRIPTION" in Mail::Identity.

Overloaded

overload: '""' stringification

When the object is used in string context, it will return the encoded representation of the e-mail address, just like string() does.

overload: 'bool' use as boolean

The object used as boolean will always return "true"

overload: 'cmp' string comparison

Two address objects are the same when their email addresses are the same.

Methods

Extends "METHODS" in Mail::Identity.

Diagnostics

Error: cannot coerce a $type into a $class

When addresses are specified to be included in header fields, they may be coerced into Mail::Message::Field::Address objects first. What you specify is not accepted as address specification. This may be an internal error. Cast by coerce()

Error: cannot load collection module for $type ($class): $@

Either the specified $type does not exist, or that module named $class returns compilation errors. If the type as specified in the warning is not the name of a package, you specified a nickname which was not defined. Maybe you forgot the 'require' the package which defines the nickname. Cast by addCollection()

Error: invalid collection $name.

The collection with $name does not exist and can not be created. Cast by add()

Error: this $object is not a collection.

Cast by addCollection()