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