NAME

Lingua::Conlang::Numbers - Convert numbers into words in various constructed languages

VERSION

This document describes Lingua::Conlang::Numbers version 0.04.

SYNOPSIS

    use Lingua::Conlang::Numbers qw(
        num2conlang num2conlang_ordinal num2conlang_languages
    );

WARNING

The interface for the Lingua::Conlang::Numbers module may change in the future, but will likely remain the same for the individual language modules included in the Lingua-Conlang-Numbers distribution.

DESCRIPTION

The Lingua-Conlang-Numbers distribution includes modules for converting numbers into words in various constructed languages, also known as planned languages or artificial languages.

The Lingua::Conlang::Numbers module provides a common interface to all of the included modules without the need to use each one.

FUNCTIONS

The following functions are provided but are not exported by default.

num2conlang STRING, EXPR

If STRING is a supported language, EXPR is passed to the num2xx function from the corresponding module, which will handle the return value.

    num2conlang(eo => 3.141593);

num2conlang_ordinal STRING, EXPR

If STRING is a supported language, EXPR is passed to the num2xx_ordinal function from the corresponding module, which will handle the return value.

    num2conlang_ordinal(jbo => 5);

num2conlang_languages

Returns the list of supported language strings in list context and the number of supported languages in scalar context.

The STRING argument for num2conlang or num2conlang_ordinal may be the case-insensitive language name with optional underscores (e.g., TokiPona, tokipona, toki_pona) or the two-letter ISO 639-1 codes and three-letter ISO 639-3 codes when available (e.g., eo, epo, EO, EPO).

The :all tag can be used to import all functions.

    use Lingua::Conlang::Numbers qw( :all );

MODULES

See the individual language modules for details on supported numbers and provided output.

• Lingua::EO::Numbers - Esperanto (eo, epo)

• Lingua::JBO::Numbers - Lojban (jbo)

• Lingua::TLH::Numbers - Klingon (tlh)

• Lingua::TokiPona::Numbers - Toki Pona

TODO

Add support for additional constructed languages including, but not limited to: Ido, Interlingua, Latino sine Flexione, Loglan, Na'vi, Occidental, Quenya, and Volapük.

SEE ALSO

utf8, Lingua::Any::Numbers

AUTHOR

Nick Patch <patch@cpan.org>

ACKNOWLEDGEMENTS

Sean M. Burke created the current interface to Lingua::EN::Numbers, which the included modules are based on.

COPYRIGHT AND LICENSE

Copyright 2009, 2010 Nick Patch

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

cpanm Lingua::Conlang::Numbers

perl -MCPAN -e shell
install Lingua::Conlang::Numbers