docs-v2/content/flux/v0/stdlib/array/map.md

title	description	menu	weight	introduced
array.map() function	`array.map()` iterates over an array, applies a function to each element to produce a new element, and then returns a new array.	flux_v0_ref name parent identifier array.map array array/map	101	0.173.0

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

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

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

arr

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

fn

({{< req >}}) 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

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)

{{< expand-wrapper >}} {{% expand "View example output" %}}

Output data

_value
1
2
3
4
5

{{% /expand %}} {{< /expand-wrapper >}}