Email::MIME::Header

NAME

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

VERSION

version 1.949

DESCRIPTION

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.

AUTHORS

Ricardo SIGNES <rjbs@cpan.org>

Casey West <casey@geeknest.com>

Simon Cozens <simon@cpan.org>

COPYRIGHT AND LICENSE

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.