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.