2018-05-12 18:39:29 +02:00
|
|
|
---
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "distinct - Functions - Configuration Language"
|
2018-05-12 18:39:29 +02:00
|
|
|
sidebar_current: "docs-funcs-collection-distinct"
|
|
|
|
description: |-
|
|
|
|
The distinct function removes duplicate elements from a list.
|
|
|
|
---
|
|
|
|
|
|
|
|
# `distinct` Function
|
|
|
|
|
2019-01-17 01:33:57 +01:00
|
|
|
-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
|
|
|
|
earlier, see
|
|
|
|
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
|
|
|
|
|
2018-05-12 18:39:29 +02:00
|
|
|
`distinct` takes a list and returns a new list with any duplicate elements
|
|
|
|
removed.
|
|
|
|
|
2019-03-21 20:20:29 +01:00
|
|
|
The first occurrence of each value is retained and the relative ordering of
|
2018-05-12 18:39:29 +02:00
|
|
|
these elements is preserved.
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
```
|
|
|
|
> distinct(["a", "b", "a", "c", "d", "b"])
|
|
|
|
[
|
|
|
|
"a",
|
|
|
|
"b",
|
|
|
|
"c",
|
|
|
|
"d",
|
|
|
|
]
|
|
|
|
```
|