encode::unicode::utf7(3pm) [debian man page]

Encode::Unicode::UTF7(3pm)				User Contributed Perl Documentation				Encode::Unicode::UTF7(3pm)

NAME

       Encode::Unicode::UTF7 -- UTF-7 encoding

SYNOPSIS

	   use Encode qw/encode decode/;
	   $utf7 = encode("UTF-7", $utf8);
	   $utf8 = decode("UTF-7", $ucs2);

ABSTRACT

       This module implements UTF-7 encoding documented in RFC 2152.  UTF-7, as its name suggests, is a 7-bit re-encoded version of UTF-16BE.  It
       is designed to be MTA-safe and expected to be a standard way to exchange Unicoded mails via mails.  But with the advent of UTF-8 and 8-bit
       compliant MTAs, UTF-7 is hardly ever used.

       UTF-7 was not supported by Encode until version 1.95 because of that.  But Unicode::String, a module by Gisle Aas which adds Unicode
       supports to non-utf8-savvy perl did support UTF-7, the UTF-7 support was added so Encode can supersede Unicode::String 100%.

In Practice
       When you want to encode Unicode for mails and web pages, however, do not use UTF-7 unless you are sure your recipients and readers can
       handle it.  Very few MUAs and WWW Browsers support these days (only Mozilla seems to support one).  For general cases, use UTF-8 for
       message body and MIME-Header for header instead.

SEE ALSO

       Encode, Encode::Unicode, Unicode::String

       RFC 2781 <http://www.ietf.org/rfc/rfc2152.txt>

perl v5.14.2							    2011-08-09						Encode::Unicode::UTF7(3pm)

Encode::MIME::Header(3pm)				 Perl Programmers Reference Guide				 Encode::MIME::Header(3pm)

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 dif-
       ference 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 encoding 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 implementation too compli-
       cated.  These days major mail agents all support =?UTF-8? so I think it is just good enough.

SEE ALSO

       Encode

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

perl v5.8.0							    2002-06-01						 Encode::MIME::Header(3pm)