---
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/experimental/array/map/
estimated_tokens: 371
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/experimental/array/map/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.155.0 – 0.173.0

InfluxDB support

> [!Important]
> `array.map()` is experimental and [subject to change at any time](/flux/v0/stdlib/experimental/#experimental-packages-are-subject-to-change).

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

#### Deprecated

Experimental `array.map()` is deprecated in favor of[`array.map()`](/flux/v0/stdlib/array/map).

##### 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 "experimental/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   |

#### Related

* [Work with arrays](/flux/v0/data-types/composite/array/)

[array](/flux/v0/tags/array/)[tables](/flux/v0/tags/tables/)
| _value |
| --- |
| _value |
| 1 |
| 2 |
| 3 |
| 4 |
| 5 |