Function to

Change the unit of a value.

For matrices, the function is evaluated element wise.

Syntax

to(x, unit)

Parameters

Parameter Type Description
x Unit | Array | Matrix The unit to be converted.
unit Unit | Array | Matrix New unit. Can be a string like "cm" or a unit without value.

Returns

Type Description
Unit | Array | Matrix value with changed, fixed unit.

Examples

to(unit('2 inch'), 'cm');                   // returns Unit 5.08 cm
to(unit('2 inch'), unit(null, 'cm'));  // returns Unit 5.08 cm
to(unit(16, 'bytes'), 'bits');              // returns Unit 128 bits

See also

unit