As a super-class of numbers, Kawa also provides quantities. A quantity is a product of a unit and a pure number. The number part can be an arbitrary complex number. The unit is a product of integer powers of base units, such as meter or second.
Quantity literals have the following syntax:
Some examples are
10pt (10 points),
5s (5 seconds),
4cm^2 (4 square centimeters).
Note the quantity syntax is not recognized by the reader.
Instead these are read as symbols.
Assuming there is no lexical binding the for the symbol, it will be
rewritten at compile-time into an expression. For example
is transformed into:
(* 4.0 (expt unit:cm 2))
True iff object is a quantity. Note that all numbers are
quantities, but not the other way round.
Currently, there are no quantities that are not numbers.
To distinguish a plain unit-less number from a quantity,
you can use
Returns the pure number part of the quantity q, relative to primitive (base) units. If q is a number, returns q. If q is a unit, yields the magitude of q relative to base units.
Returns the unit of the quantity q. If q is a number, returns the empty unit.
Returns the product of x (a pure number) and unit.
You can specify a string instead of unit, such as
Define unit-name as a base (primitive) unit, which is used to measure along the specified dimension.
(define-base-unit dollar "Money")
Define unit-name as a unit (that can be used in literals) equal to the quantity expression.
(define-unit cent 0.01dollar)
The unit-name is declared in the
so the above is equivalent to:
(define-constant unit:cent (* 0.01 unit:dollar))
The following angle units are dimensionless, with no base unit.
Some procedures treat a unit-less real number as if it were in radians
(which mathematicians prefer);
some procedures (such as
rotate) treat a unit-less real number
as if it were in degrees
(which is common in Web and other standards).
A unit for angles specified in radians.
A full circle is 2*pi radians.
(= 1.5 1.5rad) is true,
(eqv? 1.5 1.5rad) is false.
A unit for angles specified in degrees. A full circle is 360 degrees.
A unit for angles specified in gradians. A full circle is 400 gradians.