yamldecode Функция

yamldecode разбирает строку как подмножество YAML и создает представление ее значения.

Эта функция поддерживает подмножество YAML 1.2, описанное ниже.

Эта функция сопоставляет значения YAML со значениями языка OpenTofu следующим образом:

Правила автоматического преобразования типов языка OpenTofu означают, что обычно вам не нужно беспокоиться о том, какой именно тип будет создан для заданного значения: результат можно просто использовать интуитивно понятным образом.

Однако учтите, что сопоставление выше неоднозначно: несколько исходных типов сопоставляются с одним и тем же целевым типом, поэтому преобразование туда и обратно с помощью yamldecode, а затем yamlencode не может дать идентичный результат.

YAML — сложный язык, поддерживающий ряд возможностей, которые невозможно представить в системе типов языка OpenTofu. Поэтому этот декодер YAML поддерживает только подмножество YAML 1.2 со следующими ограничениями:

• Хотя псевдонимы ранее объявленных якорей поддерживаются, циклические структуры данных (в которых ссылка на коллекцию находится внутри этой коллекции) не поддерживаются. Если yamldecode обнаружит такую структуру, функция вернет ошибку.

• Поддерживаются только теги типов, приведенные в таблице выше (или эквивалентные альтернативные представления этих же тегов). Любые другие теги приведут к ошибке.

• Допускается только один документ YAML. Если в заданной строке присутствует несколько документов, эта функция вернет ошибку.

Примеры​

> yamldecode("hello: world")
{
  "hello" = "world"
}

> yamldecode("true")
true

> yamldecode("{a: &foo [1, 2, 3], b: *foo}")
{
  "a" = [
    1,
    2,
    3,
  ]
  "b" = [
    1,
    2,
    3,
  ]
}

> yamldecode("{a: &foo [1, *foo, 3]}")

Error: Error in function call

Call to function "yamldecode" failed: cannot refer to anchor "foo" from inside
its own definition.

> yamldecode("{a: !not-supported foo}")

Error: Error in function call

Call to function "yamldecode" failed: unsupported tag "!not-supported".

Связанные функции​

• jsondecode выполняет аналогичную операцию, используя JSON вместо YAML.
• yamlencode выполняет обратную операцию — кодирует значение в формате YAML.