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

hclsyntax: Include legacy index syntax in the specification

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
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
The _attribute access_ operator returns the value of a single attribute in