DOCS: More clarification about parenthesized format args.

This commit is contained in:
Jeremy Wall 2019-01-28 21:41:34 -06:00
parent 315fbabc3d
commit 7b4995607c

View File

@ -269,11 +269,12 @@ should be placed. Any primitive value can be used as an argument.
"https://@:@/" % (host, port) "https://@:@/" % (host, port)
``` ```
A slightly more complex form starts with a string followed by the `%` operator and A slightly more complex form starts with a string followed by the `%` operator
an expression. the template string can then reference the result of the expression and an unparenthesized expression. the template string can then reference the
in expressions embedded within the format string. The expressions result can be referenced using the special name `item` in the embedded expression. The result result of the expression in expressions embedded within the format string. The
of the expression will be rendered as the default string representation in the expressions result can be referenced using the special name `item` in the
resulting string. embedded expression. The result of the expression will be rendered as the
default string representation in the resulting string.
``` ```
let tpl = { let tpl = {
@ -285,6 +286,9 @@ let tpl = {
"foo.bar.1 == @{item.foo.bar.1}" % tpl; "foo.bar.1 == @{item.foo.bar.1}" % tpl;
``` ```
If the `%` operator is followed by a parenthesized expression it will be treated
as the first form with one item.
Range Expression Range Expression
---------------- ----------------