---
title: array.map() function
description: array.map() iterates over an array, applies a function to each element to produce a new element, and then returns a new array.
url: https://docs.influxdata.com/flux/v0/stdlib/array/map/
estimated_tokens: 1126
product: Flux
version: v0
---

# array.map() function

-   Flux 0.173.0+
-   View InfluxDB support

`array.map()` iterates over an array, applies a function to each element to produce a new element, and then returns a new array.

##### Function type signature

```js
(<-arr: [A], fn: (x: A) => B) => [B]
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### arr

Array to operate on. Defaults is the piped-forward array (`<-`).

### fn

(Required) Function to apply to elements. The element is represented by `x` in the function.

## Examples

### Convert an array of integers to an array of records

```js
import "array"

a = [
    1,
    2,
    3,
    4,
    5,
]
b = a |> array.map(fn: (x) => ({_value: x}))

// b returns [{_value: 1}, {_value: 2}, {_value: 3}, {_value: 4}, {_value: 5}]
// Output the array of records as a table
array.from(rows: b)
```

[](#view-example-output)

View example output

#### Output data

| _value |
| --- |
| 1 |
| 2 |
| 3 |
| 4 |
| 5 |

[array](/flux/v0/tags/array/) [tables](/flux/v0/tags/tables/)