format Функция
Функция format создает строку, форматируя несколько других значений в соответствии со строкой спецификации. Она похожа на функцию printf в C и другие подобные функции в других языках программирования.
format(spec, values...)
Примеры
> format("Hello, %s!", "Ander")
Hello, Ander!
> format("There are %d lights", 4)
There are 4 lightsПростые спецификаторы формата, такие как %s и %d, работают аналогично синтаксису интерполяции в шаблонах, который зачастую более читабелен.
> format("Hello, %s!", var.name)
Hello, Valentina!
> "Hello, ${var.name}!"
Hello, Valentina!Спецификатор формата %#v принимает значение любого типа и представляет его в формате JSON, аналогично jsonencode. Это может быть полезно для описания значений, переданных модулю в сообщениях об ошибках проверки пользовательских условий.
> format("%#v", "hello")
"\"hello\""
> format("%#v", true)
"true"
> format("%#v", 1)
"1"
> format("%#v", {a = 1})
"{\"a\":1}"
> format("%#v", [true])
"[true]"
> format("%#v", null)
"null"Функция format наиболее полезна при использовании более сложных спецификаций формата.
Синтаксис спецификации
Спецификация — это строка, содержащая спецификаторы формата, начинающиеся с символа %. Для каждого такого последовательного фрагмента в спецификации вызов функции должен содержать дополнительный аргумент. Спецификаторы сопоставляются с последовательными аргументами и форматируют их указанным образом, если каждый переданный аргумент можно преобразовать в тип, требуемый спецификатором формата.
По умолчанию последовательности % используют аргументы по порядку, начиная с первого. Если непосредственно перед буквой спецификатора указать последовательность [n], где n — десятичное целое число, можно явно выбрать аргумент по его индексу, отсчитываемому от единицы. При последующих вызовах без явного индекса используются n+1, n+2 и т. д.
Функция выдает ошибку, если строка формата запрашивает невозможное преобразование или обращение к большему числу аргументов, чем передано. Ошибка также возникает при использовании неподдерживаемого спецификатора формата.
Спецификаторы
Спецификация может содержать следующие спецификаторы.
| Спецификатор | Результат |
|---|---|
%% |
Литерал символа процента; значение не используется. |
%v |
Форматирование по умолчанию на основе типа значения. Принимает значения всех типов, включая элементы типов null, list и map. |
%#v |
Сериализация значения в JSON, как в jsonencode. Принимает значения всех типов, включая элементы типов null, list и map. |
%t |
Преобразовать в логическое значение и вывести true или false. |
%b |
Преобразовать в целое число и вывести его двоичное представление. |
%d |
Преобразовать в целое число и вывести его десятичное представление. |
%o |
Преобразовать в целое число и вывести его восьмеричное представление. |
%x |
Преобразовать в целое число и вывести его шестнадцатеричное представление, используя строчные буквы. |
%X |
Как %x, но использовать прописные буквы. |
%e |
Преобразовать в число и вывести его в экспоненциальной записи, как -1.234456e+78. |
%E |
Как %e, но для обозначения экспоненты использовать прописную букву E. |
%f |
Преобразовать в число и вывести его в десятичной записи без экспоненты, как 123.456. |
%g |
Как %e для больших экспонент или как %f в остальных случаях. |
%G |
Как %E для больших экспонент или как %f в остальных случаях. |
%s |
Преобразовать в строку и вставить ее символы. |
%q |
Преобразовать в строку и вывести ее в виде строки в кавычках, представленной в формате JSON. |
Спецификаторы формата по умолчанию
При использовании %v OpenTofu выбирает подходящий спецификатор формата на основе типа значения.
| Тип | Спецификатор |
|---|---|
string |
%s |
number |
%g |
bool |
%t |
| любой другой | %#v |
Если форматировать нулевые значения с помощью %v или %#v, результатом будет строка null; использование других спецификаторов вызовет ошибку.
Модификатор ширины
Чтобы задать количество символов, используемых для представления значения, укажите модификатор ширины — необязательное десятичное число непосредственно перед буквой спецификатора. После ширины (если она указана) можно задать точность: для этого поставьте точку (.), за которой следует десятичное число. Если ширина или точность не указаны, OpenTofu выбирает значения по умолчанию на основе переданного значения.
В следующих примерах показаны варианты использования модификатора ширины.
| Последовательность | Результат |
|---|---|
%f |
Ширина и точность по умолчанию. |
%9f |
Ширина 9, точность по умолчанию. |
%.2f |
Ширина по умолчанию, точность 2. |
%9.2f |
Ширина 9, точность 2. |
Модификаторы ширины и точности для нечисловых типов, например строк (%s), интерпретируются иначе. Указание нулевой ширины или точности равносильно их отсутствию.
Дополнительные параметры форматирования
Чтобы задать дополнительные требования к форматированию, используйте следующие символы сразу после символа %.
| Символ | Результат |
|---|---|
| пробел | Оставить пробел на месте знака, если число положительное. |
+ |
Показывать знак числа, даже если оно положительное. |
- |
Дополнять ширину пробелами справа, а не слева. |
0 |
Дополнять ширину начальными нулями, а не пробелами. |
Связанные функции
-
formatdate— специализированная функция форматирования временных меток в удобном для чтения виде. -
formatlistиспользует тот же синтаксис спецификации, чтобы создать список строк.
Copyright (c) The OpenTofu Authors
Copyright (c) 2014 HashiCorp, Inc.
Mozilla Public License, version 2.0
https://opentofu.org/docs/v1.12/language/functions/format/
