NAME

Lingua::JBO::Numbers - Convert numbers into Lojban words

VERSION

This document describes Lingua::JBO::Numbers version 0.03.

SYNOPSIS

    use 5.010;
    use Lingua::JBO::Numbers qw( num2jbo );

    for my $namcu (reverse 0 .. 99) {
        say '.', num2jbo($namcu), ' botpi le birje cu cpana le bitmu';
    }

output:

    .soso botpi le birje cu cpana le bitmu
    .sobi botpi le birje cu cpana le bitmu
    .soze botpi le birje cu cpana le bitmu
      ...
    .no botpi le birje cu cpana le bitmu

DESCRIPTION

This module provides functions to convert numbers into words in Lojban, a constructed logical language created by The Logical Language Group and published in 1998.

FUNCTIONS

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

num2jbo EXPR

If EXPR looks like a number, the text describing the number is returned. Both integers and real numbers are supported, including negatives. Special values such as "inf" and "NaN" are also supported.

num2jbo_ordinal EXPR

If EXPR looks like an integer, the text describing the number in ordinal form is returned. The behavior when passing a non-integer value is undefined.

If EXPR is a value that does not look like a number or is not currently supported by this module, undef is returned.

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

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

TODO

• support exponential notation

• support "ra'e" for repeating decimals

• option for using either space or nothing to separate output words

• option for using the thousands separator "ki'o" in output

• option for eluding to zeros using "ki'o"

• provide POD translation in Lojban

SEE ALSO

Lingua::Conlang::Numbers, http://www.lojban.org/publications/reference_grammar/chapter18.html

AUTHOR

Nick Patch <patch@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2010 Nick Patch

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