yamlencode Function

yamlencode encodes a given value to a string using YAML 1.2 block syntax.

Warning: This function is currently experimental and its exact result format may change in future versions of Nomad, based on feedback. Do not use yamldecode to construct a value for any argument where changes to the result would be disruptive. To get a consistent string representation of a value use jsonencode instead; its results are also valid YAML because YAML is a JSON superset.

This function maps Nomad language values to YAML tags in the following way:

Nomad type	YAML type
`string`	`!!str`
`number`	`!!float` or `!!int`
`bool`	`!!bool`
`list(...)`	`!!seq`
`set(...)`	`!!seq`
`tuple(...)`	`!!seq`
`map(...)`	`!!map`
`object(...)`	`!!map`
Null value	`!!null`

yamlencode uses the implied syntaxes for all of the above types, so it does not generate explicit YAML tags.

Because the YAML format cannot fully represent all of the Nomad language types, passing the yamlencode result to yamldecode will not produce an identical value, but the Nomad language automatic type conversion rules mean that this is rarely a problem in practice.

Examples

> yamlencode({"a":"b", "c":"d"})
"a": "b"
"c": "d"

> yamlencode({"foo":[1, 2, 3], "bar": "baz"})
"bar": "baz"
"foo":
- 1
- 2
- 3

> yamlencode({"foo":[1, {"a":"b","c":"d"}, 3], "bar": "baz"})
"bar": "baz"
"foo":
- 1
- "a": "b"
  "c": "d"
- 3

yamlencode always uses YAML's "block style" for mappings and sequences, unless the mapping or sequence is empty. To generate flow-style YAML, use jsonencode instead: YAML flow-style is a superset of JSON syntax.

jsonencode is a similar operation using JSON instead of YAML.
yamldecode performs the opposite operation, decoding a YAML string to obtain its represented value.

yamlencode Function

Examples

Related Functions