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. This module follows the Revised Romanization of Korean which was released on July 7, 2000 as the official romanization system in South Korea.

$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

UTF-8 FLAG

This module treats utf8 flag transparently.

SEE ALSO

Lingua::JA::Romanize::Japanese for Japanese

Lingua::ZH::Romanize::Pinyin for Chinese

http://www.korean.go.kr/06_new/rule/rule06.jsp

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

COPYRIGHT AND LICENSE

Copyright (c) 1998-2008 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.