Encode::compat - Encode.pm emulation layer
This document describes version 0.07 of Encode::compat, released June 3, 2004.
use Encode::compat; # a no-op for Perl v5.7.1+ use Encode qw(...); # all constants and imports works transparently # use Encode functions as normal
WARNING: THIS IS A PROOF-OF-CONCEPT. Most functions are incomplete. All implementation details are subject to change!
This module provide a compatibility layer for Encode.pm users on perl versions earlier than v5.7.1. It translates whatever call it receives into Text::Iconv, or (in the future) Unicode::MapUTF8 to perform the actual work.
The is_utf8(), _utf8_on() and _utf8_off() calls are performed by the method native to the perl version -- 5.6.1 would use pack/unpack, 5.6.0 uses tr//CU, etc.
is_utf8()
_utf8_on()
_utf8_off()
pack
unpack
tr//CU
Theoretically, it could be backported to 5.005 and earlier, with none of the unicode-related semantics available, and serves only as a abstraction layer above Text::Iconv, Unicode::MapUTF8 and possibly other transcoding modules.
Text::Iconv
Unicode::MapUTF8
Currently, this module only support 5.6.1+, and merely provides the three utility function above (encode(), decode() and from_to()), with a very kludgy FB_HTMLCREF fallback against latin-1 in from_to().
encode()
decode()
from_to()
FB_HTMLCREF
latin-1
Encode, perlunicode
Autrijus Tang <autrijus@autrijus.org>
Copyright 2002, 2003, 2004 by Autrijus Tang <autrijus@autrijus.org>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://www.perl.com/perl/misc/Artistic.html
To install Encode::compat, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Encode::compat
CPAN shell
perl -MCPAN -e shell install Encode::compat
For more information on module installation, please visit the detailed CPAN module installation guide.