summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/collections/Intersect.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/collections/Intersect.md')
-rw-r--r--docs/content/en/functions/collections/Intersect.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/content/en/functions/collections/Intersect.md b/docs/content/en/functions/collections/Intersect.md
new file mode 100644
index 000000000..6a2c131b4
--- /dev/null
+++ b/docs/content/en/functions/collections/Intersect.md
@@ -0,0 +1,37 @@
+---
+title: collections.Intersect
+linkTitle: intersect
+description: Returns the common elements of two arrays or slices, in the same order as the first array.
+categories: [functions]
+keywords: []
+menu:
+ docs:
+ parent: functions
+function:
+ aliases: [intersect]
+ returnType: any
+ signatures: [collections.Intersect SET1 SET2]
+relatedFunctions:
+ - collections.Complement
+ - collections.Intersect
+ - collections.SymDiff
+ - collections.Union
+aliases: [/functions/intersect]
+---
+A useful example is to use it as `AND` filters when combined with where:
+
+## AND filter in where query
+
+```go-html-template
+{{ $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 parameters.
+
+See [union](/functions/collections/union) for `OR`.
+
+
+[partials]: /templates/partials/
+[single]: /templates/single-page-templates/