• new($line, %options)

  Pass a $line as it could be found in a file: a (possibly folded) line which is terminated by a new-line.

• new($name, $body, [$attributes], %options)

  A set of values which shape the line.

Create a new header field object. Specify the whole $line (encoded octets) at once, and it will be split-up for you. I case you already have the parts of the header line, you may specify them separately as $name and field $body.

In case you specify a single $body object, or an ARRAY of objects, these are processed to become suitable to fill a field, usually by simple strification. When you specify one or more Mail::Address objects, these are transformed into a string using their "format" method. You may also add one Mail::Message::Field, whose body is taken. In case of an array, the elements are joined into one string with a comma.

The $attributes can be exactly one string which may contain multiple attributes at once, quoted and formatted as required in RFC2822. As alternative, list of key-value pairs can be used. In this case, the values will get quoted if needed and everything formatted as the protocol demands. Improves base, see "Constructors" in Mail::Message::Field

 -Option--Defined in     --Default
  log     Mail::Reporter   <disabled>
  trace   Mail::Reporter   <disabled>

log => LEVEL

trace => LEVEL

» example:

  my $mime = Mail::Message::Field->new(
    'Content-Type: text/plain; charset=US-ASCII');
  my $mime = Mail::Message::Field->new(
    'Content-Type' => 'text/plain; charset=US-ASCII');
  my $mime = Mail::Message::Field->new(
    'Content-Type' => 'text/plain', 'charset=US-ASCII');
  my $mime = Mail::Message::Field->new(
    'Content-Type' => 'text/plain', charset => 'Latin1');
  my $mime = Mail::Message::Field->new(
    To => Mail::Address->new('My', 'me@example.com');
  my $mime = Mail::Message::Field->new( Cc => [
    Mail::Address->new('You', 'you@example.com'),
    Mail::Address->new('His', 'he@example.com')
  ]);

But in practice, you can simply call

  my $head = Mail::Message::Head->new;
  $head->add( 'Content-Type' => 'text/plain', charset => 'utf8');

which implicitly calls this constructor (when needed). You can specify the same things for Mail::Message::Head::Complete::add() as this "new" accepts.