mathjs/docs/reference/functions/map.md

Math.js is an extensive math library for JavaScript and Node.js. It features a flexible expression parser and offers an integrated solution to work with numbers, big numbers, complex numbers, units, and matrices.

# Function map

Create a math.matrix or array with the results of the callback function executed on
each entry of the matrix/array.


## Syntax

```js
math.map(x, callback)
```

### Parameters

Parameter | Type | Description
--------- | ---- | -----------
`x` | Matrix | Array | The matrix to iterate on.
`callback` | Function | The callback method is invoked with three parameters: the value of the element, the index of the element, and the matrix being traversed.

### Returns

Type | Description
---- | -----------
Matrix | array | Transformed map of x


## Examples

```js
math.map([1, 2, 3], function(value) {
  return value * value;
});  // returns [1, 4, 9]
```


## See also

[filter](filter.md),
[forEach](forEach.md),
[sort](sort.md)


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