mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 22:40:03 -05:00
71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
---
|
|
title: merge
|
|
description: "Returns the result of merging two or more maps."
|
|
date: 2019-08-08
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
keywords: [dictionary]
|
|
signature: ["collections.Merge MAP MAP...", "merge MAP MAP..."]
|
|
workson: []
|
|
hugoversion: "0.56.0"
|
|
relatedfuncs: [dict, append, reflect.IsMap, reflect.IsSlice]
|
|
aliases: []
|
|
---
|
|
|
|
Returns the result of merging two or more maps from left to right. If a key already exists, `merge` updates its value. If a key is absent, `merge` inserts the value under the new key.
|
|
|
|
Key handling is case-insensitive.
|
|
|
|
The following examples use these map definitions:
|
|
|
|
```go-html-template
|
|
{{ $m1 := dict "x" "foo" }}
|
|
{{ $m2 := dict "x" "bar" "y" "wibble" }}
|
|
{{ $m3 := dict "x" "baz" "y" "wobble" "z" (dict "a" "huey") }}
|
|
```
|
|
|
|
Example 1
|
|
|
|
```go-html-template
|
|
{{ $merged := merge $m1 $m2 $m3 }}
|
|
|
|
{{ $merged.x }} --> baz
|
|
{{ $merged.y }} --> wobble
|
|
{{ $merged.z.a }} --> huey
|
|
```
|
|
|
|
Example 2
|
|
|
|
```go-html-template
|
|
{{ $merged := merge $m3 $m2 $m1 }}
|
|
|
|
{{ $merged.x }} --> foo
|
|
{{ $merged.y }} --> wibble
|
|
{{ $merged.z.a }} --> huey
|
|
```
|
|
|
|
Example 3
|
|
|
|
```go-html-template
|
|
{{ $merged := merge $m2 $m3 $m1 }}
|
|
|
|
{{ $merged.x }} --> foo
|
|
{{ $merged.y }} --> wobble
|
|
{{ $merged.z.a }} --> huey
|
|
```
|
|
|
|
Example 4
|
|
|
|
```go-html-template
|
|
{{ $merged := merge $m1 $m3 $m2 }}
|
|
|
|
{{ $merged.x }} --> bar
|
|
{{ $merged.y }} --> wibble
|
|
{{ $merged.z.a }} --> huey
|
|
```
|
|
|
|
{{% note %}}
|
|
Regardless of depth, merging only applies to maps. For slices, use [append]({{< ref "functions/append" >}}).
|
|
{{% /note %}}
|