Search

Documents

Math::Units - Unit conversion

• NAME
• SYNOPSIS
• DESCRIPTION
• EXAMPLES

NAME

Math::Units - Unit conversion

SYNOPSIS

use Math::Units qw(convert);

my $out_value = convert($in_value, 'in unit', 'out unit');

DESCRIPTION

The Math::Units module converts a numeric value in one unit of measurement to some other unit. The units must be compatible, i.e. length can not be converted to volume. If a conversion can not be made an exception is thrown.

A combination chaining and reduction algorithm is used to perform the most direct unit conversion possible. Units may be written in several different styles. An abbreviation table is used to convert from common long-form unit names to the (more or less) standard abbreviations that the units module uses internally. All multiplicative unit conversions are cached so that future conversions can be performed very quickly.

Too many units, prefixes and abbreviations are supported to list here. See the source code for a complete listing.

EXAMPLES

print ``5 mm == '', convert(5, 'mm', 'in'), `` inches\n''; print ``72 degrees Farenheit == '', convert(72, 'F', 'C'), `` degrees Celsius\n''; print ``1 gallon == '', convert(1, 'gallon', 'cm^3'), `` cubic centimeters\n''; print ``4500 rpm == '', convert(4500, 'rpm', 'Hz'), `` Hertz\n'';

Information