The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Lingua::ZH::Numbers::Currency - Converts currency values into their Chinese string equivalents

VERSION

This document describes version 0.01 of Lingua::ZH::Numbers::Currency, released November 23, 2002.

SYNOPSIS

    # OO Style
    use Lingua::ZH::Numbers::Currency 'big5';
    my $shuzi = Lingua::ZH::Numbers::Currency->new( 123 );
    print $shuzi->get_string;

    my $lingyige_shuzi = Lingua::ZH::Numbers::Currency->new;
    $lingyige_shuzi->parse( 7340 );
    $chinese_string = $lingyige_shuzi->get_string;

    # Function style
    print currency_to_zh( 345 );        # automatically exported

    # Change output format
    Lingua::ZH::Numbers::Currency->charset('gb');

DESCRIPTION

This module is a subclass of Lingua::ZH::Numbers; it provides a different set of characters used in currency numbers as used in financial transactions. All five representation systems (charsets): traditional, simplified, big5, gb and pinyin are still supported, although the pinyin variant is identical to the one used in Lingua::ZH::Numbers.

You can also use this module in a functionnal manner by invoking the currency_to_zh() function.

CAVEATS

Fraction currency numbers are unsupported; you have to round the number before passing it for conversion, via int() or s/\.(.*)//.

SEE ALSO

Lingua::ZH::Numbers::Currency

ACKNOWLEDGMENTS

Dieter Simader for suggesting me to write this module.

AUTHORS

Autrijus Tang <autrijus@autrijus.org>

COPYRIGHT

Copyright 2002 by Autrijus Tang <autrijus@autrijus.org>.

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

See http://www.perl.com/perl/misc/Artistic.html