Rats' nest.
[p5sagit/p5-mst-13.2.git] / ext / Encode / CN / CN.pm
CommitLineData
0e567a6c 1package Encode::CN;
fab31126 2our $VERSION = do { my @r = (q$Revision: 0.93 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
c0d88b76 3
4use Encode;
5use Encode::CN::HZ;
0e567a6c 6use XSLoader;
7XSLoader::load('Encode::CN',$VERSION);
8
fab31126 9Encode::define_alias( qr/euc.*cn$/i => '"euc-cn"' );
10Encode::define_alias( qr/cn.*euc/i => '"euc-cn"' );
11
0e567a6c 121;
13__END__
b2729934 14=head1 NAME
15
16Encode::CN - China-based Chinese Encodings
17
18=head1 SYNOPSIS
19
2b217bf7 20 use Encode 'encode';
21 $euc_cn = encode("euc-cn", $utf8); # loads Encode::CN implicitly
ee981de6 22 $utf8 = decode("euc-cn", $euc_cn); # ditto
b2729934 23
24=head1 DESCRIPTION
25
26This module implements China-based Chinese charset encodings.
27Encodings supported are as follows.
28
fab31126 29 Canonical Alias Description
30 --------------------------------------------------------------------
31 euc-cn /euc.*cn$/i EUC (Extended Unix Character)
32 /cn.*euc$/i
33 gb2312 The raw (low-bit) GB2312 character map
34 gb12345 Traditional chinese counterpart to
35 GB2312 (raw)
36 iso-ir-165 GB2312 + GB6345 + GB8565 + additions
37 cp936 Code Page 936, also known as GBK
38 (Extended GuoBiao)
39 hz 7-bit escaped GB2312 encoding
b2729934 40
41To find how to use this module in detail, see L<Encode>.
42
43=head1 NOTES
44
45Due to size concerns, C<GB 18030> (an extension to C<GBK>) is distributed
46separately on CPAN, under the name L<Encode::HanExtra>. That module
47also contains extra Taiwan-based encodings.
48
c0d88b76 49=head1 BUGS
b2729934 50
51ASCII part (0x00-0x7f) is preserved for all encodings, even though it
52conflicts with mappings by the Unicode Consortium. See
53
54F<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
55
56to find why it is implemented that way.
57
58=head1 SEE ALSO
59
60L<Encode>
61
62=cut