github-repos/config
1
0
Fork 0
mirror of https://github.com/lightbend/config.git synced 2025-03-22 23:30:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc ToC ordering

Browse Source
This commit is contained in:
Ryan O'Neill 2015-08-18 09:56:17 -07:00
parent e5910b8739
commit 94dd4c97bd
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
HOCON.md
View File

@ -22,11 +22,11 @@
- [Note: Arrays without commas or newlines](#note-arrays-without-commas-or-newlines) - [Note: Arrays without commas or newlines](#note-arrays-without-commas-or-newlines)
- [Path expressions](#path-expressions) - [Path expressions](#path-expressions)
- [Paths as keys](#paths-as-keys) - [Paths as keys](#paths-as-keys)
- [Conditional expressions](#conditional-expressions)
- [Substitutions](#substitutions) - [Substitutions](#substitutions)
- [Self-Referential Substitutions](#self-referential-substitutions) - [Self-Referential Substitutions](#self-referential-substitutions)
- [The `+=` field separator](#the--field-separator) - [The `+=` field separator](#the--field-separator)
- [Examples of Self-Referential Substitutions](#examples-of-self-referential-substitutions) - [Examples of Self-Referential Substitutions](#examples-of-self-referential-substitutions)
- [Conditional expressions](#conditional-expressions)
- [Includes](#includes) - [Includes](#includes)
- [Include syntax](#include-syntax) - [Include syntax](#include-syntax)
- [Include semantics: merging](#include-semantics-merging) - [Include semantics: merging](#include-semantics-merging)
@ -720,23 +720,6 @@ resolving an optional substitution (i.e. the `${?foo}` syntax).
If `${?foo}` refers to itself then it's as if it referred to a If `${?foo}` refers to itself then it's as if it referred to a
nonexistent value. nonexistent value.
### Conditional expressions
Conditional expressions allow for a block of configuration to be
included or omitted based on the value of a substitution.
Example conditional expression:
- `if [${a} == "a"] { b: true }`
In this case, if the substitution ${a} was equal to the string "a"
then the object { b: true } would be merged into the object that
the conditional expression was declared inside. If it was not
equal to "a" nothing would be merged.
The left hand side substitution cannot be optional. Currently, only equality comparisons are supported. The right hand side
of the expression can be any string, quoted or unquoted, or a boolean.
#### The `+=` field separator #### The `+=` field separator
Fields may have `+=` as a separator rather than `:` or `=`. A Fields may have `+=` as a separator rather than `:` or `=`. A
@ -913,6 +896,23 @@ rather than by the path inside the `${}` expression, because
substitutions may be resolved differently depending on their substitutions may be resolved differently depending on their
position in the file. position in the file.
### Conditional expressions
Conditional expressions allow for a block of configuration to be
included or omitted based on the value of a substitution.
Example conditional expression:
- `if [${a} == "a"] { b: true }`
In this case, if the substitution ${a} was equal to the string "a"
then the object { b: true } would be merged into the object that
the conditional expression was declared inside. If it was not
equal to "a" nothing would be merged.
The left hand side substitution cannot be optional. Currently, only equality comparisons are supported. The right hand side
of the expression can be any string, quoted or unquoted, or a boolean.
### Includes ### Includes
#### Include syntax #### Include syntax