50 lines
1.4 KiB
Plaintext
50 lines
1.4 KiB
Plaintext
---
|
|
page_title: formatlist - Functions - Configuration Language
|
|
description: |-
|
|
The formatlist function produces a list of strings by formatting a number of
|
|
other values according to a specification string.
|
|
---
|
|
|
|
# `formatlist` Function
|
|
|
|
`formatlist` produces a list of strings by formatting a number of other
|
|
values according to a specification string.
|
|
|
|
```hcl
|
|
formatlist(spec, values...)
|
|
```
|
|
|
|
The specification string uses
|
|
[the same syntax as `format`](/language/functions/format#specification-syntax).
|
|
|
|
The given values can be a mixture of list and non-list arguments. Any given
|
|
lists must be the same length, which decides the length of the resulting list.
|
|
|
|
The list arguments are iterated together in order by index, while the non-list
|
|
arguments are used repeatedly for each iteration. The format string is evaluated
|
|
once per element of the list arguments.
|
|
|
|
## Examples
|
|
|
|
```
|
|
> formatlist("Hello, %s!", ["Valentina", "Ander", "Olivia", "Sam"])
|
|
[
|
|
"Hello, Valentina!",
|
|
"Hello, Ander!",
|
|
"Hello, Olivia!",
|
|
"Hello, Sam!",
|
|
]
|
|
> formatlist("%s, %s!", "Salutations", ["Valentina", "Ander", "Olivia", "Sam"])
|
|
[
|
|
"Salutations, Valentina!",
|
|
"Salutations, Ander!",
|
|
"Salutations, Olivia!",
|
|
"Salutations, Sam!",
|
|
]
|
|
```
|
|
|
|
## Related Functions
|
|
|
|
* [`format`](/language/functions/format) defines the specification syntax used by this
|
|
function and produces a single string as its result.
|