Scroll to navigation

Email::MIME::Header(3pm) User Contributed Perl Documentation Email::MIME::Header(3pm)


Email::MIME::Header - the header of a MIME message


version 1.946


This object behaves like a standard Email::Simple header, with the following changes:
  • the "header" method automatically decodes encoded headers if possible
  • the "header_as_obj" method returns an object representation of the header value
  • the "header_raw" method returns the raw header; (read only for now)
  • stringification uses "header_raw" rather than "header"

Note that "header_set" does not do encoding for you, and expects an encoded header. Thus, "header_set" round-trips with "header_raw", not "header"! Be sure to properly encode your headers with "Encode::encode('MIME-Header', $value)" before passing them to "header_set". And be sure to use minimal version 2.83 of Encode module due to bugs in MIME-Header.

Alternately, if you have Unicode (character) strings to set in headers, use the "header_str_set" method.


  • Ricardo SIGNES <>
  • Casey West <>
  • Simon Cozens <>


This software is copyright (c) 2004 by Simon Cozens and Casey West.

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

2017-11-21 perl v5.26.1