Number::Format - Convert numbers to strings with pretty formatting Version: 1.62 WHAT IS IT Number::Format is a library for formatting numbers. Functions are provided for converting numbers to strings in a variety of ways, and to convert strings that contain numbers back into numeric form. The output formats may include thousands separators - characters inserted between each group of three characters counting right to left from the decimal point. The characters used for the decimal point and the thousands separator come from the locale information or can be specified by the user. Also of note is the format_picture command which converts a number into a string using a "picture" string that you provide. This is similar to the PRINT USING statement that some versions of BASIC have. In addition, functions exist to generate strings for numbers containing currency (e.g. "USD 9.99", "DEM 20.00", etc.) or for rounding large values of bytes to the nearest giga/mega/kilo (e.g. "1.5M", "640K", etc.). ALSO AVAILABLE The following are also available as part of the number-format Sourceforge project: - Template Toolkit users: Use Template::Plugin::Number::Format (contributed by Darren Chamberlain) from your templates. - JavaScript users: we also have a JavaScript translation of the Number::Format done by Cees Hek. Find that in our CVS repository here: http://number-format.cvs.sourceforge.net/number-format/javascript HOW TO GET Download it from your favorite CPAN mirror, or from the Sourceforge project: http://sourceforge.net/projects/number-format/ If you are interested in being a developer for this project, or for more information, please contact William R. Ward, SwPrAwM@cpan.org (remove "SPAM" before sending email, leaving only my initials). BUILDING/INSTALLING Perl version 5.8 or higher is required, though it may work on older versions if you edit the 'require 5.008' line. This package is set up to configure and build like a typical Perl extension. To build: perl Makefile.PL make make test make install NOTE: This installs the files in your core Perl module area, typically /usr/local/lib/perl on Unix/Linux and C:\PERL\LIB on Windows, so you may need super-user (root/administrator) access to install. If you wish to install in a private area, such as your home directory, specify that as "perl Makefile.PL PREFIX=/path/to/private/area" and it will be installed there instead. PROBLEMS/BUG REPORTS Please submit your issues via the CPAN RT bug tracker or the Sourceforge bug system: http://rt.cpan.org/NoAuth/Bugs.html?Dist=Number-Format http://sourceforge.net/tracker/?group_id=175334 Please check for existing bug reports on your issue in both places before filing a new bug. MAILING LIST We have an electronic mailing list for announcements of new releases of this module. If you wish to join this list, visit this URL: http://lists.sourceforge.net/mailman/listinfo/number-format-announce We also have a mailing list for developers which you may join if you are interested in contributing to the project: https://lists.sourceforge.net/lists/listinfo/number-format-developers We do not yet have any list for users of the module; if you would like one, let us know and we will look into it. There are also forums available on the SourceForge site: http://sourceforge.net/forum/?group_id=175334 CREDITS AND LICENSES This package is copyright 1997-2008 by William R. Ward et al., and may be distributed under the same terms as cover Perl itself (your choice of Artistic or GPL). See http://dev.perl.org/licenses/ for more information. RECENT CHANGES Changes for version 1.63 (Feb 10, 2009) ------------------------ - Minor tweak to format_bytes test for German locales Changes for version 1.62 (Feb 9, 2009) ------------------------ - Change format_bytes to fully specify all formatting options, not rely on locale at all as it was causing too many CPAN tester errors. Changes for version 1.61 (Dec 29, 2008) ------------------------ - Fix bugs in locale operations for format_price (thanks Moritz Onken) - Fix documentation in format_bytes (rt # 42036) - Enable warning when format_bytes called with numeric precision not hash Changes for version 1.60 (Jul 2, 2008) ------------------------ - Rewrite new() and format_price() to use mon_* POSIX Locale values - Add all missing POSIX Locale variables (Thanks to Kevin Ryde for help identifying the problem) See the file "CHANGES" for more details and previous changes. You can also browse the CVS history on SourceForge for full details.