mingw/html/lib/Encode/Unicode/UTF7.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>Encode::Unicode::UTF7 -- UTF-7 encoding</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;Encode::Unicode::UTF7 -- UTF-7 encoding</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#synopsis">SYNOPSIS</a></li>
  24         <li><a href="#abstract">ABSTRACT</a></li>
  25         <li><a href="#in_practice">In Practice</a></li>
  26         <li><a href="#see_also">SEE ALSO</a></li>
  27 </ul>
  28 <!-- INDEX END -->
  29
  30 <hr />
  31 <p>
  32 </p>
  33 <h1><a name="name">NAME</a></h1>
  34 <p>Encode::Unicode::UTF7 -- UTF-7 encoding</p>
  35 <p>
  36 </p>
  37 <hr />
  38 <h1><a name="synopsis">SYNOPSIS</a></h1>
  39 <pre>
  40     use Encode qw/encode decode/;
  41     $utf7 = encode(&quot;UTF-7&quot;, $utf8);
  42     $utf8 = decode(&quot;UTF-7&quot;, $ucs2);</pre>
  43 <p>
  44 </p>
  45 <hr />
  46 <h1><a name="abstract">ABSTRACT</a></h1>
  47 <p>This module implements UTF-7 encoding documented in RFC 2152.  UTF-7,
  48 as its name suggests, is a 7-bit re-encoded version of UTF-16BE.  It
  49 is designed to be MTA-safe and expected to be a standard way to
  50 exchange Unicoded mails via mails.  But with the advent of UTF-8 and
  51 8-bit compliant MTAs, UTF-7 is hardly ever used.</p>
  52 <p>UTF-7 was not supported by Encode until version 1.95 because of that.
  53 But Unicode::String, a module by Gisle Aas which adds Unicode supports
  54 to non-utf8-savvy perl did support UTF-7, the UTF-7 support was added
  55 so Encode can supersede Unicode::String 100%.</p>
  56 <p>
  57 </p>
  58 <hr />
  59 <h1><a name="in_practice">In Practice</a></h1>
  60 <p>When you want to encode Unicode for mails and web pages, however, do
  61 not use UTF-7 unless you are sure your recipients and readers can
  62 handle it.  Very few MUAs and WWW Browsers support these days (only
  63 Mozilla seems to support one).  For general cases, use UTF-8 for
  64 message body and MIME-Header for header instead.</p>
  65 <p>
  66 </p>
  67 <hr />
  68 <h1><a name="see_also">SEE ALSO</a></h1>
  69 <p><a href="file://C|\msysgit\mingw\html/lib/Encode.html">the Encode manpage</a>, <a href="file://C|\msysgit\mingw\html/lib/Encode/Unicode.html">the Encode::Unicode manpage</a>, <a href="file://C|\msysgit\mingw\html/Unicode/String.html">the Unicode::String manpage</a></p>
  70 <p>RFC 2781 <a href="http://www.ietf.org/rfc/rfc2152.txt">http://www.ietf.org/rfc/rfc2152.txt</a></p>
  71 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  72 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  73 <big><strong><span class="block">&nbsp;Encode::Unicode::UTF7 -- UTF-7 encoding</span></strong></big>
  74 </td></tr>
  75 </table>
  76
  77 </body>
  78
  79 </html>