Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Encode::Unicode::UTF7 (3)

Name

Encode::Unicode::UTF7 - 7 encoding

Synopsis

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

Description

Perl Programmers Reference Guide                      Encode::Unicode::UTF7(3)



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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | runtime/perl-532      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

SEE ALSO
       Encode, Encode::Unicode, Unicode::String

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



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.perl.org/.



perl v5.32.0                      2020-06-14          Encode::Unicode::UTF7(3)