mirror of
https://github.com/opentffoundation/opentf.git
synced 2025-12-21 02:37:43 -05:00
a15a6c9657
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
50 lines
1.3 KiB
Plaintext
50 lines
1.3 KiB
Plaintext
---
|
|
sidebar_label: formatlist
|
|
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.mdx#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.mdx) defines the specification syntax used by this
|
|
function and produces a single string as its result.
|