/ 
Lingua-LO-Romanize-0.04
River stage zero No dependents
/ Lingua::LO::Romanize

NAME

Lingua::LO::Romanize - Romanization of Lao language

VERSION

Version 0.04

SYNOPSIS

This module romanizes Lao text using the BGN/PCGN standard from 1966 (with some modifications, see below).

use Lingua::LO::Romanize;

my $foo = Lingua::LO::Romanize->new(text => 'ພາສາລາວ');

my $bar = $foo->romanize;           # $bar will hold the string 'phasalao'
$bar = $foo->romanize(hyphen => 1); # $bar will hold the string 'pha-sa-lao'

DESCRIPTION

Lingua::LO::Romanize romanizes lao text using the BGN/PCGN standard from 1966 (also know as the 'French style') with some modifications for post-revolutionary spellings (spellings introduced from 1975). One such modification is that Lao words has to be spelled out. For example, 'ສະຫວັນນະເຂດ' will be romanized correctly into 'savannakhét' while the older spelling 'ສວັນນະເຂດ' will not be romanized correctly due to lack of characters.

Furthermore, 'ຯ' will be romanized to '...', Lao numbers will be 'romanized' to Arabic numbers (0,1,2,3 etc.), and 'ໆ' will repeat the previous syllable.

Note that all charcters are treated as UTF-8.

FUNCTIONS

new

Creates a new object, a Lao text string is required

my $foo = Lingua::LO::Romanize->new(text => 'ພາສາລາວ');

text

If a string is passed as argument, this string will be used to romanized from.

$foo->text('ເບຍ');

If no arguments as passed, an array reference of Lingua::LO::Romanize::Word from the current text will be returned.

all_words

Will return an array reference of Lingua::LO::Romanize::Word from the current text.

romanize

Returns the current text as a romanized string. If hyphen is true, the syllables will be hyphenated.

my $string = $foo->romanize;

my $string_with_hyphen = $foo->romanize(hyphen => 1);

syllable_array

Returns the current text as an array of hash references. The key 'lao' represents the original syllable and 'romanized' the romanized syllable.

foreach my $syllable ($foo->syllable_array) {
    my $lao_syllable = $syllable->{lao};
    my $romanized_syllable = $syllable->{romanized};
    ...
}

AUTHOR

Joakim Lagerqvist, <jokke at cpan.org>

BUGS

Please report any bugs or feature requests to bug-lingua-lo-romanize at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Lingua-LO-Romanize. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Lingua::LO::Romanize

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2009 Joakim Lagerqvist, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.