Number::Format - Convert numbers to strings with pretty formatting Version: 1.52 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. 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: You may need super-user access to install. PROBLEMS/BUG REPORTS Please submit your issues via the bug tracker on SourceForge or send email (see HOW TO GET, above). 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-2006 by William R. Ward et al., and may be distributed under terms of the Artistic License used to cover Perl itself. See the file "Artistic" in your distribution of Perl for details of copy and distribution terms. RECENT CHANGES Changes for version 1.52 (Sep 21, 2006) ------------------------ - Minor patch to t/format_price.t addressing failling tests Changes for version 1.51 (Apr 26, 2006) ------------------------ - Patch to t/format_price.t to work with non-US locales Changes for version 1.5 (Feb 14, 2005) ------------------------ - Add Perl 5.8 and POSIX.pm to minimum requirements. - Minor bug fixes - see CHANGES for details - Change format_bytes to support options (precision, unit, and base) instead of precision number See the file "CHANGES" for more details and previous changes. You can also browse the CVS history on SourceForge for full details.