XFA Specification
Chapter 23, FormCalc Specification
Miscellaneous Built-in Functions
899
UnitValue()
Returns the value of a unitspan after an optional unit conversion. A unitspan string consist of a number
immediately followed by a unit name. Recognized unit names include:
"in", "inches",
"mm", "millimeters",
"cm", "centimeters",
"pt", "picas", "points",
"mp", "millipoints".
Syntax
UnitValue(s1 [, s2])
Parameters
s1
is a unitspan string.
s2
is an optional string containing a unit name. The unitspan's value will be converted to the given
units. If s2 is omitted, the unitspan's units are used.
Returns
The unitspan's value.
Examples
UnitValue("1in", "cm")
returns 2.54.
UnitValue("72pt", "in")
returns 1.