2018-05-12 18:39:29 +02:00
|
|
|
---
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "list - Functions - Configuration Language"
|
2018-05-12 18:39:29 +02:00
|
|
|
sidebar_current: "docs-funcs-collection-list"
|
|
|
|
description: |-
|
|
|
|
The list function constructs a list from some given elements.
|
|
|
|
---
|
|
|
|
|
|
|
|
# `list` Function
|
|
|
|
|
|
|
|
~> **This function is deprecated.** From Terraform v0.12, the Terraform
|
|
|
|
language has built-in syntax for creating lists using the `[` and `]`
|
|
|
|
delimiters. Use the built-in syntax instead. The `list` function will be
|
|
|
|
removed in a future version of Terraform.
|
|
|
|
|
|
|
|
`list` takes an arbitrary number of arguments and returns a list containing
|
|
|
|
those values in the same order.
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
```
|
|
|
|
> list("a", "b", "c")
|
|
|
|
[
|
|
|
|
"a",
|
|
|
|
"b",
|
|
|
|
"c",
|
|
|
|
]
|
|
|
|
```
|
|
|
|
|
|
|
|
Do not use the above form in Terraform v0.12 or above. Instead, use the
|
|
|
|
built-in list construction syntax, which achieves the same result:
|
|
|
|
|
|
|
|
```
|
|
|
|
> ["a", "b", "c"]
|
|
|
|
[
|
|
|
|
"a",
|
|
|
|
"b",
|
|
|
|
"c",
|
|
|
|
]
|
|
|
|
```
|
2019-01-17 18:11:48 +01:00
|
|
|
|
|
|
|
## Related Functions
|
|
|
|
|
|
|
|
* [`tolist`](./tolist.html) converts a set value to a list.
|