NAME
Interchange6::Currency - Currency objects for Interchange 6
VERSION
0.101
DESCRIPTION
Currency objects for Interchange6 Open Source eCommerce with Unicode CLDR localization and rate conversion.
Extends CLDR::Number::Format::Currency with accurate calculation functions using Math::BigFloat.
Many useful standard operators are overloaded and return currency objects if appropriate.
Although this class was written to satisfy the specific requirements of Interchange6 it is suitable for use as a standalone module. See "SEE ALSO" for other currency modules.
ATTRIBUTES
value
Value as simple decimal, e.g.: 3.45
All values are coerced into Math::BigFloat.
converter_class
Defaults to Finance::Currency::Convert::WebserviceX.
The class name which handles conversion to a new currency_code.
The converter class can be any class that supports the following method signature:
sub convert {
my ($self, $price, $from, $to) = @_;
return $converted_price;
};In addition this module supports the following converters:
converter
Vivified "converter_class".
METHODS
BUILD
Sets precision for automatic rounding of "value" to "maximum_fraction_digits" in CLDR::Number::Format::Currency.
clone %new_attrs?
Returns clone of the currency object possibly with new attribute values (if any are supplied).
convert $new_corrency_code
Convert to new currency using "converter".
NOTE: If /convert is called in void context then the currency object is mutated in place. If called in list or scalar context then the original object is not modified and a new Interchange6::Currency object is returned instead.
as_string
Stringified formatted currency, e.g.: $3.45
stringify
Alias for "as_string".
add $arg
Add $arg to "value" in place.
subtract $arg
Subtract $arg from "value" in place.
multiply $arg
Multiply "value" by $arg in place.
divide $arg
Divide "value" by $arg in place.
modulo $arg
Return "value" % $arg as currency object.
cmp_value $arg
Equivalent to "value" <=> $arg.
cmp $arg
String comparison.
Not always useful in itself since string comparison of stringified currency objects might not produce what you expect depending on locale and currency code.
SEE ALSO
Other modules which perform currency maths:
Other Interchange6 eCommerce modules:
AUTHORS
Peter Mottram (SysPete), peter@sysnix.com
ACKNOWLEDGEMENTS
Shutterstock, Inc for the excellent CLDR::Number and all of the authors of Math::BigFLoat and Moo.
LICENSE AND COPYRIGHT
Copyright 2015-2016 Peter Mottram (SysPete).
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
Unicode is a registered trademark of Unicode, Inc., in the United States and other countries.