File Coverage

blib/lib/Lingua/SWA/Num2Word.pm

Criterion	Covered	Total	%
statement	28	56	50.0
branch	2	26	7.6
condition	4	41	9.7
subroutine	9	11	81.8
pod	3	3	100.0
total	46	137	33.5

# For Emacs: -*- mode:cperl; eval: (folding-mode 1); coding:utf-8 -*-

package Lingua::SWA::Num2Word;
# ABSTRACT: Number to word conversion in Swahili

use 5.16.0;
use utf8;
use warnings;

# {{{ use block

use Carp;
use Export::Attrs;
use Readonly;

# }}}
# {{{ variable declarations

my Readonly::Scalar $COPY = 'Copyright (c) PetaMem, s.r.o. 2002-present';
our $VERSION = '0.2603300';

# }}}

# {{{ num2swa_cardinal                 convert number to text

sub num2swa_cardinal :Export {
    my $positive = shift;

    croak 'You should specify a number from interval [0, 999_999_999]'
        if    !defined $positive
           || $positive !~ m{\A\d+\z}xms
           || $positive < 0
           || $positive > 999_999_999;

    my @ones = qw(sifuri moja mbili tatu nne tano sita saba nane tisa);
    my @tens = qw(kumi ishirini thelathini arobaini hamsini sitini sabini themanini tisini);

    return $ones[$positive]             if ($positive >= 0 && $positive < 10);  # 0 .. 9
    return 'kumi'                       if ($positive == 10);                   # 10
    return 'kumi na ' . $ones[$positive - 10]
                                        if ($positive > 10 && $positive < 20);  # 11 .. 19

    my $out;
    my $remain;

    if ($positive > 19 && $positive < 100) {                    # 20 .. 99
        my $ten_idx = int($positive / 10) - 1;                  # tens[0]=kumi, tens[1]=ishirini
        $remain = $positive % 10;

        $out = $tens[$ten_idx];
        $out .= ' na ' . $ones[$remain] if ($remain);
    }
    elsif ($positive > 99 && $positive < 1000) {                # 100 .. 999
        my $hun = int($positive / 100);
        $remain = $positive % 100;

        $out = 'mia ' . $ones[$hun];
        $out .= ' na ' . num2swa_cardinal($remain) if ($remain);
    }
    elsif ($positive > 999 && $positive < 1_000_000) {          # 1000 .. 999_999
        my $thou = int($positive / 1000);
        $remain  = $positive % 1000;

        $out = 'elfu ' . num2swa_cardinal($thou);
        $out .= ' na ' . num2swa_cardinal($remain) if ($remain);
    }
    elsif ($positive > 999_999 && $positive < 1_000_000_000) {  # 1_000_000 .. 999_999_999
        my $mil = int($positive / 1_000_000);
        $remain = $positive % 1_000_000;

        $out = 'milioni ' . num2swa_cardinal($mil);
        $out .= ' ' . num2swa_cardinal($remain) if ($remain);
    }

    return $out;
}

# }}}


# {{{ num2swa_ordinal                 convert number to ordinal text

sub num2swa_ordinal :Export {
    my $number = shift;
    my $prefix = shift // 'wa';    # noun-class prefix; default = wa (persons)

    croak 'You should specify a number from interval [1, 999_999_999]'
        if    !defined $number
           || $number !~ m{\A\d+\z}xms
           || $number < 1
           || $number > 999_999_999;

    # Swahili ordinals: {noun-class-prefix} + "-a" + ordinal word.
    # 1st through 5th and 8th have special stems; the rest use cardinals.
    my %special = (
        1 => 'kwanza',
        2 => 'pili',
        3 => 'tatu',
        4 => 'nne',
        5 => 'tano',
        8 => 'nane',
    );

    my $ordinal_word = $special{$number} // num2swa_cardinal($number);

    return $prefix . ' ' . $ordinal_word;
}

# }}}

# {{{ capabilities              declare supported features

sub capabilities {
    return {
        cardinal => 1,
        ordinal  => 1,
    };
}

# }}}
1;

__END__