---
layout: default
---

<!-- Note: This file is automatically generated from source code comments. Changes made in this file will be overridden. -->

<h1 id="function-iszero">Function isZero <a href="#function-iszero" title="Permalink">#</a></h1>

Test whether a value is zero.
The function can check for zero for types `number`, `BigNumber`, `Fraction`,
`Complex`, and `Unit`.

The function is evaluated element-wise in case of Array or Matrix input.


<h2 id="syntax">Syntax <a href="#syntax" title="Permalink">#</a></h2>

```js
math.isZero(x)
```

<h3 id="parameters">Parameters <a href="#parameters" title="Permalink">#</a></h3>

Parameter | Type | Description
--------- | ---- | -----------
`x` | number &#124; BigNumber &#124; Complex &#124; Fraction &#124; Unit &#124; Array &#124; Matrix | Value to be tested

<h3 id="returns">Returns <a href="#returns" title="Permalink">#</a></h3>

Type | Description
---- | -----------
boolean | Returns true when `x` is zero. Throws an error in case of an unknown data type.


<h2 id="examples">Examples <a href="#examples" title="Permalink">#</a></h2>

```js
math.isZero(0)                     // returns true
math.isZero(2)                     // returns false
math.isZero(0.5)                   // returns false
math.isZero(math.bignumber(0))     // returns true
math.isZero(math.fraction(0))      // returns true
math.isZero(math.fraction(1,3))    // returns false
math.isZero(math.complex('2 - 4i') // returns false
math.isZero(math.complex('0i')     // returns true
math.isZero('0')                   // returns true
math.isZero('2')                   // returns false
math.isZero([2, 0, -3]')           // returns [false, true, false]
```


<h2 id="see-also">See also <a href="#see-also" title="Permalink">#</a></h2>

[isNumeric](isNumeric.html),
[isPositive](isPositive.html),
[isNegative](isNegative.html),
[isInteger](isInteger.html)