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.