NAME

Lingua::GLE::Num2Word - Number to word conversion in Irish (Gaeilge)

VERSION

version 0.2603270

Lingua::GLE::Num2Word is a module for converting numbers into their written representation in Irish (Gaeilge). Converts whole numbers from 0 up to 999 999 999.

Text output is encoded in UTF-8.

SYNOPSIS

use Lingua::GLE::Num2Word;

my $text = Lingua::GLE::Num2Word::num2gle_cardinal( 123 );
print $text || "sorry, can't convert this number into Irish.";

Functions Reference

num2gle_cardinal (positional)

1   num    number to convert
=>  str    converted string
    undef  if input number is not known

Convert number to Irish text representation. Only numbers from interval [0, 999_999_999] will be converted.

EXPORT_OK

num2gle_cardinal

DESCRIPTION

This module converts numbers (cardinals) into their Irish (Gaeilge) equivalents using the modern decimal counting system. It accepts positive integers up to, but not including, 1 billion.

Irish uses the counting form with the "a" prefix before digits (e.g., "a haon" for 1, "a dó" for 2). Compound numbers are formed as tens + unit (e.g., "tríocha a trí" for 33).

The module uses the standard modern counting forms without initial consonant mutations (lenition/eclipsis).

AUTHORS

specification, maintenance:
  Richard C. Jelinek E<lt>rj@petamem.comE<gt>
maintenance, coding (2025-present):
  PetaMem AI Coding Agents

COPYRIGHT

Copyright (c) PetaMem, s.r.o. 2004-present

LICENSE

This module is free software; you can redistribute it and/or modify it under the same terms as the Artistic License 2.0 or the BSD 2-Clause License. See the LICENSE file in the distribution for details.