ext/Encode/CN/CN.pm

   1 package Encode::CN;
   2 our $VERSION = '0.02';
   3
   4 use Encode;
   5 use Encode::CN::HZ;
   6 use XSLoader;
   7 XSLoader::load('Encode::CN',$VERSION);
   8
   9 1;
  10 __END__
  11 =head1 NAME
  12
  13 Encode::CN - China-based Chinese Encodings
  14
  15 =head1 SYNOPSIS
  16
  17     use Encode 'encode';
  18     $euc_cn = encode("euc-cn", $utf8);   # loads Encode::CN implicitly
  19     $utf8   = encode("euc-cn", $euc_cn); # ditto
  20
  21 =head1 DESCRIPTION
  22
  23 This module implements China-based Chinese charset encodings.
  24 Encodings supported are as follows.
  25
  26   euc-cn        EUC (Extended Unix Character)
  27   gb2312        The raw (low-bit) GB2312 character map
  28   gb12345       Traditional chinese counterpart to GB2312 (raw)
  29   iso-ir-165    GB2312 + GB6345 + GB8565 + additions
  30   cp936         Code Page 936, also known as GBK (Extended GuoBiao)
  31   hz            7-bit escaped GB2312 encoding
  32
  33 To find how to use this module in detail, see L<Encode>.
  34
  35 =head1 NOTES
  36
  37 Due to size concerns, C<GB 18030> (an extension to C<GBK>) is distributed
  38 separately on CPAN, under the name L<Encode::HanExtra>. That module
  39 also contains extra Taiwan-based encodings.
  40
  41 =head1 BUGS
  42
  43 ASCII part (0x00-0x7f) is preserved for all encodings, even though it
  44 conflicts with mappings by the Unicode Consortium.  See
  45
  46 F<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
  47
  48 to find why it is implemented that way.
  49
  50 =head1 SEE ALSO
  51
  52 L<Encode>
  53
  54 =cut