Operators — Math.js Reference

add

Add two values.

Syntax

x + y | add(x | y)

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	First value to add
y	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	Second value to add

Returns

Examples

a = 2.1 + 3.6
a - 3.6
3 + 2i
3 cm + 2 inch
2.3" + "4

See Also

subtract

divide

Divide two values.

Syntax

x / y | divide(x | y)

Type Signatures

Array | Matrix, Array | Matrix, DenseMatrix, any, SparseMatrix, any, Array, any, any, Array | Matrix

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	Numerator
y	number \| BigNumber \| bigint \| Fraction \| Complex \| Array \| Matrix	Denominator

Returns

Examples

a = 2 / 3
a * 3
4.5 / 2
3 + 4 / 2
(3 + 4) / 2

See Also

multiply

dotDivide

Divide two values element wise.

Syntax

x ./ y | dotDivide(x | y)

Parameters

Name	Type	Description
x	number \| BigNumber \| Fraction \| Complex \| Unit \| Array \| Matrix	Numerator
y	number \| BigNumber \| Fraction \| Complex \| Unit \| Array \| Matrix	Denominator

Returns

Examples

a = [1
2
3; 4
5
6

See Also

multiply dotMultiply divide

dotMultiply

Multiply two values element wise.

Syntax

x .* y | dotMultiply(x | y)

Parameters

Name	Type	Description
x	number \| BigNumber \| Fraction \| Complex \| Unit \| Array \| Matrix	Left hand value
y	number \| BigNumber \| Fraction \| Complex \| Unit \| Array \| Matrix	Right hand value

Returns

Examples

a = [1
2
3; 4
5
6

See Also

multiply divide dotDivide

dotPow

Calculates the power of x to y element wise.

Syntax

x .^ y | dotPow(x | y)

Parameters

Name	Type	Description
x	number \| BigNumber \| Complex \| Unit \| Array \| Matrix	The base
y	number \| BigNumber \| Complex \| Unit \| Array \| Matrix	The exponent

Returns

Examples

a = [1
2
3; 4
5
6

See Also

pow

mod

Calculates the modulus, the remainder of an integer division.

Syntax

x % y | x mod y | mod(x

Type Signatures

BigNumber, BigNumber, bigint, bigint, Fraction, Fraction

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| Array \| Matrix	Dividend
y	number \| BigNumber \| bigint \| Fraction \| Array \| Matrix	Divisor

Returns

Examples

7 % 3
11 % 2
10 mod 4
isOdd(x) = x % 2
isOdd(2)

See Also

divide

multiply

multiply two values.

Syntax

x * y | multiply(x | y)

Type Signatures

Matrix, Matrix, SparseMatrix, any, DenseMatrix, any, any, SparseMatrix, any, DenseMatrix, Array, any

Parameters

Name	Type	Description
a	Matrix	Dense Vector (N)
b	Matrix	Dense Vector (N)

Returns

number — Scalar value

Examples

a = 2.1 * 3.4
a / 3.4
2 * 3 + 4
2 * (3 + 4)
3 * 2.1 km

See Also

divide

pow

Calculates the power of x to y, x^y.

Syntax

x ^ y | pow(x | y)

Type Signatures

Complex, Complex, BigNumber, BigNumber, Fraction, Fraction, Array, BigNumber, Matrix, BigNumber, Unit, number | BigNumber

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Complex \| Unit \| Array \| Matrix	The base
y	number \| BigNumber \| bigint \| Complex	The exponent

Returns

Examples

2^3
2*2*2
1 + e ^ (pi * i)
pow([[1
2

See Also

multiply nthRoot nthRoots sqrt

subtract

subtract two values.

Syntax

x - y | subtract(x | y)

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	Initial value
y	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	Value to subtract from `x`

Returns

Examples

a = 5.3 - 2
a + 2
2/3 - 1/6
2 * 3 - 3
2.1 km - 500m

See Also

add

unaryMinus

Inverse the sign of a value. Converts booleans and strings to numbers.

Syntax

-x | unaryMinus(x)

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| Complex \| Unit \| Array \| Matrix	Number to be inverted.

Returns

Examples

-4.5
-(-5.6)
-"22

See Also

add subtract unaryPlus

unaryPlus

Converts booleans and strings to numbers.

Syntax

+x | unaryPlus(x)

Parameters

Name	Type	Description
x	number \| BigNumber \| bigint \| Fraction \| string \| Complex \| Unit \| Array \| Matrix

Returns

Examples

+true
+"2

See Also

add subtract unaryMinus