hugo/docs/content/functions/shuffle.md

879 B

title description godocref date publishdate lastmod categories menu signature workson hugoversion relatedfuncs deprecated draft aliases
shuffle Returns a random permutation of a given array or slice. 2017-02-01 2017-02-01 2017-04-30
functions
docs
parent
functions
shuffle COLLECTION
seq
false false

{{< code file="shuffle-input.html" >}}

{{ shuffle (seq 1 5) }}
{{ shuffle (slice "foo" "bar" "buzz") }}
{{< /code >}}

This example would return the following:

{{< output file="shuffle-output.html" >}}

2 5 3 1 4
buzz foo bar
{{< /output >}}

This example also makes use of the slice and seq functions.