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