nullish-math
is a lightweight TypeScript package that provides basic math operations with support for null
and undefined
values and an immutable, chainable API. It is useful when working with numeric data that may contain nullish values, as it ensures that any calculations involving nullish values result in null
values.
To install nullish-math
, use one of the following commands:
yarn add nullish-math
npm install nullish-math
To use nullish-math
, simply import the nm()
function from the package:
import { nm } from 'nullish-math'
You can then use the nm()
function to create a new NullishMath
object with an initial value:
const value = nm(42)
You can chain together multiple math operations using the add()
, subtract()
, multiply()
, and divide()
methods:
const result = nm(42).add(21).multiply(2).subtract(10).end() // 116
// null results in null
const result = nm(42).add(null).multiply(2).subtract(10).end() // null
// undefined results in null
const result = nm(undefined).add(21).multiply(2).subtract(10).end() // null
If any of the values passed to the math operation methods (add()
, subtract()
, multiply()
, divide()
) are nullish, the final value will be null
.
The nm()
function creates a new NullishMath
object with an initial value.
Returns a new instance of NullishMath
with the sum of the current value and the given number.
Returns a new instance of NullishMath
with the sum of the current value and the given numbers.
Returns a new instance of NullishMath
with the difference of the current value and the given number.
Returns a new instance of NullishMath
with the difference of the current value and the given numbers.
Returns a new instance of NullishMath
with the product of the current value and the given number.
Returns a new instance of NullishMath
with the product of the current value and the given numbers.
Returns a new instance of NullishMath
with the quotient of the current value and the given number.
Returns a new instance of NullishMath
with the quotient of the current value and the given numbers.
Returns the final value of the NullishMath
instance. If any of the values passed to the math operation methods are null
or undefined
, the final value will be null
.