NAME
   Lingua::KO::Romanize::Hangul - Romanization of Korean language

SYNOPSIS
       use Lingua::KO::Romanize::Hangul;

       my $conv = Lingua::KO::Romanize::Hangul->new();
       my $roman = $conv->char( $hangul );
       printf( "<ruby><rb>%s</rb><rt>%s</rt></ruby>", $hangul, $roman );

       my @array = $conv->string( $string );
       foreach my $pair ( @array ) {
           my( $raw, $ruby ) = @$pair;
           if ( defined $ruby ) {
               printf( "<ruby><rb>%s</rb><rt>%s</rt></ruby>", $raw, $ruby );
           } else {
               print $raw;
           }
       }

DESCRIPTION
   Hangul is phonemic characters of the Korean language.

 $conv = Lingua::KO::Romanize::Hangul->new();
   This constructer methods returns a new object.

 $roman = $conv->char( $hangul );
   This method returns romanized letters of a Hangul character. It returns
   undef when $hanji is not a valid Hangul character. The argument's
   encoding must be UTF-8.

 $roman = $conv->chars( $string );
   This method returns romanized letters of Hangul characters.

 @array = $conv->string( $string );
   This method returns a array of referenced arrays which are pairs of a
   Hangul chacater and its romanized letters.

       $array[0]           # first Korean character's pair (array)
       $array[1][0]        # secound Korean character itself
       $array[1][1]        # its romanized letters

SEE ALSO
   Lingua::JA::Romanize::Japanese Lingua::ZH::Romanize::Pinyin

   http://www.kawa.net/works/perl/romanize/romanize-e.html

AUTHOR
   Yusuke Kawasaki http://www.kawa.net/

COPYRIGHT AND LICENSE
   Copyright (c) 1998-2006 Yusuke Kawasaki. All rights reserved.

   This program is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.