Skip to main content

Interface: NumberUnitInterface<F, U>

A numeric value with unit type.

Type parameters

NameType
Fextends string
Uextends Unit<F> = Unit<F>

Implemented by

Properties

number

number: number

This NumberUnit's numeric value.

Defined in

src/sdk/math/NumberUnit.ts:17


unit

unit: U

This NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:20

Methods

abs

abs<OU>(out): NumberUnit<F, OU>

Calculates the absolute value of this NumberUnit and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The absolute value.

Defined in

src/sdk/math/NumberUnit.ts:87


add

add<OU>(value, out): NumberUnit<F, OU>

Adds a value to this NumberUnit and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
valueNumberUnitInterface<F, Unit<F>>The other value.
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The sum.

Throws

Error if the supplied value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:29

add<OU>(value, unit, out): NumberUnit<F, OU>

Adds a value to this NumberUnit and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
valuenumberThe other value.
unitUnit<F>The unit type of the other value.
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The sum.

Throws

Error if the supplied value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:38


asUnit

asUnit(unit): number

Returns the numeric value of this NumberUnit after conversion to a specified unit.

Parameters

NameTypeDescription
unitUnit<F>The unit to which to convert.

Returns

number

The converted numeric value.

Throws

Error if this NumberUnit's unit type cannot be converted to the specified unit.

Defined in

src/sdk/math/NumberUnit.ts:95


compare

compare(value): number

Checks whether this NumberUnit is greater than, equal to, or less than another value.

Parameters

NameTypeDescription
valueNumberUnitInterface<F, Unit<F>>The other value.

Returns

number

0 if this NumberUnit is equal to the other value, -1 if this number is less, 1 if this number is greater.

Throws

Error if this NumberUnit cannot be compared to the other value.

Defined in

src/sdk/math/NumberUnit.ts:103

compare(value, unit?): number

Checks whether this NumberUnit is greater than, equal to, or less than another value.

Parameters

NameTypeDescription
valuenumberThe other value.
unit?Unit<F>The unit type of the other value. Defaults to this NumberUnit's unit type.

Returns

number

0 if this NumberUnit is equal to the other value, -1 if this number is less, 1 if this number is greater.

Throws

Error if this NumberUnit cannot be compared to the other value.

Defined in

src/sdk/math/NumberUnit.ts:111


copy

copy(): NumberUnit<F, U>

Copies this NumberUnit.

Returns

NumberUnit<F, U>

A copy of this NumberUnit.

Defined in

src/sdk/math/NumberUnit.ts:141


equals

equals(value): boolean

Checks whether this NumberUnit is equal to another value. Two values are considered equal if and only if their unit types are interconvertable and when converted to the same unit type, their numeric values are equal to each other or both equal to NaN.

Parameters

NameTypeDescription
valueNumberUnitInterface<string, Unit<string>>The other value.

Returns

boolean

Whether this NumberUnit is equal to the other value.

Defined in

src/sdk/math/NumberUnit.ts:120

equals(value, unit?): boolean

Checks whether this NumberUnit is equal to another value. Two values are considered equal if and only if their unit types are interconvertable and when converted to the same unit type, their numeric values are equal to each other or both equal to NaN.

Parameters

NameTypeDescription
valuenumberThe other value.
unit?Unit<string>The unit type of the other value. Defaults to this NumberUnit's unit type.

Returns

boolean

Whether this NumberUnit is equal to the other value.

Defined in

src/sdk/math/NumberUnit.ts:129


isNaN

isNaN(): boolean

Checks whether this NumberUnit has a numeric value of NaN.

Returns

boolean

Whether this NumberUnit has a numeric value of NaN.

Defined in

src/sdk/math/NumberUnit.ts:135


ratio

ratio(value): number

Finds the ratio of this NumberUnit to another value.

Parameters

NameTypeDescription
valueNumberUnitInterface<F, Unit<F>>The other value.

Returns

number

The ratio.

Throws

Error if the other value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:72

ratio(value, unit): number

Finds the ratio of this NumberUnit to another value.

Parameters

NameTypeDescription
valuenumberThe other value.
unitUnit<F>The unit type of the other value.

Returns

number

the ratio.

Throws

Error if the other value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:80


scale

scale<OU>(factor, out): NumberUnit<F, OU>

Scales this NumberUnit by a unit-less factor and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
factornumberThe factor by which to scale.
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The scaled value.

Defined in

src/sdk/math/NumberUnit.ts:64


subtract

subtract<OU>(value, out): NumberUnit<F, OU>

Subtracts a value from this NumberUnit and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
valueNumberUnitInterface<F, Unit<F>>The other value.
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The difference.

Throws

Error if the supplied value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:47

subtract<OU>(value, unit, out): NumberUnit<F, OU>

Subtracts a value from this NumberUnit and returns the result.

Type parameters

NameType
OUextends Unit<F>

Parameters

NameTypeDescription
valuenumberThe other value.
unitUnit<F>The unit type of the other value.
outNumberUnit<F, OU>The NumberUnit to which to write the result.

Returns

NumberUnit<F, OU>

The difference.

Throws

Error if the supplied value cannot be converted to this NumberUnit's unit type.

Defined in

src/sdk/math/NumberUnit.ts:56