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.