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.