go/hcl
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

hclsyntax: Include legacy index syntax in the specification

Browse Source
This commit is contained in:
Martin Atkins 2019-09-11 16:08:38 -07:00
parent 2c66cf702c
commit ed70541558
1 changed files with 16 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
hclsyntax/spec.md
View File

@ -542,6 +542,22 @@ return type.
Within the brackets that delimit the index key, newline sequences are ignored Within the brackets that delimit the index key, newline sequences are ignored
as whitespace. as whitespace.
The HCL native syntax also includes a _legacy_ index operator that exists
only for compatibility with the precursor language HIL:
```ebnf
LegacyIndex = '.' digit+
```
This legacy index operator must be supported by parser for compatibility but
should not be used in new configurations. This allows an attribute-access-like
syntax for indexing, must still be interpreted as an index operation rather
than attribute access.
The legacy syntax does not support chaining of index operations, like
`foo.0.0.bar`, because the interpretation of `0.0` as a number literal token
takes priority and thus renders the resulting sequence invalid.
### Attribute Access Operator ### Attribute Access Operator
The _attribute access_ operator returns the value of a single attribute in The _attribute access_ operator returns the value of a single attribute in