NAME

Email::Simple::Header - the header of an Email::Simple message

SYNOPSIS

  my $email = Email::Simple->new($text);

  my $header = $email->head;
  print $header->as_string;

This method implements the headers of an Email::Simple object. It is a very minimal interface, and is mostly for private consumption at the moment.

  my $header = Email::Simple::Header->new($head, \%arg);

$head is a string containing a valid email header, or a reference to such a string.

Valid arguments are:

  crlf - the header's newline; defaults to "\n"

This returns the stringified header.

This method returns the unique header names found in this header, in no particular order.

This method returns all the field/value pairs in the header, in the order that they appear in the header.

  my $first_value = $header->header($field);
  my @all_values  = $header->header($field);

This method returns the value or values of the given header field. If the named field does not appear in the header, this method returns false.

  $header->header_set($field => @values);

This method updates the value of the given header. Existing headers have their values set in place. Additional headers are added at the end.

This method returns the newline string used in the header.

This module is maintained by the Perl Email Project

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Email::Simple::Header - the header of an Email::Simple message