jiangchengfeiyi-xiaochengxu/node_modules/mathjs/lib/esm/function/unit/to.js
2025-01-02 11:13:50 +08:00

46 lines
1.3 KiB
JavaScript

import { factory } from '../../utils/factory.js';
import { createMatrixAlgorithmSuite } from '../../type/matrix/utils/matrixAlgorithmSuite.js';
var name = 'to';
var dependencies = ['typed', 'matrix', 'concat'];
export var createTo = /* #__PURE__ */factory(name, dependencies, _ref => {
var {
typed,
matrix,
concat
} = _ref;
var matrixAlgorithmSuite = createMatrixAlgorithmSuite({
typed,
matrix,
concat
});
/**
* Change the unit of a value.
*
* For matrices, the function is evaluated element wise.
*
* Syntax:
*
* math.to(x, unit)
*
* Examples:
*
* math.to(math.unit('2 inch'), 'cm') // returns Unit 5.08 cm
* math.to(math.unit('2 inch'), math.unit('cm')) // returns Unit 5.08 cm
* math.to(math.unit(16, 'bytes'), 'bits') // returns Unit 128 bits
*
* See also:
*
* unit
*
* @param {Unit | Array | Matrix} x The unit to be converted.
* @param {Unit | Array | Matrix} unit New unit. Can be a string like "cm"
* or a unit without value.
* @return {Unit | Array | Matrix} value with changed, fixed unit.
*/
return typed(name, {
'Unit, Unit | string': (x, unit) => x.to(unit)
}, matrixAlgorithmSuite({
Ds: true
}));
});