summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/intersect.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/intersect.md')
-rw-r--r--docs/content/en/functions/intersect.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/content/en/functions/intersect.md b/docs/content/en/functions/intersect.md
new file mode 100644
index 000000000..9ab7f3c3a
--- /dev/null
+++ b/docs/content/en/functions/intersect.md
@@ -0,0 +1,37 @@
+---
+title: intersect
+linktitle: intersect
+description: Returns the common elements of two arrays or slices.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+ docs:
+ parent: "functions"
+keywords: [collections,intersect,union,complement,symdiff]
+signature: ["intersect SET1 SET2"]
+workson: []
+hugoversion:
+relatedfuncs: []
+deprecated: false
+aliases: []
+---
+An useful example is to use it as `AND` filters when combined with where:
+
+## AND filter in where query
+
+```
+{{ $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 [union](/functions/union) for `OR`.
+
+
+[partials]: /templates/partials/
+[single]: /templates/single-page-templates/