Neil Bowers > Lingua-EN-Numbers-2.00 > Lingua::EN::Numbers

Download:
Lingua-EN-Numbers-2.00.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 2.00   Source  

NAME ^

Lingua::EN::Numbers - turn "407" into "four hundred and seven", etc.

SYNOPSIS ^

  use Lingua::EN::Numbers qw(num2en num2en_ordinal);

  my $x = 234;
  my $y = 54;
  print "You have ", num2en($x), " things to do today!\n";
  print "You will stop caring after the ", num2en_ordinal($y), ".\n";

prints:

  You have two hundred and thirty-four things to do today!
  You will stop caring after the fifty-fourth.

DESCRIPTION ^

This module provides a function num2en, which converts a number (such as 123) into English text ("one hundred and twenty-three"). It also provides a function num2en_ordinal, which converts a number into the ordinal form in words, so 54 becomes "fifty-fourth".

If you pass either function something that doesn't look like a number, they will return undef.

This module can handle integers like "12" or "-3" and real numbers like "53.19".

This module also understands exponential notation -- it turns "4E9" into "four times ten to the ninth"). And it even turns "INF", "-INF", "NaN" into "infinity", "negative infinity", and "not a number", respectively.

Any commas in the input numbers are ignored.

LEGACY INTERFACE ^

The first version of this module, 0.01 released in May 1995, had an OO interface. This was finally dropped in the 1.08 release.

SEE ALSO ^

http://neilb.org/reviews/spell-numbers.html - a review of CPAN modules for converting numbers into English words.

The following modules will convert a number into words:

There are other modules which provide related, but not identical, functionality:

REPOSITORY ^

https://github.com/neilbowers/Lingua-EN-Numbers

COPYRIGHT ^

Copyright (c) 2005, Sean M. Burke.

Copyright (c) 2011-2013, Neil Bowers, minor changes in 1.02 and later.

This library is free software; you can redistribute it and/or modify it only under the terms of version 2 of the GNU General Public License (perlgpl).

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

(But if you have any problems with this library, I ask that you let me know.)

AUTHOR ^

The first release to CPAN, 0.01, was written by Stephen Pandich in 1999.

Sean M Burke took over maintenance in 2005, and completely rewrote the module, releasing versions 0.02 and 1.01.

Neil Bowers <neilb@cpan.org> has been maintaining the module since 2011.

syntax highlighting: