/ 
Email-MIME-1.943-TRIAL
River stage three • 66 direct dependents • 142 total dependents
/ Email::MIME::Header

NAME

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

VERSION

version 1.943

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.