ext/Encode/KR/KR.pm

   1 package Encode::KR;
   2 BEGIN {
   3     if (ord("A") == 193) {
   4         die "Encode::KR not supported on EBCDIC\n";
   5     }
   6 }
   7 our $VERSION = do { my @r = (q$Revision: 1.21 $ =~ /\d+/g); sprintf "%d."."%02d" x $#r, @r };
   8
   9 use Encode;
  10 use XSLoader;
  11 XSLoader::load(__PACKAGE__,$VERSION);
  12
  13 1;
  14 __END__
  15
  16 =head1 NAME
  17
  18 Encode::KR - Korean Encodings
  19
  20 =head1 SYNOPSIS
  21
  22     use Encode qw/encode decode/;
  23     $euc_kr = encode("euc-kr", $utf8);   # loads Encode::KR implicitly
  24     $utf8   = decode("euc-kr", $euc_kr); # ditto
  25
  26 =head1 DESCRIPTION
  27
  28 This module implements Korean charset encodings.  Encodings supported
  29 are as follows.
  30
  31
  32   Canonical   Alias             Description
  33   --------------------------------------------------------------------
  34   euc-kr      /\beuc.*kr$/i     EUC (Extended Unix Character)
  35               /\bkr.*euc$/i
  36   ksc5601-raw                   Korean standard code set (as is)
  37   cp949       /(?:x-)?uhc$/i
  38               /(?:x-)?windows-949$/i
  39               /\bks_c_5601-1987$/i
  40                                 Code Page 949 (EUC-KR + 8,822
  41                                 (additional Hangul syllables)
  42   MacKorean                     EUC-KR + Apple Vendor Mappings
  43   johab       JOHAB             A supplementary encoding defined in
  44                                              Annex 3 of KS X 1001:1998
  45   iso-2022-kr                   iso-2022-kr                  [RFC1557]
  46   --------------------------------------------------------------------
  47
  48 To find how to use this module in detail, see L<Encode>.
  49
  50 =head1 BUGS
  51
  52 When you see C<charset=ks_c_5601-1987> on mails and web pages, they really
  53 mean "cp949" encodings.  To fix that, the following aliases are set;
  54
  55   qr/(?:x-)?uhc$/i         => '"cp949"'
  56   qr/(?:x-)?windows-949$/i => '"cp949"'
  57   qr/ks_c_5601-1987$/i     => '"cp949"'
  58
  59 ASCII part (0x00-0x7f) is preserved for all encodings, even though it
  60 conflicts with mappings by the Unicode Consortium.  See
  61
  62 L<http://www.debian.or.jp/~kubota/unicode-symbols.html.en>
  63
  64 to find why it is implemented that way.
  65
  66 =head1 SEE ALSO
  67
  68 L<Encode>
  69
  70 =cut