43 lines
991 B
Markdown
43 lines
991 B
Markdown
---
|
|
layout: "language"
|
|
page_title: "merge - Functions - Configuration Language"
|
|
sidebar_current: "docs-funcs-collection-merge"
|
|
description: |-
|
|
The merge function takes an arbitrary number maps or objects, and returns a
|
|
single map or object that contains a merged set of elements from all
|
|
arguments.
|
|
---
|
|
|
|
# `merge` Function
|
|
|
|
`merge` takes an arbitrary number of maps or objects, and returns a single map
|
|
or object that contains a merged set of elements from all arguments.
|
|
|
|
If more than one given map or object defines the same key or attribute, then
|
|
the one that is later in the argument sequence takes precedence. If the
|
|
argument types do not match, the resulting type will be an object matching the
|
|
type structure of the attributes after the merging rules have been applied.
|
|
|
|
## Examples
|
|
|
|
```
|
|
> merge({a="b", c="d"}, {e="f", c="z"})
|
|
{
|
|
"a" = "b"
|
|
"c" = "z"
|
|
"e" = "f"
|
|
}
|
|
```
|
|
|
|
```
|
|
> merge({a="b"}, {a=[1,2], c="z"}, {d=3})
|
|
{
|
|
"a" = [
|
|
1,
|
|
2,
|
|
]
|
|
"c" = "z"
|
|
"d" = 3
|
|
}
|
|
```
|