diff options
Diffstat (limited to 'docs/content/en/functions/complement.md')
| -rw-r--r-- | docs/content/en/functions/complement.md | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/content/en/functions/complement.md b/docs/content/en/functions/complement.md new file mode 100644 index 000000000..461227789 --- /dev/null +++ b/docs/content/en/functions/complement.md @@ -0,0 +1,29 @@ +--- +title: "complement" +description: "`collections.Complement` (alias `complement`) gives the elements of a collection that are not in any of the others." +date: 2018-11-07 +categories: [functions] +menu: + docs: + parent: "functions" +keywords: [collections,intersect,union] +signature: ["COLLECTION | complement COLLECTION [COLLECTION]..." ] +hugoversion: "0.51" +aliases: [] +--- + +Example: + +```go-html-template +{{ $pages := .Site.RegularPages | first 50 }} +{{ $news := where $pages "Type" "news" | first 5 }} +{{ $blog := where $pages "Type" "blog" | first 5 }} +{{ $other := $pages | complement $news $blog | first 10 }} +``` + +The above is an imaginary use case for the home page where you want to display different page listings in sections/boxes on different places on the page: 5 from `news`, 5 from the `blog` and then 10 of the pages not shown in the other listings, to _complement_ them. + + + + + |