Avi Finkel > Money-ChangeMaker-0.2 > Money::ChangeMaker::Presets

Download:
Money-ChangeMaker-0.2.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Source   Latest Release: Money-ChangeMaker-0.3.1

NAME ^

Money::ChangeMaker::Presets - Contains preset currency sets for Money::ChangeMaker

SYNOPSIS ^

        See L<Money::ChangeMaker>

DESCRIPTION ^

Simply contains the preset monetary sets used by the Money::ChangeMaker module. In general, users should not interact with this module at all, it is simply provided as separate so that users may modify it in their own installation to add/modify existing preset sets.

METHODS ^

There are no public methods in this module.

CAVEATS ^

When working with monetary amounts, it is common to want to represent them in the same terms as they are represented in life -- e.g. 12.45 to represent twelve dollars and 45 cents. However, in perl, floating point numbers are subject to certain inherent inconsitencies and as such should really be avoided when possible. It is therefore better to work only with integer values, by making sure that the smallest unit in a monetary set is represented by 1, not by 0.01. This is the standard as used by all presets in this module.

More details about floating point errors are available at http://www.lahey.com/float.htm

Available Presets ^

Canada

The base unit for this set is the penny. Thus, twenty dollars is represented by 2000 and fifty cents by 50.

        Value       Name               Plural
        ----------------------------------------
        10000       hundred dollar bill
        2000        twenty dollar bill
        1000        ten dollar bill
        500         five dollar bill
        200         two dollar coin
        100         one dollar coin
        25          quarter
        10          dime
        5           nickel
        1           penny              pennies

India

The base unit for this set is the rupee. This means that there are some floating point units, for the paisa coins -- they are rare enough that I decded to simplify the currency set rather than avoid a rare possible error case.

        Value       Name               Plural
        ----------------------------------------
        1000        thousand rupee note
        500         five hundred rupee note
        100         one hundred rupee note
        50          fifty rupee note
        20          twenty rupee note
        10          ten rupee note
        5           five rupee note
        2           two rupee note
        1           rupee coin
        0.5         50 paise coin
        0.25        25 paise coin

UK

The base unit for this set is the penny. Thus, twenty pounds is represented by 2000 and fifty pence by 50.

        Value       Name               Plural
        ----------------------------------------
        5000        fifty pound note
        2000        twenty pound note
        1000        ten pound note
        500         five pound note
        200         two pound coin
        100         one pound coin
        50          fifty pence coin
        20          twenty pence coin
        10          ten pence coin
        5           five pence coin
        2           two pence coin
        1           penny              pence

USA

The base unit for this set is the penny. Thus, twenty dollars is represented by 2000 and fifty cents by 50.

        Value       Name               Plural
        ----------------------------------------
        10000       hundred dollar bill
        5000        fifty dollar bill
        2000        twenty dollar bill
        1000        ten dollar bill
        500         five dollar bill
        100         dollar bill
        25          quarter
        10          dime
        5           nickel
        1           penny              pennies

Australia

The base unit for this set is the cent. Thus, twenty dollars is represented by 2000 and fifty cents by 50.

        Value       Name               Plural
        ----------------------------------------
        10000       hundred dollar note
        5000        fifty dollar note
        2000        twenty dollar note
        1000        ten dollar note
        500         five dollar note
        200         two dollar coin
        100         one dollar coin
        50          fifty cent piece
        20          twenty cent piece
        10          ten cent piece
        5           five cent piece

Euro

The base unit for this set is the cent. Thus, twenty euros is represented by 2000 and fifty cents by 50.

        Value       Name               Plural
        ----------------------------------------
        50000       five hundred euro note
        20000       two hundred euro note
        10000       one hundred euro note
        5000        fifty euro note
        2000        twenty euro note
        1000        ten euro note
        500         five euro note
        200         two euro coin
        100         one euro coin
        50          fifty cent coin
        20          twenty cent coin
        10          ten cent coin
        5           five cent coin
        2           two cent coin
        1           one cent coin

Adding Sets ^

In this release, there is no programmatic method for adding new currency sets to the preset data, apart from directly modifying the documentation of this module. If there is sufficient demand, I will add functionality to allow people to add new sets at run-time. Instead, I suggest you use one of these methods instead:

You can modify the contents of the Presets.pm file on your local installation. If you do this, simply follow the pattern as already laid out in the file. Keep in mind that preset lists must be created in descending value order. When dynamic currency sets are added, they are sorted, so this is not important in that case. However, when reading from presets, it assumes that the units are already in order, as an optimization.

Preferably, if you think that the monetary set would be of use to more than just yourself, you can send it to me at avi@finkel.org. There is no specific format I need it in, I just ask that any submissions are complete, accurate and detailed. If possible, include alternate "slang" names for any currency units, include units that are no longer in circulation (but please indicate them as such,) and any other notes about the units that may be of interest. Any submissions will be greatly appreciated and appropriately credited.

Please keep in mind that ChangeMaker objects do not need to built using presets. If you are building denomination sets dynamically, they should be stored in your own code and given to the ChangeMaker object using the 'denomination' method.

AUTHOR ^

Copyright 2006 Avi Finkel <avi@finkel.org>

This package is free software and is provided "as is" without express or implied warranty. It may be used, redistributed and/or modified under the terms of the Perl Artistic License (see http://www.perl.com/perl/misc/Artistic.html)

syntax highlighting: