ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

website: "for" expression examples to use canonical formatting 

The "terraform fmt" command produces a different canonical form than we
were showing in our examples here. Our examples should always reflect the
conventions applied by "terraform fmt" to avoid confusion.

(This particular decision is a pragmatic one because the formatter design
needs to use the same rules for the colon in the ? : conditional operator
as for the colon in "for" expressions.)
This commit is contained in:
Martin Atkins 2019-03-08 18:07:47 -08:00
parent 0a9959cbe4
commit 36bb9b462c
1 changed files with 8 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
website/docs/configuration/expressions.html.md
View File

@ -497,7 +497,7 @@ For example, if `var.list` is a list of strings, then the following expression
produces a list of strings with all-uppercase letters: produces a list of strings with all-uppercase letters:
```hcl ```hcl
[for s in var.list: upper(s)] [for s in var.list : upper(s)]
``` ```
This `for` expression iterates over each element of `var.list`, and then This `for` expression iterates over each element of `var.list`, and then
@ -511,7 +511,7 @@ it produces. The above example uses `[` and `]`, which produces a tuple. If
expressions must be provided separated by the `=>` symbol: expressions must be provided separated by the `=>` symbol:
```hcl ```hcl
{for s in var.list: s => upper(s)} {for s in var.list : s => upper(s)}
``` ```
This expression produces an object whose attributes are the original elements This expression produces an object whose attributes are the original elements
@ -522,7 +522,7 @@ from the source collection, which can produce a value with fewer elements than
the source: the source:
``` ```
[for s in var.list: upper(s) if s != ""] [for s in var.list : upper(s) if s != ""]
``` ```
The source value can also be an object or map value, in which case two The source value can also be an object or map value, in which case two
@ -530,7 +530,7 @@ temporary variable names can be provided to access the keys and values
respectively: respectively:
``` ```
[for k, v in var.map: length(k) + length(v)] [for k, v in var.map : length(k) + length(v)]
``` ```
Finally, if the result type is an object (using `{` and `}` delimiters) then Finally, if the result type is an object (using `{` and `}` delimiters) then
@ -538,7 +538,7 @@ the value result expression can be followed by the `...` symbol to group
together results that have a common key: together results that have a common key:
``` ```
{for s in var.list: substr(s, 0, 1) => s... if s != ""} {for s in var.list : substr(s, 0, 1) => s... if s != ""}
``` ```
## Splat Expressions ## Splat Expressions
@ -550,7 +550,7 @@ If `var.list` is a list of objects that all have an attribute `id`, then
a list of the ids could be produced with the following `for` expression: a list of the ids could be produced with the following `for` expression:
```hcl ```hcl
[for o in var.list: o.id] [for o in var.list : o.id]
``` ```
This is equivalent to the following _splat expression:_ This is equivalent to the following _splat expression:_
@ -572,7 +572,7 @@ var.list[*].interfaces[0].name
The above expression is equivalent to the following `for` expression: The above expression is equivalent to the following `for` expression:
```hcl ```hcl
[for o in var.list: o.interfaces[0].name] [for o in var.list : o.interfaces[0].name]
``` ```
Splat expressions also have another useful effect: if they are applied to Splat expressions also have another useful effect: if they are applied to
@ -609,7 +609,7 @@ This form has a subtly different behavior, equivalent to the following
`for` expression: `for` expression:
``` ```
[for o in var.list: o.interfaces][0].name [for o in var.list : o.interfaces][0].name
``` ```
Notice that with the attribute-only splat expression the index operation Notice that with the attribute-only splat expression the index operation