xref: /inferno-os/man/1/units (revision 46439007cf417cbd9ac8049bb4122c890097a0fa)
UNITS 1
NAME
units - conversion program
SYNOPSIS
units [ -v ] [ file ]
DESCRIPTION
Units converts quantities expressed in various standard scales to their equivalents in other scales. It works interactively in this fashion:
.EX you have: inch you want: cm * 2.54 / 0.3937008

A quantity is specified as a multiplicative combination of units and floating point numbers. Operators have the following precedence:

.EX \fL+ \fL- \f1add and subtract \fL* \fL/ \fL× \fL÷ \f1multiply and divide catenation multiply \fL² \fL³ \fL^ \f1exponentiation \fL| \f1divide \fL( ... \fL) \f1grouping

Most familiar units, abbreviations, and metric prefixes are recognized, together with a generous leavening of exotica and a few constants of nature including:

\fL\\$1\ \\$2 \\$3 \\$4 \\$5 \\$6 ..
.fq pi,\f1π ratio of circumference to diameter
.fq c speed of light
.fq e charge on an electron
.fq g acceleration of gravity
.fq force same as \fLg
.fq mole Avogadro's number
.fq water "pressure head per unit height of water"
.fq au astronomical unit

The .L pound is a unit of mass. Compound names are run together, e.g. .LR lightyear . British units that differ from their US counterparts are prefixed thus: .LR brgallon . Currency is denoted .LR belgiumfranc , .LR britainpound , etc.

The complete list of units can be found in /lib/units . A file argument to units specifies a file to be used instead of /lib/units. The -v flag causes units to print its entire database.

EXAMPLE
.EX you have: 15 pounds force/in² you want: atm * 1.020689 / 0.9797299
FILES
/lib/units
SOURCE
/appl/cmd/units.y

/appl/cmd/units.b

BUGS
Since units does only multiplicative scale changes, it can convert Kelvin to Rankine but not Centigrade to Fahrenheit, except that the latter is handled as a special case.

Currency conversions are only as accurate as the last time someone updated /lib/units .