mathjs/docs/reference/functions/unequal.md

Function unequal

Test whether two values are unequal.

The function tests whether the relative difference between x and y is larger than the configured epsilon. The function cannot be used to compare values smaller than approximately 2.22e-16.

For matrices, the function is evaluated element wise. In case of complex numbers, x.re must unequal y.re, or x.im must unequal y.im.

Syntax

math.unequal(x, y)

Parameters

Parameter	Type	Description
x	Number | BigNumber | Boolean | Complex | Unit | String | Array | Matrix | null | undefined	First value to compare
y	Number | BigNumber | Boolean | Complex | Unit | String | Array | Matrix | null | undefined	Second value to compare

Returns

Type	Description
Boolean | Array | Matrix	Returns true when the compared values are unequal, else returns false

Examples

math.unequal(2 + 2, 3);       // returns true
math.unequal(2 + 2, 4);       // returns false

var a = math.unit('50 cm');
var b = math.unit('5 m');
math.unequal(a, b);           // returns false

var c = [2, 5, 1];
var d = [2, 7, 1];

math.unequal(c, d);           // returns [false, true, false]
math.deepEqual(c, d);         // returns false

See also

equal, deepEqual, smaller, smallerEq, larger, largerEq, compare