MirBSD manpage: Encode::MIME::Header(3p)

ext::Encode::lib:PerloPreoxgtr:a:mEmnecrosdeR:e:fleirbe:n:cEncode::MIME::Header(3p)

NAME

     Encode::MIME::Header -- MIME 'B' and 'Q' header encoding

SYNOPSIS

         use Encode qw/encode decode/;
         $utf8   = decode('MIME-Header', $header);
         $header = encode('MIME-Header', $utf8);

ABSTRACT

     This module implements RFC 2047 Mime Header Encoding.  There
     are 3 variant encoding names; "MIME-Header", "MIME-B" and
     "MIME-Q".  The difference is described below

                   decode()          encode()
       ----------------------------------------------
       MIME-Header Both B and Q      =?UTF-8?B?....?=
       MIME-B      B only; Q croaks  =?UTF-8?B?....?=
       MIME-Q      Q only; B croaks  =?UTF-8?Q?....?=

DESCRIPTION

     When you decode(=?encoding?X?ENCODED WORD?=), ENCODED WORD
     is extracted and decoded for X encoding (B for Base64, Q for
     Quoted-Printable). Then the decoded chunk is fed to
     decode(encoding).  So long as encoding is supported by
     Encode, any source encoding is fine.

     When you encode, it just encodes UTF-8 string with X encod-
     ing then quoted with =?UTF-8?X?....?= .  The parts that RFC
     2047 forbids to encode are left as is and long lines are
     folded within 76 bytes per line.

BUGS

     It would be nice to support encoding to non-UTF8, such as
     =?ISO-2022-JP? and =?ISO-8859-1?= but that makes the imple-
     mentation too complicated. These days major mail agents all
     support =?UTF-8? so I think it is just good enough.

     Due to popular demand, 'MIME-Header-ISO_2022_JP' was intro-
     duced by Makamaka.  Thre are still too many MUAs especially
     cellular phone handsets which does not grok UTF-8.

SEE ALSO

     Encode

     RFC 2047, <http://www.faqs.org/rfcs/rfc2047.html> and many
     other locations.

perl v5.8.8                2005-02-05                           1