|
Returns
the numerical value of a measurement with its associated unitspan,
after an optional unit conversion. A unitspan is a string consisting
of a number followed by a valid unit of measurement.
SyntaxUnitValue(s1 [, s2 ])
Parameters
Parameters
|
Description
|
|---|
s1
|
A valid string containing a numeric value
and a valid unit of measurement (unitspan). Recognized units of
measurement are:
in, inches
mm, millimeters
cm, centimeters
pt, picas, points
mp, millipoints
|
s2 (optional)
|
A string containing a valid unit of measurement.
The function converts the unitspan specified in s1 to
this new unit of measurement.
If you do not include a value
for s2, the function uses the unit of measurement
specified in s1. If s2 is invalid, the
function converts s1 into inches.
|
ExamplesThe
following expressions are examples that use the UnitValue function:
Expression
|
Returns
|
|---|
UnitValue("2in")
|
2
|
UnitValue("2in", "cm")
|
5.08
|
UnitValue("6", "pt")
|
432
|
UnitValue("A", "cm")
|
0
|
UnitValue(Size[2], "mp")
|
Returns the measurement value of the third
occurrence of Size converted into millipoints.
|
UnitValue("5.08cm", "kilograms")
|
2
|
|
|
|
