mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
230a495941
93f7baf80 netlify: Hugo 0.92.2 ecd8a6b6b Merge branch 'tempv0.92.2' ee04caf9f Fix validation of Page Kind in cascade target map 3fce03ed2 Remove the "check" command 70ad71b25 Fix typo (#1651) dfd1dc570 Fix internal link (#1650) b5e0e0d38 Update rotten Fedora package link 78276390a Add missing word in types.md (#1645) 45eb945f8 Remove hugo gen autocomplete 2f84d0896 netlify: Hugo 0.92.1 b55f5773b Update complement.md 7013ee43e Remove deprecated RSSLink from page variables 1c3fb6ed3 Remove deprecated page vars (#1638) 9bd0af3ab Update union.md 4576487a0 Update symdiff.md 58f1b26c7 Update starter-kits.md (#1521) 285356c1d Move inline partials section (#1635) 4d08625d2 Improve directions for editing Win 10 path env var (#1632) 41d9c7804 Update page content (#1629) d05536cad Removed unpaired quote character (#1630) 3b0fdcd88 netlify: Bump to Hugo 0.92.0 cdb068346 docs: Regenerate docshelper 778503ca8 Merge commit 'a8e9fc699a6ff7d578f97a7c553ce844efad8fdb' 2d2401c91 docs: Add dependency table to maintainance page 6bc95c386 Add hugo.Deps 19d0b5e23 docs. Regen CLI docs 76a750d96 docs: Regenerate CLI docs 70156962a docs: Regenerate docshelper git-subtree-dir: docs git-subtree-split: 93f7baf80bd03176ad44701cd2452433d492ea0b
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
---
|
|
title: union
|
|
# linktitle: union
|
|
description: Given two arrays or slices, returns a new array that contains the elements or objects that belong to either or both arrays/slices.
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
lastmod: 2017-03-12
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
keywords: [collections,intersect,union,complement]
|
|
signature: ["union SET1 SET2"]
|
|
workson: []
|
|
hugoversion: 0.20
|
|
relatedfuncs: [intersect,where]
|
|
deprecated: false
|
|
aliases: []
|
|
---
|
|
|
|
Given two arrays (or slices) A and B, this function will return a new array that contains the elements or objects that belong to either A or to B or to both. The elements supported are strings, integers, and floats (only float64).
|
|
|
|
```
|
|
{{ union (slice 1 2 3) (slice 3 4 5) }}
|
|
<!-- returns [1 2 3 4 5] -->
|
|
|
|
{{ union (slice 1 2 3) nil }}
|
|
<!-- returns [1 2 3] -->
|
|
|
|
{{ union nil (slice 1 2 3) }}
|
|
<!-- returns [1 2 3] -->
|
|
|
|
{{ union nil nil }}
|
|
<!-- returns an error because both arrays/slices have to be of the same type -->
|
|
```
|
|
|
|
## OR filter in where query
|
|
|
|
This is also very useful to use as `OR` filters when combined with where:
|
|
|
|
```
|
|
{{ $pages := where .Site.RegularPages "Type" "not in" (slice "page" "about") }}
|
|
{{ $pages := $pages | union (where .Site.RegularPages "Params.pinned" true) }}
|
|
{{ $pages := $pages | intersect (where .Site.RegularPages "Params.images" "!=" nil) }}
|
|
```
|
|
|
|
The above fetches regular pages not of `page` or `about` type unless they are pinned. And finally, we exclude all pages with no `images` set in Page params.
|
|
|
|
See [intersect](/functions/intersect) for `AND`.
|