simple-squiggle/node_modules/mathjs/docs/reference/functions/unequal.md

1.9 KiB

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. Strings are compared by their numerical value.

Values null and undefined are compared strictly, thus null is unequal with everything except null, and undefined is unequal with everything except undefined.

Syntax

math.unequal(x, y)

Parameters

Parameter Type Description
x number | BigNumber | Fraction | boolean | Complex | Unit | string | Array | Matrix | undefined First value to compare
y number | BigNumber | Fraction | boolean | Complex | Unit | string | Array | Matrix | undefined Second value to compare

Returns

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

Throws

Type Description

Examples

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

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

const c = [2, 5, 1]
const d = [2, 7, 1]

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

math.unequal(0, null)        // returns true

See also

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