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

title	description	menu	weight	introduced
array.concat() function	`array.concat()` appends two arrays and returns a new array.	flux_v0_ref name parent identifier array.concat array array/concat	101	0.173.0

array.concat() appends two arrays and returns a new array.

Neither input array is mutated and a new array is returned.

Function type signature

(<-arr: [A], v: [A]) => [A]

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

Parameters

arr

First array. Default is the piped-forward array (<-).

v

({{< req >}}) Array to append to the first array.

Examples

Merge two arrays

import "array"

a = [1, 2, 3]
b = [4, 5, 6]

c = a |> array.concat(v: b)

// Returns [1, 2, 3, 4, 5, 6]
// Output each value in the array as a row in a table
array.from(rows: c |> array.map(fn: (x) => ({_value: x})))

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

Output data

_value
1
2
3
4
5
6

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