BSKConvertUnits

BSKI32 BSKConvertUnits( BSKUnitDefinition* list,
                        BSKFLOAT quantity,
                        BSKUI32 from,
                        BSKUI32 to,
                        BSKFLOAT* result );

• list - the list of all units.
• quantity - the number of 'from' units to convert.
• from - the units to convert from.
• to - the units to convert to.
• result - a buffer to store the result of the conversion in (must not be null).

Description: Converts the given quantity (in 'from' units) to the units given by 'to', and stores the new number in 'result'. If the units 'from' and 'to' are not compatible, returns UERR_INCOMPATIBLE_UNITS. Units are incompatible if, by following the path of 'referenceUnit' from one unit to it's parent, a common unit definition cannot be found for both 'from' and 'to'.

Return to the API
Return to the function listing